Глоссарий
Канонический двуязычный глоссарий OneKYC. Каждая статья содержит русский термин, англоязычное соответствие, определение и связанные понятия. Полный двуязычный список с API-полями см. в English glossary.
Примечание: если одному русскому слову соответствуют разные понятия (например, Сессия (верификации) и Сессия (вход администратора)), они оформлены отдельными статьями.
AML (Anti-Money Laundering) — комплекс мер по противодействию отмыванию денежных средств. В контексте OneKYC — автоматическая проверка аппликанта по санкционным спискам, базам PEP и иным watch-листам. Результат фиксируется в сессии верификации.
API key (API-ключ) — пара «ключ + секрет» для аутентификации вашего бэкенда в Tenant API. Идентификатор ключа передаётся в заголовке запроса; тело запроса подписывается HMAC с использованием секрета. Ключи создаются в разделе API-ключи и имеют назначенные scopes (права доступа). Подробнее: Аутентификация.
Applicant (аппликант) — физическое лицо, проходящее или завершившее верификацию. В API и админ-панели аппликант идентифицируется по внутреннему ID или по внешнему идентификатору вашей системы (external_user_id). С аппликантом связаны верификационные сессии, загруженные документы и результаты проверок.
Beneficial owner (бенефициарный владелец, УБО) — физическое лицо, которое в конечном счёте владеет или контролирует бизнес, проходящий KYB-верификацию. Идентификация бенефициаров — одна из обязательных KYB-проверок.
Business (бизнес) — юридическое лицо (компания, ИП), проходящее KYB-верификацию. Аналог аппликанта в KYB.
BYOB (Bring-Your-Own-Bucket) — возможность подключить собственный S3 / S3-совместимый / GCS / Azure Blob-стораж тенанта вместо общего хранилища OneKYC. См. Хранилище.
Cross-device handoff (передача на другое устройство) — возможность флоу продолжить верификацию на другом устройстве (как правило, сканированием QR-кода с мобильного для съёмки документов и селфи).
Dead letter queue (DLQ) — очередь, в которую попадают вебхук-события после исчерпания всех автоматических попыток доставки. Записи можно отправить повторно, удалить или массово воспроизвести после восстановления приёмника. См. Вебхуки.
Document liveness — проверка, что перед камерой находится реальный физический документ, а не фотография или экран.
Face liveness — проверка, что перед камерой реальный живой человек, а не фотография, видеозапись или цифровой дипфейк.
Face match (сопоставление лица) — автоматическая проверка соответствия лица на селфи лицу на фотографии в документе. Результат выражается в виде числового показателя степени сходства (similarity score).
Flow (флоу) — сценарий верификации: упорядоченный набор шагов, которые проходит пользователь (загрузка документа, съёмка селфи, проверка liveness, ввод OTP и другие). Конфигурация сценария задаётся в разделе Флоу; по сценарию создаются верификационные сессии.
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 (ручная проверка / ревью) — очередь сессий верификации, требующих решения оператора. Ревьюеры просматривают документы и данные аппликанта, затем одобряют, отклоняют или запрашивают пересдачу. См. Ревью.
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 (ссылка верификации) — ссылка с ограниченным сроком действия, по которой пользователь переходит к прохождению верификации. Привязана к сценарию; при активации создаётся верификационная сессия. Создаётся в разделе Ссылки верификации или через Tenant API.
Webhook (вебхук) — HTTP-уведомление, направляемое OneKYC на указанный вами URL при наступлении определённого события (создание сессии, завершение шага, одобрение или отклонение верификации). Запросы подписываются секретом для обеспечения подлинности. Настройка эндпоинтов выполняется в разделе Вебхуки.
Webhook secret (секрет вебхука) — строка с префиксом whsec_, которой подписываются payload'ы вебхуков. Проверка подписи на вашей стороне доказывает, что запрос пришёл от OneKYC.
Шифрование (envelope) — двухуровневая схема шифрования: Data Encryption Key (DEK) на тенанта выводится из мастер-ключа и шифрует фактический ciphertext. Применяется для BYOB-credentials.
Внешний ID пользователя (external user ID) — идентификатор пользователя в вашей системе, используемый для привязки сессии верификации к конкретному аппликанту на вашей стороне.
Шаблон флоу (flow template) — заготовленная конфигурация флоу, которую можно клонировать для создания нового флоу без проектирования с нуля.
Журнал аудита (audit log) — хронологический журнал всех действий пользователей и API-ключей: входы, изменения конфигурации, решения по верификации, ротации секретов. См. Аудит.
Документ (document) — документ, удостоверяющий личность (паспорт, ID-карта, водительские права и т. д.), загруженный в ходе верификации. Подлежит OCR, проверкам подлинности и document liveness.