SAML বা OIDC দিয়ে সিঙ্গল সাইন-অন (SSO) কনফিগার করা

ScribbleMaps SAML 2.0 বা OpenID Connect (OIDC) ব্যবহার করে এন্টারপ্রাইজ সিঙ্গল সাইন-অন সমর্থন করে। এর ফলে আপনার টিম সদস্যরা Okta, Microsoft Entra ID (Azure AD), Google Workspace বা Auth0-এর মতো আপনার প্রতিষ্ঠানের আইডেন্টিটি প্রোভাইডার (IdP) ব্যবহার করে প্রমাণীকরণ করতে পারেন।

SSO কনফিগারেশন team.scribblemaps.com-এ পাওয়া যায় এবং এটি সম্পূর্ণ বিনামূল্যে।

সূচিপত্র

1. সমর্থিত বৈশিষ্ট্যসমূহ
2. শুরু করার আগে
3. ধাপ ১: আপনার ইমেইল ডোমেইন যাচাই করুন
4. ধাপ ২: আপনার আইডেন্টিটি প্রোভাইডার কনফিগার করুন
5. ধাপ ৩: ScribbleMaps-এ SSO কনফিগার করুন
6. ধাপ ৪: আপনার কনফিগারেশন পরীক্ষা করুন
7. ধাপ ৫: SSO চালু করুন
8. SP-ইনিশিয়েটেড SSO
9. OIN ইউনিভার্সাল লগআউট
10. প্রোভাইডার-নির্দিষ্ট গাইডসমূহ
11. উন্নত বিকল্পসমূহ
12. সমস্যা সমাধান

সমর্থিত বৈশিষ্ট্যসমূহ

ScribbleMaps SSO ইন্টিগ্রেশন নিম্নলিখিত বৈশিষ্ট্যসমূহ সমর্থন করে:

শুরু করার আগে

• SSO কনফিগার করতে আপনাকে অবশ্যই টিম মালিক হতে হবে
• আপনার প্রতিষ্ঠানের আইডেন্টিটি প্রোভাইডার অ্যাডমিন কনসোলে আপনার অ্যাক্সেস থাকতে হবে
• আপনার ইমেইল ডোমেইন প্রস্তুত রাখুন (যেমন, yourcompany.com)

ধাপ ১: আপনার ইমেইল ডোমেইন যাচাই করুন

SSO কনফিগার করার আগে আপনাকে অবশ্যই আপনার ইমেইল ডোমেইনের মালিকানা যাচাই করতে হবে। এই নিরাপত্তা ব্যবস্থা নিশ্চিত করে যে শুধুমাত্র অনুমোদিত প্রতিষ্ঠানগুলোই তাদের ডোমেইনের জন্য SSO কনফিগার করতে পারে।

1. team.scribblemaps.com-এ লগ ইন করুন
2. সেটিংস > Single Sign-On-এ যান
3. Domains ট্যাবে যান
4. Add Domain-এ ক্লিক করুন এবং আপনার ইমেইল ডোমেইন লিখুন (যেমন, yourcompany.com)
5. একটি যাচাইকরণ পদ্ধতি বেছে নিন:

বিকল্প ক: DNS TXT রেকর্ড (প্রস্তাবিত)

আপনার ডোমেইনের DNS সেটিংসে একটি TXT রেকর্ড যোগ করুন:

নোট: DNS পরিবর্তন কার্যকর হতে ৪৮ ঘণ্টা পর্যন্ত সময় লাগতে পারে।

বিকল্প খ: ফাইল আপলোড

1. scribblemaps-verify.txt নামে একটি টেক্সট ফাইল তৈরি করুন
2. আপনার যাচাইকরণ কোডটি একমাত্র বিষয়বস্তু হিসেবে যোগ করুন
3. এখানে আপলোড করুন: https://yourcompany.com/.well-known/scribblemaps-verify.txt

যাচাইকরণ যোগ করার পর মালিকানা নিশ্চিত করতে Verify Domain-এ ক্লিক করুন।

ধাপ ২: আপনার আইডেন্টিটি প্রোভাইডার কনফিগার করুন

