OAuth 2.0

Метаданные OAuth 2.0 Authorization Server (RFC 8414)

Тело ответа

`application/json`

curl -X GET "https://loading/.well-known/oauth-authorization-server"

{
  "authorization_endpoint": "string",
  "code_challenge_methods_supported": [
    "string"
  ],
  "dpop_signing_alg_values_supported": [
    "string"
  ],
  "grant_types_supported": [
    "string"
  ],
  "introspection_endpoint": "string",
  "introspection_endpoint_auth_methods_supported": [
    "string"
  ],
  "issuer": "string",
  "jwks_uri": "string",
  "registration_endpoint": "string",
  "response_types_supported": [
    "string"
  ],
  "revocation_endpoint": "string",
  "revocation_endpoint_auth_methods_supported": [
    "string"
  ],
  "scopes_supported": [
    "string"
  ],
  "service_documentation": "string",
  "token_endpoint": "string",
  "token_endpoint_auth_methods_supported": [
    "string"
  ],
  "userinfo_endpoint": "string"
}

OpenID Connect Discovery 1.0

Тело ответа

`application/json`

curl -X GET "https://loading/.well-known/openid-configuration"

{
  "authorization_endpoint": "string",
  "code_challenge_methods_supported": [
    "string"
  ],
  "dpop_signing_alg_values_supported": [
    "string"
  ],
  "grant_types_supported": [
    "string"
  ],
  "introspection_endpoint": "string",
  "introspection_endpoint_auth_methods_supported": [
    "string"
  ],
  "issuer": "string",
  "jwks_uri": "string",
  "registration_endpoint": "string",
  "response_types_supported": [
    "string"
  ],
  "revocation_endpoint": "string",
  "revocation_endpoint_auth_methods_supported": [
    "string"
  ],
  "scopes_supported": [
    "string"
  ],
  "service_documentation": "string",
  "token_endpoint": "string",
  "token_endpoint_auth_methods_supported": [
    "string"
  ],
  "userinfo_endpoint": "string",
  "property1": null,
  "property2": null
}

Эндпоинт авторизации OAuth 2.0 (RFC 6749 §3.1, PKCE RFC 7636)

Авторизация

bearerAuth

АвторизацияBearer <токен>

В: header

Параметры запроса

response_type*string

Только authorization code flow

Значение в"code"

client_id*string

client_id зарегистрированного клиента

redirect_uri*string

Зарегистрированный redirect URI

scope?string

Запрашиваемые scope через пробел

state?string

Непрозрачное значение, возвращается в redirect

nonce?string

OIDC nonce

code_challenge*string

PKCE challenge (обязателен)

code_challenge_method?string

Метод PKCE, только S256

Значение в"S256"

dpop_jkt?string

Отпечаток DPoP-ключа для привязки токенов (RFC 9449 §10)

resource?string

Целевой ресурс (RFC 8707)

Тело ответа

`application/json`

curl -X GET "https://loading/oauth/authorize?response_type=code&client_id=string&redirect_uri=string&code_challenge=string"

Пусто

{
  "error": "string",
  "error_description": "string"
}

Контекст экрана согласия OAuth (имя клиента, scopes, redirect_uri)

Авторизация

bearerAuth

АвторизацияBearer <токен>

В: header

Параметры запроса

client_id*string

client_id из authorize-запроса

redirect_uri*string

redirect_uri из authorize-запроса

scope?string

Запрашиваемые scope через пробел

resource?string

Целевой ресурс (RFC 8707)

Тело ответа

`application/json`

curl -X GET "https://loading/oauth/authorize/context?client_id=string&redirect_uri=string"

{
  "application_type": "string",
  "client_id": "string",
  "client_name": "string",
  "redirect_uri": "string",
  "resource": "string",
  "scopes": [
    "string"
  ]
}

{
  "error": "string",
  "error_description": "string"
}

Решение пользователя по экрану согласия OAuth (выдача кода или отказ)

Авторизация

bearerAuth

АвторизацияBearer <токен>

В: header

Тело запроса

application/json

TypeScript-определения

Используйте тип request body в TypeScript.

approve*boolean

Решение пользователя: true — разрешить, false — отказать

client_id*string

client_id из authorize-запроса

code_challenge*string

PKCE challenge из authorize-запроса

code_challenge_method?string

Метод PKCE, только S256

Значение в"S256"

dpop_jkt?string

Отпечаток DPoP-ключа

nonce?string

OIDC nonce из authorize-запроса

redirect_uri*string

redirect_uri из authorize-запроса

resource?string

Целевой ресурс (RFC 8707)

scope?string

Scope из authorize-запроса

state?string

State из authorize-запроса

Тело ответа

`application/json`

curl -X POST "https://loading/oauth/authorize/decision" \  -H "Content-Type: application/json" \  -d '{    "approve": true,    "client_id": "string",    "code_challenge": "string",    "redirect_uri": "string"  }'

{
  "location": "string"
}

{
  "error": "string",
  "error_description": "string"
}

