Тихая ревалидация

Использует движок Тихая ревалидация, который анализирует поведенческий контекст пользователя в рамках сетевого эффекта Unico и выдаёт сигнал уверенности для текущей транзакции. Другими словами, мы предоставляем уровень уверенности в том, что это именно тот пользователь, который ожидается в транзакции.

Атрибуты PrepareInfo

Атрибут	Тип	Обязательно	Описание
`externalUserId`	`String`	✅	Идентификатор пользователя в вашей системе. Автоматически хешируется с помощью SHA-256 перед передачей, никогда не отправляется в открытом виде.

Запуск тихой ревалидации

Шаг 1 — Реализуйте initializeSDK

Создайте новый класс/объект UnicoSDK со статическим методом initializeSDK, который возвращает экземпляр UnicoSDK, принимая context и UnicoSDKConfig с вашими sdkKey, bundleId и environment. Сохраните возвращённый экземпляр — он понадобится позже для вызова startSilentValidation из Java.

Вызывайте его при запуске приложения

UnicoSDK.initializeSDK должен вызываться как можно раньше при запуске приложения (например, в Application.onCreate). Более поздний вызов сокращает время фоновой обработки и увеличивает вероятность неопределённых ответов аутентификации.

Kotlin
Java

UnicoSDK.initializeSDK(
    context,
    UnicoSDKConfig(
        sdkKey = "your_sdk_key",
        bundleId = "your_bundle_id",
        environment = Environment.UAT
    )
)

UnicoSDK sdk = UnicoSDK.initializeSDK(
    context,
    new UnicoSDKConfig("your_sdk_key", "your_bundle_id", Environment.UAT)
);

Шаг 2 — Реализуйте startSilentValidation

После initializeSDK свяжите уже выполняющийся сбор данных с идентифицированным пользователем, вызвав startSilentValidation с PrepareInfo, содержащим externalUserId.

Kotlin
Java

val prepareInfo = PrepareInfo(
    externalUserId = "external_user_id"
)

UnicoSDK.startSilentValidation(prepareInfo)
    .onSuccess { result -> /* ... */ }
    .onFailure { error -> /* ... */ }

Java требует Kotlin-мост

startSilentValidation — это suspend-функция Kotlin, и Java не может вызвать её напрямую. Используйте мост ниже, чтобы установить соединение.

interface SilentAuthCallback {
    fun onSuccess(success: Boolean)
    fun onFailure(message: String?)
}

object SilentAuthBridge {

    @JvmStatic
    fun startSilentValidation(
        owner: LifecycleOwner,
        sdk: UnicoSDK,
        externalUserId: String,
        callback: SilentAuthCallback
    ) {
        owner.lifecycleScope.launch {
            val result = sdk.startSilentValidation(PrepareInfo(externalUserId, null))
            result.onSuccess { callback.onSuccess(it.success) }
                .onFailure { callback.onFailure(it.message) }
        }
    }
}

SilentAuthBridge.startSilentValidation(this, sdk, externalUserId, new SilentAuthCallback() {
    @Override
    public void onSuccess(boolean success) {
        /* ... */
    }

    @Override
    public void onFailure(String message) {
        /* ... */
    }
});

Если валидация происходит в начале потока, например при входе в систему, дождитесь колбэка onSuccess, прежде чем переходить к Шагу 3.

Шаг 3 — Создайте процесс и выполните аутентификацию

Пока валидация выполняется, создайте процесс верификации для завершения аутентификации. См. Справочник API ▸ API ▸ Создание процесса.

Включите в тело запроса тот же externalUserId, который был отправлен в PrepareInfo на Шаге 2 — именно это позволяет бэкенду сопоставить создание процесса с уже выполняющейся валидацией.

curl -X POST https://api.id.unico.app/processes/v1 \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": {
      "duiType": 1,
      "code": "12345678909",
      "name": "Luke Skywalker",
      "gender": "M",
      "birthDate": "2000-05-20",
      "email": "[email protected]",
      "phone": "5519725570707"
    },
    "useCase": "Onboarding",
    "externalUserId": "external_user_id"
  }'

Ответ содержит поле silentAuth.result с результатом аутентификации:

{
    "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
    "status": 3,
    "silentAuth": {
        "result": "yes"
    }
}

Поле	Тип	Описание
`silentAuth.result`	string	`yes` или `no` — см. возможные значения ниже.

silentAuth.result — возможные значения

Значение	Смысл
`yes`	Аутентификация одобрена, пользователь распознан с достаточной уверенностью, дополнительный захват не требуется.
`no`	Недостаточно данных для одобрения в тихом режиме. Рекомендуется аутентификация с помощью биометрии (селфи) или другого альтернативного метода.