SAML یا OIDC سان سِنگَل سائن آن (SSO) کَنفِگَر کَرُن

ScribbleMaps چُھ SAML 2.0 یا OpenID Connect (OIDC) ہیتھ اینٹرپرائز سِنگَل سائن آن سپورٹ کران۔ یہ چُھ تُہنٛدین ٹیم ممبرَن ہُنٛد تَصدیق تُہنٛدِ ادارٕک آئیڈینٹِٹی پرووائڈَر (IdP) سان کرنہٕ دِوان، یُتھ کہ Okta، Microsoft Entra ID (Azure AD)، Google Workspace، یا Auth0۔

SSO کَنفِگَریشَن چھُ team.scribblemaps.com پؠٹھ دستیاب تہٕ مُکَمَل طور مُفت۔

مَواد ہُنٛد فہرِست

1. سَپورٹ کرنہٕ آمُت فیچرز
2. شُروع کرنُک برٛونٛہہ
3. قدم 1: پنُن ای میل ڈومین تَصدیق کٔرِو
4. قدم 2: پنُن آئیڈینٹِٹی پرووائڈَر کَنفِگَر کٔرِو
5. قدم 3: ScribbleMaps مَنز SSO کَنفِگَر کٔرِو
6. قدم 4: پنُن کَنفِگَریشَن ٹیسٹ کٔرِو
7. قدم 5: SSO اِنیبَل کٔرِو
8. SP-Initiated SSO
9. OIN Universal Logout
10. پرووائڈَر مُطابِق گائیڈز
11. ایڈوانسڈ اِختِیارات
12. مَسلہٕ حَل کَرُن

سَپورٹ کرنہٕ آمُت فیچرز

ScribbleMaps SSO اِنٹیگریشَن چھُ ہیٚتٕہ دِنہٕ آمتِن فیچرَن کٕہ سَپورٹ کران:

شُروع کرنُک برٛونٛہہ

• SSO کَنفِگَر کرنہٕ خاطرٕ گژھہِ تُہہِ ٹیم اونر آسُن
• تُہنٛدِ آئیڈینٹِٹی پرووائڈَرَس ہُنٛد ایڈمن کنسول رَسائی گژھہِ آسُن
• پنُن ای میل ڈومین تیار رٔکھِو (مثلاً yourcompany.com)

قدم 1: پنُن ای میل ڈومین تَصدیق کٔرِو

SSO کَنفِگَر کرنُک برٛونٛہہ گژھہِ تُہہِ پنُن ای میل ڈومین مِلکِیَتھ تَصدیق کرُن۔ یہ سکیورٹی اِقدام چھُ یَقینی بناوان زِ صِرف مُجاز ادارہٕ ہیکن پنٕنِن ڈومینَن خاطرٕ SSO کَنفِگَر کٔرِتھ۔

1. team.scribblemaps.com پؠٹھ لاگ اِن کٔرِو
2. سیٹنگس > Single Sign-On پؠٹھ گژھِو
3. Domains ٹیب مَنز گژھِو
4. Add Domain پؠٹھ کِلِک کٔرِو تہٕ پنُن ای میل ڈومین دِیِو (مثلاً yourcompany.com)
5. اَکھ تَصدیقی طَریقہٕ چُنِو:

اِختِیار A: DNS TXT ریکارڈ (تَجوِیز کرنہٕ آمُت)

پنٕنِس ڈومینَس ہُنٛدِس DNS سیٹنگس مَنز اَکھ TXT ریکارڈ شٲمِل کٔرِو:

نوٹ: DNS تَبدیلیٖن ہیکن 48 گھَنٹن تام پھَیلنہٕ خاطرٕ وَکھ نِیتھ۔

اِختِیار B: فایٔل اَپلوڈ

1. scribblemaps-verify.txt ناوُک اَکھ ٹیکسٹ فایٔل بَنٲوِو
2. پنُن تَصدیقی کوڈ چھُ صِرف مَواد طور شٲمِل کرُن
3. یَتھ پَتَس اَپلوڈ کٔرِو: https://yourcompany.com/.well-known/scribblemaps-verify.txt

تَصدیق شٲمِل کرنہٕ پَتہٕ، مِلکِیَتھ تَصدیق کرنہٕ خاطرٕ Verify Domain پؠٹھ کِلِک کٔرِو۔

قدم 2: پنُن آئیڈینٹِٹی پرووائڈَر کَنفِگَر کٔرِو

