Обзор

Сервис аутентификации Cryptometrics предоставляет безопасную систему аутентификации на основе OAuth 2.0 и OpenID Connect. Вы можете интегрировать свое приложение с нашим сервисом двумя способами:

• Через автоматическое обнаружение конфигурации (рекомендуется)
• Через ручную настройку эндпоинтов

Автоматическое обнаружение конфигурации

Наш сервис поддерживает стандарт OpenID Connect Discovery, который позволяет вашему приложению автоматически получить всю необходимую информацию для интеграции.

Шаг 1: Получение конфигурации

Отправьте GET-запрос на эндпоинт обнаружения:

Шаг 2: Использование полученной конфигурации

Ответ будет содержать все необходимые URL-адреса и параметры для настройки вашего клиента OAuth2:

{
  "issuer": "https://dev.cryptometrics.pro",
  "authorization_endpoint": "https://dev.cryptometrics.pro/oauth2/authorize",
  "token_endpoint": "https://dev.cryptometrics.pro/oauth2/token",
  "userinfo_endpoint": "https://dev.cryptometrics.pro/oauth2/userinfo",
  "revocation_endpoint": "https://dev.cryptometrics.pro/oauth2/logout",
  "jwks_uri": "https://dev.cryptometrics.pro/.well-known/jwks.json",
  "response_types_supported": ["code"],
  "subject_types_supported": ["public"],
  "id_token_signing_alg_values_supported": ["ES256"],
  "scopes_supported": ["openid", "email"],
  "token_endpoint_auth_methods_supported": ["client_secret_post"],
  "claims_supported": ["aud", "exp", "email", "iat", "iss", "sub", "name", "at_hash", "nonce"],
  "code_challenge_methods_supported": ["plain"],
  "grant_types_supported": ["authorization_code", "refresh_token"]
}

Шаг 3: Получение ключей для проверки подписи токенов

Для проверки подписи JWT-токенов используйте эндпоинт JWKS:

Ручная настройка эндпоинтов

Если вы предпочитаете настроить интеграцию вручную, используйте следующие эндпоинты:

Пример интеграции

Ниже приведен пример кода для интеграции с нашим сервисом аутентификации:

JavaScript (с использованием библиотеки oidc-client)

// Настройка клиента OpenID Connect
const settings = {
    authority: 'https://dev.cryptometrics.pro',
    client_id: 'ваш-client-id',
    redirect_uri: 'https://ваше-приложение.com/callback',
    response_type: 'code',
    scope: 'openid email',
    automaticSilentRenew: true,
    loadUserInfo: true
};

const userManager = new Oidc.UserManager(settings);

// Авторизация пользователя
function login() {
  userManager.signinRedirect();
}

// Обработка callback
function handleCallback() {
  userManager.signinRedirectCallback().then(user => {
    console.log('Пользователь авторизован', user);
    // Сохранение токенов и перенаправление
  }).catch(err => {
    console.error('Ошибка авторизации', err);
  });
}

Регистрация клиентского приложения

Для использования сервиса аутентификации необходимо зарегистрировать ваше приложение и получить client_id и client_secret. Свяжитесь с администратором системы для получения учетных данных.

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

Рекомендации по безопасности:

• Всегда проверяйте подпись JWT-токенов с помощью публичных ключей из JWKS
• Используйте HTTPS для всех запросов
• Храните client_secret в безопасном месте
• Используйте state и nonce параметры для предотвращения CSRF-атак

Overview

The Cryptometrics Authentication Service provides a secure authentication system based on OAuth 2.0 and OpenID Connect. You can integrate your application with our service in two ways:

• Through automatic configuration discovery (recommended)
• Through manual endpoint configuration

Automatic Configuration Discovery

Our service supports the OpenID Connect Discovery standard, which allows your application to automatically retrieve all necessary information for integration.

Step 1: Get Configuration

Send a GET request to the discovery endpoint:

Step 2: Use the Retrieved Configuration

The response will contain all the necessary URLs and parameters to configure your OAuth2 client:

{
  "issuer": "https://dev.cryptometrics.pro",
  "authorization_endpoint": "https://dev.cryptometrics.pro/oauth2/authorize",
  "token_endpoint": "https://dev.cryptometrics.pro/oauth2/token",
  "userinfo_endpoint": "https://dev.cryptometrics.pro/oauth2/userinfo",
  "revocation_endpoint": "https://dev.cryptometrics.pro/oauth2/logout",
  "jwks_uri": "https://dev.cryptometrics.pro/.well-known/jwks.json",
  "response_types_supported": ["code"],
  "subject_types_supported": ["public"],
  "id_token_signing_alg_values_supported": ["ES256"],
  "scopes_supported": ["openid", "email"],
  "token_endpoint_auth_methods_supported": ["client_secret_post"],
  "claims_supported": ["aud", "exp", "email", "iat", "iss", "sub", "name", "at_hash", "nonce"],
  "code_challenge_methods_supported": ["plain"],
  "grant_types_supported": ["authorization_code", "refresh_token"]
}

Step 3: Get Keys for Token Signature Verification

To verify JWT token signatures, use the JWKS endpoint:

Manual Endpoint Configuration

If you prefer to configure the integration manually, use the following endpoints:

Integration Example

Below is an example code for integrating with our authentication service:

JavaScript (using oidc-client library)

// Configure OpenID Connect client
const settings = {
  authority: 'https://dev.cryptometrics.pro',
  client_id: 'your-client-id',
  redirect_uri: 'https://your-app.com/callback',
  response_type: 'code',
  scope: 'openid email',
  automaticSilentRenew: true,
  loadUserInfo: true
};

const userManager = new Oidc.UserManager(settings);

// Authorize user
function login() {
  userManager.signinRedirect();
}

// Handle callback
function handleCallback() {
  userManager.signinRedirectCallback().then(user => {
    console.log('User authorized', user);
    // Save tokens and redirect
  }).catch(err => {
    console.error('Authorization error', err);
  });
}

Client Application Registration

To use the authentication service, you need to register your application and obtain a client_id and client_secret. Contact your system administrator to get these credentials.

Security

Security recommendations:

• Always verify JWT token signatures using public keys from JWKS
• Use HTTPS for all requests
• Store client_secret in a secure location
• Use state and nonce parameters to prevent CSRF attacks