사일런트 재검증

사일런트 재검증 엔진을 사용하여 유니코의 네트워크 효과 내에서 사용자의 행동 컨텍스트를 분석하고 현재 거래에 대한 신뢰 신호를 제공합니다. 다시 말해, 해당 사용자가 거래에서 예상된 사용자일 신뢰 수준을 제공합니다.

PrepareInfo 속성

속성	유형	필수	설명
`externalUserId`	`String`	✅	사용자 시스템 내 식별자입니다. 전송 전에 SHA-256으로 자동 해시 처리되며, 평문으로 전송되지 않습니다.

사일런트 재검증 시작하기

1단계 — initializeSDK 구현

context와 sdkKey, bundleId, environment를 담은 UnicoSDKConfig를 받아 UnicoSDK 인스턴스를 반환하는 정적 initializeSDK 메서드를 가진 새로운 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 이후, externalUserId를 포함하는 PrepareInfo와 함께 startSilentValidation을 호출하여 이미 진행 중인 수집을 식별된 사용자와 연결하세요.

Kotlin
Java

val prepareInfo = PrepareInfo(
    externalUserId = "external_user_id"
)

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

Java는 Kotlin 브리지가 필요합니다

startSilentValidation은 Kotlin suspend 함수이므로 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) {
        /* ... */
    }
});

로그인처럼 플로우 시작 시점에 검증이 이루어지는 경우, 3단계로 넘어가기 전에 onSuccess 콜백을 기다리세요.

3단계 — 프로세스 생성 및 인증

검증이 진행되는 동안, 인증을 완료하기 위한 검증 프로세스를 생성하세요. API 참조 ▸ API ▸ Create Process를 참고하세요.

요청 본문에 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`	사일런트로 승인하기에 데이터가 충분하지 않습니다. 생체 인증(셀피) 또는 다른 대체 방법을 통한 인증을 권장합니다.