用户/组和角色¶
安全性¶
只有具有角色“管理员”的用户才能访问用户/组和角色REST API。
输入/输出¶
数据对象传输¶
XML和JSON都支持数据对象的传输。默认值为XML。或者,可以通过将请求中的“content-type”(post)和“accept”(get)HTTP头设置为“application/json”来使用json。
用户的XML编码::
<user>
<userName>..</userName>
<password>..</password>
<enabled>true/false</enabled>
</user>
JSON中用户的编码:
{"userName": "..", "password": "..", enabled: true/false}
在读取请求的结果中省略了密码。
用XML编码用户列表:
<users>
<user> ... </user>
<user> ... </user>
...
</users>
JSON中用户列表的编码:
{"users":[ {..}, {..}, .. ]}
组列表的XML编码::
<groups>
<group> agroupname </group>
<group> bgroupname </group>
...
</groups>
在json中对组列表进行编码:
{"groups":[ {..}, {..}, .. ]}
角色列表编码::
<roles>
<role> arolename </role>
<role> brolename </role>
...
</roles>
JSON中角色列表的编码:
{"roles":[ {..}, {..}, .. ]}
配置¶
默认的用户/组服务是名为“默认”的服务。这可以通过以下方式进行更改:
使用以下Java系统属性启动GeoServer:
org.geoserver.rest.DefaultUserGroupServiceName=<name_of_usergroupservice>
请求¶
/rest/usergroup/[service/<serviceName>/]users/
¶
查询所有用户或在特定或默认用户/组服务中添加新用户。
方法 |
行动 |
响应 |
---|---|---|
GET |
列出服务中的所有用户。 |
200好。XML中的用户列表。 |
POST |
添加新用户 |
插入201。创建 |
/rest/usergroup/[service/<serviceName>/]user/<user>
¶
查询、修改或删除特定或默认用户/组服务中的特定用户。
方法 |
行动 |
响应 |
---|---|---|
GET |
读取用户信息 |
200好。XML中的用户。 |
POST |
修改用户,未指定的字段保持不变。 |
200好。 |
DELETE |
删除用户 |
200好。 |
/rest/usergroup/[service/<serviceName>/]groups/
¶
查询特定用户/组或默认服务中的所有组。
方法 |
行动 |
响应 |
---|---|---|
GET |
列出服务中的所有组。 |
200好。XML中的组列表。 |
/rest/usergroup/[service/<serviceName>/]group/<group>
¶
添加或删除特定或默认用户/组服务中的特定组。
方法 |
行动 |
响应 |
---|---|---|
POST |
添加组。 |
200好。 |
DELETE |
删除组。 |
200好。 |
/rest/usergroup/[service/<serviceName>/]user/<user>/groups
¶
查询与特定用户或默认用户/组服务中的用户关联的所有组。
方法 |
行动 |
响应 |
---|---|---|
GET |
列出与用户关联的所有组。 |
200好。XML中的组列表。 |
/rest/usergroup/[service/<serviceName>/]group/<group>/users
¶
查询与特定组或默认用户/组服务中的组关联的所有用户。
方法 |
行动 |
响应 |
---|---|---|
GET |
列出与组关联的所有用户。 |
200好。XML中的组列表。 |
/rest/usergroup/[service/<serviceName>/]<user>/group/<group>
¶
将特定用户与特定组或默认用户/组服务中的特定组关联或解除关联。
方法 |
行动 |
响应 |
---|---|---|
POST |
将用户与组关联。 |
200好。 |
DELETE |
解除用户与组的关联。 |
200好。 |
rest/roles/[service/{serviceName}/]
¶
查询特定角色服务或活动角色服务中的所有角色。
方法 |
行动 |
响应 |
---|---|---|
GET |
列出服务中的所有角色。 |
200好。XML中的角色列表。 |
/rest/roles/[service/<serviceName>/]role/<role>
¶
添加或删除特定角色服务或活动角色服务中的特定角色。
方法 |
行动 |
响应 |
---|---|---|
POST |
添加角色。 |
200好。 |
DELETE |
删除角色。 |
200好。 |
/rest/roles/[service/<serviceName>/]<serviceName>/user/<user>/roles
¶
查询与特定角色服务或活动角色服务中的用户关联的所有角色。
方法 |
行动 |
响应 |
---|---|---|
GET |
列出与用户关联的所有角色。 |
200好。XML中的角色列表。 |
/rest/roles/[service/<serviceName>/]role/<role>/user/<user>/
¶
将特定用户与特定角色服务或活动角色服务中的特定角色关联或解除关联。
方法 |
行动 |
响应 |
---|---|---|
POST |
将用户与角色关联。 |
200好。 |
DELETE |
解除用户与角色的关联。 |
200好。 |