`/sys/config/cors`

Конечная точка /sys/config/cors используется для настройки параметров CORS.

sudo требуется – эта конечная точка требует sudo возможности в дополнение к любым возможностям, специфичным для пути.

1. Настройки CORS

Эта конечная точка возвращает текущую конфигурацию CORS.

Метод

Путь

GET

/sys/config/cors

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

curl \
  --header "X-Vault-Token: ..." \
  http://127.0.0.1:8200/v1/sys/config/cors

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

{
  "enabled": true,
  "allowed_origins": ["http://www.example.com"],
  "allowed_headers": [
    "Content-Type",
    "X-Requested-With",
    "X-Vault-No-Request-Forwarding",
    "X-Vault-Token",
    "Authorization",
    "X-Vault-Wrap-Format",
    "X-Vault-Wrap-TTL"
  ]
}

2. Настройка параметров CORS

Эта конечная точка позволяет настраивать источники, которым разрешено делать запросы между источниками, а также заголовки, разрешенные в запросах между источниками.

Метод

Путь

POST

/sys/config/cors

2.1. Параметры

allowed_origins (string or string array: <required>) – подстановочный знак (*), строка, разделенная запятыми, или массив строк, указывающих источники, которым разрешено делать запросы между источниками.
allowed_headers (string or string array: "" or []) – строка или массив строк, разделённых запятыми, определяющие заголовки, которым разрешено выполнять запросы между источниками. Заголовки, заданные этим параметром, будут добавлены к списку заголовков, разрешённых StarVault по умолчанию.

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

{
  "allowed_origins": "*",
  "allowed_headers": "X-Custom-Header"
}

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

curl \
  --header "X-Vault-Token: ..." \
  --request POST \
  --data @payload.json \
  http://127.0.0.1:8200/v1/sys/config/cors

3. Удаление настройки CORS

Данная конечная точка удаляет любую конфигурацию CORS.

Метод

Путь

DELETE

/sys/config/cors

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

curl \
  --header "X-Vault-Token: ..." \
  --request DELETE \
  http://127.0.0.1:8200/v1/sys/config/cors