ScribbleMaps چھُ پنٕنِس آئیڈینٹِٹی پرووائڈَرس مَنز اَیپلی کیشَن طور شٲمِل کرُن۔ اگر تُہہِ Okta استعمال کران چھوٕ، تیٚلہِ ہیکو تُہہِ ScribbleMaps براہِ راست Okta Integration Network (OIN) کیٹلاگ پؠٹھ شٲمِل کٔرِتھ — SAML SSO URL، SP Entity ID، ACS URL، تہٕ OIDC Redirect URI چھِ خودکار طور پہلے سے کَنفِگَر۔

SAML 2.0 خاطرٕ

OIDC خاطرٕ

قدم 3: ScribbleMaps مَنز SSO کَنفِگَر کٔرِو

SAML 2.0 کَنفِگَر کَرُن

1. ScribbleMaps مَنز سیٹنگس > Single Sign-On > SAML ٹیب پؠٹھ گژھِو
2. پنٕنِس آئیڈینٹِٹی پرووائڈَر پؠٹھ ہیٚتھ ہیٚتھ ہیٚتٕہ دِنہٕ آمُت مَعلوٗمات دِیِو:

3. سَیٹِنٛگز کٔرِو مَحفوظ پؠٹھ کِلِک کٔرِو

OIDC کَنفِگَر کَرُن

1. ScribbleMaps مَنز سیٹنگس > Single Sign-On > OIDC ٹیب پؠٹھ گژھِو
2. پنُن Provider Type چُنِو (Google، Microsoft، Okta، Auth0، یا حَسبِ ضَرورَت)
3. ہیٚتٕہ دِنہٕ آمُت مَعلوٗمات دِیِو:

4. سَیٹِنٛگز کٔرِو مَحفوظ پؠٹھ کِلِک کٔرِو

قدم 4: پنُن کَنفِگَریشَن ٹیسٹ کٔرِو

سارنی صٲرِفَن خاطرٕ SSO اِنیبَل کرنُک برٛونٛہہ، پنُن کَنفِگَریشَن ٹیسٹ کٔرِو:

1. Test Connection بَٹَن پؠٹھ کِلِک کٔرِو
2. SSO لاگ اِن فلو سِمیُلیٹ کرنہٕ خاطرٕ کُھلہِ اَکھ نۆو ونڈو
3. پنٕنِس آئیڈینٹِٹی پرووائڈَر سان تَصدیق مُکَمَل کٔرِو
4. تَصدیق کٔرِو زِ تُہہِ چھِو کامیابی سان واپس ScribbleMaps طرف ریڈائرِکٹ گَمٕتۍ

اگر ٹیسٹ ناکام گژھہِ، تیٚلہِ ایرَر میسِج وُچھِو تہٕ پنٕنۍ کَنفِگَریشَن سیٹنگس چیک کٔرِو۔

قدم 5: SSO اِنیبَل کٔرِو

اکہِ لَٹہِ ٹیسٹنگ کامیاب گژھہِ:

1. Enable SSO سوئچ ON کٔرِو
2. پنُن اِنفورسمنٹ اِختِیار چُنِو:
   • Optional: صٲرف ہیکن SSO یا پاسوَرڈ لاگ اِن چُنِتھ
   • Enforced: تَصدیق شُدہ ای میل ڈومینَن والین صٲرِفَن گژھہِ SSO استعمال کرُن (پاسوَرڈ لاگ اِن چھُ بَند)

نوٹ: ٹیم اونر ہیکن SSO اِنفورس گَمٕتہِ تہِ بیک اَپ طور پاسوَرڈ لاگ اِن استعمال کٔرِتھ۔

SP-Initiated SSO

ScribbleMaps چھُ SP-initiated SSO سَپورٹ کران، یُس صٲرفَن ScribbleMaps لاگ اِن پیج پؠٹھ پؠٹھ سائن اِن پروسیس شُروع کرنہٕ دِوان چھُ۔ یہ چھُ یُتھ کار کران:

1. scribblemaps.com/account/login پؠٹھ گژھِو
2. پنُن ای میل پتہٕ دِیِو (مثلاً [email protected])
3. Sign in with SSO پؠٹھ کِلِک کٔرِو
4. تُہہِ چھِو تَصدیق خاطرٕ پنٕنِس ادارٕکس آئیڈینٹِٹی پرووائڈَرس (مثلاً Okta) طرف ریڈائرِکٹ کرنہٕ یِوان
5. کامیاب تَصدیق پَتہٕ چھِو تُہہِ خودکار طور واپس ScribbleMaps طرف ریڈائرِکٹ کرنہٕ یِوان تہٕ سائن اِن گَمُت

