PingOne के साथ SSO सेटअप करें¶

PingOne OIDC-अनुरूप है। इसके दो मानों पर ध्यान चाहिए: environment ID, जो हर एंडपॉइंट URL में दिखाई देता है, और regional domain, जो North American, European, Canadian, Asia-Pacific और Australian टेनेंट्स में अलग होता है।

यह मार्गदर्शिका केवल PingOne पक्ष को कवर करती है: एप्लिकेशन बनाना और वे मान इकट्ठा करना जो digna को चाहिए। digna पक्ष — dashboard_config.toml, परीक्षण और समस्या निवारण — हर प्रदाता के लिए समान है और Single Sign-On Overview में वर्णित है।

शुरू करने से पहले¶

चरण 1: एप्लिकेशन बनाएं¶

1. PingOne एडमिन कंसोल में साइन इन करें और अपना environment चुनें
2. Applications → Applications पर जाएँ
3. + बटन पर क्लिक करें
4. Application Name में digna दर्ज करें
5. OIDC Web App चुनें
6. Save पर क्लिक करें

चरण 2: Redirect URI कॉन्फ़िगर करें¶

1. एप्लिकेशन की Configuration टैब खोलें
2. एडिट करने के लिए पेंसिल आइकन पर क्लिक करें
3. पुष्टि करें कि Response Type Code है और Grant Type Authorization Code है
4. Redirect URIs के तहत अपने digna callback URL दर्ज करें:

https://digna.yourdomain.com/oidc/callback

1. Token Endpoint Authentication Method को Client Secret Post या Client Secret Basic पर सेट करें
2. Save पर क्लिक करें

चरण 3: एप्लिकेशन सक्षम करें¶

एप्लिकेशन की पंक्ति या डिटेल पैनल पर टॉगल को enabled पर स्विच करें।

चरण 4: Scopes दें¶

1. Resources टैब खोलें
2. सुनिश्चित करें कि openid दिया गया है, और OpenID Connect संसाधन से profile और email जोड़ें
3. Save पर क्लिक करें

चरण 5: उपयोगकर्ता असाइन करें¶

1. Access टैब खोलें
2. वह पॉपुलेशन या समूह जोड़ें जिनके सदस्य digna का उपयोग कर सकते हैं
3. Save पर क्लिक करें

चरण 6: क्रेडेंशियल्स और Environment ID इकट्ठा करें¶

Configuration टैब पर, General खोलें:

• Client ID → यह DIGNA_OIDC_CLIENT_ID बन जाता है
• Client Secret → यह DIGNA_OIDC_CLIENT_SECRET बन जाता है (आईकन पर क्लिक करके देखें)
• Environment ID → यह discovery URL में जाता है

उसी टैब पर तैयार-निर्मित OIDC Discovery Endpoint भी सूचीबद्ध होता है, जिसे आप हाथ से बनाने के बजाय सीधे कॉपी कर सकते हैं।

चरण 7: Discovery URL बनाएँ¶

environment ID और अपने क्षेत्र का डोमेन सब्स्टिट्यूट करें:

https://auth.pingone.com/<environment_id>/as/.well-known/openid-configuration

एक European environment के लिए:

https://auth.pingone.eu/12345678-1234-1234-1234-123456789012/as/.well-known/openid-configuration

चरण 8: digna कॉन्फ़िगर करें¶

dashboard/dashboard_config.toml¶

[login]
usePassword = true

[[login.oidc]]
key = "pingone"
label = "PingOne से लॉगिन"

config.toml¶

[oidc.pingone]
DIGNA_OIDC_CLIENT_ID = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
DIGNA_OIDC_CLIENT_SECRET = "<the client secret copied in Step 6>"
DIGNA_OIDC_REDIRECT_URI = "https://digna.yourdomain.com/oidc/callback"
DIGNA_OIDC_CONFIGURATION_URL = "https://auth.pingone.eu/12345678-1234-1234-1234-123456789012/as/.well-known/openid-configuration"

दोनों फ़ाइलों में key मेल खाना चाहिए — यहाँ pingone।

चरण 9: परीक्षण करें¶

बैकएंड और वेब सर्वर को रीस्टार्ट करें, फिर डैशबोर्ड खोलें। पूरा चेकलिस्ट देखने के लिए Testing Login देखें।

PingOne समस्या निवारण¶

Discovery URL पर 404¶

क्षेत्रीय डोमेन या environment ID गलत है। एप्लिकेशन की Configuration टैब पर दिखाई जाने वाली OIDC Discovery Endpoint से तुलना करें।

NOT_FOUND या Application Disabled¶

Step 3 में टॉगल अभी भी बंद है।

Redirect URI मेल नहीं खा रही¶

PingOne पूरे स्ट्रिंग से मैच करता है। Configuration → Redirect URIs में ट्रेलिंग स्लैश या स्कीम अंतर की जाँच करें।

लॉगिन सफल लेकिन कोई Email Claim digna तक नहीं पहुँचता¶

Resources टैब पर email और profile स्कोप दिए गए नहीं हैं।

उपयोगकर्ता एप्लिकेशन नहीं देख सकता¶

Access टैब पर किसी पॉपुलेशन या समूह को एक्सेस नहीं दिया गया है।

संबंधित¶

• Single Sign-On Overview — कॉन्फ़िगरेशन संदर्भ, परीक्षण और सामान्य समस्या निवारण
• PingOne: OIDC application configuration