# Начать вход через OIDC — перенаправление к корпоративному IdP

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Начать вход через OIDC — перенаправление к корпоративному IdP

`POST /api/v1/security/sso/login/{providerId}`

**Параметры**

| Имя | Где | Обязательный | Тип | Описание |
| --- | --- | --- | --- | --- |
| `providerId` | path | да | string (uuid) |  |
| `returnTo` | query | нет | string | Куда вернуть пользователя после входа |
| `idempotency-key` | header | нет | string | Ключ идемпотентности для безопасного повтора запроса: 8–255 символов из набора A-Za-z0-9_.:+/=-, ответ кэшируется на 24 ч |

**Ответы**

- `200` — URL authorize-endpoint IdP (`application/json`, object)
  - `authUrl`: string (uri), обязательное
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `429` — Превышен лимит запросов, повторите через Retry-After секунд (`application/problem+json`, ProblemDetails)

    </>
  );
}