# Глоссарий

Канонический двуязычный глоссарий OneKYC. Каждая статья содержит русский термин, англоязычное соответствие, определение и связанные понятия. Полный двуязычный список с API-полями см. в [English glossary](/en/reference/glossary).

> Примечание: если одному русскому слову соответствуют разные понятия (например, **Сессия (верификации)** и **Сессия (вход администратора)**), они оформлены отдельными статьями.

---

**AML (Anti-Money Laundering)** — комплекс мер по противодействию отмыванию денежных средств. В контексте OneKYC — автоматическая проверка аппликанта по санкционным спискам, базам PEP и иным watch-листам. Результат фиксируется в сессии верификации.

**API key (API-ключ)** — пара «ключ + секрет» для аутентификации вашего бэкенда в Tenant API. Идентификатор ключа передаётся в заголовке запроса; тело запроса подписывается HMAC с использованием секрета. Ключи создаются в разделе [API-ключи](/ru/admin/api-keys) и имеют назначенные scopes (права доступа). Подробнее: [Аутентификация](/ru/api/authentication).

**Applicant (аппликант)** — физическое лицо, проходящее или завершившее верификацию. В API и админ-панели аппликант идентифицируется по внутреннему ID или по внешнему идентификатору вашей системы (`external_user_id`). С аппликантом связаны верификационные сессии, загруженные документы и результаты проверок.

**Beneficial owner (бенефициарный владелец, УБО)** — физическое лицо, которое в конечном счёте владеет или контролирует бизнес, проходящий KYB-верификацию. Идентификация бенефициаров — одна из обязательных KYB-проверок.

**Business (бизнес)** — юридическое лицо (компания, ИП), проходящее KYB-верификацию. Аналог аппликанта в KYB.

**BYOB (Bring-Your-Own-Bucket)** — возможность подключить собственный S3 / S3-совместимый / GCS / Azure Blob-стораж тенанта вместо общего хранилища OneKYC. См. [Хранилище](/ru/admin/tenant-storage).

**Cross-device handoff (передача на другое устройство)** — возможность флоу продолжить верификацию на другом устройстве (как правило, сканированием QR-кода с мобильного для съёмки документов и селфи).

**Dead letter queue (DLQ)** — очередь, в которую попадают вебхук-события после исчерпания всех автоматических попыток доставки. Записи можно отправить повторно, удалить или массово воспроизвести после восстановления приёмника. См. [Вебхуки](/ru/admin/webhooks).

**Document liveness** — проверка, что перед камерой находится реальный физический документ, а не фотография или экран.

**Face liveness** — проверка, что перед камерой реальный живой человек, а не фотография, видеозапись или цифровой дипфейк.

**Face match (сопоставление лица)** — автоматическая проверка соответствия лица на селфи лицу на фотографии в документе. Результат выражается в виде числового показателя степени сходства (similarity score).

**Flow (флоу)** — сценарий верификации: упорядоченный набор шагов, которые проходит пользователь (загрузка документа, съёмка селфи, проверка liveness, ввод OTP и другие). Конфигурация сценария задаётся в разделе [Флоу](/ru/admin/flows); по сценарию создаются верификационные сессии.

**Grace period (период грации)** — настраиваемый интервал, в течение которого принимаются и старая, и новая версия секрета (или местоположения хранения), чтобы интеграции могли переключиться без потери запросов.

**HMAC (Hash-based Message Authentication Code)** — механизм аутентификации сообщений на основе хеш-функции. Используется для подписания запросов к Tenant API и проверки подлинности вебхуков. Подпись формируется с использованием секрета API-ключа или секрета вебхука соответственно.

**KBY-AI** — сторонний вендор, поставляющий OCR, проверки подлинности документов, document liveness, face liveness и face match.

**KMS (Key Management Service)** — сервис управления ключами (AWS KMS, GCP KMS). Для BYOB на AWS политика SSE-KMS может требовать шифрования объектов KMS-ключом тенанта.

**Kontur.Compliance (Фокус.Комплаенс)** — сторонний AML-провайдер (агрегатор русскоязычных watch-листов), используемый для проверки по санкциям, PEP и другим спискам.

**Kontur.Focus (Фокус API)** — сторонний провайдер обогащения данных по российским компаниям и физлицам.

**KYB (Know Your Business)** — процедура верификации юридических лиц. Включает проверку данных компании, бенефициарных владельцев и связанных лиц. В OneKYC KYB-верификация осуществляется через отдельные API-эндпоинты и типы ключей.

**KYC (Know Your Customer)** — процедура идентификации и верификации личности клиента. Основной процесс OneKYC, включающий проверку документов, биометрию, AML-скрининг и иные этапы в соответствии с настроенным сценарием.

**Liveness** — проверка «живого присутствия»: подтверждение того, что перед камерой находится реальный человек или реальный документ, а не фотография, видеозапись или цифровая подделка. Делится на face liveness и document liveness.

**Manual review (ручная проверка / ревью)** — очередь сессий верификации, требующих решения оператора. Ревьюеры просматривают документы и данные аппликанта, затем одобряют, отклоняют или запрашивают пересдачу. См. [Ревью](/ru/admin/review).

**OCR (Optical Character Recognition)** — оптическое распознавание символов. Технология автоматического извлечения текстовых данных из изображения документа (ФИО, дата рождения, номер документа, дата выдачи и другие реквизиты).

