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 یونیورسل لاگ آؤٹ
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 منتخب کریں (گوگل، 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 نافذ ہے تو لاگ ان صفحے پر اپنا ای میل درج کرنے سے آپ خود بخود اپنے آئیڈینٹٹی پرووائیڈر پر بھیج دیے جائیں گے — پاس ورڈ کا فیلڈ نہیں دکھایا جائے گا۔

OIN یونیورسل لاگ آؤٹ

Okta کا یونیورسل لاگ آؤٹ معاون ہے۔ ترتیب کی ہدایات کے لیے براہِ کرم اس لنک پر جائیں۔

پرووائیڈر کے مخصوص گائیڈز

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) پروویژننگ

فعال ہونے پر، پہلی SSO لاگ ان پر صارفین ScribbleMaps میں خود بخود بن جاتے ہیں۔ ان کی پروفائل معلومات (نام، ای میل) آئیڈینٹٹی پرووائیڈر سے حاصل کی جاتی ہیں۔

ملٹی فیکٹر تصدیق لازمی کریں (صرف OIDC)

لاگ ان کی اجازت دینے سے پہلے MFA کی تصدیق لازمی کرنے کے لیے یہ اختیار فعال کریں۔ ScribbleMaps تصدیق کرے گا کہ آپ کے IdP نے صارف کے لیے MFA نافذ کیا ہے۔

Okta کے لیے آپ حسب ضرورت ACR قدریں متعین کر سکتے ہیں، جیسے:

• urn:okta:loa:2fa:any - کوئی بھی دوسرا فیکٹر
• phr - فشنگ سے محفوظ تصدیق
• phrh - فشنگ سے محفوظ ہارڈویئر سے منسلک تصدیق

خصوصیت/کلیم میپنگ

اپنی مرضی کے مطابق ترتیب دیں کہ آپ کے IdP کی صارف خصوصیات ScribbleMaps کے صارف فیلڈز سے کیسے میپ ہوں:

مسائل کا حل

عام مسائل

"Domain not verified"

• یقینی بنائیں کہ آپ کا DNS TXT ریکارڈ یا تصدیقی فائل درست طریقے سے ترتیب دی گئی ہے
• DNS تبدیلیوں کو پھیلنے میں 48 گھنٹے تک لگ سکتے ہیں
• تصدیقی کوڈ میں کسی غلطی کی جانچ کریں

"Invalid certificate"

• یقینی بنائیں کہ آپ مکمل سرٹیفکیٹ استعمال کر رہے ہیں جس میں -----BEGIN CERTIFICATE----- اور -----END CERTIFICATE----- شامل ہوں
• جانچیں کہ سرٹیفکیٹ کی میعاد ختم نہیں ہوئی
• یقینی بنائیں کہ آپ نے سائننگ سرٹیفکیٹ کاپی کیا ہے، انکرپشن سرٹیفکیٹ نہیں

"Invalid signature"

• تصدیق کریں کہ سرٹیفکیٹ آپ کے IdP کے موجودہ سائننگ سرٹیفکیٹ سے میل کھاتا ہے
• جانچیں کہ سگنیچر الگورتھم میل کھاتا ہے (SHA-256 بمقابلہ SHA-1)

"User not found" یا "Email mismatch"

• یقینی بنائیں کہ آپ کے IdP کی طرف سے واپس کیا گیا ای میل کسی تصدیق شدہ ڈومین سے میل کھاتا ہے
• جانچیں کہ NameID فارمیٹ Email Address پر سیٹ ہے
• تصدیق کریں کہ خصوصیت/کلیم میپنگ درست ہے

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

• یہ اس وقت ہوتا ہے جب IdP کی ترتیب تصدیق شدہ ڈومین سے میل نہیں کھاتی
• یقینی بنائیں کہ ای میل ڈومین آپ کی ٹیم کے تحت تصدیق شدہ ہے
• جانچیں کہ آپ کسی تصدیق شدہ ڈومین کے ای میل سے لاگ ان کر رہے ہیں

آڈٹ لاگز دیکھنا

ترتیبات > Single Sign-On > Audit Logs میں SSO سرگرمی کی نگرانی کریں۔ آپ یہ کر سکتے ہیں:

• ایونٹ کی قسم کے لحاظ سے فلٹر کریں (لاگ ان، لاگ آؤٹ، ناکام لاگ ان)
• تاریخ کی حد کے لحاظ سے فلٹر کریں
• تعمیلی رپورٹنگ کے لیے لاگز کو CSV کے طور پر ایکسپورٹ کریں

مدد چاہیے؟

اگر آپ کو SSO کی ترتیب میں مسائل کا سامنا ہے تو براہِ کرم ہماری سپورٹ ٹیم سے رابطہ کریں اور یہ معلومات فراہم کریں:

• آپ کی ٹیم کا نام
• آپ جو آئیڈینٹٹی پرووائیڈر استعمال کر رہے ہیں
• کوئی بھی غلطی کے پیغامات جو آپ دیکھ رہے ہیں
• آپ کے IdP کی ترتیب کے اسکرین شاٹس (حساس ڈیٹا ہٹا کر)

ہم آپ کی تنظیم کے لیے SSO ترتیب دینے میں آپ کی مدد کے لیے حاضر ہیں۔