إعداد تسجيل الدخول الموحّد (SSO)
دع فريقك يسجّل الدخول إلى Polzy عبر Okta أو Microsoft Entra ID أو Google Workspace أو أي مزوّد SAML أو OpenID Connect: إعداد خطوة بخطوة، واختبار قبل التشغيل، وإلزام إن أردت.
في هذه الصفحة
- 1كيف يعمل
- 2قبل أن تبدأ
- 3دع فريق تقنية المعلومات يتولّى الأمر
- 4بدء الإعداد
- 5التحقق من نطاقك
- 6إضافة سجل TXT لدى مزوّد DNS
- 7ربط مزوّد الهوية
- 8Okta
- 9Microsoft Entra ID
- 10Google Workspace
- 11OneLogin
- 12JumpCloud
- 13Ping Identity
- 14مزوّد SAML 2.0 آخر
- 15OpenID Connect
- 16اختيار من يدخل
- 17اختبار تسجيل الدخول
- 18تفعيله
- 19إلزام SSO
- 20الإدارة أو الإيقاف أو الحذف
- 21الشهادات
- 22حلّ المشكلات
- 23روابط مفيدة
مع تسجيل الدخول الموحّد، يسجّل أفراد مؤسستك الدخول إلى Polzy عبر مزوّد الهوية الخاص بكم بدلًا من كلمة المرور. تُعدّه مرة واحدة للمؤسسة كلها، بما فيها كل مساحات العمل، عبر SAML 2.0 أو OpenID Connect (OIDC). يأخذك هذا الدليل من الصفر إلى تسجيل دخول مُختبَر ويعمل: في Polzy، وعند مزوّد DNS، وفي مزوّد الهوية، مع قسم خاص بكل مزوّد.
تسجيل الدخول الموحّد متاح في خطة Enterprise. وحده مالك المؤسسة يستطيع إعداده أو تغييره. ويرى المسؤولون حالته في إعدادات المؤسسة ← الأمان.
كيف يعمل
- نطاقاتكم. ينطبق تسجيل الدخول الموحّد على عناوين البريد في النطاقات التي تتحقّق منها وفي نطاقاتها الفرعية. تربط المؤسسة مزوّد هوية واحدًا وتتحقّق من كل النطاقات التي يستخدمها أفرادها.
- تسجيل الدخول. من يكتب عنوانًا من نطاقكم في صفحة تسجيل الدخول إلى Polzy يرى المتابعة باستخدام واسم زر تسجيل الدخول الخاص بكم، مثل Okta، بدلًا من Google وMicrosoft.
- الأشخاص الجدد. تختار ما يحدث عند أول تسجيل دخول لشخص من نطاقكم: يجعله Polzy عضوًا فورًا، أو لا يُدخل إلا من سبقت دعوتهم أو مزامنتهم.
- إلزام SSO. إن أردت، لا يستطيع أفراد نطاقاتكم بعد ذلك تسجيل الدخول إلا عبر مزوّد الهوية.
لا يتوفّر تسجيل الخروج الموحّد في SAML (single logout)، ولا أكثر من مزوّد هوية واحد لكل مؤسسة.
قبل أن تبدأ
تحتاج إلى:
- مؤسسة على خطة Enterprise، وأن تكون مالكها.
- صلاحية الوصول إلى DNS نطاقكم لإضافة سجل TXT واحد. راجع إضافة سجل TXT لدى مزوّد DNS.
- حساب مسؤول لدى مزوّد الهوية لإضافة Polzy كتطبيق.
أبقِ تبويبين مفتوحين، واحدًا على Polzy وآخر على مزوّد الهوية: ستنسخ القيم في الاتجاهين.
دع فريق تقنية المعلومات يتولّى الأمر
إذا كان شخص آخر يدير مزوّد الهوية، فأرسل إليه رابط إعداد بدلًا من مشاركة بيانات دخولك.
- افتح إعدادات المؤسسة ← الأمان. في قسم تسجيل الدخول الموحّد ابحث عن روابط الإعداد لفريق تقنية المعلومات واختر إرسال رابط.
- ضمن إرسال رابط إعداد أدخل بريده الإلكتروني واللغة التي تُكتب بها الرسالة والصفحة، ثم اختر إرسال الرابط.
يفتح الرابط خطوات الإعداد (المزوّد والنطاق والربط والأشخاص وتسجيل الدخول التجريبي) ورمز SCIM، ولا شيء غير ذلك في Polzy. لا يحتاج إلى حساب في Polzy ولا يشغل مقعدًا، وكل ما يُنجز عبره يُسجَّل في سجل التدقيق. أما تفعيل تسجيل الدخول الموحّد وإلزامه فيبقيان بيدك.
- يعمل الرابط 7 أيام، أو حتى تختار إلغاء، أو حتى تفعّل تسجيل الدخول الموحّد. يمكن أن تعمل 5 روابط في الوقت نفسه كحدّ أقصى، ويمكن إرسال 20 رابطًا في اليوم كحدّ أقصى.
- بعد أن يُفعَّل تسجيل الدخول الموحّد مرة، يعرض الرابط الجديد الإعداد ويستطيع إنشاء رمز SCIM؛ ويبقى تغيير النطاقات والربط لك وحدك.
- يستطيع الرابط إنشاء رمز SCIM لكنه لا يستطيع استبداله. وإلغاء الرابط يوقف أيضًا رمز SCIM الذي أُنشئ عبره.
بدء الإعداد
- افتح قائمة الحساب أسفل الشريط الجانبي، واختر إعدادات المؤسسة ثم الأمان.
- في قسم تسجيل الدخول الموحّد اختر إعداد تسجيل الدخول الموحّد. يفتح الإعداد في ست خطوات: المزوّد والنطاق والربط والأشخاص والاختبار والتفعيل. يُحفظ ما تدخله كلما تقدّمت: أغلق الإعداد متى شئت، وسيعيدك متابعة الإعداد إلى أول خطوة فيها ما يُنجز.
- اختر مزوّد الهوية: Okta أو Microsoft Entra ID أو Google Workspace أو OneLogin أو JumpCloud أو Ping Identity أو مزوّد SAML 2.0 آخر أو مزوّد OpenID Connect آخر. يحدّد اختيارك البروتوكول وأسماء الحقول في الخطوات التالية. تبدأ Okta وMicrosoft Entra ID وGoogle Workspace بـ SAML؛ اختر استخدم OpenID Connect بدلًا من ذلك لربطها عبر OIDC.
- في الاسم على زر تسجيل الدخول أبقِ اسم المزوّد أو اكتب اسمًا آخر، كاسم مؤسستك. يرى أفراد نطاقاتكم المتابعة باستخدام وهذا الاسم.
يفتح دليل خطوة بخطوة لـ مزوّدك، بجانب كل خطوة، قسم ذلك المزوّد في هذه الصفحة.
التحقق من نطاقك
لا يثق Polzy بمزوّد الهوية إلا في العناوين التابعة لنطاق أثبتّ أنه ملكك.
- في خطوة النطاق اكتب نطاق عناوين فريقك، مثل
acme.com، واختر إضافة النطاق. - يعرض Polzy السجل المطلوب: النوع
TXT، والاسم@(أو النطاق كاملًا إن طلبه مزوّد DNS)، وقيمة تبدأ بـpolzy-domain-verification=. انسخ القيمة. - أضف السجل لدى مزوّد DNS في جذر النطاق، لا في نطاق فرعي. راجع إضافة سجل TXT لدى مزوّد DNS.
- عُد إلى Polzy واختر تحقّق الآن. ينتقل النطاق من بانتظار DNS إلى تم التحقق. قد يستغرق ظهور السجل الجديد من بضع دقائق إلى ساعة؛ تحقّق لاحقًا إن لم يُعثر عليه بعد.
يمكنك متابعة الخطوات التالية أثناء تحديث DNS: وحده التفعيل ينتظر نطاقًا مُتحقَّقًا منه. أضف كل نطاق يستخدمه فريقك، مثل acme.com وacme.eu؛ لكل منهما سجله. ويغطي النطاق المُتحقَّق منه نطاقاته الفرعية أيضًا، مثل eu.acme.com.
لا يمكن التحقق من نطاق بريد عام مثل gmail.com أو outlook.com، والنطاق ملك لمؤسسة واحدة فقط مع النطاقات الأعلى والأدنى منه. أبقِ السجل في مكانه: يتحقّق Polzy منه يوميًا، وينبّه المسؤولين في أول يوم يغيب فيه، وبعد 3 أيام متتالية من غيابه يضع على النطاق السجل مفقود ويوقف تسجيل الدخول الموحّد لعناوينه.
إضافة سجل TXT لدى مزوّد DNS
مزوّد DNS هو المكان الذي تُدار فيه سجلات نطاقك: غالبًا الشركة التي اشتريت منها النطاق، وأحيانًا خدمة مستقلة. يطلب كل مزوّد الأشياء الثلاثة نفسها: النوع (TXT)، والاسم أو المضيف (@ لجذر النطاق)، والقيمة التي عرضها Polzy. اترك مدة الصلاحية (TTL) على قيمتها الافتراضية.
| مزوّد DNS | أين تضيفه | الدليل الرسمي |
|---|---|---|
| Cloudflare | DNS ← Records ← Add record، النوع TXT، الاسم @ | Cloudflare: Manage DNS records |
| GoDaddy | Domain Portfolio ← نطاقك ← DNS ← Add New Record، النوع TXT، الاسم @ | GoDaddy: Add a TXT record |
| Amazon Route 53 | Hosted zones ← نطاقك ← Create record، النوع TXT، واترك اسم السجل فارغًا | AWS: Creating records by using the Amazon Route 53 console |
| Google Cloud DNS | Cloud DNS ← منطقتك ← Add standard، النوع TXT، واترك اسم DNS فارغًا (لا يقرأ Cloud DNS الرمز @ على أنه الجذر) | Google Cloud: Add, update, and delete records |
| Microsoft 365 | Settings ← Domains ← نطاقك ← DNS records ← Add records، النوع TXT، الاسم @ | Microsoft: Add or edit DNS records |
| Azure DNS | منطقة DNS الخاصة بك ← Recordsets ← Add، النوع TXT، الاسم @ | Microsoft: Manage DNS record sets and records with Azure DNS |
| Namecheap | Domain List ← Manage ← Advanced DNS ← Add new record، TXT Record، المضيف @ | Namecheap: How do I add TXT records |
| Squarespace Domains | DNS ← DNS Settings ← Custom Records ← Add record، النوع TXT، الاسم @ | Squarespace: Adding TXT records |
| IONOS | نطاقك ← DNS ← Add Record ← TXT، اسم المضيف @ | IONOS: Managing TXT records |
| OVHcloud | Web Cloud ← Domain names ← نطاقك ← DNS zone ← Add an entry، النوع TXT | OVHcloud: Editing an OVHcloud DNS zone |
| TransIP | Domain ← نطاقك ← DNS settings، النوع TXT، الاسم @ | TransIP: Setting a TXT record |
لست متأكدًا من الجهة المستضيفة؟ خوادم الأسماء لنطاقك تخبرك: أسماء مثل ns1.cloudflare.com أو ns-123.awsdns-45.com تشير إلى Cloudflare وRoute 53. ويمكن لفريق تقنية المعلومات أو الشركة التي اشتُري منها النطاق إخبارك أيضًا.
ربط مزوّد الهوية
يحتاج الربط إلى الجانبين: مزوّد الهوية يحتاج إلى عناوين Polzy، وPolzy يحتاج إلى عناوين مزوّد الهوية.
جانب Polzy في SAML. تحت الصق هذه القيم في مزوّد الهوية، يعرض Polzy قيمتين للنسخ، كل منهما باسم الحقل الذي يستخدمه مزوّدك، والسمات التي يجب أن يرسلها.
| يعرض Polzy | ما هو |
|---|---|
| ACS URL | المكان الذي يعيد إليه مزوّد الهوية الأشخاص بعد تسجيل الدخول: رابط Assertion Consumer Service أو reply URL. تسمّيه Okta Single sign-on URL. |
| Entity ID | اسم Polzy لهذا الربط: الجمهور أو المعرّف. تسمّيه Okta Audience URI (SP Entity ID). |
| تنزيل بيانات التعريف الخاصة بنا | القيمتان في ملف واحد، لمزوّد هوية يستطيع قراءته. عنوان الرابط هو رابط بيانات التعريف الخاص بـ Polzy. |
جانب مزوّد الهوية. تحت بيانات من مزوّد الهوية، أعطِ Polzy إعداداته بإحدى ثلاث طرق:
- رابط بيانات التعريف: الصق عنوان بيانات التعريف واختر استيراد. بعد تفعيل تسجيل الدخول الموحّد يعيد Polzy قراءته كل يوم، فتصل إليه شهادة التوقيع الجديدة تلقائيًا.
- رفع ملف: ملف بيانات التعريف بصيغة XML الذي يقدّمه المزوّد، حتى 1 ميغابايت.
- إدخال يدوي: معرّف كيان مزوّد الهوية (يُسمّى أحيانًا المُصدِر)، ورابط تسجيل الدخول، وشهادة التوقيع بما فيها سطرا BEGIN وEND.
السمات التي يقرأها Polzy (SAML). تُقارن الأسماء دون اعتبار لحالة الأحرف.
| جزء من العضو | يقرأ Polzy | ويتعرّف أيضًا على |
|---|---|---|
| البريد الإلكتروني | سمة email، أو NameID عندما تكون صيغته عنوان بريد | mail، emailAddress، http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress |
| الاسم الأول | firstName | givenName، first_name، given_name، http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname |
| اسم العائلة | lastName | sn، surname، last_name، family_name، http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname |
| المجموعات (اختياري) | groups | memberOf، role، roles، http://schemas.microsoft.com/ws/2008/06/identity/claims/groups |
إذا كان مزوّد الهوية يستخدم أسماء أخرى، فغيّرها في خطوة الأشخاص تحت متقدّم: أسماء السمات. يجب توقيع الإقرار (assertion) بـ SHA-256 أو أقوى: يُرفض الرد الموقّع بـ SHA-1.
في OpenID Connect انسخ رابط إعادة التوجيه من Polzy إلى مزوّد الهوية، ثم أدخل في Polzy رابط المُصدِر ومعرّف العميل وسرّ العميل. يُخزَّن سرّ العميل مشفّرًا؛ اترك الحقل فارغًا لاحقًا للاحتفاظ به. يطلب Polzy النطاقات openid وemail وprofile، ويقرأ email وgiven_name وfamily_name، وgroups إن كنت تستخدم قواعد المجموعات.
توضّح الأقسام التالية أين توضع كل قيمة في كل مزوّد هوية، مع رابط إلى الدليل الرسمي لذلك المزوّد. تُذكر قوائم المزوّدين بالإنجليزية كما تظهر.
Okta
- في Okta Admin Console انتقل إلى Applications ← Applications واختر Create App Integration. إن سألتك Okta عن المعالج، فاختر Classic experience. حدّد SAML 2.0 واختر Next.
- سمِّ التطبيق Polzy واختر Next.
- الصق Single sign-on URL من Polzy في Single sign-on URL وأبقِ Use this for Recipient URL and Destination URL محدّدًا. والصق Audience URI (SP Entity ID) في Audience URI (SP Entity ID).
- اضبط Name ID format على EmailAddress وApplication username format على Email.
- تحت Attribute Statements أضف
emailبالقيمةuser.email، وfirstNameبالقيمةuser.firstName، وlastNameبالقيمةuser.lastName. لتوزيع الأشخاص حسب المجموعة، أضف Group Attribute Statement باسمgroupsمع مرشّح مثل Starts withpolzy. - اختر Next، وحدّد I'm an Okta customer adding an internal app، ثم اختر Finish.
- في تبويب Sign On للتطبيق انسخ Metadata URL، والصقه في Polzy تحت رابط بيانات التعريف واختر استيراد.
- في تبويب Assignments اختر Assign وعيّن الأشخاص أو المجموعات الذين يستخدمون Polzy.
في OpenID Connect أنشئ التكامل باختيار OIDC - OpenID Connect وWeb Application، والصق عنوان Polzy في Sign-in redirect URIs، وأعطِ Polzy قيمة Client ID وClient secret وعنوان Okta الخاص بك، مثل https://acme.okta.com، بوصفه المُصدِر.
أدلة Okta: Create SAML app integrations وCreate OpenID Connect app integrations وAssign an app integration to a group.
Microsoft Entra ID
- في مركز إدارة Microsoft Entra انتقل إلى Entra ID ← Enterprise apps ← All applications، واختر New application ثم Create your own application.
- سمِّه Polzy، واختر Integrate any other application you don't find in the gallery (Non-gallery) ثم Create.
- افتح Single sign-on واختر SAML.
- تحت Basic SAML Configuration اختر Edit. الصق Identifier (Entity ID) من Polzy في Identifier (Entity ID)، وReply URL (Assertion Consumer Service URL) في Reply URL (Assertion Consumer Service URL)، ثم احفظ.
- تحت Attributes & Claims ترسل المطالبات الافتراضية الأسماء أصلًا، وترسل اسم المستخدم الأساسي (UPN) بوصفه Name ID، ويستخدمه Polzy عنوانًا للبريد. إذا لم تكن أسماء UPN لدى فريقك هي عناوين بريدهم، فاختر Add new claim وسمِّها
emailواختر سمة المصدرuser.mail: يقرأ Polzy أولًا المطالبة المسمّاةemail. لتوزيع الأشخاص حسب المجموعة، اختر Add a group claim وGroups assigned to the application. - تحت SAML Certificates انسخ App Federation Metadata Url، والصقه في Polzy تحت رابط بيانات التعريف واختر استيراد.
- تحت Users and groups اختر Add user/group وعيّن الأشخاص أو المجموعات الذين يستخدمون Polzy.
يرسل Entra كل مجموعة بمعرّف الكائن ما لم تختر صيغة أخرى، لذا تذكر قاعدة المجموعة في Polzy اسم المجموعة كما يرسله Entra تمامًا. ويريك تسجيل الدخول التجريبي ما هو.
في OpenID Connect سجّل تطبيقًا تحت App registrations بنوع حساب يقتصر على المستأجر الخاص بك، وأضف عنوان Polzy بوصفه رابط إعادة توجيه من نوع Web، وأنشئ سرّ عميل تحت Certificates & secrets. المُصدِر هو https://login.microsoftonline.com/<tenant ID>/v2.0 مع معرّف المستأجر الخاص بك.
أدلة Microsoft: Enable SAML single sign-on for an enterprise application وCustomize SAML token claims وConfigure group claims وManage users and groups assignment to an application وRegister an application وAdd a redirect URI وAdd credentials.
Google Workspace
- في وحدة تحكّم المشرف في Google انتقل إلى Apps ← Web and mobile apps واختر Add App ← Add custom SAML app.
- سمِّ التطبيق Polzy وتابع.
- في Google Identity Provider details اختر Download IDP metadata واحتفظ بالملف من أجل Polzy.
- في Service Provider Details الصق ACS URL من Polzy في ACS URL وEntity ID في Entity ID. اضبط Name ID format على EMAIL وName ID على Basic Information > Primary email.
- تحت Attribute mapping اربط First name بـ
firstNameوLast name بـlastName. لتوزيع الأشخاص حسب المجموعة، أضف المجموعات تحت Group membership مع سمة التطبيقgroups؛ ترسل Google حتى 75 مجموعة. - اختر Finish، ثم ارفع ملف بيانات التعريف إلى Polzy تحت رفع ملف.
- افتح User access للتطبيق وفعّله للجميع، أو للوحدات التنظيمية أو المجموعات التي تستخدم Polzy. قد تستغرق Google حتى 24 ساعة لتطبيق ذلك.
في OpenID Connect أنشئ في Google Cloud Console عميل OAuth من النوع Web application، وأضف عنوان Polzy تحت Authorized redirect URIs، وأعطِ Polzy معرّف العميل وسرّه مع المُصدِر https://accounts.google.com. ولا يستطيع الدخول بهذه الطريقة إلا حسابات Google Workspace الخاصة بك في أحد نطاقاتك المُتحقَّق منها.
أدلة Google: Set up your own custom SAML app وManage OAuth clients وOpenID Connect.
OneLogin
- في OneLogin انتقل إلى Applications ← Applications واختر Add App. ابحث عن SAML Custom Connector (Advanced) وسمِّه Polzy واحفظ.
- في تبويب Configuration الصق Entity ID من Polzy في Audience (EntityID)، وACS URL في Recipient وACS (Consumer) URL. وفي ACS (Consumer) URL Validator أدخل ACS URL مسبوقًا بـ
^ومتبوعًا بـ$. - اضبط SAML nameID format على Email وSAML signature element على Assertion، ثم احفظ.
- في تبويب Parameters أضف
emailوfirstNameوlastNameبالقيم Email وFirst Name وLast Name، مع تضمين كل منها في إقرار SAML. لتوزيع الأشخاص حسب المجموعة، أضفgroupsبالقيمة User Roles بوصفها معاملًا متعدد القيم. - في تبويب SSO انسخ Issuer URL، والصقه في Polzy تحت رابط بيانات التعريف واختر استيراد.
- امنح من يستخدمون Polzy الوصول إلى التطبيق، عبر أدوارهم أو تحت Users.
دليل OneLogin: Advanced SAML Custom Connector.
JumpCloud
- في JumpCloud Admin Portal انتقل إلى Access ← SSO Applications، واختر Add New Application ثم Custom Application، واختر Manage Single Sign-On (SSO) مع Configure SSO with SAML. سمِّه Polzy.
- أدخل IdP Entity ID فريدًا، كنطاقك. الصق Entity ID من Polzy في SP Entity ID وACS URL تحت ACS URLs.
- اضبط SAMLSubject NameID على
emailوSAMLSubject NameID Format علىurn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress، ووقّع الإقرار. - تحت User Attributes أضف
emailوfirstNameوlastNameمرتبطة ببريد المستخدم واسمه الأول واسم عائلته. لتوزيع الأشخاص حسب المجموعة، حدّد Include Group Attribute؛ يقرأ Polzy الاسم الافتراضي في JumpCloud،memberOf، كما يقرأgroups. - فعّل التطبيق، واختر Export Metadata وارفع الملف إلى Polzy تحت رفع ملف. أو اختر Copy Metadata URL واستورده.
- في تبويب User Groups أضف المجموعات التي تستخدم Polzy.
أدلة JumpCloud: SSO using custom SAML application connectors وSSO application connector fields.
Ping Identity
- في PingOne انتقل إلى Applications ← Applications وأضف تطبيقًا. سمِّه Polzy واختر SAML Application ثم Configure.
- اختر Manually Enter: الصق ACS URL من Polzy تحت ACS URLs وEntity ID في Entity ID. أو اختر Import from URL مع رابط بيانات التعريف من Polzy. ثم احفظ.
- في تبويب Attribute Mappings اربط
saml_subjectبـ Email Address، وأضفemail(Email Address) وfirstName(Given Name) وlastName(Family Name). لتوزيع الأشخاص حسب المجموعة، أضفgroupsمرتبطًا بـ Group Names. - في تبويب Overview للتطبيق انسخ IDP Metadata URL، والصقه في Polzy تحت رابط بيانات التعريف واختر استيراد.
- فعّل التطبيق، وفي تبويب Access امنح الوصول للمجموعات التي تستخدم Polzy.
في PingFederate أنشئ اتصال SP من رابط بيانات التعريف الخاص بـ Polzy، مع عنوان البريد بوصفه الموضوع (subject)، وأعطِ Polzy بيانات التعريف لهذا الاتصال.
أدلة Ping Identity: Adding an application وEditing a SAML application وIdP metadata for SAML applications وAccessing SP connections.
مزوّد SAML 2.0 آخر
يعمل أي مزوّد هوية يدعم SAML 2.0. اختر مزوّد SAML 2.0 آخر في الخطوة الأولى، ثم في مزوّد الهوية:
- أضف تطبيق SAML باستخدام ACS URL وEntity ID من Polzy، أو دعه يقرأ رابط بيانات التعريف من Polzy.
- أرسل عنوان البريد بوصفه NameID بصيغة عنوان بريد، أو في سمة
email. - وقّع الإقرار بـ SHA-256 أو أقوى. يقبل Polzy عدة شهادات توقيع في وقت واحد، فيمكن استبدال الشهادة دون انقطاع.
- أضف السمتين
firstNameوlastName، وgroupsلتوزيع الأشخاص حسب المجموعة.
ثم أعطِ Polzy بيانات التعريف، عبر رابط أو ملف XML، أو أدخل الإعدادات يدويًا.
OpenID Connect
استخدم OpenID Connect مع أي مزوّد هوية يقدّمه. اختر مزوّد OpenID Connect آخر في الخطوة الأولى، أو استخدم OpenID Connect بدلًا من ذلك لـ Okta أو Microsoft Entra ID أو Google Workspace.
- في مزوّد الهوية أنشئ تطبيق ويب يسجّل الدخول بتدفّق authorization code وله سرّ عميل.
- أضف رابط إعادة التوجيه من Polzy بوصفه رابط إعادة التوجيه لتسجيل الدخول.
- اسمح بالنطاقات
openidوemailوprofile. ومطالبةgroupsفي رمز الهوية اختيارية لتوزيع الأشخاص حسب المجموعة. - في Polzy أدخل رابط المُصدِر: العنوان الذي يوجد تحته
/.well-known/openid-configurationالخاص بمزوّدك. ثم معرّف العميل وسرّ العميل للتطبيق.
يُرفض العنوان الذي يضع عليه مزوّد الهوية علامة "غير مُتحقَّق منه". ومع Microsoft Entra ID يجب أن يذكر المُصدِر المستأجر الخاص بك: https://login.microsoftonline.com/<tenant ID>/v2.0. وتُرفض المُصدِرات المشتركة common وorganizations وconsumers لأن أي حساب Microsoft يستطيع الدخول عبرها.
أدلة: OpenID Connect Discovery (مواصفة OpenID Foundation لعنوان المُصدِر) وMicrosoft: OpenID Connect on the Microsoft identity platform.
اختيار من يدخل
تحدّد خطوة الأشخاص ما يحدث عند أول تسجيل دخول لشخص من نطاقكم عبر مزوّد الهوية.
- إنشاء عضو تلقائيًا. اختر مساحة العمل التي ينضمّ إليها والدور فيها، مُشاهد في البداية. يشغل العضو الجديد مقعدًا، وما دام لا يوجد مقعد شاغر يُرفض تسجيل دخوله.
- فقط الأشخاص المدعوون أو المُزامَنون مسبقًا. من ليس عضوًا بعد يُرفض ويُطلب منه التواصل مع مسؤول، حتى لو كان تسجيل دخوله لدى مزوّد الهوية صحيحًا.
يحتفظ الأعضاء الحاليون بمساحات عملهم وأدوارهم. ويربط أول تسجيل دخول لهم عبر مزوّد الهوية حسابهم في Polzy به. ويبقى العضو المعطّل معطّلًا.
قواعد المجموعات (اختيارية) توزّع الأشخاص حسب المجموعة: أضف قاعدة لكل مجموعة، باسم المجموعة كما يرسله مزوّد الهوية، ومساحة عمل، ودور. عند أول تسجيل دخول لشخص، يقرأ Polzy سمة المجموعات: ينضمّ العضو الجديد إلى مساحة العمل التي تذكرها كل مجموعة من مجموعاته، بالدور الذي تمنحه القاعدة. ولا تغيّر عمليات تسجيل الدخول اللاحقة أي مساحة عمل أو دور، لذا لا تصل القاعدة دون SCIM إلى الأشخاص إلا عند انضمامهم أول مرة. ويجب أن يرسل مزوّد الهوية سمة المجموعات.
تحت متقدّم: أسماء السمات غيّر الأسماء التي يقرأ منها Polzy البريد والاسم الأول واسم العائلة والمجموعات. وتحت حقول مساحة العمل تملأ سمة يرسلها مزوّد الهوية، كالقسم أو البلد، حقلًا في مساحة العمل: تُكتب عند الانضمام وتُحدَّث مع كل تسجيل دخول.
إذا كنت تستخدم أيضًا توفير SCIM، فهو يوزّع الأشخاص بمساحة العمل والدور وقواعد المجموعات نفسها: ليس لـ SCIM قواعد خاصة به، ويفتح زر تعديل قواعد المجموعات فيه هذه الخطوة. ومع SCIM تأتي المجموعات من دليلك لا من تسجيل الدخول، وتُطبَّق القواعد كلما أضاف شخصًا إلى مجموعة أو أخرجه منها، بمن فيهم من انضموا أولًا بتسجيل الدخول.
اختبار تسجيل الدخول
- في خطوة الاختبار اختر اختبار تسجيل الدخول. يفتح مزوّد الهوية في تبويب جديد؛ وإن حظره المتصفح فاختر فتح تسجيل الدخول التجريبي.
- سجّل الدخول لدى مزوّد الهوية بحساب شخص من نطاق مُتحقَّق منه.
- عند العودة إلى Polzy تظهر النتيجة تلقائيًا؛ وإن لم تظهر فاختر التحقق من النتيجة.
يعرض Polzy بالضبط ما أرسله مزوّد الهوية: تحت ما سيستخدمه تسجيل الدخول البريد والأسماء والمجموعات، وعلى كل منها وصل أو لم يُرسَل؛ وتحت كل ما أرسله مزوّدك، كل سمة بقيمتها.
عندما يفشل الاختبار يشرح Polzy السبب بكلمات بسيطة وأين يُصلح. غيّر الإعداد لدى مزوّد الهوية واختر اختبار مرة أخرى.
لا يسجّل الاختبار دخول أحد ولا ينشئ جلسة. يُفتح كل اختبار عبر عنوان يعمل مرة واحدة لمدة 10 دقائق، وتنتظر الصفحة الرد حتى دقيقتين. ويبقى الاختبار الناجح صالحًا 7 أيام: يتطلّب تفعيل تسجيل الدخول الموحّد وإلزامه اختبارًا خلال آخر 7 أيام.
تفعيله
تعرض خطوة التفعيل ما بقي: نطاق مُتحقَّق منه، ومزوّد الهوية مربوط، وأول تسجيل دخول مضبوط، واختبار ناجح خلال آخر 7 أيام. حين يُعلَّم كل شيء، اختر تفعيل تسجيل الدخول الموحّد.
منذ تلك اللحظة يسجّل أفراد نطاقاتكم المُتحقَّق منها الدخول عبر مزوّد الهوية:
- في صفحة تسجيل الدخول يكتبون بريدهم ويختارون المتابعة باستخدام واسم زرّكم.
- رابط إلى إحدى مساحات عملكم، ومربع Polzy في مزوّد الهوية، يمرّان بهم عبر تسجيل الدخول نفسه.
- للإشارة المرجعية استخدم
app.polzy.ai/login?sso=متبوعًا بعنوان مساحة عملك، مثلapp.polzy.ai/login?sso=acme.
ما لم تُلزم تسجيل الدخول الموحّد، يمكن للجميع أيضًا الدخول كما كانوا. ويُنهي التفعيل كل روابط الإعداد لفريق تقنية المعلومات التي ما زالت تعمل.
ما دام تسجيل الدخول الموحّد مفعّلًا تبقى نطاقاتكم لكم: يُرفض التسجيل في Polzy بعنوان من تلك النطاقات، عبر النموذج أو عبر Google أو Microsoft، وتعرض الصفحة بدلًا من ذلك تسجيل الدخول الخاص بمؤسستكم.
لا يضمن مزوّد الهوية إلا الأشخاص في مساحات عمل مؤسستكم. ومن سجّل الدخول عبره ثم فتح مساحة عمل تابعة لمؤسسة أخرى في Polzy يُطلب منه أولًا رمز التحقق بخطوتين الخاص به إن كان مفعّلًا، إلا إذا اختار على ذلك الجهاز الوثوق بهذا الجهاز لمدة 30 يومًا.
إلزام SSO
عند تفعيل تسجيل الدخول الموحّد إلزامي لا يستطيع أفراد نطاقاتكم المُتحقَّق منها الدخول إلا عبر مزوّد الهوية. تُرفض لهم كلمة المرور، ورابط تسجيل الدخول المُرسل بالبريد، والدخول عبر Google أو Microsoft.
- افتح إدارة في قسم تسجيل الدخول الموحّد. صار اسم الخطوة الأخيرة إدارة تسجيل الدخول الموحّد.
- فعّل تسجيل الدخول الموحّد إلزامي. يذكر Polzy عدد الأعضاء الذين لن يدخلوا بعدها إلا عبر مزوّد الهوية.
- اختر جعله إلزاميًا. تنتهي فورًا جلسات الأعضاء الذين دخلوا بطريقة أخرى، ولا تنتهي جلستك أبدًا.
- يتطلّب نطاقًا مُتحقَّقًا منه، واختبارًا ناجحًا خلال آخر 7 أيام، وطريقًا للعودة لك: أن تكون أنت نفسك داخلًا عبر تسجيل الدخول الموحّد، أو أن يكون التحقق بخطوتين مفعّلًا لديك.
- إذا لم تعد خطتك تتضمّن تسجيل الدخول الموحّد، يتوقف الإلزام ويعود الأعضاء إلى الطرق الأخرى. لا يُحتجز أحد خارج المنصّة.
- لا ينطبق إلا على عناوين نطاقاتكم المُتحقَّق منها. أما العضو الذي يستخدم نطاقًا آخر، كمتعاقد خارجي، فيستمر في الدخول بكلمة مرور أو رابط أو عبر Google أو Microsoft.
من يمكنه تسجيل الدخول بدونه. حتى لا تُحتجز المؤسسة خارجًا أبدًا إذا تعطّل مزوّد الهوية، يستطيع المالك دائمًا الدخول بطريقة أخرى، وكذلك كل مسؤول تضيفه عبر إضافة مسؤول. ويحتاج كل منهم إلى تفعيل التحقق بخطوتين لاستخدام ذلك: تعرض القائمة من لديه. وحذف شخص من القائمة أثناء الإلزام يُنهي جلساته الأخرى فورًا.
الإدارة أو الإيقاف أو الحذف
يرى المسؤولون حالة تسجيل الدخول الموحّد في إعدادات المؤسسة ← الأمان: النطاقات المُتحقَّق منها، ومزوّد الهوية مع آخر تسجيل دخول، وهل الإلزام مفعّل، وروابط الإعداد لفريق تقنية المعلومات، وSCIM. ولا يرى إدارة إلا المالك.
تحت منطقة الخطر في إدارة تسجيل الدخول الموحّد:
- إيقاف تسجيل الدخول الموحّد (إيقاف): يعود الجميع إلى الدخول بكلمة المرور أو رابط تسجيل الدخول، ويتوقف الإلزام أيضًا. تُحفظ الإعدادات لتفعيله لاحقًا.
- حذف الربط (حذف): يزيل الربط وكل إعداداته؛ وتبقى نطاقاتكم المُتحقَّق منها. لا يمكن حذف ربط مفعّل: أوقفه أولًا. والتبديل بين SAML وOpenID Connect يتطلّب أيضًا أن يكون موقوفًا.
الشهادات
لشهادة توقيع SAML تاريخ انتهاء يظهر مع الربط في إعدادات المؤسسة ← الأمان. ينبّه Polzy مسؤولي المؤسسة، داخل التطبيق وبالبريد، قبل 30 و7 ويوم واحد من انتهاء أقرب شهادة، ثم مجددًا عندما تنتهي كل الشهادات المحفوظة. يمكن أن تكون عدة شهادات نشطة معًا: أضف الجديدة لدى مزوّد الهوية، وأعطِ Polzy بيانات التعريف المحدّثة، ولا تسحب القديمة إلا بعد ذلك.
إذا أعطيت Polzy رابط بيانات تعريف، يعيد Polzy قراءته كل يوم ما دام تسجيل الدخول الموحّد مفعّلًا، ويحفظ الشهادة الجديدة تلقائيًا. وإذا توقف العنوان عن الاستجابة، تستمر الشهادات المحفوظة في العمل؛ ويوضح تبويب الأمان منذ كم يومًا، ويُبلَّغ المسؤولون بعد ثلاثة أيام متتالية.
لا يوقف Polzy تسجيل الدخول الموحّد أبدًا بسبب شهادة، لكن بمجرد أن يوقّع مزوّد الهوية بشهادة لا يملكها Polzy، تفشل عمليات تسجيل الدخول حتى تعطيه بيانات التعريف المحدّثة.
حلّ المشكلات
ابدأ بتسجيل دخول تجريبي: يعرض ما أرسله مزوّد الهوية، وتوضح الرسالة ما يجب إصلاحه.
| ما يقوله Polzy | السبب | ما العمل |
|---|---|---|
| لم يرسل مزوّدك أي بريد إلكتروني | لم يصل أي بريد في السمة التي يقرأها Polzy، وNameID ليس عنوانًا. | اجعل NameID عنوان البريد، أو أرسل سمة email. أو غيّر الاسم تحت الأشخاص ← متقدّم: أسماء السمات. |
| تعذّر التحقق من ردّ مزوّدك | معرّف الكيان أو رابط تسجيل الدخول أو الشهادة في Polzy لا تطابق ما لدى مزوّدك، أو الرد موقّع بـ SHA-1. | أعد استيراد بيانات التعريف في خطوة الربط، ووقّع بـ SHA-256. |
| رفض مزوّدك تسجيل الدخول | لم يسمح مزوّد الهوية بدخول الشخص. | عيّن الشخص أو مجموعته لتطبيق Polzy لدى مزوّد الهوية. |
| البريد الإلكتروني ليس ضمن نطاق تحقّقت منه | العنوان من نطاق لم تتحقّق منه، أو اختفى سجله. | تحقّق من النطاق في خطوة النطاق، أو أعد سجل TXT. |
| هذا الشخص ليس عضوًا، ولا يُسمح بالدخول إلا للمدعوين أو المُزامَنين مسبقًا | اخترت فقط الأشخاص المدعوون أو المُزامَنون مسبقًا. | ادعُه، أو اختر إنشاء عضو تلقائيًا. |
| لم يتبقَّ مقعد في خطتك لعضو جديد | كل المقاعد مشغولة. | أزل شخصًا لم يعد يستخدم Polzy، أو أضف مقاعد إلى خطتك. |
| حساب هذا الشخص معطّل | عُطّل العضو، من مسؤول أو مزامنة أو دليلكم. | أعد تفعيله إن كان يجب أن يحصل على الوصول. |
| لا توجد مساحة عمل ينتقل إليها هذا الشخص | لم تُختر مساحة عمل للأعضاء الجدد. | اختر واحدة في خطوة الأشخاص. |
| أرسل مزوّدك هذا العنوان لمستخدم مختلف | العنوان يسجّل الدخول عبر مزوّد الهوية باسم مستخدم آخر هناك، غالبًا عنوان مُنح لشخص جديد. | احذف الحساب القديم في Polzy أولًا، أو امنح الشخص الجديد عنوانًا آخر. |
| يفيد مزوّدك بأن البريد الإلكتروني غير مُتحقَّق منه | يضع مزوّد OpenID Connect على العنوان علامة غير مُتحقَّق منه. | تحقّق من العنوان لدى مزوّد الهوية. |
| استغرق الاختبار وقتًا طويلًا أو لم تصل أي نتيجة | أُغلق تبويب الاختبار، أو استغرق تسجيل الدخول وقتًا أطول من المسموح. | اختر اختبار مرة أخرى وسجّل الدخول فورًا. |
| السجل مفقود على نطاق | اختفى سجل TXT من DNS. | أعد السجل نفسه؛ يُتحقَّق من النطاق مجددًا كل يوم. |
| انتهت صلاحية الشهادة | يوقّع مزوّد الهوية بشهادة لا يملكها Polzy. | أعطِ Polzy بيانات التعريف المحدّثة. |
سببان آخران لا يسمّيهما الاختبار:
- يصل العنوان الخطأ. في Okta يكون اسم مستخدم التطبيق هو اسم المستخدم في Okta، ما لم تضبط Application username format على Email. وفي Entra يكون Name ID هو اسم المستخدم الأساسي. إذا لم يكن هذا هو العنوان الذي يستخدمه الشخص في Polzy، فأرسل العنوان الصحيح في سمة
email. - قواعد المجموعات لا تعمل. يجب أن يطابق اسم المجموعة في القاعدة ما يرسله مزوّد الهوية: يرسل Entra معرّفات الكائنات ما لم تغيّر الصيغة. انسخ القيمة من كل ما أرسله مزوّدك في الاختبار.
روابط مفيدة
- Okta: Create SAML app integrations
- Microsoft: Enable SAML single sign-on for an enterprise application
- Google: Set up your own custom SAML app
- OneLogin: Advanced SAML Custom Connector
- JumpCloud: SSO using custom SAML application connectors
- Ping Identity: Adding an application
- التالي: توفير الأعضاء عبر SCIM، وأمان المؤسسة لمدة الجلسة والتحقق بخطوتين.
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.