# Вход через Taskless

OpenID Connect

Пользователи входят в ваше приложение аккаунтом Taskless по стандарту OpenID Connect — Taskless выступает провайдером личности. Обычный OAuth 2.1 с PKCE, без раздачи паролей.

`https://taskless.ru/api` · OAuth 2.1 · PKCE S256

## Как подключить

1. Создайте OIDC-клиента в настройках воркспейса — получите `client_id`, `client_secret` (показывается один раз) и укажите `redirect_uri` вашего приложения.
2. Настройте свою OAuth-библиотеку значениями из блока «Эндпоинты» ниже.
3. Добавьте кнопку «Войти через Taskless» — она ведёт на `authorization_endpoint`.

## Эндпоинты

Многие библиотеки настраиваются одним discovery-URL. Либо укажите эндпоинты вручную:

issuer: `https://taskless.ru/api`

discovery: `https://taskless.ru/api/.well-known/openid-configuration`

authorization_endpoint: `https://taskless.ru/api/oauth/authorize`

token_endpoint: `https://taskless.ru/api/oauth/token`

userinfo_endpoint: `https://taskless.ru/api/oauth/userinfo`

jwks_uri: `https://taskless.ru/api/oauth/jwks`

PKCE S256 обязателен. Аутентификация клиента: client_secret_basic или client_secret_post.

## Scopes

- `openid` — обязательный — идентификатор пользователя (sub)
- `profile` — имя и аватар
- `email` — адрес почты
- `groups` — членство и роли для маппинга доступа
- `taskless:full` — полный доступ к API от имени пользователя

Кто может входить — все участники воркспейса или список пользователей и команд — настраивается при создании клиента.

## Роли (опционально)

Чтобы задать роли пользователей, ваш сервис отдаёт конфиг по адресу `{origin}/.well-known/taskless-roles` — Taskless периодически фетчит его (подписанным запросом). Формат строгий:

```json
{
  "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. Замените плейсхолдеры (капсом) на свои значения.

```bash
# 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`.

Войти через Taskless

```html
<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>
```