اگر تُہنٛدِس ادارٕکس SSO اِنفورس گَمُت چھُ، تیٚلہِ لاگ اِن پیج پؠٹھ ای میل دِنہٕ پَتہٕ چھوٗ تُہہِ خودکار طور تُہنٛدِس آئیڈینٹِٹی پرووائڈَرس طرف ریڈائرِکٹ کرنہٕ یِوان — کانٛہہ تہِ پاسوَرڈ field چھُنہٕ ظٲہِر گژھان۔

OIN Universal Logout

Okta ہُنٛد Universal logout چھُ سَپورٹ کرنہٕ آمُت۔ کَنفِگَریشَن ہِدایات خاطرٕ مہربانی کٔرِتھ یہ لِنک وُچھِو۔

پرووائڈَر مُطابِق گائیڈز

Okta

1. Okta Admin Console مَنز Applications > Browse App Catalog پؠٹھ گژھِو
2. ScribbleMaps تَلاش کٔرِو تہٕ Add Integration پؠٹھ کِلِک کٔرِو
3. SSO URL، Entity ID، تہٕ Redirect URI چھِ خودکار طور پہلے سے کَنفِگَر
4. پنٕنِس IdP کَنفِگَریشَن تَفصیلات خاطرٕ Sign On ٹیب پؠٹھ گژھِو:
   • X.509 Certificate ڈاؤن لوڈ کٔرِو
   • Identity Provider Issuer (Entity ID) کاپی کٔرِو
   • Single Sign-On URL کاپی کٔرِو
5. یم قَدٕر ScribbleMaps SSO سیٹنگس مَنز دِیِو (وُچھِو قدم 3)

Microsoft Entra ID (Azure AD)

1. Azure Portal مَنز Microsoft Entra ID > App registrations > New registration پؠٹھ گژھِو
2. کَنفِگَر کٔرِو:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web پلیٹ فارم)
3. Certificates & secrets پؠٹھ گژھِو > نۆو Client secret بَنٲوِو
4. Application (client) ID تہٕ Client secret value کاپی کٔرِو
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. Google Cloud Console مَنز APIs & Services > Credentials پؠٹھ گژھِو
2. Create Credentials > OAuth client ID پؠٹھ کِلِک کٔرِو
3. Web application چُنِو
4. Authorized redirect URI شٲمِل کٔرِو: https://api.scribblemaps.com/oidc/callback
5. Client ID تہٕ Client Secret کاپی کٔرِو
6. Authority URL: https://accounts.google.com

نوٹ: Google Workspace خاطرٕ MFA لازِم کرنہٕ خاطرٕ، پنٕنِس Google Workspace Admin Console مَنز اتھ کَنفِگَر کٔرِو۔

Auth0

1. Auth0 Dashboard مَنز Applications > Create Application پؠٹھ گژھِو
2. Regular Web Applications چُنِو
3. کَنفِگَر کٔرِو:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Settings ٹیب پؠٹھ Client ID تہٕ Client Secret کاپی کٔرِو
5. Authority URL: https://YOUR-DOMAIN.auth0.com

ایڈوانسڈ اِختِیارات

Just-In-Time (JIT) Provisioning

ییٚلہِ یہ اِنیبَل گژھہِ، صٲرف چھِ پنٕنِس پیٚٹھمِس SSO لاگ اِن پؠٹھ ScribbleMaps مَنز خودکار طور بَنان۔ تٔمۍ ہُنٛد پروفایل مَعلوٗمات (ناو، ای میل) چھُ آئیڈینٹِٹی پرووائڈَر پؠٹھ بَرنہٕ یِوان۔

Multi-Factor Authentication لازِم کٔرِو (صِرف OIDC)

لاگ اِن اجازَت دِنُک برٛونٛہہ MFA تَصدیق لازِم کرنہٕ خاطرٕ یہ اِختِیار اِنیبَل کٔرِو۔ ScribbleMaps چھُ تَصدیق کران زِ تُہنٛدِ IdP صٲرِفَس خاطرٕ MFA اِنفورس گَمُت چھُ۔

Okta خاطرٕ ہیکو تُہہِ حَسبِ ضَرورَت ACR قَدٕر تَعیٖن کٔرِتھ، یُتھ کہ:

• urn:okta:loa:2fa:any - کانٛہہ تہِ دویُم فیکٹر
• phr - فِشنگ مُزاحِم تَصدیق
• phrh - فِشنگ مُزاحِم ہارڈویئر-بَند تَصدیق

