> ## Documentation Index
> Fetch the complete documentation index at: https://veriqa.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение к облаку

> Основной путь подключения к Veriqa Cloud: пять адресов проекта, обычный OIDC-клиент и никаких библиотек Veriqa.

Основной путь — обычный redirect: пользователь уходит на страницу входа Veriqa и возвращается в
ваше приложение. Со стороны кода это **стандартный OIDC-клиент** — тот же, что вы завели бы для
любого провайдера.

## Что нужно

* **адрес проекта**: `https://<хост облака>/p/{project}`;
* **`client_id`** приложения и, если оно confidential, **`client_secret`**;
* **`redirect_uri`**, зарегистрированный в Console.

Библиотеки Veriqa **не нужны**. Никакого предварительного запроса за конфигурацией тоже: всё, что
требуется клиенту, лежит в discovery.

<Note>
  Вызов `bootstrap` на этом пути не участвует. Он нужен только тогда, когда кнопки каналов рисует
  ваша страница — см. [кнопки каналов](/docs/ru/cloud/channel-buttons).
</Note>

## Пять адресов, которых достаточно

| Метод | Путь |
| - | - |
| GET | `/p/{project}/.well-known/openid-configuration` |
| GET | `/p/{project}/.well-known/jwks.json` |
| GET | `/p/{project}/connect/authorize` |
| POST | `/p/{project}/connect/token` |
| GET | `/p/{project}/connect/userinfo` |

Указывайте библиотеке **issuer** — остальное она возьмёт из discovery сама. Прописывать адреса
руками стоит только там, где клиент discovery не умеет.

## Аутентификация запросов

| Что вызываете | Как аутентифицируетесь |
| - | - |
| `token`, `introspection`, `revocation` | `client_id` + `client_secret` (Basic или `client_secret_post`); public-клиент — PKCE без секрета |
| `status`, `health` | без аутентификации |

Для облачных эндпоинтов сверх OIDC используется заголовок `X-Veriqa-Cloud-Key` — он описан на
странице про кнопки каналов.

## Параметры, которые понимает `/connect/authorize`

Помимо стандартных `scope`, `state`, `nonce` и PKCE:

* **`acr_values=channel:<тип>`** — сузить набор каналов до перечисленных (несколько значений
  разделяются пробелом);
* **`ui_locales`** — язык окна входа;
* **`ui_config`** — код набора настроек окна, заведённого владельцем проекта; подробнее в разделе
  про кастомизацию.

## Проверка на месте

Статус проекта и его каналов отдаёт публичный `GET /p/{project}/v1/status`, здоровье инстанса —
`GET /v1/health`. Оба без аутентификации, удобны для мониторинга и для быстрой проверки «дело во
мне или в облаке».

<Warning>
  Адреса вида `https://cloud.veriqa.io/...` в примерах иллюстративные. Фактический хост вашего
  облака смотрите в Console.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.