OpenID Connect
Вход через Taskless
Пользователи входят в ваше приложение аккаунтом Taskless по стандарту OpenID Connect — Taskless выступает провайдером личности. Обычный OAuth 2.1 с PKCE, без раздачи паролей.
https://taskless.ru/apiOAuth 2.1PKCE S256Как подключить
- 1Создайте OIDC-клиента в настройках воркспейса — получите
client_id,client_secret(показывается один раз) и укажитеredirect_uriвашего приложения. - 2Настройте свою OAuth-библиотеку значениями из блока «Эндпоинты» ниже.
- 3Добавьте кнопку «Войти через Taskless» — она ведёт на
authorization_endpoint.
Эндпоинты
Многие библиотеки настраиваются одним discovery-URL. Либо укажите эндпоинты вручную:issuer
https://taskless.ru/apidiscovery
https://taskless.ru/api/.well-known/openid-configurationauthorization_endpoint
https://taskless.ru/api/oauth/authorizetoken_endpoint
https://taskless.ru/api/oauth/tokenuserinfo_endpoint
https://taskless.ru/api/oauth/userinfojwks_uri
https://taskless.ru/api/oauth/jwksScopes
openidобязательный — идентификатор пользователя (sub)profileимя и аватарemailадрес почтыgroupsчленство и роли для маппинга доступаtaskless:fullполный доступ к API от имени пользователя
Роли (опционально)
Чтобы задать роли пользователей, ваш сервис отдаёт конфиг по адресу{origin}/.well-known/taskless-roles — Taskless периодически фетчит его (подписанным запросом). Формат строгий:{
"version": 1,
"roles": [
{ "value": "admin", "label": "Администратор", "description": "опц." },
{ "value": "editor", "label": "Редактор" }
],
"defaultRole": "editor"
}version (число) и roles (массив ≤100). Поле роли — именно value (не key/name/id) + label; description и defaultRole опциональны. Эндпоинт: application/json, https (кроме localhost).Роль юзера возвращается в id_token под ключом https://taskless.ru/roles (массив) — читайте именно его, не groups (это команды воркспейса) и не rolesна верхнем уровне.Пример интеграции
Полный authorization-code + PKCE flow. Замените плейсхолдеры (капсом) на свои значения.# 1. Отправьте пользователя на страницу входа (PKCE S256).
# code_verifier — случайная строка 43–128 символов;
# code_challenge = base64url(sha256(code_verifier)).
GET https://taskless.ru/api/oauth/authorize
?response_type=code
&client_id=YOUR_CLIENT_ID
&redirect_uri=https://your.app/callback
&scope=openid%20profile%20email
&code_challenge=CODE_CHALLENGE
&code_challenge_method=S256
&state=RANDOM_STATE
# 2. Пользователь вернётся на redirect_uri с ?code=... — обменяйте на токены:
curl -X POST https://taskless.ru/api/oauth/token \
-d grant_type=authorization_code \
-d code=AUTH_CODE \
-d redirect_uri=https://your.app/callback \
-d code_verifier=CODE_VERIFIER \
-d client_id=YOUR_CLIENT_ID \
-d client_secret=YOUR_CLIENT_SECRET
# 3. Ответ: { access_token, id_token, refresh_token }. Профиль:
curl https://taskless.ru/api/oauth/userinfo -H "Authorization: Bearer ACCESS_TOKEN"Кнопка входа
Кнопка ведёт на ваш серверный маршрут (например/auth/taskless/login), который стартует OAuth-flow и редиректит на authorization_endpoint.<a class="tl-signin" href="/auth/taskless/login">
<svg width="18" height="16" viewBox="0 0 60 54" aria-hidden="true">
<path fill="currentColor" d="M46.92 0H10.24A10.24 10.24 0 0 0 0 10.24v.16a10.24 10.24 0 0 0 10.24 10.24h6.6a8.28 8.28 0 0 0 7.21-3l12.01-11.9a5.42 5.42 0 0 1 3.82-1.58h6.44a6.29 6.29 0 0 1 6.29 6.29v.16a6.29 6.29 0 0 1-6.29 6.29h-7.11a8.3 8.3 0 0 0-6.06 2.62L21.13 31.58a8.3 8.3 0 0 0-2.86 6.26v2.26a10.24 10.24 0 0 0 20.48 0V20.74a8.4 8.4 0 0 1 1.07-.1h7.11a10.24 10.24 0 0 0 10.24-10.24v-.16A10.24 10.24 0 0 0 46.92 0Z"/>
</svg>
Войти через Taskless
</a>
<style>
.tl-signin {
display: inline-flex; align-items: center; gap: 8px;
padding: 10px 18px; border-radius: 8px;
background: #4a7cf6; color: #fff;
font: 600 0.875rem/1 system-ui, sans-serif;
text-decoration: none; transition: background .15s;
}
.tl-signin:hover { background: #6a93f8; }
</style>