静默重新验证

使用静默重新验证引擎，在 Unico 网络效应范围内分析用户的行为背景，并为当前交易提供置信度信号。换句话说，我们提供的是判断当前用户是否为该交易预期用户的置信水平。

PrepareInfo 属性

属性	类型	是否必填	描述
`externalUserId`	`String`	✅	您系统中的用户标识符。传输前会自动使用 SHA-256 进行哈希处理，绝不会以明文形式发送。

开始静默重新验证

步骤 1 — 实现 initializeSDK

创建一个新的 UnicoSDK 类/对象，其中包含一个静态的 initializeSDK 方法，该方法接收 context 和一个包含您的 sdkKey、bundleId 和 environment 的 UnicoSDKConfig，并返回 UnicoSDK 实例。请保留返回的实例——稍后从 Java 调用 startSilentValidation 时需要用到它。

在应用启动时调用

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 并传入包含 externalUserId 的 PrepareInfo，将已在进行中的采集与已识别的用户关联起来。

Kotlin
Java

val prepareInfo = PrepareInfo(
    externalUserId = "external_user_id"
)

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

Java 需要一个 Kotlin 桥接

startSilentValidation 是一个 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 ▸ 创建流程。

在请求正文中包含与步骤 2 中 PrepareInfo 所发送的相同 externalUserId——这样后端才能将流程创建与已在进行中的验证关联起来。

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`	数据不足，无法静默通过认证。建议通过生物识别（自拍）或其他替代方式进行认证。