`/sys/internal/ui/mounts`

Кконечная точка /sys/internal/ui/mounts используется для управления видимостью списка монтирования. Ответ, генерируемый этой конечной точкой, основан на listing_visibility значении, заданном в монтировании, которое можно задать во время монтирования или с помощью настройки монтирования. В настоящее время эта конечная точка используется только для внутренних целей, для пользовательского интерфейса и предварительных проверок CLI, и не требует аутентификации.

При вызове с допустимым токеном в X-Vault-Token заголовке ответ будет включать дополнительные монтирования, на которых токену предоставлены возможности пути.

Ввиду предполагаемого использования обратная совместимость для этой конечной точки не гарантируется.

1. Получите доступные видимые монтирования

В этой конечной точке перечислены все включенные методы аутентификации.

Метод

Путь

GET

/sys/internal/ui/mounts

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

curl \
  http://127.0.0.1:8200/v1/sys/internal/ui/mounts

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

{
  "auth": {
    "github/": {
      "description": "GitHub auth",
      "type": "github"
    }
  },
  "secret": {
    "custom-secrets/": {
      "description": "Custom secrets",
      "options": {
        "version": "2"
      },
      "type": "kv"
    }
  }
}

2. Получение сведений об единичном монтировании

Эта конечная точка содержит сведения о конкретном пути монтирования. Это аутентифицированная конечная точка, которая в настоящее время используется только для внутренних целей.

Вызывающему токену не следует предоставлять разрешения на эти конечные точки API напрямую, вместо этого он должен полагаться на разрешения, предоставленные для отдельного пути монтирования. Это означает, что если вы предоставите токену политику с возможностями для :path (например, /secret/*), токен сможет вызывать sys/internal/ui/mounts/:path (например, sys/internal/ui/mounts/secret) без необходимости добавлять этот буквальный путь в документ политики.

На некоторых монтированиях можно вызвать произвольный путь внутри механизма секретов (например, /sys/internal/ui/mounts/secret/path/to/secret если путь монтирования — /secret). При таком вызове эта конечная точка вернет данные для монтируемого объекта, содержащего этот путь. Следовательно, вызовы /sys/internal/ui/mounts/secret/path/to/secret и /sys/internal/ui/mounts/secret дадут идентичный ответ.