Как подключить «Войти через GOXOST ID» к своему сервису
Для разработчиков: общий порядок подключения GOXOST ID по OpenID Connect (Authorization Code + PKCE).
На этой странице
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. Схема входа кратко
- Для каждого входа создайте
state,nonceиcode_verifier; SHA-256-хешcode_verifierпередайте какcode_challenge. - Перенаправьте пользователя на
/oauth/authorize(response_type=code,code_challenge_method=S256). - Пользователь входит и (в первый раз) даёт разрешение; GOXOST ID возвращает его на redirect URI с кодом.
- Ваш сервер проверяет
stateи обменивает код на токены в/oauth/token. Код живёт 60 секунд и работает один раз. - Проверьте
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.