Перейти к содержимому

Глава 3 · Разработчикам

Как подключить «Войти через GOXOST ID» к своему сервису

Для разработчиков: общий порядок подключения GOXOST ID по OpenID Connect (Authorization Code + PKCE).

2 мин чтения

На этой странице
  1. Основные параметры
  2. 1. Получите клиента
  3. 2. Схема входа кратко
  4. Важно

GOXOST ID — стандартный провайдер OpenID Connect. Ваш сервис никогда не видит пароль пользователя, подойдёт любая сертифицированная OpenID Connect-библиотека. Полное руководство: https://myid.goxost.net/docs

Основные параметры

Issuer https://myid.goxost.net
Discovery https://myid.goxost.net/.well-known/openid-configuration
Протокол OpenID Connect 1.0, OAuth 2.0 Authorization Code
PKCE Обязателен для каждого клиента, только S256
Scope openid (обязательный), profile, email, offline_access
ID token JWT, подписанный RS256

1. Получите клиента

Самостоятельной регистрации пока нет — клиентов регистрирует команда GOXOST. Оставьте обращение в Центре помощи и укажите:

  • название и логотип сервиса для окна согласия;
  • тип клиента: конфиденциальный (серверное приложение, с client_secret) или публичный (SPA, мобильное приложение — без секрета, только PKCE);
  • все redirect URI в точном написании (только https; для разработки допускается http://localhost);
  • redirect URI после выхода (если нужны);
  • нужные scope.

Вы получите client_id, начинающийся с gxid_, а конфиденциальный клиент — ещё и client_secret, который показывается один раз.

2. Схема входа кратко

  1. Для каждого входа создайте state, nonce и code_verifier; SHA-256-хеш code_verifier передайте как code_challenge.
  2. Перенаправьте пользователя на /oauth/authorize (response_type=code, code_challenge_method=S256).
  3. Пользователь входит и (в первый раз) даёт разрешение; GOXOST ID возвращает его на redirect URI с кодом.
  4. Ваш сервер проверяет state и обменивает код на токены в /oauth/token. Код живёт 60 секунд и работает один раз.
  5. Проверьте id_token или вызовите /oauth/userinfo.
https://myid.goxost.net/oauth/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https%3A%2F%2Fexample.com%2Fauth%2Fgoxost%2Fcallback
  &scope=openid%20profile%20email
  &state=RANDOM_STATE
  &nonce=RANDOM_NONCE
  &code_challenge=YOUR_CODE_CHALLENGE
  &code_challenge_method=S256

Важно

  • Связывайте пользователя по sub — он никогда не меняется, а почта может измениться.
  • Храните client_secret только в защищённых настройках сервера. Если секрет утёк, запросите новый у поддержки.
  • Если redirect_uri не совпадает с зарегистрированным в точности, GOXOST ID покажет страницу ошибки и не выполнит перенаправление.

Готовые примеры для PHP, Laravel, Node.js и Python, а также про токены, выход и мобильные/SPA-приложения — на https://myid.goxost.net/docs.

Статья была полезной?

Не нашли ответ?

Отправьте обращение — специалист проверит ваш аккаунт и ответит.