Attribute/Claim Mapping

حَسبِ ضَرورَت بَنٲوِو زِ تُہنٛدِ IdP پؠٹھ صٲرِف صِفَتھ کِتھ پٲٹھۍ ScribbleMaps صٲرِف fields سان میپ گژھن:

مَسلہٕ حَل کَرُن

عام مَسلہٕ

"Domain not verified"

• یَقینی بَنٲوِو زِ تُہنٛد DNS TXT ریکارڈ یا تَصدیقی فایٔل صَحیح طور کَنفِگَر گَمُت چھُ
• DNS تَبدیلیٖن ہیکن 48 گھَنٹن تام پھَیلنہٕ خاطرٕ وَکھ نِیتھ
• تَصدیقی کوڈ مَنز کانٛہہ تہِ ٹائپو چھُنہٕ، یہ تَصدیق کٔرِو

"Invalid certificate"

• یَقینی بَنٲوِو زِ تُہہِ چھِو مُکَمَل سَرٹیفِکیٹ استعمال کران، یتھ -----BEGIN CERTIFICATE----- تہٕ -----END CERTIFICATE----- شٲمِل چھِ
• چیک کٔرِو زِ سَرٹیفِکیٹ چھُنہٕ ختم گومُت
• یَقینی بَنٲوِو زِ تُہہِ سائننگ سَرٹیفِکیٹ کاپی کور، نہ زِ انکرِپشَن سَرٹیفِکیٹ

"Invalid signature"

• تَصدیق کٔرِو زِ سَرٹیفِکیٹ چھُ تُہنٛدِ IdP ہُنٛد مَوجوٗدٕ سائننگ سَرٹیفِکیٹ سان میل کھاوان
• چیک کٔرِو زِ signature algorithm چھُ میل کھاوان (SHA-256 بنام SHA-1)

"User not found" یا "Email mismatch"

• یَقینی بَنٲوِو زِ تُہنٛدِ IdP ہُنٛد واپس دِنہٕ آمُت ای میل چھُ اَکس تَصدیق شُدہ ڈومین سان میل کھاوان
• چیک کٔرِو زِ NameID فارمَیٹ چھُ ای میل پتہٕ سیٹ گَمُت
• تَصدیق کٔرِو زِ attribute/claim میپنگ چھِ صَحیح

"Security error: Your Identity Provider is not authorized for this email domain"

• یہ چھُ تیٚلہِ پیش یوان یِلہِ IdP کَنفِگَریشَن تَصدیق شُدہ ڈومین سان میل چھُنہٕ کھاوان
• یَقینی بَنٲوِو زِ ای میل ڈومین چھُ تُہنٛدِ ٹیمہ تَحَت تَصدیق شُدہ
• چیک کٔرِو زِ تُہہِ چھِو اَکس تَصدیق شُدہ ڈومینَس ہُنٛد ای میل استعمال کٔرِتھ لاگ اِن کران

آڈٹ لاگز وُچھُن

سیٹنگس > Single Sign-On > Audit Logs مَنز SSO سَرگَرمی مانیٹَر کٔرِو۔ تُہہِ ہیکو:

• ایوینٹ قِسٕم مُطابِق فِلٹَر کٔرِو (Login، Logout، ناکام Login)
• تاریخ حَد مُطابِق فِلٹَر کٔرِو
• تَعمیل رِپورٹنگ خاطرٕ لاگز CSV طور برآمد کٔرِو

مَدَتھ چھِ ضَروٗرِ؟

اگر تُہہِ SSO کَنفِگَریشَن مَنز مَسلہٕ تجربہ کران چھوٕ، تیٚلہِ مہربانی کٔرِتھ ہمیٚشِ سَپورٹ ٹیمَس سان رابطہ کٔرِو تہٕ یم دِیِو:

• تُہنٛد ٹیم ناو
• یُس آئیڈینٹِٹی پرووائڈَر تُہہِ استعمال کران چھوٕ
• کانٛہہ تہِ ایرَر میسِج یُس تُہہِ وُچھان چھوٕ
• تُہنٛدِ IdP کَنفِگَریشَن ہٕنٛد سکرین شاٹس (حَساس ڈیٹا ہٹنہٕ سان)

اسہِ چھِ تُہنٛدِس ادارٕکس خاطرٕ SSO کَنفِگَر کرنَس مَنز تُہنٛدِ مَدَتھ خاطرٕ حاضر۔