原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/security-api-authenticate.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/security-api-authenticate.html
本地英文版地址: ../en/security-api-authenticate.html
重要: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 当前版本文档。
Authenticate APIedit
Enables you to submit a request with a basic auth header to authenticate a user and retrieve information about the authenticated user.
Requestedit
GET /_security/_authenticate
Descriptionedit
A successful call returns a JSON structure that shows user information such as their username, the roles that are assigned to the user, any assigned metadata, and information about the realms that authenticated and authorized the user.
Response codesedit
If the user cannot be authenticated, this API returns a 401 status code.
Examplesedit
To authenticate a user, submit a GET request to the
/_security/_authenticate endpoint:
GET /_security/_authenticate
The following example output provides information about the "rdeniro" user:
{
"username": "rdeniro",
"roles": [
"admin"
],
"full_name": null,
"email": null,
"metadata": { },
"enabled": true,
"authentication_realm": {
"name" : "file",
"type" : "file"
},
"lookup_realm": {
"name" : "file",
"type" : "file"
}
}