mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-29 01:44:36 -04:00
255c9a7f95
**Problem:** For historical reasons, source files for the Elasticsearch Guide's security, watcher, and Logstash API docs are housed in the `x-pack/docs` directory. This can confuse new contributors who expect Elasticsearch Guide docs to be located in `docs/reference`. **Solution:** - Move the security, watcher, and Logstash API doc source files to the `docs/reference` directory - Update doc snippet tests to use security Rel: https://github.com/elastic/platform-docs-team/issues/208
127 lines
3.5 KiB
Text
127 lines
3.5 KiB
Text
[role="xpack"]
|
|
[[security-api-has-privileges]]
|
|
=== Has privileges API
|
|
++++
|
|
<titleabbrev>Has privileges</titleabbrev>
|
|
++++
|
|
[[security-api-has-privilege]]
|
|
|
|
Determines whether the logged in user has a specified list of privileges.
|
|
|
|
[[security-api-has-privileges-request]]
|
|
==== {api-request-title}
|
|
|
|
`GET /_security/user/_has_privileges`
|
|
|
|
`POST /_security/user/_has_privileges`
|
|
|
|
|
|
[[security-api-has-privileges-prereqs]]
|
|
==== {api-prereq-title}
|
|
|
|
* All users can use this API, but only to determine their own privileges.
|
|
To check the privileges of other users, you must use the run as feature. For
|
|
more information, see
|
|
<<run-as-privilege>>.
|
|
|
|
[[security-api-has-privileges-desc]]
|
|
==== {api-description-title}
|
|
|
|
For a list of the privileges that you can specify in this API,
|
|
see <<security-privileges>>.
|
|
|
|
A successful call returns a JSON structure that shows whether each specified
|
|
privilege is assigned to the user.
|
|
|
|
[[security-api-has-privileges-request-body]]
|
|
==== {api-request-body-title}
|
|
|
|
`cluster`:: (list) A list of the cluster privileges that you want to check.
|
|
|
|
`index`::
|
|
`names`::: (list) A list of indices.
|
|
`allow_restricted_indices`::: (Boolean) This needs to be set to `true` (default
|
|
is `false`) if using wildcards or regexps for patterns that cover restricted
|
|
indices. Implicitly, restricted indices do not match index patterns because
|
|
restricted indices usually have limited privileges and including them in
|
|
pattern tests would render most such tests `false`. If restricted indices are
|
|
explicitly included in the `names` list, privileges will be checked against
|
|
them regardless of the value of `allow_restricted_indices`.
|
|
`privileges`::: (list) A list of the privileges that you want to check for the
|
|
specified indices.
|
|
|
|
`application`::
|
|
`application`::: (string) The name of the application.
|
|
`privileges`::: (list) A list of the privileges that you want to check for the
|
|
specified resources. May be either application privilege names, or the names of
|
|
actions that are granted by those privileges
|
|
`resources`::: (list) A list of resource names against which the privileges
|
|
should be checked
|
|
|
|
|
|
[[security-api-has-privileges-example]]
|
|
==== {api-examples-title}
|
|
|
|
The following example checks whether the current user has a specific set of
|
|
cluster, index, and application privileges:
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
GET /_security/user/_has_privileges
|
|
{
|
|
"cluster": [ "monitor", "manage" ],
|
|
"index" : [
|
|
{
|
|
"names": [ "suppliers", "products" ],
|
|
"privileges": [ "read" ]
|
|
},
|
|
{
|
|
"names": [ "inventory" ],
|
|
"privileges" : [ "read", "write" ]
|
|
}
|
|
],
|
|
"application": [
|
|
{
|
|
"application": "inventory_manager",
|
|
"privileges" : [ "read", "data:write/inventory" ],
|
|
"resources" : [ "product/1852563" ]
|
|
}
|
|
]
|
|
}
|
|
--------------------------------------------------
|
|
|
|
The following example output indicates which privileges the "rdeniro" user has:
|
|
|
|
[source,console-result]
|
|
--------------------------------------------------
|
|
{
|
|
"username": "rdeniro",
|
|
"has_all_requested" : false,
|
|
"cluster" : {
|
|
"monitor" : true,
|
|
"manage" : false
|
|
},
|
|
"index" : {
|
|
"suppliers" : {
|
|
"read" : true
|
|
},
|
|
"products" : {
|
|
"read" : true
|
|
},
|
|
"inventory" : {
|
|
"read" : true,
|
|
"write" : false
|
|
}
|
|
},
|
|
"application" : {
|
|
"inventory_manager" : {
|
|
"product/1852563" : {
|
|
"read": false,
|
|
"data:write/inventory": false
|
|
}
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
// TESTRESPONSE[s/"rdeniro"/"$body.username"/]
|
|
// TESTRESPONSE[s/: false/: true/]
|