Аутентификация

Методы аутентификации запросов к API платформы Coren. Поддержка API ключей, JWT токенов и корпоративного SSO.

Методы аутентификации

API ключи

Простая аутентификация для серверных приложений

JWT токены

Токены с ограниченным сроком действия для пользователей

LDAP / AD

Интеграция с корпоративным каталогом

API ключи

API ключи — простейший способ аутентификации. Используйте их для серверных приложений, где ключ хранится безопасно.

Создание ключа

Перейдите на страницу API ключи в панели управления
Нажмите «Создать ключ» и укажите описание
Выберите права доступа и срок действия
Скопируйте ключ — он показывается только один раз

Использование

Terminal
curl http://api.internal:8080/v1/chat/completions \
  -H "Authorization: Bearer sk_live_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3-70b",
    "messages": [{"role": "user", "content": "Привет"}]
  }'

Python SDK

auth.py
1from coren import Coren
2
3# Из переменной окружения (рекомендуется)
4# export COREN_API_KEY=sk_live_...
5client = Coren()
6
7# Или явно
8client = Coren(api_key="sk_live_ваш_api_ключ")

Безопасность

• Не храните ключи в коде или публичных репозиториях
• Используйте переменные окружения или secrets manager
• Ротируйте ключи регулярно
• Создавайте отдельные ключи для dev и prod

JWT токены

JWT токены используются для аутентификации пользователей через IAM Service. Токены имеют ограниченный срок действия и могут быть обновлены.

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

Terminal
curl http://api.internal:8080/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@company.ru",
    "password": "password123"
  }'

Ответ

response.json
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "rt_a1b2c3d4e5f6..."
}

Использование токена

jwt_auth.py
1from coren import Coren
2
3# С JWT токеном
4client = Coren(access_token="eyJhbGciOiJSUzI1NiIs...")
5
6# SDK автоматически обновит токен при истечении
7response = client.chat.create(
8    model="llama-3-70b",
9    messages=[{"role": "user", "content": "Привет"}]
10)

Обновление токена

Terminal
curl http://api.internal:8080/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{
    "refresh_token": "rt_a1b2c3d4e5f6..."
  }'

LDAP / Active Directory

Интеграция с корпоративным каталогом для централизованного управления пользователями и группами.

Конфигурация

application.yml
# application.yml IAM Service
ldap:
  enabled: true
  url: ldap://dc.company.local:389
  base-dn: dc=company,dc=local
  user-dn-pattern: uid={0},ou=users
  group-search-base: ou=groups
  group-search-filter: (member={0})

  # Маппинг атрибутов
  attribute-mapping:
    username: uid
    email: mail
    display-name: cn
    groups: memberOf

  # Маппинг групп на роли
  group-role-mapping:
    CN=AI-Admins,OU=Groups,DC=company,DC=local: admin
    CN=AI-Developers,OU=Groups,DC=company,DC=local: developer
    CN=AI-Analysts,OU=Groups,DC=company,DC=local: analyst