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

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

आवश्यकता

न्यूनतम संस्करण: 3.3.0

PrepareInfo विशेषताएँ

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

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

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

स्टैटिक UnicoSDK.initializeSDK मेथड को कॉल करें, जिसमें अपना AcessoBioConfigDataSource और environment पास करें।

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

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

Swift
Objective-C

UnicoSDK.initializeSDK(
    config: YourUnicoConfig(),
    environment: .UAT
)

[UnicoSDK initializeSDKWithConfig:[YourUnicoConfig new] environment:UAT];

config, वही AcessoBioConfigDataSource है जिसे आप पहले से कैप्चर के लिए इम्प्लीमेंट करते हैं — sdkKey, getHostKey() से आता है और bundle, getBundleIdentifier() से:

final class YourUnicoConfig: NSObject, AcessoBioConfigDataSource {
    func getBundleIdentifier() -> String { "your_bundle_id" }
    func getHostKey() -> String { "your_sdk_key" }
}

यदि environment को छोड़ दिया जाता है, तो डिफ़ॉल्ट .PROD होता है।

चरण 2 — startSilentValidation को इम्प्लीमेंट करें

initializeSDK के बाद, पहले से चल रहे कलेक्शन को पहचाने गए उपयोगकर्ता के साथ जोड़ने के लिए externalUserId वाले PrepareInfo के साथ startSilentValidation को कॉल करें।

Swift
Objective-C

let prepareInfo = PrepareInfo(externalUserId: "external_user_id")

UnicoSDK.startSilentValidation(prepareInfo: prepareInfo) { result in
    switch result {
    case .success:
        break
    case .failure(let error):
        print(error.code, error.desc, error.info)
    }
}

PrepareInfo *prepareInfo = [[PrepareInfo alloc] initWithExternalUserId:@"external_user_id"
                                                              useCase:nil];

[UnicoSDK startSilentValidationWithPrepareInfo:prepareInfo
                               errorCompletion:^(ErrorBio * _Nullable error) {
    if (error == nil) {
        // ...
    } else {
        // error.code, error.desc, error.info
    }
}];

यदि वैलिडेशन फ्लो की शुरुआत में होता है, उदाहरण के लिए लॉगिन के समय, तो चरण 3 पर आगे बढ़ने से पहले सफलता कॉलबैक की प्रतीक्षा करें।

त्रुटियाँ

कोड	अर्थ
`75001`	SDK इनिशियलाइज़ नहीं किया गया है। `initializeSDK` को कॉल नहीं किया गया था, अभी तक पूरा नहीं हुआ है, या विफल हो गया।
`75000`	सामान्य कैप्चर विफलता।

चरण 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`	साइलेंट रूप से स्वीकृत करने के लिए अपर्याप्त डेटा। बायोमेट्रिक्स (सेल्फी) या किसी अन्य वैकल्पिक विधि के माध्यम से प्रमाणीकरण करने की सिफारिश की जाती है।