> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# प्रमाणीकरण इंटीग्रेशन गाइड: आर्किटेक्चर और गो-लाइव

> Didit Authentication को प्रोडक्शन में कैसे इंटीग्रेट करें: होस्टेड या अपनी स्क्रीन, token स्टोरेज, बैकएंड जाँच, सत्र, नेटिव ऐप और गो-लाइव प्रक्रिया।

यह गाइड बताती है कि Didit Authentication का प्रोडक्शन इंटीग्रेशन पहले रीडायरेक्ट से लेकर लाइव होने की चेकलिस्ट तक कैसे एक साथ काम करता है।
अगर आपने अभी तक किसी व्यक्ति को साइन इन नहीं कराया है, तो पहले [क्विकस्टार्ट](https://docs.didit.me/hi/authentication/quickstart.md) देखें, और हर SDK का कोड प्लेटफ़ॉर्म क्विकस्टार्ट में देखें।

## Architecture

```mermaid theme={null}
sequenceDiagram
    participant App as Your app (browser or mobile)
    participant Hosted as Your Didit sign-in origin
    participant API as Your backend
    participant Webhook as Your webhook endpoint

    App->>Hosted: Open /sign-in (redirect_uri, state, PKCE challenge)
    Note over Hosted: Sign-in method, MFA,<br/>bot protection, verification
    Hosted-->>App: Redirect to redirect_uri with code and state
    App->>Hosted: POST /token/ (code, PKCE verifier)
    Hosted-->>App: Access token (5 min), ID token, refresh token
    App->>API: Request with Authorization: Bearer access token
    Note over API: Verify the signature<br/>with the cached JWKS
    API->>Hosted: GET /session/ before a sensitive action
    Hosted-->>API: Live session, or 401
    Hosted->>Webhook: auth.signup, auth.login, auth.new_device ...
```

इसमें चार भाग शामिल हैं:

| भाग | क्या संभालता है |
| - | - |
| आपका ऐप | साइन-इन शुरू करना, PKCE verifier और `state` को सुरक्षित रखना, token रखना, और एक्सेस टोकन को आपके बैकएंड तक भेजना। यह सब SDK करते हैं। |
| आपका साइन-इन ओरिजिन | `https://<slug>.auth.didit.me` (या आपका [कस्टम डोमेन](https://docs.didit.me/hi/authentication/branding-and-custom-domain.md#कस्टम-डोमेन)): होस्टेड पेज, टोकन endpoint, सत्र, डिस्कवरी और हस्ताक्षर कुंजियाँ। |
| आपका बैकएंड | हर सुरक्षित अनुरोध पर एक्सेस टोकन सत्यापित करना, संवेदनशील कार्रवाइयों से पहले सत्र जाँचना, और तय करना कि व्यक्ति क्या कर सकता है। |
| Didit कंसोल और webhook | कॉन्फ़िगरेशन, लोग और उनके सत्र, साइन-इन इवेंट, और वे `auth.*` webhook जिन्हें आपका सर्वर सब्सक्राइब करता है। |

आपके ऐप में Didit API कुंजी या कोई सीक्रेट कभी नहीं होना चाहिए: प्रकाशन योग्य कुंजी सार्वजनिक होती है, और कोड एक्सचेंज क्लाइंट सीक्रेट की जगह PKCE से सुरक्षित रहता है।

## होस्टेड पेज या आपकी अपनी स्क्रीन

लोग ईमेल, पासवर्ड या कोड कहाँ टाइप करें, यह चुनें।
सेटिंग `sign_in_ui` है (डिफ़ॉल्ट `hosted` है, या `own`), और आप इसे बाद में भी बदल सकते हैं।

| | होस्टेड पेज (अनुशंसित) | आपकी अपनी स्क्रीन |
| - | - | - |
| आप क्या बनाते हैं | एक साइन-इन बटन और एक कॉलबैक पेज। | हर स्क्रीन और हर मध्यवर्ती चरण। |
| तरीके | सभी, जिनमें मैजिक लिंक, कंपनी SSO और पासकी शामिल हैं। | पासवर्ड, ईमेल कोड, फ़ोन कोड, MFA और प्रोटेक्शन चैलेंज, SDKs के हेडलेस मेथड्स के ज़रिए। मैजिक लिंक केवल होस्टेड पेज पर चलते हैं। |
| अगले चरण | आपके लिए संभाले जाते हैं: MFA, MFA नामांकन, प्रोटेक्शन चैलेंज और साइन-अप पर सत्यापन। | आपकी स्क्रीन `mfa_required`, `mfa_enrollment_required`, `protection_required` और `verification_required` को संभालती हैं। देखें [साइन-इन के तरीके](https://docs.didit.me/hi/authentication/sign-in-methods.md)। |
| ब्रांड | [ब्रांडिंग](https://docs.didit.me/hi/authentication/branding-and-custom-domain.md) से आपका लोगो, रंग और टेक्स्ट। | पूरी तरह आपका। |
| सेटअप | रीडायरेक्ट URL। | रीडायरेक्ट URL, साथ में **Allowed origins** में आपका वेब ओरिजिन। |

पासकी आपके एप्लिकेशन के साइन-इन ओरिजिन से जुड़ी होती हैं।
SDKs के पासकी मेथड्स केवल उसी ओरिजिन से सर्व किए गए पेजों पर काम करते हैं, इसलिए किसी दूसरे डोमेन पर अपनी स्क्रीन पर पासकी के लिए लोगों को होस्टेड पेज पर भेजें।

## SDK चुनें

| आपका ऐप | पैकेज | टोकन कहाँ रहते हैं |
| - | - | - |
| एकल-पेज वेब ऐप | [`@didit-protocol/auth`](https://docs.didit.me/hi/authentication/quickstarts/javascript) या [`@didit-protocol/auth-react`](https://docs.didit.me/hi/authentication/quickstarts/react) | ब्राउज़र में वेब स्टोरेज या मेमोरी। कड़ी Content Security Policy रखें। |
| सर्वर-रेंडर्ड वेब ऐप | [`@didit-protocol/auth-nextjs`](https://docs.didit.me/hi/authentication/quickstarts/nextjs) | आपके सर्वर द्वारा सेट की गई HttpOnly कुकीज़। पेज कभी टोकन नहीं देखता। |
| iOS | [`DiditAuth`](https://docs.didit.me/hi/authentication/quickstarts/ios) | Keychain। |
| Android | [`me.didit:didit-auth`](https://docs.didit.me/hi/authentication/quickstarts/android) | Android Keystore द्वारा सुरक्षित स्टोरेज। |
| React Native या Flutter | [`@didit-protocol/auth-react-native`](https://docs.didit.me/hi/authentication/quickstarts/react-native) या [`didit_auth`](https://docs.didit.me/hi/authentication/quickstarts/flutter) | नेटिव मॉड्यूल के माध्यम से, प्लेटफ़ॉर्म का सुरक्षित स्टोरेज। |
| कोई भी बैकएंड | [सर्वर SDKs](https://docs.didit.me/hi/integration/server-sdks/overview.md), `@didit-protocol/auth/server` से `verifyToken`, या कोई भी JWT लाइब्रेरी | कुछ भी संग्रहीत करने की ज़रूरत नहीं: यह प्राप्त टोकन को सत्यापित करता है। |

SDK के बिना, PKCE के साथ authorization code flow खुद लागू करें: [JavaScript क्विकस्टार्ट](https://docs.didit.me/hi/authentication/quickstarts/javascript.md#sdk-के-बिना) पूरा कॉन्ट्रैक्ट दिखाता है।

## अपने बैकएंड की सुरक्षा करें

फ़्रंटएंड सत्र जाँच केवल यह नियंत्रित करती है कि आप क्या दिखाते हैं।
आपका बैकएंड हर निर्णय एक सत्यापित token से लेता है।

1. **हर अनुरोध पर access token सत्यापित करें।** ES256 हस्ताक्षर को अपने issuer के JWKS से जाँचें, फिर `iss`, `aud`, `exp` और `typ: at+jwt` जाँचें, और ऐसे token को अस्वीकार करें जिसका `act` `null` न हो, जब तक रूट [AI एजेंट](https://docs.didit.me/hi/authentication/agent-access.md) स्वीकार न करता हो। देखें [अपने सर्वर पर token सत्यापित करना](https://docs.didit.me/hi/authentication/tokens-and-jwks.md#अपने-सर्वर-पर-टोकन-सत्यापित-करें)।
2. **संवेदनशील कार्रवाई से पहले लाइव सत्र जाँचें।** Access token अपनी समाप्ति तक मान्य रहता है, और यह समाप्ति 5 मिनट के भीतर होती है। `GET /session/` तुरंत विफल हो जाता है, जब सत्र रद्द किया गया हो, निष्क्रिय हो गया हो या समाप्त हो गया हो, जब व्यक्ति ब्लॉक किया गया हो, या जब सत्र अब आपकी MFA नीति को पूरा नहीं करता। देखें [सत्र जाँचना](https://docs.didit.me/hi/authentication/tokens-and-jwks.md#सत्र-जाँचें)।
3. **जोखिम भरी कार्रवाई पर step-up माँगें।** भुगतान, नए बैंक खाते, या ईमेल या फ़ोन बदलने से पहले, Didit से पूछें कि क्या व्यक्ति को फिर से सत्यापन करना होगा, और केवल ऐसे `approved` step-up पर कार्य करें जिसे आपके बैकएंड ने स्वयं पढ़ा हो। देखें [संवेदनशील कार्रवाइयों से पहले step-up](https://docs.didit.me/hi/authentication/verified-identity.md#संवेदनशील-कार्रवाइयों-से-पहले-स्टेप-अप)।
4. **`vendor_data` सत्यापित token से लें**, ब्राउज़र द्वारा भेजे गए किसी फ़ील्ड से कभी नहीं, और उसका उपयोग व्यक्ति के सत्यापनों और लेन-देन के लिए करें।

## सत्र

| इवेंट | क्या होता है |
| - | - |
| साइन-इन | एक सत्र शुरू होता है। इसकी अवधि आपके `session_lifetime` के बराबर होती है (डिफ़ॉल्ट रूप से 30 दिन), और `idle_timeout` (डिफ़ॉल्ट रूप से 1 दिन) तक कोई गतिविधि न होने पर यह उससे पहले भी समाप्त हो जाता है। |
| हर कुछ मिनट में | SDK एक्सेस token को रिफ़्रेश करता है, जो अधिकतम 5 मिनट तक मान्य रहता है। रिफ़्रेश token घूमता रहता है: हर token केवल एक बार काम करता है। |
| पहले से उपयोग किया जा चुका रिफ़्रेश token दोबारा भेजा जाता है | Didit इसे चोरी मानता है और सत्र समाप्त कर देता है। प्रति सत्र एक समय में केवल एक रिफ़्रेश चलाएँ। |
| किसी दूसरे डिवाइस पर साइन-इन | `multiple_sessions: false` होने पर, व्यक्ति के बाकी सत्र समाप्त हो जाते हैं। |
| पासवर्ड रीसेट | जब `revoke_on_password_change` चालू हो (डिफ़ॉल्ट यही है), तब हर सत्र समाप्त हो जाता है। |
| साइन-आउट | `DELETE /session/` सत्र समाप्त करता है, और आपका ऐप व्यक्ति को आपके `post_logout_redirect_uri` पर भेजता है। |
| आपकी टीम कार्रवाई करती है | कंसोल एक सत्र रद्द कर सकता है, किसी व्यक्ति को हर जगह से साइन-आउट कर सकता है, या उसे ब्लॉक कर सकता है। [कंसोल गाइड](https://docs.didit.me/hi/authentication/console.md#साइन-इन-और-सत्र) देखें। |

लंबाई बदलने के लिए **Authentication > Security and sessions** में जाएँ, या API से [एप्लिकेशन सेटिंग्स](https://docs.didit.me/hi/authentication/overview.md#एप्लिकेशन-सेटिंग्स) में बदलें।

![Didit Business Console में Active sessions व्यू, जिसमें साइन-इन किए गए सत्र दिख रहे हैं: डिवाइस, स्थान, शुरुआत, अंतिम गतिविधि, समाप्ति और Revoke बटन।](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-active-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=098f6be31804b0af7c680e569f341bfb)

Authentication > Sign-ins > Active sessions, हर सत्र पर Revoke के साथ।

## नेटिव ऐप्स

Didit किसी व्यक्ति को नेटिव ऐप पर केवल HTTPS रीडायरेक्ट के ज़रिए वापस भेजता है। यह कोई भी कस्टम URL स्कीम स्वीकार नहीं करता।

* **iOS:** रीडायरेक्ट को एक एसोसिएटेड डोमेन बनाएँ, और अपनी `apple-app-site-association` में `webcredentials` जोड़ें।
* **Android:** रीडायरेक्ट को App Link बनाएँ, और अपनी `assetlinks.json` जोड़ें।
* हर रीडायरेक्ट URL को **Authentication > Security and sessions** के अंतर्गत पंजीकृत करें, जैसे वेब कॉलबैक के लिए करते हैं।

अपने ऐप में passkeys के लिए, जो ऐप आपके एप्लिकेशन की passkeys साझा करते हैं, उन्हें [प्रमाणीकरण प्रबंधन API](https://docs.didit.me/hi/authentication/set-up-by-api.md) पर `PUT native-apps/` से पंजीकृत करें।
Didit फिर उन्हें आपके साइन-इन ओरिजिन पर दी गई `apple-app-site-association` और `assetlinks.json` में सूचीबद्ध करता है।
`MANAGEMENT_BASE` आपके एप्लिकेशन का प्रबंधन API पता है, और `authentication` स्कोप वाली API कुंजी, जिसमें **write** अनुमति हो, यह कॉल कर सकती है।
यह कॉल दोनों सूचियों को बदल देती है, इसलिए दोनों भेजें:

```bash theme={null}
curl --fail-with-body --request PUT "${MANAGEMENT_BASE}native-apps/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ios_app_ids": ["ABCDE12345.com.example.app"],
    "android_apps": [
      {
        "package_name": "com.example.app",
        "sha256_cert_fingerprints": ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
      }
    ]
  }'
```

| फ़ील्ड | नियम |
| - | - |
| `ios_app_ids` | Team ID और बंडल आइडेंटिफ़ायर की अधिकतम 10 प्रविष्टियाँ, उदाहरण के लिए `ABCDE12345.com.example.app`। |
| `android_apps` | अधिकतम 10 ऐप, जिनमें से हर एक के साथ उसका `package_name` और 1 से 5 SHA-256 साइनिंग-सर्टिफ़िकेट फ़िंगरप्रिंट हों। |

[iOS](https://docs.didit.me/hi/authentication/quickstarts/ios.md) और [Android](https://docs.didit.me/hi/authentication/quickstarts/android.md) के क्विकस्टार्ट्स में ऐप वाला हिस्सा दिखाया गया है।

## पहचान सत्यापन और लेन-देन निगरानी को जोड़ें

हर व्यक्ति का एक `vendor_data` मान होता है, जो उसके token और उसके सत्र दोनों में होता है।
जब आप [सत्यापन सत्र बनाते](https://docs.didit.me/hi/sessions-api/create-session.md) हैं या [लेन-देन सबमिट करते](https://docs.didit.me/hi/transaction-monitoring/transactions.md) हैं, तो इसे `vendor_data` के रूप में उपयोग करें। इससे कंसोल एक ही व्यक्ति के साइन-इन, सत्यापन और लेन-देन को एक साथ दिखाता है।

* साइन-अप के समय, या भुगतान से पहले फिर से लोगों की जाँच करने के लिए, बिना सत्यापन फ़्लो बनाए [सत्यापित पहचान](https://docs.didit.me/hi/authentication/verified-identity.md) का उपयोग करें।
* साइन-इन इवेंट अपने-आप [इवेंट नियमों](https://docs.didit.me/hi/transaction-monitoring/event-rules.md) और धोखाधड़ी वाले व्यूज़ तक पहुँचते हैं। उन्हीं साइन-इन के लिए अपने `auth.login` इवेंट पोस्ट न करें।
* सफल साइन-इन कभी भी सत्यापन या लेन-देन को स्वीकृत नहीं करता: हर प्रोडक्ट का निर्णय अलग से संभालें।

[सभी उत्पादों में एक ही व्यक्ति को बनाए रखना](https://docs.didit.me/hi/authentication/overview.md#उत्पादों-में-एक-ही-व्यक्ति-को-बनाए-रखें) देखें।

## साइन-इन इवेंट प्राप्त करें

आपको जिन `auth.*` प्रकारों की ज़रूरत है, जैसे `auth.new_device` या `auth.account_locked`, उनके लिए एक [webhook गंतव्य](https://docs.didit.me/hi/integration/webhooks.md) सब्सक्राइब करें।
`auth_event.event_id` के आधार पर डुप्लिकेट इवेंट हटाएँ, और हर Didit webhook की तरह उसके हस्ताक्षर को सत्यापित करें।
हर प्रकार और उसके payload के लिए [इवेंट और webhooks](https://docs.didit.me/hi/authentication/events-and-webhooks.md) देखें।

## मौजूदा उपयोगकर्ताओं को माइग्रेट करें

यदि आपके उपयोगकर्ताओं के पास पहले से किसी अन्य पहचान प्लेटफ़ॉर्म पर या आपके अपने डेटाबेस में खाते हैं, तो साइन-इन बदलने से पहले [उन्हें इंपोर्ट करें](https://docs.didit.me/hi/authentication/migration.md)।
जहाँ स्रोत उनके पासवर्ड हैश देता है, वहाँ उन्हें इंपोर्ट करें, उनके सोशल लिंक बनाए रखें, और अपनी उपयोगकर्ता आईडी को `external_id` के रूप में रखें, जो उनका `vendor_data` बन जाएगा।
आपका ऐप Didit पर स्विच करने तक उनके लिए कुछ नहीं बदलेगा।

## गो-लाइव चेकलिस्ट

1. आपके लाइव एप्लिकेशन के लिए **Products** पेज पर प्रमाणीकरण चालू है।
2. आपके प्रोडक्शन `https://` रीडायरेक्ट URL और अनुमत ऑरिजिन लाइव एप्लिकेशन पर पंजीकृत हैं। लाइव एप्लिकेशन कोई `http://` पता स्वीकार नहीं करता।
3. हर सोशल साइन-इन विधि आपके अपने ऐप के क्लाइंट ID और सीक्रेट का उपयोग करती है: Didit के परीक्षण क्रेडेंशियल केवल Sandbox में काम करते हैं।
4. आपके प्रोडक्शन कॉन्फ़िगरेशन में लाइव पब्लिशेबल की (`pk_live_`) और आपका लाइव issuer शामिल हैं।
5. आपकी MFA नीति, सत्र की अवधि, निष्क्रियता टाइमआउट, पासवर्ड की लंबाई और साइन-अप नीति वैसी ही हैं जैसी आप चाहते हैं। देखें [एप्लिकेशन सेटिंग्स](https://docs.didit.me/hi/authentication/overview.md#एप्लिकेशन-सेटिंग्स)।
6. [बॉट सुरक्षा](https://docs.didit.me/hi/authentication/bot-protection.md) चालू है, जिसमें लीक हुए पासवर्ड की जाँच भी शामिल है।
7. आपका बैकएंड हर access token सत्यापित करता है, और संवेदनशील कार्रवाइयों से पहले `GET /session/` को कॉल करता है।
8. आपकी ब्रांडिंग, पेज टेक्स्ट और नियम व शर्तों तथा गोपनीयता नीति के लिंक सेट हैं। यदि आप [कस्टम डोमेन](https://docs.didit.me/hi/authentication/branding-and-custom-domain.md#कस्टम-डोमेन) जोड़ने की योजना बना रहे हैं, तो लोगों के passkeys जोड़ना शुरू करने से पहले उसे सक्रिय करें।
9. आपका webhook गंतव्य उन `auth.*` प्रकारों की सदस्यता लिए हुए है जिन्हें आप संभालते हैं।
10. आपने लाइव एप्लिकेशन पर साइन-अप, वापस आने वाले उपयोगकर्ताओं का साइन-इन, रद्दीकरण, पासवर्ड भूलना, MFA, सत्र समाप्ति, साइन-आउट और निरस्त सत्र का परीक्षण कर लिया है।

## समस्या निवारण

| लक्षण | कारण और समाधान |
| - | - |
| हर रनटाइम रूट `404` का जवाब देता है | एप्लिकेशन के लिए प्रमाणीकरण बंद है, या पता सैंडबॉक्स और लाइव ओरिजिन को मिला रहा है। इसे **Products** पेज से चालू करें, और वही ओरिजिन इस्तेमाल करें जो आपकी पब्लिशेबल कुंजी में दिया गया है। |
| साइन-इन पेज `400` का जवाब देता है और पता रजिस्टर करने को कहता है, या `POST /authorize/` `invalid_redirect_uri` का जवाब देता है | `redirect_uri` ठीक-ठीक रजिस्टर नहीं है: स्कीम, होस्ट, पोर्ट, पथ और क्वेरी अक्षर-दर-अक्षर मेल खाने चाहिए। देखें [redirect URLs](https://docs.didit.me/hi/authentication/overview.md#रीडायरेक्ट-url)। |
| आपके साइन-इन ओरिजिन पर ब्राउज़र कॉल `403` और `origin_not_allowed` का जवाब देती है | आपका वेब ओरिजिन **Allowed origins** में नहीं है। इसे बिना पथ और अंतिम स्लैश के जोड़ें। |
| `POST /token/` `invalid_grant` का जवाब देता है | कोड पहले ही इस्तेमाल हो चुका है, 60 सेकंड से पुराना है, या किसी दूसरे PKCE verifier या `redirect_uri` के साथ भेजा गया था। रिफ़्रेश के मामले में, refresh token पहले ही इस्तेमाल हो चुका था, जिससे सत्र समाप्त हो जाता है। साइन इन फिर से शुरू करें। |
| सही पासवर्ड के साथ पासवर्ड साइन-इन `invalid_credentials` का जवाब देता है | ईमेल सत्यापित नहीं है, या खाता लॉक या अवरुद्ध है। Didit जानबूझकर यही जवाब देता है। **Users** में व्यक्ति की जाँच करें। |
| `GET /session/` `401` का जवाब देता है | सत्र रद्द हो गया, निष्क्रिय हो गया या समय-सीमा समाप्त हो गई, व्यक्ति अवरुद्ध हो गया, रिफ़्रेश करने पर token बदल गया, या सत्र अब आपकी MFA नीति को पूरा नहीं करता। Token रिफ़्रेश करें, या व्यक्ति को फिर से साइन इन कराएँ। |
| पासकी या ऑथेंटिकेटर जोड़ने पर `403 reauthentication_required` आता है | इसके लिए पिछले 5 मिनट में बना सत्र चाहिए। पहले व्यक्ति को फिर से साइन इन कराएँ। |
| फ़ोन कोड `503 delivery_unavailable` का जवाब देता है | कोड डिलीवर नहीं हो सका। व्यक्ति को पुनः प्रयास करने दें, या कोई दूसरा तरीका दें। |
| कॉल `429` का जवाब देती है | आपने रेट लिमिट छू ली है। `Retry-After` में दिए समय के बाद पुनः प्रयास करें। देखें [rate limits](https://docs.didit.me/hi/authentication/bot-protection.md#रेट-लिमिट)। |
| API कुंजी के साथ सेटअप कॉल `409 product_disabled` का जवाब देती है | एप्लिकेशन के लिए प्रमाणीकरण बंद है। कोई व्यक्ति कंसोल में इसे चालू करता है। |
| कॉल `403 plan_required` का जवाब देती है | यह सुविधा, जैसे कस्टम भूमिकाएँ या कंपनी SSO सेटअप लिंक, Scale या Enterprise प्लान माँगती है। सैंडबॉक्स एप्लिकेशन में यह किसी भी प्लान पर चालू रहती है। |
| कस्टम डोमेन सक्रिय करने के बाद token विफल होते हैं | इश्यूअर और पब्लिशेबल कुंजी बदल गए हैं। नई कुंजी अपने ऐप में कॉपी करें, और बैकएंड में जिस इश्यूअर की जाँच होती है उसे अपडेट करें। |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.