আপনার আইডেন্টিটি প্রোভাইডারে ScribbleMaps-কে একটি অ্যাপ্লিকেশন হিসেবে যোগ করুন। আপনি যদি Okta ব্যবহার করেন, তাহলে Okta Integration Network (OIN) ক্যাটালগ থেকে সরাসরি ScribbleMaps যোগ করতে পারেন — SAML SSO URL, SP Entity ID, ACS URL এবং OIDC Redirect URI স্বয়ংক্রিয়ভাবে আগে থেকে কনফিগার করা থাকে।

SAML 2.0-এর জন্য

OIDC-এর জন্য

ধাপ ৩: 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. সেটিংস সংরক্ষণ করুন-এ ক্লিক করুন

ধাপ ৪: আপনার কনফিগারেশন পরীক্ষা করুন

সব ব্যবহারকারীর জন্য SSO চালু করার আগে আপনার কনফিগারেশন পরীক্ষা করুন:

1. Test Connection বোতামে ক্লিক করুন
2. SSO লগইন প্রক্রিয়া অনুকরণ করতে একটি নতুন উইন্ডো খুলবে
3. আপনার আইডেন্টিটি প্রোভাইডারের সাথে প্রমাণীকরণ সম্পন্ন করুন
4. আপনি সফলভাবে ScribbleMaps-এ ফিরে এসেছেন কিনা যাচাই করুন

পরীক্ষা ব্যর্থ হলে ত্রুটির বার্তাটি পর্যালোচনা করুন এবং আপনার কনফিগারেশন সেটিংস যাচাই করুন।

ধাপ ৫: SSO চালু করুন

পরীক্ষা সফল হলে:

1. Enable SSO সুইচটি ON করুন
2. আপনার কার্যকর করার বিকল্প বেছে নিন:
   • Optional: ব্যবহারকারীরা SSO বা পাসওয়ার্ড লগইনের মধ্যে বেছে নিতে পারবেন
   • Enforced: যাচাইকৃত ইমেইল ডোমেইনের ব্যবহারকারীদের অবশ্যই SSO ব্যবহার করতে হবে (পাসওয়ার্ড লগইন নিষ্ক্রিয়)

নোট: SSO বাধ্যতামূলক থাকলেও টিম মালিকরা ব্যাকআপ হিসেবে সবসময় পাসওয়ার্ড লগইন ব্যবহার করতে পারেন।

SP-ইনিশিয়েটেড SSO

ScribbleMaps SP-ইনিশিয়েটেড 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 সেটিংসে লিখুন (ধাপ ৩ দেখুন)

Microsoft Entra ID (Azure AD)

1. Azure Portal-এ Microsoft Entra ID > App registrations > New registration-এ যান
2. কনফিগার করুন:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (ওয়েব প্ল্যাটফর্ম)
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

উন্নত বিকল্পসমূহ

জাস্ট-ইন-টাইম (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 পরিবর্তন কার্যকর হতে ৪৮ ঘণ্টা পর্যন্ত সময় লাগতে পারে
• যাচাইকরণ কোডে কোনো টাইপো নেই তা যাচাই করুন

"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 কার্যকলাপ পর্যবেক্ষণ করুন। আপনি করতে পারেন:

• ইভেন্টের ধরন অনুযায়ী ফিল্টার করুন (Login, Logout, Failed Login)
• তারিখের পরিসর অনুযায়ী ফিল্টার করুন
• কমপ্লায়েন্স রিপোর্টিংয়ের জন্য লগ CSV হিসেবে এক্সপোর্ট করুন

সহায়তা দরকার?

SSO কনফিগারেশনে সমস্যা হলে অনুগ্রহ করে আমাদের সাপোর্ট টিমের সাথে নিম্নলিখিত তথ্যসহ যোগাযোগ করুন:

• আপনার টিমের নাম
• আপনি যে আইডেন্টিটি প্রোভাইডার ব্যবহার করছেন
• আপনি যেসব ত্রুটির বার্তা দেখছেন
• আপনার IdP কনফিগারেশনের স্ক্রিনশট (সংবেদনশীল তথ্য মুছে ফেলে)

আপনার প্রতিষ্ঠানের জন্য SSO কনফিগার করতে আমরা আপনাকে সাহায্য করতে এখানে আছি।