`/identity/lookup`

В данном разделе представлена документация API для поиска сущностей и групп в хранилище идентификации.

1. Поиск сущности

Данная конечная точка осуществляет поиск сущности на основе заданных критериев. Критериями могут быть name, id, alias_id или комбинация alias_name и alias_mount_accessor.

Метод Путь

Метод	Путь
`POST`	`/identity/lookup/entity`

POST

/identity/lookup/entity

1.1. Параметры

name (string: "") - имя сущности.
id (string: "") - ID сущности.
alias_id (string: "") - ID псевдонима.
alias_name (string: "") - имя псевдонима. Должно быть указано совместно с alias_mount_accessor.
alias_mount_accessor (string: "") - accessor монтирования, к которому принадлежит этот псевдоним. Должно быть указано совместно с alias_name.

Пример тела запроса:

{
  "id": "043fedec-967d-b2c9-d3af-0c467b04e1fd"
}

Пример запроса:

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    --data @payload.json \
    http://127.0.0.1:8200/v1/identity/lookup/entity

Пример ответа:

{
  "data": {
    "aliases": [],
    "creation_time": "2025-07-29T09:17:20.328729846Z",
    "direct_group_ids": [],
    "group_ids": [],
    "id": "043fedec-967d-b2c9-d3af-0c467b04e1fd",
    "inherited_group_ids": [],
    "last_update_time": "2025-07-29T09:17:20.328729846Z",
    "merged_entity_ids": null,
    "metadata": null,
    "name": "entity_43cc451b",
    "policies": null
  }
}

2. Поиск группы

Эта конечная точка осуществляет поиск группы на основе заданных критериев. Критериями могут быть name,id, alias_id или комбинация alias_name и alias_mount_accessor.

Метод Путь

Метод	Путь
`POST`	`/identity/lookup/group`

POST

/identity/lookup/group

2.1. Параметры

name (string: "") - имя группы.
id (string: "") - ID группы.
alias_id (string: "") - ID псевдонима.
alias_name (string: "") - имя псевдонима. Должно быть указано совместно с alias_mount_accessor.
alias_mount_accessor (string: "") - accessor монтирования, к которому принадлежит этот псевдоним. Должно быть указано совместно с alias_name.

Пример тела запроса:

{
  "id": "70a4bdef-9da3-4460-b524-bb08542eef25"
}

Пример запроса:

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    --data @payload.json \
    http://127.0.0.1:8200/v1/identity/lookup/group

Пример ответа:

{
  "data": {
    "alias": {},
    "creation_time": "2025-05-20T06:18:56.18726631Z",
    "id": "70a4bdef-9da3-4460-b524-bb08542eef25",
    "last_update_time": "2025-05-20T06:18:56.18726631Z",
    "member_entity_ids": [],
    "member_group_ids": null,
    "metadata": null,
    "modify_index": 1,
    "name": "group_eaf2aab1",
    "policies": null,
    "type": "internal"
  }
}