› › ›

API создания токена учетной записи службы

Создает токен учетной записи службы для доступа без необходимости базовой аутентификации.

Запрос

POST /_security/service/<namespace>/<service>/credential/token/<token_name>

PUT /_security/service/<namespace>/<service>/credential/token/<token_name>

POST /_security/service/<namespace>/<service>/credential/token

Предварительные условия

Для использования этого API у вас должен быть как минимум manage_service_account привилегия кластера.

Описание

Успешный вызов API создания токена учетной записи службы возвращает JSON-структуру, содержащую токен учетной записи службы, его имя и секретное значение.

Токены учетных записей службы никогда не истекают. Вы должны их удалять, если они больше не нужны.

Параметры пути

namespace

(Обязательно, строка) Имя пространства имен.

service

(Обязательно, строка) Имя службы.

token_name

(Необязательно, строка) Имя токена учетной записи службы. Если опущено, будет сгенерировано случайное имя.

Имена токенов должны содержать не менее 1 и не более 256 символов. Они могут содержать алфавитно-цифровые символы (a-z, A-Z, 0-9), дефисы (-) и подчеркивания (_), но не могут начинаться с подчеркивания.

Имена токенов должны быть уникальными в контексте связанной учетной записи службы. Они также должны быть глобально уникальными со своими полными именами, которые состоят из принципала учетной записи службы и имени токена, например, <namespace>/<service>/<token-name>.

Примеры

Следующий запрос создает токен учетной записи службы:

POST /_security/service/elastic/fleet-server/credential/token/token1

Ответ включает токен учетной записи службы, его имя и его секретное значение:

{
  "created": true,
  "token": {
    "name": "token1",
    "value": "AAEAAWVsYXN0aWM...vZmxlZXQtc2VydmVyL3Rva2VuMTo3TFdaSDZ" 
  }
}

Секретное значение для использования в качестве токена-носителя

Для использования токена учетной записи службы включите сгенерированное значение токена в запрос с заголовком Authorization: Bearer:

curl -H "Authorization: Bearer AAEAAWVsYXN0aWM...vZmxlZXQtc2VydmVyL3Rva2VuMTo3TFdaSDZ" http://localhost:9200/_cluster/health

Если на узле установлено xpack.security.http.ssl.enabled в значение true, то необходимо указать https в URL запроса.

Следующий запрос создает токен службы с автоматически сгенерированным именем токена:

POST /_security/service/elastic/fleet-server/credential/token

Ответ включает токен учетной записи службы, его автоматически сгенерированное имя и его секретное значение:

{
  "created": true,
  "token": {
    "name": "Jk5J1HgBuyBK5TpDrdo4",
    "value": "AAEAAWVsYXN0aWM...vZmxlZXQtc2VydmVyL3Rva2VuMTo3TFdaSDZ"
  }
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/security-api-create-service-token.html