Интроспекция токена (RFC 7662)

Тело запроса

application/x-www-form-urlencoded

TypeScript-определения

Используйте тип request body в TypeScript.

client_id?string

client_id (если клиент не аутентифицируется через Basic)

client_secret?string

client_secret confidential-клиента

token*string

Проверяемый токен

token_type_hint?string

Подсказка типа токена

Значение в"access_token" | "refresh_token"

Тело ответа

`application/json`

curl -X POST "https://loading/oauth/introspect" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'token=string'

{
  "active": true,
  "aud": "string",
  "client_id": "string",
  "cnf": {
    "jkt": "string"
  },
  "exp": 0,
  "iat": 0,
  "iss": "string",
  "jti": "string",
  "nbf": 0,
  "scope": "string",
  "sub": "string",
  "token_type": "string",
  "username": "string"
}

{
  "error": "string",
  "error_description": "string"
}

{
  "error": "string",
  "error_description": "string"
}

Динамическая регистрация клиента OAuth 2.0 (RFC 7591)

Тело запроса

application/json

TypeScript-определения

Используйте тип request body в TypeScript.

application_type?string

Тип приложения

Значение в"web" | "native"

client_name?string

Название приложения

Длинаlength <= 255

grant_types?array<string>

Запрашиваемые grant-типы

redirect_uris*array<string>

Redirect URI: https или loopback (http://127.0.0.1), без wildcard, до 5

Элементы1 <= items <= 5

response_types?array<string>

Запрашиваемые response_type

scope?string

Запрашиваемые scope через пробел (openid, profile, email, mcp:tools:execute)

token_endpoint_auth_method?string

Способ аутентификации; для публичных клиентов none

Тело ответа

`application/json`

curl -X POST "https://loading/oauth/register" \  -H "Content-Type: application/json" \  -d '{    "redirect_uris": [      "string"    ]  }'

{
  "application_type": "string",
  "client_id": "string",
  "client_id_issued_at": 0,
  "client_name": "string",
  "grant_types": [
    "string"
  ],
  "redirect_uris": [
    "string"
  ],
  "response_types": [
    "string"
  ],
  "scope": "string",
  "token_endpoint_auth_method": "string"
}

{
  "error": "string",
  "error_description": "string"
}

Отзыв токена (RFC 7009)

Тело запроса

application/x-www-form-urlencoded

TypeScript-определения

Используйте тип request body в TypeScript.

client_id?string

client_id (если клиент не аутентифицируется через Basic)

client_secret?string

client_secret confidential-клиента

token*string

Отзываемый токен

token_type_hint?string

Подсказка типа токена

Значение в"access_token" | "refresh_token"

Тело ответа

curl -X POST "https://loading/oauth/revoke" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'token=string'

Пусто

Эндпоинт выдачи токенов OAuth 2.0 (RFC 6749 §3.2)

Тело запроса

application/x-www-form-urlencoded

TypeScript-определения

Используйте тип request body в TypeScript.

act_as_service_principal?string

Сервис-принципал для делегирования

audience?string

Audience целевого токена (RFC 8693)

client_id?string

client_id (если клиент не аутентифицируется через Basic)

client_secret?string

client_secret confidential-клиента

code?string

Authorization code (для authorization_code)

code_verifier?string

PKCE code_verifier

grant_type*string

Grant-тип: authorization_code, refresh_token, client_credentials или token-exchange (RFC 8693)

redirect_uri?string

redirect_uri из authorize-запроса

refresh_token?string

Refresh-токен (для refresh_token)

requested_token_type?string

Запрашиваемый тип токена (RFC 8693)

resource?string

Целевой ресурс (RFC 8707)

scope?string

Запрашиваемые scope через пробел

subject_token?string

Обмениваемый токен (RFC 8693)

subject_token_type?string

Тип обмениваемого токена (RFC 8693)

team_id?string

Команда для client_credentials-токена

witness_id?string

Witness-идентификатор для witness-токенов

witnessed_user_id?string

Пользователь, действия которого заверяются

Тело ответа

`application/json`

curl -X POST "https://loading/oauth/token" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'grant_type=string'

{
  "access_token": "string",
  "expires_in": 0,
  "refresh_token": "string",
  "scope": "string",
  "token_type": "string"
}

{
  "error": "string",
  "error_description": "string"
}

{
  "error": "string",
  "error_description": "string"
}

Эндпоинт UserInfo (профиль текущего пользователя)

Авторизация

bearerAuth

АвторизацияBearer <токен>

В: header

Тело ответа

`application/json`

curl -X GET "https://loading/oauth/userinfo"

{
  "email": "string",
  "family_name": "string",
  "given_name": "string",
  "name": "string",
  "sub": "string"
}

{
  "error": "string",
  "error_description": "string"
}

200application/json

200application/json

302

400application/json

200application/json

400application/json

200application/json

400application/json

200application/json

400application/json

401application/json

201application/json

400application/json

200

200application/json

400application/json

401application/json

200application/json

401application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`