साइलेंट पुनर्सत्यापन

साइलेंट पुनर्सत्यापन इंजन का उपयोग करता है, जो Unico के नेटवर्क प्रभाव के भीतर उपयोगकर्ता के व्यवहारिक संदर्भ का विश्लेषण करता है और वर्तमान लेनदेन के लिए विश्वास संकेत प्रदान करता है। दूसरे शब्दों में, हम लेनदेन में अपेक्षित उपयोगकर्ता होने के विश्वास स्तर को प्रदान करते हैं।

PrepareInfo विशेषताएँ

विशेषता	प्रकार	आवश्यक	विवरण
`externalUserId`	`String`	✅	आपके सिस्टम में उपयोगकर्ता पहचानकर्ता। ट्रांसमिशन से पहले SHA-256 के साथ स्वचालित रूप से हैश किया जाता है, कभी भी प्लेन टेक्स्ट में नहीं भेजा जाता।

साइलेंट पुनर्सत्यापन शुरू करना

चरण 1 — initializeSDK को इम्प्लीमेंट करें

एक नया UnicoSDK क्लास/ऑब्जेक्ट बनाएँ, जिसमें एक स्टैटिक initializeSDK मेथड हो जो UnicoSDK इंस्टेंस रिटर्न करता है, और context तथा आपके sdkKey, bundleId, और environment के साथ एक UnicoSDKConfig प्राप्त करता है। रिटर्न किए गए इंस्टेंस को सुरक्षित रखें — बाद में Java से startSilentValidation कॉल करने के लिए इसकी आवश्यकता होती है।

इसे ऐप लॉन्च पर कॉल करें

UnicoSDK.initializeSDK को ऐप लॉन्च पर यथासंभव जल्द से जल्द कॉल किया जाना चाहिए (उदाहरण के लिए, Application.onCreate)। इसे बाद में कॉल करने से बैकग्राउंड प्रोसेसिंग समय कम हो जाता है और अनिर्णायक (inconclusive) प्रमाणीकरण प्रतिक्रियाओं की संभावना बढ़ जाती है।

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 Reference ▸ API ▸ Create Process।

रिक्वेस्ट बॉडी में वही externalUserId शामिल करें जो चरण 2 में PrepareInfo में भेजा गया था — यही बैकएंड को प्रोसेस निर्माण को पहले से चल रहे वैलिडेशन के साथ सहसंबंधित (correlate) करने की अनुमति देता है।

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"
  }'

प्रतिक्रिया (response) में प्रमाणीकरण परिणाम के साथ silentAuth.result फ़ील्ड शामिल होता है:

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

फ़ील्ड	प्रकार	विवरण
`silentAuth.result`	string	`yes` या `no` — संभावित मान नीचे देखें।

silentAuth.result — संभावित मान

मान अर्थ

yes प्रमाणीकरण स्वीकृत, उपयोगकर्ता को पर्याप्त विश्वास के साथ पहचाना गया, किसी अतिरिक्त कैप्चर की आवश्यकता नहीं है।

no साइलेंट रूप से स्वीकृत करने के लिए अपर्याप्त डेटा। बायोमेट्रिक्स (सेल्फी) या किसी अन्य वैकल्पिक विधि के माध्यम से प्रमाणीकरण करने की सिफारिश की जाती है।

मान	अर्थ
`yes`	प्रमाणीकरण स्वीकृत, उपयोगकर्ता को पर्याप्त विश्वास के साथ पहचाना गया, किसी अतिरिक्त कैप्चर की आवश्यकता नहीं है।
`no`	साइलेंट रूप से स्वीकृत करने के लिए अपर्याप्त डेटा। बायोमेट्रिक्स (सेल्फी) या किसी अन्य वैकल्पिक विधि के माध्यम से प्रमाणीकरण करने की सिफारिश की जाती है।