Руководство разработчика по интеграции Didit с современными стеками наблюдаемости (RU)

Бесшовная интеграцияЧистые API Didit и ориентированный на разработчиков дизайн позволяют легко интегрироваться с ведущими инструментами наблюдаемости, такими как Grafana, Loki и Tempo.

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

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

Оптимизированная производительностьМодульная и AI-ориентированная архитектура Didit в сочетании с надежной наблюдаемостью помогает оптимизировать производительность и надежность ваших сервисов верификации личности, предлагая при этом бесплатный базовый KYC.

Критичность наблюдаемости в верификации личности

В современном цифровом ландшафте верификация личности больше не является простой галочкой; это фундаментальный столп доверия и безопасности. По мере роста бизнеса и усложнения пользовательских взаимодействий, базовые процессы верификации личности должны быть надежными, устойчивыми и прозрачными. Именно здесь вступают в игру современные стеки наблюдаемости. Инструменты, такие как Grafana для визуализации, Loki для логов и Tempo для трассировок, предоставляют всесторонний обзор состояния и производительности ваших приложений. Интеграция их с вашей платформой верификации личности, такой как Didit, имеет первостепенное значение для проактивного мониторинга, быстрой отладки и обеспечения бесперебойного пользовательского опыта.

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

Инструментирование сессий Didit с помощью логов (Loki) и метрик (Grafana)

Подход Didit, ориентированный на API, делает невероятно простым внедрение сбора логов и метрик в ваши рабочие процессы верификации личности. Когда вы создаете сессию верификации с помощью API Didit, вы получаете session_id и status. Это важные точки данных для наблюдаемости.

Логирование с Loki

Для каждого вызова API Didit, особенно при создании сессии или получении веб-хука, вы должны логировать соответствующие детали. Loki — отличный выбор для этого благодаря индексации на основе меток, что делает его эффективным для запросов. Вот как вы можете подойти к этому:

// Псевдокод для логирования создания сессии
const diditResponse = await didit.createSession({
  workflow_id: 'your-workflow-id',
  callback: 'https://yourapp.com/verification-complete',
  vendor_data: 'user-123'
});

logger.info('Didit session created', {
  session_id: diditResponse.session_id,
  workflow_id: diditResponse.workflow_id,
  status: diditResponse.status,
  vendor_data: diditResponse.vendor_data,
  service: 'identity-verification-service',
  component: 'didit-api-integration'
});

Когда Didit отправляет веб-хуки, уведомляющие вас об обновлениях сессии (например, изменениях статуса, успешной верификации или сбоях), логируйте эти события с аналогичной детализацией. Это позволяет вам искать в Loki все логи, связанные с конкретным session_id или vendor_data, чтобы понять полный жизненный цикл попытки верификации. Например, если у пользователя возникла проблема со верификацией ID Didit, вы можете быстро отфильтровать логи, чтобы увидеть точные изменения статуса и любые сообщения об ошибках.

Метрики с Grafana

Для количественного анализа предоставляйте метрики из вашего приложения, взаимодействующие с Didit. Общие метрики включают:

• didit_session_created_total: Счетчик общего количества инициированных сессий.
• didit_session_status_total{status="success"}: Счетчик успешных верификаций.
• didit_session_status_total{status="failed"}: Счетчик неудачных верификаций.
• didit_session_duration_seconds: Гистограмма или сводка времени, прошедшего от создания сессии до завершения.
• didit_api_request_duration_seconds: Гистограмма времени ответа API.

Эти метрики, предоставляемые через Prometheus и визуализируемые в Grafana, предоставляют информационные панели, которые показывают общее состояние и производительность вашей системы верификации личности. Вы можете настроить оповещения о внезапных падениях показателей успеха или увеличении задержки, указывающих на потенциальные проблемы с обнаружением живости Didit или другими компонентами.

Распределенная трассировка для сложных рабочих процессов (Tempo)

Современные приложения часто включают в себя множество микросервисов, взаимодействующих для выполнения одного пользовательского запроса. Верификация личности не является исключением, особенно когда оркеструются различные проверки, такие как AML-проверка, подтверждение адреса и верификация телефона и электронной почты. Распределенная трассировка, обеспечиваемая такими инструментами, как Tempo, становится здесь незаменимой.

Когда пользователь инициирует поток верификации личности, вы можете начать новую трассировку. Когда ваше приложение вызывает API Didit, и когда веб-хуки Didit запускают последующие действия в вашей системе, вы должны распространять контексты трассировки (например, идентификаторы трассировки OpenTelemetry). Это позволяет вам видеть весь путь запроса на верификацию по всем задействованным сервисам, от инициации на фронтенде до окончательного решения о верификации.

// Псевдокод для использования OpenTelemetry с вызовом API Didit
import { trace } from '@opentelemetry/api';

const tracer = trace.getTracer('my-app-didit-integration');

async function verifyUser(userData) {
  const span = tracer.startSpan('didit.createSession');
  try {
    // Добавить соответствующие атрибуты к span
    span.setAttribute('user.id', userData.id);
    span.setAttribute('workflow.id', 'your-workflow-id');

    const diditResponse = await didit.createSession({
      workflow_id: 'your-workflow-id',
      callback: 'https://yourapp.com/verification-complete',
      vendor_data: userData.id
    });

    span.setAttribute('didit.session_id', diditResponse.session_id);
    span.setAttribute('didit.status', diditResponse.status);
    span.setStatus({ code: SpanStatusCode.OK });
    return diditResponse;
  } catch (error) {
    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
    span.recordException(error);
    throw error;
  } finally {
    span.end();
  }
}

Если пользователь сообщает о проблеме с процессом оценки возраста или NFC-верификации, вы можете использовать идентификатор пользователя или идентификатор сессии для поиска в Tempo. Трассировка покажет вам, какой именно сервис или внешний вызов API (например, API Didit) вызвал задержку или сбой, предоставляя бесценные сведения для отладки и оптимизации производительности.

Как помогает Didit

Didit разработан с нуля как платформа для разработчиков, что делает интеграцию с современными стеками наблюдаемости не просто возможной, но и бесшовной. Наша модульная архитектура позволяет подключать и использовать проверки личности, каждая из которых может быть индивидуально инструментирована для превосходного мониторинга. AI-ориентированная платформа Didit гарантирует, что основные процессы, такие как верификация ID, пассивная и активная проверка живости, а также сопоставление лиц 1:1 и поиск лиц, являются высокопроизводительными и надежными, а наш надежный дизайн API обеспечивает четкие точки входа и выхода для ваших данных наблюдаемости.

Мы предлагаем бесплатный базовый KYC, устраняя финансовые барьеры для начала работы с основной верификацией личности. Наша платформа генерирует структурированные данные о личности, что идеально подходит для подачи в ваши системы логирования и метрик. Отслеживаете ли вы процент успеха оценки возраста Didit для соответствия требованиям или мониторите производительность нашей NFC-верификации для высокозащищенных приложений, Didit предоставляет необходимую прозрачность. Нет никаких сборов за установку, а наша модель оплаты за успешную проверку гарантирует, что вы платите только за то, что используете, что облегчает масштабирование ваших усилий по наблюдаемости вместе с ростом вашего бизнеса.

Готовы начать?

Хотите увидеть Didit в действии? Получите бесплатную демонстрацию сегодня.

Начните бесплатно верифицировать личности с бесплатным тарифом Didit.