**OTP (One-Time Password)** — одноразовый пароль, направляемый пользователю по SMS или электронной почте для подтверждения владения указанным номером телефона или адресом электронной почты.

**PEP (Politically Exposed Person)** — публичное должностное лицо. PEP-статус — один из списков AML-скрининга.

**Presigned URL** — кратковременный подписанный URL, разрешающий конкретную операцию (как правило, GET или POST) над конкретным объектом в object-storage. OneKYC использует presigned URL для скачивания документов и прямой загрузки из браузера.

**Rate limit** — ограничение на количество запросов к API в единицу времени. Применяется для защиты системы от избыточной нагрузки. При превышении лимита запросы отклоняются с кодом `429 Too Many Requests`.

**Redirect URL** — адрес перенаправления пользователя после завершения верификации. Указывается при создании ссылки верификации. Поведение (кнопка или автоматический переход) настраивается в параметрах сценария.

**Rejection reason (причина отклонения)** — структурированный код, который возвращает ревьюер (или автоматическая проверка), чтобы объяснить, почему верификация отклонена.

**Resubmit request (запрос пересдачи)** — запрос от ревьюера к пользователю на повторную сдачу одного конкретного шага (например, фото документа) без отклонения всей сессии. Подчиняется лимитам (≤ 3 на сессию) и TTL 7 дней.

**Review task (задача ревью)** — единица работы в очереди ручного ревью, привязанная к одной сессии верификации. Содержит назначение, приоритет, комментарии, решение и историю запросов пересдачи.

**S3** — Amazon Simple Storage Service либо любое S3-совместимое объектное хранилище (Cloudflare R2, Backblaze B2, MinIO, Wasabi). Используется для хранения документов, селфи и KYB-материалов.

**Sanctions (санкции)** — ограничительные меры государств или международных органов в отношении физических и юридических лиц. Соответствие санкциям — один из списков AML-скрининга.

**Scope** — право доступа API-ключа к определённому ресурсу или действию (например, `applicants:read`, `sessions:create`). Каждый эндпоинт API требует наличия одного или нескольких scopes; при отсутствии необходимого права запрос возвращает ошибку `403 Forbidden`.

**Selfie (селфи)** — автопортретное фото или видео, снятое в ходе верификации. Используется для face liveness и сопоставления с фотографией в документе.

**Session (admin login) — сессия (вход администратора)** — аутентифицированная сессия в админ-панели: период между входом и выходом / истечением токена. Не путать с сессией верификации.

**Session (verification) — сессия (верификации)** — единичный процесс верификации: пользователь переходит по ссылке, проходит шаги сценария (документ, селфи, liveness и другие), сессия завершается одобрением, отклонением или истечением срока действия. Каждая сессия имеет уникальный идентификатор, статус и привязку к сценарию и аппликанту.

**Step (шаг)** — отдельный этап сценария верификации: загрузка документа, съёмка селфи, проверка liveness, ввод OTP, ревью данных и другие. Шаги могут быть видимыми для пользователя (требуют его участия) или скрытыми (выполняются автоматически после завершения предыдущего шага).

**Storage migration (миграция хранилища)** — фоновый процесс, копирующий исторические файлы из общего хранилища OneKYC в бакет тенанта после активации BYOB.

**Team (команда)** — набор пользователей, имеющих доступ к админ-панели тенанта. Управляется в разделе «Команда»: приглашения, назначение ролей, удаление, сброс пароля.

**Tenant (тенант)** — организация (компания, проект) в системе OneKYC. Данные каждого тенанта полностью изолированы: сессии, аппликанты, сценарии, API-ключи. Каждый тенант располагает собственной админ-панелью и составом пользователей.

**Verification link (ссылка верификации)** — ссылка с ограниченным сроком действия, по которой пользователь переходит к прохождению верификации. Привязана к сценарию; при активации создаётся верификационная сессия. Создаётся в разделе [Ссылки верификации](/ru/admin/verification-links) или через Tenant API.

**Webhook (вебхук)** — HTTP-уведомление, направляемое OneKYC на указанный вами URL при наступлении определённого события (создание сессии, завершение шага, одобрение или отклонение верификации). Запросы подписываются секретом для обеспечения подлинности. Настройка эндпоинтов выполняется в разделе [Вебхуки](/ru/admin/webhooks).

**Webhook secret (секрет вебхука)** — строка с префиксом `whsec_`, которой подписываются payload'ы вебхуков. Проверка подписи на вашей стороне доказывает, что запрос пришёл от OneKYC.

**Шифрование (envelope)** — двухуровневая схема шифрования: Data Encryption Key (DEK) на тенанта выводится из мастер-ключа и шифрует фактический ciphertext. Применяется для BYOB-credentials.

**Внешний ID пользователя (external user ID)** — идентификатор пользователя в вашей системе, используемый для привязки сессии верификации к конкретному аппликанту на вашей стороне.

**Шаблон флоу (flow template)** — заготовленная конфигурация флоу, которую можно клонировать для создания нового флоу без проектирования с нуля.

**Журнал аудита (audit log)** — хронологический журнал всех действий пользователей и API-ключей: входы, изменения конфигурации, решения по верификации, ротации секретов. См. [Аудит](/ru/admin/audit).

**Документ (document)** — документ, удостоверяющий личность (паспорт, ID-карта, водительские права и т. д.), загруженный в ходе верификации. Подлежит OCR, проверкам подлинности и document liveness.