Holarch

الإدارة

تسجيل الدخول الموحد وSCIM

اربط موفّر هوية SAML 2.0 لمؤسسة (Okta أو Microsoft Entra ID أو Microsoft AD FS أو Google Workspace أو Ping)، أو Active Directory الخاص بخادم مستضاف ذاتيًا مباشرةً، وتحقق من نطاقات بريدها الإلكتروني، واشترط تسجيل الدخول الموحد، واربط المجموعات بالأدوار، وجهّز الحسابات باستخدام SCIM 2.0.

طريقة استخدامها ←

في هذه الصفحة
  1. المفاهيم
  2. طريقة استخدامها
    1. التحقق من نطاق بريد إلكتروني
    2. توصيل موفّر الهوية
    3. تفعيل تسجيل الدخول الموحد
    4. فرض تسجيل الدخول الموحد
    5. تزويد الحسابات باستخدام SCIM
    6. حين تتغير شهادة موفّر الهوية
    7. تسجيل دخول الشركة لعدة مؤسسات (مستضاف ذاتيًا)
    8. الوصول إلى مشاريع القسم (مستضاف ذاتيًا)
  3. قواعد تسجيل الدخول
    1. تسجيل الدخول بخطوتين
  4. السمات
    1. المجموعات إلى الأدوار
  5. SCIM
    1. مجموعات SCIM والأقسام (مستضاف ذاتيًا)
  6. إعداد موفّر الهوية الخاص بك
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. دليل الشركة (Active Directory / LDAP)
    1. إعداد دليل الشركة
    2. الأقسام من مجموعات الدليل
    3. من يمكنه تسجيل الدخول
    4. الفحص الدوري
    5. تسجيل الدخول بخطوتين مع دليل الشركة
  8. الحدود وملاحظات الأمان

يمكن للمؤسسة أن تتيح لأعضائها تسجيل الدخول إلى Holarch بحساب العمل. Holarch هو مزوّد الخدمة؛ ويتحقق موفّر الهوية الخاص بمؤسستك (Okta أو Microsoft Entra ID أو Microsoft AD FS أو Google Workspace أو Ping Identity أو أي مزوّد SAML 2.0) من هويتهم. ويمكن لموفّر الهوية أيضًا إنشاء حسابات Holarch وتحديثها وإلغاء تنشيطها عبر SCIM 2.0.

يُعدّ مسؤول المؤسسة تسجيل الدخول الموحد تحت إعدادات المؤسسة ← المؤسسة ← الوصول وتسجيل الدخول ← تسجيل الدخول الموحد. ويعمل في الخدمة المستضافة وعلى الخوادم المستضافة ذاتيًا، لا في تطبيق سطح المكتب. ويحتاج الخادم المستضاف ذاتيًا إلى وصول صادر للتحقق من نطاق (استعلام DNS) ولقراءة البيانات الوصفية من عنوان URL. ويمكن للخادم المستضاف ذاتيًا أيضًا التحقق من حسابات الشركة بنفسه عبر Active Directory أو دليل LDAP آخر، دون موفّر هوية: انظر دليل الشركة (Active Directory / LDAP).

ملاحظة: تسجيل الدخول الموحد وتزويد SCIM جزء من خطة Team (الخاصة بالمؤسسة). وتحتفظ بهما المؤسسات التي استخدمتهما قبل الإصدار 2.29.0. ومن دون الخطة، تُحفظ الإعدادات، لكن الأعضاء يسجّلون الدخول بكلمة المرور (يضبط هل نسيت كلمة المرور؟ واحدة) أو Google أو Microsoft، وتُرفض طلبات SCIM.

المفاهيم

المصطلحالمعنى
النطاق الموثَّقنطاق بريد إلكتروني (مثل example.com) أثبتت المؤسسة أنها تتحكم فيه بسجل DNS من نوع TXT. ولا يعمل تسجيل الدخول الموحد وSCIM إلا للعناوين في النطاقات الموثَّقة. ويمكن أن توثّق النطاقَ مؤسسةٌ واحدة.
موفّر الهوية (IdP)الخدمة التي تسجّل دخول أعضائك: معرّف الكيان الخاص بها (الجهة المصدرة)، وعنوان URL لتسجيل الدخول، وشهادة التوقيع.
مزوّد الخدمة (SP)Holarch، لهذه المؤسسة. ولكل مؤسسة معرّف كيان وACS URL وعنوان URL للبيانات الوصفية خاصة بها.
الأعضاء المُدارونأعضاء المؤسسة الذين يقع عنوان بريدهم الإلكتروني في نطاق موثَّق وليسوا من مسؤولي المؤسسة. وينطبق عليهم فرض تسجيل الدخول الموحد.
رمز SCIMسر يستخدمه موفّر الهوية لاستدعاء SCIM API في Holarch لهذه المؤسسة. وهو غير مرتبط بشخص.

طريقة استخدامها

التحقق من نطاق بريد إلكتروني

  1. افتح إعدادات المؤسسة، وحدد المؤسسة، وافتح الوصول وتسجيل الدخول وابحث عن تسجيل الدخول الموحد.
  2. تحت نطاقات البريد الإلكتروني، أدخل نطاق عناوين أعضائك واختر إضافة نطاق.
  3. انشر سجل TXT المعروض: الاسم _holarch-challenge.<domain> بالقيمة holarch-domain-verification=….
  4. اختر تحقق. قد تستغرق تغييرات DNS بضع دقائق لتصل؛ فتحقق مرة أخرى حتى يعرض النطاق موثَّق.

أضف كل نطاق يستخدمه أعضاؤك (مثل example.com وeng.example.com). حتى 20 نطاقًا لكل مؤسسة.

توصيل موفّر الهوية

  1. في موفّر الهوية الخاص بك، أنشئ تطبيق SAML 2.0 (انظر أقسام المزوّدين أدناه) بالقيم الواردة تحت موفّر الهوية في Holarch:
    • Entity ID (الجمهور): https://app.holarch.app/api/auth/saml/<organization id>/metadata
    • ACS URL (عنوان URL للرد): https://app.holarch.app/api/auth/saml/<organization id>/acs
    • عنوان URL للبيانات الوصفية: مثل معرّف الكيان؛ ويمكن للمزوّدين الذين يستوردون البيانات الوصفية لمزوّد الخدمة استخدامه.
  2. انسخ XML البيانات الوصفية للمزوّد أو عنوان URL لبياناته الوصفية إلى المربع في الأعلى واختر قراءة البيانات الوصفية. يملأ Holarch معرّف الكيان وعنوان URL لتسجيل الدخول والشهادة. أو أدخلها بنفسك.
  3. تحت السمات والأدوار، اضبط أسماء السمات إن كان مزوّدك يستخدم أسماء غير معتادة (انظر السمات)، ودور الأعضاء الجدد، والمجموعات إلى الأدوار اختياريًا.
  4. اختر حفظ موفّر الهوية وأدخل كلمة المرور.

تفعيل تسجيل الدخول الموحد

  1. حدد تسجيل الدخول الموحّد لهذه المؤسسة. وهو يحتاج إلى موفّر هوية محفوظ ونطاق موثَّق.
  2. أعطِ الأعضاء رابط تسجيل الدخول للأعضاء، أو اطلب منهم اختيار تسجيل الدخول الموحّد في شاشة تسجيل الدخول وإدخال عنوان بريدهم الإلكتروني للعمل.
  3. جرّبه مع عضو واحد أولًا.

عند أول تسجيل دخول لعضو، ينشئ Holarch الحساب (مؤكدًا، دون كلمة مرور) ويضيفه إلى المؤسسة، حتى حين يحتاج التسجيل إلى دعوة. وحين يوجد حساب بذلك العنوان، يُربط تسجيل الدخول الموحد به ويتلقى مالكه بريدًا إلكترونيًا.

فرض تسجيل الدخول الموحد

حدد فرض تسجيل الدخول الموحّد على الأعضاء في النطاقات الموثَّقة بعد أن يعمل تسجيل الدخول الموحد.

  • عندئذ لا يسجّل الأعضاء المُدارون الدخول إلا عبر موفّر الهوية. وتجيب طرق تسجيل الدخول بكلمة المرور ومفتاح المرور وGoogle وMicrosoft بأن المؤسسة تفرض تسجيل الدخول الموحد، مع زر ينتقل إليه. وتنتهي فورًا جلساتهم الحالية من طرق تسجيل الدخول الأخرى.
  • لا يُفرض على مسؤولي المؤسسة: يحتفظون بكلمة المرور أو مفتاح المرور مع تسجيل الدخول بخطوتين، ليتمكنوا من إصلاح إعداد معطوب لموفّر الهوية (وصول الطوارئ). أبقِ مسؤولَين للمؤسسة على الأقل.
  • لا يتأثر الأعضاء الذين تقع عناوينهم خارج النطاقات الموثَّقة (المتعاونون الخارجيون).
  • ما زالت إعادة تعيين كلمة المرور تضبط كلمة المرور الجديدة لكنها لا تسجّل دخول العضو؛ فيسجّل الدخول بعدها عبر موفّر الهوية.
  • تظل رموز API والتطبيقات المتصلة للأعضاء المُدارين تعمل. ألغِ تنشيط الحساب عبر SCIM لإنهائها.

تزويد الحسابات باستخدام SCIM

  1. تحت التزويد (SCIM 2.0)، اختر إنشاء رمز SCIM مميز وأدخل كلمة المرور.
  2. انسخ الرمز وعنوان URL الأساسي (https://app.holarch.app/scim/v2) إلى إعدادات التزويد في موفّر الهوية الخاص بك. ويعرض Holarch الرمز مرة واحدة.
  3. فعّل إنشاء المستخدمين وتحديثهم وإلغاء تنشيطهم في المزوّد.

حتى 5 رموز لكل مؤسسة. وينهي إلغاء الرمز فورًا.

حين تتغير شهادة موفّر الهوية

  1. الصق الشهادة الجديدة أسفل القديمة (يُسمح بشهادتين) واحفظ.
  2. بدّل المزوّد إلى الشهادة الجديدة.
  3. أزل الشهادة القديمة واحفظ مرة أخرى.

تعرض قائمة الشهادات موضوع كل شهادة وتاريخ انتهائها وبصمتها.

تسجيل دخول الشركة لعدة مؤسسات (مستضاف ذاتيًا)

ينتمي نطاق البريد الإلكتروني إلى مؤسسة واحدة. وحين تشغّل شركة مؤسسة لكل قسم على خادم مستضاف ذاتيًا، تتحقق مؤسسة واحدة (عادةً مؤسسة قسم تقنية المعلومات) من نطاق الشركة، وتربط موفّر الهوية، وتفعّل تسجيل الدخول الموحد. ثم تربط المؤسسات الأخرى مجموعات موفّر الهوية بأدوارها الخاصة:

  1. في إعدادات المؤسسة ← الوصول وتسجيل الدخول ← تسجيل الدخول الموحد الخاصة بالقسم، ابحث عن تسجيل دخول الشركة. وهو يذكر المؤسسة التي تدير تسجيل دخول الشركة.
  2. تحت من المجموعات إلى الأدوار، اكتب ربطًا واحدًا في كل سطر، مثل packs-engineers = member وpacks-leads = admin، واختر حفظ المجموعات.
  3. اختياري: أضف وصول المجموعة إلى مشاريع القسم بعد فاصلة، مثل packs-contractors = member, viewer. انظر الوصول إلى مشاريع القسم.

عند كل تسجيل دخول عبر تسجيل دخول الشركة، ينضم الشخص الموجود في مجموعة مربوطة إلى تلك المؤسسة بذلك الدور، أو يصبح مسؤول مؤسسة فيها. ولا يزيل تسجيل الدخول أحدًا أبدًا ولا يخفض دوره (أما مجموعات SCIM فتستطيع ذلك: انظر مجموعات SCIM والأقسام)؛ ويزيل مسؤولو المؤسسة الأشخاص في إعدادات المؤسسة. ويجب أن يرسل موفّر الهوية المجموعات (سمة المجموعات في تسجيل دخول الشركة).

يتحكم مسؤولو المؤسسة التي تدير تسجيل دخول الشركة في تسجيل الدخول لكل عنوان في النطاق. اقصر تلك المؤسسة على الأشخاص الذين يديرون موفّر الهوية.

الوصول إلى مشاريع القسم (مستضاف ذاتيًا)

يمكن لكل ربط مجموعة أيضًا أن يحدد مقدار ما يحصل عليه أفرادها في المشاريع المشتركة مع المؤسسة كلها (مشاركة ← المؤسسات): viewer أو reviewer أو editor (الافتراضي). ودور الشخص في مثل هذا المشروع هو الأدنى بين دور المشاركة وأعلى وصول بين مجموعاته المربوطة هناك. مثلًا، مع مشروع مشترك بدور محرر وpacks-contractors = member, viewer، يشاهده المتعاقد؛ ومن هو في packs-contractors وpacks-engineers = member معًا يحرره. وتسري القاعدة أينما جاءت المجموعات: تسجيل الدخول الموحد للشركة، ومجموعات SCIM، ودليل الشركة. ولا تتأثر المشاريع المشتركة مع شخص مباشرةً، والعضو المضاف يدويًا (غير الموجود في أي مجموعة مربوطة) يحصل على دور المشاركة. ويسري تغيير وصول مجموعة فورًا على كل من وضعتهم.

مقاعد المحررين. يحدّ الترخيص عدد المحررين؛ والمشاهدون والمراجعون مجانيون. وحين يجعل وصول المحرر لمجموعة شخصًا ما محررًا ولا يوجد مقعد شاغر، يحصل ذلك الشخص على دور مشاهد بدلًا من ذلك، ويظل تسجيل الدخول يعمل. وتُظهر إعدادات المؤسسة والمسؤول ← دليل الشركة عدد الأشخاص المُبقَين على دور مشاهد؛ وتسرد صفحة دليل الشركة كل محرر يأتي مقعده من مجموعة، وكل شخص مُبقى. وحين تتحرر مقاعد، يحصل الأشخاص المُبقَون على دور محرر عند الفحص التالي، بدءًا بالأقدم عضوية.

الخوادم على شبكة مغلقة. حين لا يستطيع الخادم الاستعلام عن DNS العام، يمكن لمسؤول الموقع اختيار وضع علامة موثّق بجانب نطاق غير موثّق بدلًا من نشر سجل TXT. ويظل النطاق تابعًا لمؤسسة واحدة فقط، ويُسجَّل التغيير في سجل التدقيق.

قواعد تسجيل الدخول

يفحص Holarch كل إجابة من موفّر الهوية بدقة. ويُرفض تسجيل الدخول حين:

  • لا يكون التأكيد موقّعًا بشهادة مكوَّنة، أو يكون موقّعًا بـ SHA-1؛
  • لا تتطابق الجهة المصدرة أو الجمهور (معرّف كيان المؤسسة) أو الوجهة أو المستلم (ACS URL)؛
  • لا يكون التأكيد صالحًا بعد أو يكون قد انتهى (يُسمح بفرق دقيقتين في الساعة)؛
  • يجيب عن تسجيل دخول لم يبدأ في المتصفح نفسه، أو عن تسجيل دخول استُخدم بالفعل (يبدأ كل تسجيل دخول مرة واحدة وينتهي بعد 10 دقائق)؛
  • يصل التأكيد نفسه مرة ثانية (إعادة التشغيل)؛
  • يكون عنوان البريد الإلكتروني مفقودًا أو خارج النطاقات الموثَّقة للمؤسسة؛
  • يكون الحساب معطّلًا.

عندئذ تذكر شاشة تسجيل الدخول ما الخطأ، ويسجّله سجل تدقيق المؤسسة بوصفه auth.sso-failed.

تسجيل الدخول من بوابة موفّر الهوية (بمبادرة من IdP، حين يبدأ الأعضاء من لوحة تطبيقات المزوّد) متوقف افتراضيًا، لأن مثل هذه الإجابة غير مرتبطة بتسجيل دخول بدأه المتصفح. لا تفعّل السماح بتسجيل الدخول من بوابة موفّر الهوية إلا حين يحتاج أعضاؤك إليه. وما زالت الحماية من إعادة التشغيل وكل الفحوص الأخرى تنطبق.

تسجيل الدخول بخطوتين

افتراضيًا، يكون تسجيل الدخول الموحد هو الخطوة الأولى. وما زالت الحسابات التي فعّلت تسجيل الدخول بخطوتين تؤكد مفتاح مرور أو رمزًا، وما زال إعداد فرض تسجيل الدخول بخطوتين في المؤسسة يطلبه من الأعضاء.

مع تفعيل الوثوق بتسجيل الدخول متعدد العوامل لدى موفّر الهوية، لا يحتاج تسجيل الدخول الذي يبلّغ تأكيده عن مصادقة متعددة العوامل إلى خطوة ثانية من Holarch، ويستوفي شرط الخطوتين في هذه المؤسسة لتلك الجلسة (لا في مؤسسات أخرى). ويقبل Holarch سياقات المصادقة هذه بوصفها متعددة العوامل:

سياق المصادقةيرسله
https://refeds.org/profile/mfaكثير من المزوّدين حين يُكوَّنون لذلك
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (و…MobileTwoFactorUnregistered)Okta وغيره
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncTokenرمز لمرة واحدة
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard و…SmartcardPKIالبطاقات الذكية

يُحتسب أيضًا ادعاء http://schemas.microsoft.com/claims/authnmethodsreferences في Entra ID مع multipleauthn. وتسجيل الدخول بكلمة مرور فقط لدى موفّر الهوية ليس متعدد العوامل، حتى مع تفعيل الوثوق.

السمات

Holarchأسماء السمات الافتراضية (يُستخدم أول اسم موجود)
البريد الإلكتروني (مطلوب)email أو mail أو emailaddress أو http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress أو urn:oid:0.9.2342.19200300.100.1.3، أو NameID حين يكون عنوان بريد إلكتروني، وإلا فمطالبة UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
الاسمdisplayName أو name أو http://schemas.microsoft.com/identity/claims/displayname، أو ادعاء name في WS-Federation، أو الاسم الأول واسم العائلة (givenName/firstName، sn/surname/lastName وصيغ ادعاءاتها)
المجموعاتالسمة التي تسمّيها في سمة المجموعات، مثل groups. وإن لم تُسمَّ أي سمة: groups وmemberOf وRole وhttp://schemas.xmlsoap.org/claims/Group الخاصة بـ AD FS وhttp://schemas.microsoft.com/ws/2008/06/identity/claims/role و…/claims/groupsid و…/claims/groups

يُعثر على الحساب بواسطة NameID لموفّر الهوية (بصيغة دائمة، أو بريد إلكتروني، أو اسم مؤهل بنطاق Windows، أو صيغة أخرى). ودون NameID (لا يرسل AD FS أيًا منها ما لم تُصدره قاعدة مطالبة)، يحدد عنوان البريد الإلكتروني الحساب. وحين يتغير NameID ويبقى عنوان البريد الإلكتروني، يُعاد ربط الحساب.

تُقارن أسماء المجموعات دون مراعاة حالة الأحرف. والاسم المؤهل بالنطاق مثل CORP\Packs Engineers يطابق أيضًا ربطًا لـ Packs Engineers، ومعرّف SID لمجموعة (S-1-5-21-…) يطابق ربطًا مكتوبًا بذلك المعرّف.

المجموعات إلى الأدوار

اكتب ربطًا واحدًا في كل سطر: holarch-admins = admin أو engineering = member. عند كل تسجيل دخول، يصبح العضو في مجموعة مربوطة بـ admin مسؤول المؤسسة؛ وإلا يصبح العضو في مجموعة مربوطة عضوًا. ويحتفظ الأعضاء الذين لا ينتمون إلى أي مجموعة مربوطة بدورهم. ولا يُخفَّض أبدًا دور آخر مسؤول للمؤسسة.

SCIM

تتبع SCIM API المعيارين RFC 7643 وRFC 7644 على https://app.holarch.app/scim/v2 مع Authorization: Bearer hsc_….

نقطة النهايةما الذي يفعله
GET /ServiceProviderConfig, /ResourceTypes, /Schemasوصف الخدمة
GET /Usersسرد المستخدمين المزوَّدين في المؤسسة والأعضاء في نطاقاتها الموثَّقة؛ وfilter مع eq على userName أو externalId أو id أو emails.value أو emails[type eq "work"].value؛ وstartIndex وcount
POST /Usersإنشاء مستخدم (أو ربط حساب موجود بذلك العنوان) وإضافته إلى المؤسسة
GET, PUT, PATCH /Users/<id>قراءة مستخدم أو استبداله أو تغييره: userName، name، displayName، emails، externalId، active
DELETE /Users/<id>إلغاء تنشيط المستخدم ونسيان المعرّف الخارجي
/Groupsالخوادم المستضافة ذاتيًا: سرد المجموعات وإنشاؤها وقراءتها واستبدالها وتغييرها (PATCH على members وdisplayName وexternalId، بصيغتي Okta وMicrosoft Entra ID) وحذفها؛ وfilter مع eq على displayName أو externalId أو id؛ وexcludedAttributes=members. انظر مجموعات SCIM والأقسام. الخدمة المستضافة: قائمة فارغة، وتُرفض التغييرات؛ اربط المجموعات بالأدوار ضمن تسجيل الدخول الموحد بدلًا من ذلك.
  • لا يمكن إنشاء أو تغيير إلا العناوين في النطاقات الموثَّقة للمؤسسة.
  • يزيل إلغاء التنشيط (active: false، أو DELETE) الشخص من المؤسسة، ويعطّل الحساب، وينهي كل جلساته، ويلغي رموز API والتطبيقات المتصلة الخاصة به. وتؤدي إعادة التنشيط إلى تمكين الحساب واستعادة دوره في المؤسسة. ويبقى الحساب الذي عطّله Holarch (مثلًا بعد إساءة الاستخدام) معطّلًا.
  • تُقبل سمات امتداد Enterprise وتُتجاهل.
  • يمكن لكل رمز تقديم 600 طلب في الدقيقة. ويُسجَّل كل تغيير في سجل تدقيق المؤسسة (scim.create، scim.deactivate، وغيرهما).

مجموعات SCIM والأقسام (مستضاف ذاتيًا)

على خادم مستضاف ذاتيًا، يمكن لموفّر الهوية دفع مجموعاته إلى نقطة نهاية SCIM للمؤسسة التي تملك نطاق الشركة. ثم يقرر من المجموعات إلى الأدوار الخاص بالأقسام تحت تسجيل دخول الشركة من ينتمي إلى أي قسم، وبأي دور. ويخدم ربط واحد الأمرين: تسجيل الدخول عبر تسجيل الدخول الموحد للشركة، ومجموعات SCIM.

  • الشخص المضاف إلى مجموعة مربوطة ينضم إلى تلك المؤسسة بالدور المربوط؛ وتغيير المجموعة يغيّر الدور.
  • الشخص المُزال من كل مجموعة مربوطة يغادر المؤسسات التي أضافته إليها المجموعات.
  • العضويات المضافة بطريقة أخرى (بواسطة مسؤول مؤسسة، أو دعوة، أو استيراد، أو تسجيل دخول) لا تزيلها المجموعات ولا تخفضها أبدًا؛ ويمكن للمجموعات فقط رفعها إلى مسؤول مؤسسة. وحين يغيّر مسؤول مؤسسة دور عضو يدويًا، تصبح العضوية منذ ذلك الحين بيد مسؤولي المؤسسة.
  • لا يُزال آخر مسؤول مؤسسة في مؤسسة ولا يُخفض دوره أبدًا.
  • يسري تغيير من المجموعات إلى الأدوار لقسم فورًا على كل من في المجموعات.
  • يجب أن يكون أعضاء المجموعة مستخدمين يجهّزهم هذا الرمز أو يديرهم؛ وتُتجاهل المعرّفات الأخرى.
  • يعمل إلغاء تنشيط مستخدم كما كان من قبل؛ وتتبع أقسامه مجموعاته.
  • يُسجَّل كل تغيير: scim.group-create وscim.group-update وscim.group-delete في سجل تدقيق مؤسسة الشركة، وكل تغيير في العضوية في سجل القسم.

إعداد موفّر الهوية الخاص بك

Okta

  1. Applications → Create App Integration → SAML 2.0.
  2. Single sign-on URL: ACS URL. أبقِ Use this for Recipient URL and Destination URL محددًا. Audience URI (SP Entity ID): معرّف الكيان.
  3. Name ID format: EmailAddress أو Persistent. Application username: Email.
  4. Attribute statements: email → user.email، displayName → user.displayName. Group attribute statements (اختياري): groups، مع التصفية حسب حاجتك.
  5. أنهِ الإعداد، ثم انسخ عنوان URL للبيانات الوصفية من علامة التبويب Sign On إلى Holarch واختر قراءة البيانات الوصفية.
  6. لـ SCIM: في علامة التبويب General للتطبيق، فعّل SCIM provisioning؛ وفي Provisioning، يكون SCIM connector base URL هو عنوان URL الأساسي، وUnique identifier field هو userName، وAuthentication Mode هو HTTP Header مع رمز SCIM؛ وفعّل Create Users وUpdate User Attributes وDeactivate Users.

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application (من خارج المعرض)، ثم Single sign-on → SAML.
  2. Identifier (Entity ID): معرّف الكيان. Reply URL (Assertion Consumer Service URL): ACS URL.
  3. Attributes & Claims: يعمل ادعاء emailaddress الافتراضي؛ وأضف ادعاء مجموعات إن كنت تربط المجموعات.
  4. تحت SAML Certificates، انسخ App Federation Metadata Url إلى Holarch واختر قراءة البيانات الوصفية.
  5. للوثوق بتسجيل الدخول متعدد العوامل في Entra، افرض MFA في نهج Conditional Access للتطبيق؛ وعندئذ يرسل Entra القيمة multipleauthn.
  6. لـ SCIM: Provisioning → Automatic؛ ويكون Tenant URL هو عنوان URL الأساسي وSecret Token هو رمز SCIM. Test Connection، ثم ابدأ التزويد.

Microsoft AD FS

يسجّل AD FS (Active Directory Federation Services، على Windows Server 2016 أو أحدث) دخول الأشخاص من Active Directory المحلي لديك. في وحدة تحكم AD FS Management:

  1. Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online، وأدخل عنوان URL للبيانات الوصفية الخاص بـ Holarch. وإذا تعذّر على خادم AD FS الوصول إلى Holarch، فاحفظ البيانات الوصفية في ملف واختر Import data about the relying party from a file. اسم العرض: Holarch.
  2. Access control policy: Permit everyone، أو Permit everyone and require MFA (انظر الخطوة 6).
  3. افتح Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims الخاص بالثقة، مع مخزن السمات Active Directory:
سمة LDAPنوع المطالبة الصادرة
E-Mail-AddressesE-Mail Address
Display-Nameالاسم
Token-Groups – Unqualified Namesالمجموعة

استخدم Token-Groups – Qualified by Domain Name بدلًا من ذلك حين يكون لنطاقين مجموعات بالاسم نفسه؛ وToken-Groups as SIDs (نوع المطالبة Group SID) حين تتغير أسماء المجموعات. ويقرأ Holarch مطالبات Group وRole وGroup SID دون سمة المجموعات.

يرسل AD FS لكل مجموعة pre-Windows 2000 name (الاسم السابق لـ Windows 2000، sAMAccountName)، لا اسم العرض ولا cn، ويتضمن المجموعة الأساسية (عادةً Domain Users). اربط المجموعات بذلك الاسم، أو بمعرّف SID. وعلى خادم متصل بدليل الشركة، يسرد المسؤول ← دليل الشركة ← اختبار مستخدم كليهما لكل مجموعة من مجموعات الشخص.

  1. اختياري، NameID ثابت: Add Rule → Transform an Incoming Claim، والمطالبة الواردة E-Mail Address (أو UPN)، والصادرة Name ID، والصيغة Email (أو Persistent Identifier). ودون ذلك يحدد Holarch الحساب بعنوان بريده الإلكتروني.
  2. في Properties → Advanced الخاصة بالثقة، أبقِ SHA-256. واترك علامة التبويب Encryption فارغة: لا يفك Holarch تشفير التأكيدات، والاتصال عبر https. ويوقّع AD FS التأكيد افتراضيًا (SamlResponseSignature AssertionOnly)، وهو ما يشترطه Holarch.
  3. انسخ https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml إلى عنوان URL للبيانات الوصفية في Holarch واختر قراءة البيانات الوصفية. يملأ ذلك معرّف الكيان (http://<host>/adfs/services/trust)، وعنوان URL لتسجيل الدخول (https://<host>/adfs/ls/)، وشهادة توقيع الرموز. وللوثوق بتسجيل الدخول متعدد العوامل في AD FS، اشترط MFA في سياسة التحكم في الوصول وفعّل الوثوق بتسجيل الدخول متعدد العوامل لدى موفّر الهوية؛ عندها يرسل AD FS http://schemas.microsoft.com/claims/multipleauthn.

على خادم مستضاف ذاتيًا، يمكن أن يكون عنوان URL للبيانات الوصفية عنوانًا داخليًا (https://adfs.corp.example.com/…، أو عنوان IP خاصًا)، وتُفحص شهادته مقابل CA الشركة في tls/ldap-ca.pem وكذلك مقابل جهات CA الموثوقة في النظام. وتتجدد شهادة توقيع الرموز في AD FS كل عام: يُظهر Holarch تاريخ انتهائها؛ اختر قراءة البيانات الوصفية مرة أخرى حين يضيف AD FS الشهادة الجديدة (تُحفظ الاثنتان خلال فترة التداخل). ولا يدعم AD FS بروتوكول SCIM؛ ومع دليل شركة على خادم مستضاف ذاتيًا، يفحص Holarch الحسابات بنفسه (أدناه).

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
  2. انسخ IdP metadata (نزّلها، ثم الصق XML في Holarch).
  3. ACS URL: ACS URL. Entity ID: معرّف الكيان. Name ID format: EMAIL، Name ID: Basic Information › Primary email.
  4. Attribute mapping: Primary email → email؛ First name → givenName؛ Last name → sn. Group membership → groups (اختياري).
  5. شغّل التطبيق ON for everyone (أو لوحدة تنظيمية).
  6. لا يرسل Google Workspace سياق مصادقة MFA؛ فاترك الوثوق بتسجيل الدخول متعدد العوامل لدى موفّر الهوية متوقفًا. ولا يعمل تزويد SCIM من Google إلا مع تطبيقات المعرض؛ فأنشئ الحسابات عبر تسجيل الدخول الموحد بدلًا من ذلك.

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application (PingFederate: اتصال SP).
  2. استورد عنوان URL للبيانات الوصفية الخاص بـ Holarch، أو أدخل ACS URL وEntity ID.
  3. Attribute mapping: saml_subject → Email Address؛ وأضف email وdisplayName.
  4. انسخ عنوان URL للبيانات الوصفية لـ IdP إلى Holarch واختر قراءة البيانات الوصفية.
  5. لـ SCIM: تزويد PingOne باتصال SCIM؛ وعنوان URL الأساسي ومصادقة OAuth 2 Bearer Token مع رمز SCIM.

دليل الشركة (Active Directory / LDAP)

على خادم مستضاف ذاتيًا، يمكن للأشخاص تسجيل الدخول باسم المستخدم وكلمة المرور الخاصين بهم في الشركة، ويتحقق منهما دليل الشركة: Active Directory (وحدات التحكم بالمجال فيه) أو دليل LDAP آخر مثل OpenLDAP أو FreeIPA. ولا حاجة إلى موفّر هوية. يُعدّه مسؤول الموقع في المسؤول ← دليل الشركة؛ ويمكن لملف .env على الخادم أن يعطي القيم الأولية (HOLARCH_LDAP_*، وSIGN-IN.md في حزمة التسليم المستضافة ذاتيًا). ولا يُتاح في الخدمة المستضافة.

إعداد دليل الشركة

اختر أولًا نوع الدليل في أعلى المسؤول ← دليل الشركة: Active Directory أو دليل LDAP آخر (OpenLDAP، FreeIPA، …). وهو اتصال واحد في الحالتين؛ ويحدد النوع عمليات البحث عن المجموعات المعروضة، والقيم التي يضعها استخدام القيم الافتراضية لـ Active Directory أو استخدام القيم الافتراضية لـ LDAP في النموذج، والتلميحات والأمثلة. ويؤدي تغييره إلى استبدال عامل تصفية المستخدمين أو البحث عن المجموعات إذا كان لا يزال على القيمة الافتراضية للنوع الآخر، ويُبقي عامل التصفية الذي كتبته بنفسك. وتستنتج الصفحة النوع من الإعدادات المحفوظة (المجموعات المتداخلة أو عامل تصفية Active Directory تعني Active Directory).

  1. أنشئ حساب خدمة للقراءة فقط في الدليل (مثل svc-holarch). ضع اسمه في حساب الربط وكلمة مروره في .env على الخادم بالاسم HOLARCH_LDAP_BIND_PASSWORD، ثم أعد تشغيل الخادم. ولا تُعرض كلمة المرور أبدًا في المسؤول.
  2. تحت خوادم الدليل، أدخل كل وحدة تحكم بالمجال أو خادم LDAP بالصيغة ldaps://dc1.corp.example.com (المنفذ 636)، واحدًا في كل سطر؛ وتُجرَّب بالترتيب. ولا يعمل ldap://host:389 إلا مع تشغيل استخدام StartTLS مع عناوين ldap://. ويُرفض LDAP غير المشفر، فلا تعبر كلمة المرور الشبكة دون تشفير أبدًا. استخدم اسم مضيف كل خادم كما يظهر في شهادته.
  3. ضع شهادة CA التي أصدرت شهادات الخوادم في شهادة CA (PEM)، أو في tls/ldap-ca.pem على الخادم. والقيمة الفارغة تعني جهات CA الموثوقة في النظام.
  4. أدخل DN الأساسي (DC=corp,DC=example,DC=com، أو dc=example,dc=com في دليل LDAP آخر) ونطاقات البريد الإلكتروني المسموح بها.
  5. اختر اختبار الاتصال. يتصل بالقيم الموجودة في النموذج، دون حفظ، ويذكر المشكلة حين يفشل شيء (لم يُجب أي خادم، الشهادة، حساب الربط، DN الأساسي).
  6. تحت اختبار مستخدم، أدخل اسم مستخدم لترى ما سيجده تسجيل الدخول: عنوان البريد الإلكتروني، وهل الحساب نشط، ومجموعاته، والمؤسسات التي سينضم إليها. وكلمة المرور اختيارية؛ تُفحص مرة واحدة ولا تُخزَّن أبدًا.
  7. فعّل السماح بتسجيل الدخول بحسابات الشركة واختر حفظ. عندها تُظهر شاشة تسجيل الدخول تسجيل الدخول بحساب الشركة (أو نص الزر الخاص بك).

Active Directory: يعثر عامل تصفية المستخدمين الافتراضي على المستخدمين النشطين عبر sAMAccountName أو userPrincipalName أو mail، فيمكن للأشخاص كتابة jsmith أو [email protected] أو CORP\jsmith. وتُستبعد الحسابات المعطَّلة. ويوفر البحث عن المجموعات Active Directory، مع المجموعات المتداخلة (الافتراضي) والسمة memberOf ‏(المجموعات المباشرة فقط).

دليل LDAP آخر: يضع استخدام القيم الافتراضية لـ LDAP القيمة (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) في عامل تصفية المستخدمين، فيكتب الأشخاص uid الخاص بهم أو عنوان بريدهم الإلكتروني؛ ويعمل أي عامل تصفية يتضمن {username} في موضع الاسم المكتوب. ويوفر البحث عن المجموعات السمة memberOf (OpenLDAP مع طبقة memberof، وFreeIPA، و389 Directory Server) والمجموعات التي تُدرج الشخص عضوًا فيها (groupOfNames وgroupOfUniqueNames؛ ويحدد DN الأساسي للمجموعات مكانها). ولا تُحتسب المجموعات المتداخلة.

الأقسام من مجموعات الدليل

تضع مجموعات الدليل الأشخاص في المؤسسات عبر المجموعات إلى الأدوار نفسه تحت تسجيل دخول الشركة كما في SAML (انظر تسجيل دخول الشركة لعدة مؤسسات): في مربع تسجيل الدخول الموحد لكل مؤسسة، اربط المجموعات بالأدوار، مثل Packs Engineers = member وPacks Leads = admin. وتُقارن الأسماء دون مراعاة حالة الأحرف؛ ويعمل DN المجموعة كذلك، وفي Active Directory معرّف SID الخاص بها. ويحتسب Active Directory، مع المجموعات المتداخلة الشخص في مجموعة عبر مجموعات أخرى بداخلها.

عند كل تسجيل دخول وكل فحص دوري، ينضم الشخص الموجود في مجموعة مربوطة إلى تلك المؤسسة بذلك الدور، ومع وصول المجموعة إلى مشاريع القسم. وتُزال العضوية التي منحها الدليل حين يغادر الشخص كل مجموعة مربوطة بها؛ وتبقى العضويات المضافة يدويًا (يمكن للدليل رفع عضو إلى مسؤول مؤسسة هناك، لكنه لا يخفضه أبدًا). ولا يُزال آخر مسؤول مؤسسة أبدًا.

من يمكنه تسجيل الدخول

  • يجب أن يكون الحساب نشطًا في الدليل: تُرفض الحسابات المعطّلة والمقفلة والمنتهية الصلاحية، وكذلك الحسابات التي انتهت صلاحية كلمة مرورها أو يجب تغييرها عند تسجيل الدخول التالي.
  • يجب أن يحتوي إدخال الدليل على عنوان بريد إلكتروني في نطاق مسموح به. وينشئ أول تسجيل دخول حساب Holarch، أو يربط الحساب الموجود بذلك العنوان. ولا يُستولى على حساب مرتبط بالفعل بإدخال دليل مختلف.
  • يمنع اشتراط تسجيل الدخول بحساب الشركة للحسابات المرتبطة الحسابات المرتبطة من تسجيل الدخول بكلمة مرور Holarch. ويحتفظ مسؤولو الموقع بكلمة مرورهم، فلا يؤدي تعطل الدليل أبدًا إلى إقفال الجميع.
  • توقف كلمات المرور الخاطئة تسجيل الدخول لذلك الحساب في الشركة مؤقتًا لمدة 15 دقيقة بعد المحاولات الفاشلة قبل الإيقاف المؤقت (الافتراضي 3)، أيًا كانت صيغة الاسم المكتوبة (jsmith، [email protected]، CORP\jsmith). أبقِ القيمة أقل من حد الإقفال في المجال حتى لا يقفل Holarch أبدًا حساب شركة. وتحصل أسماء المستخدمين غير المعروفة وكلمات المرور الخاطئة على الرد نفسه، في الوقت نفسه تقريبًا.

الفحص الدوري

كل عدد من الدقائق يحدده فحص الحسابات كل (الافتراضي 15)، يستعلم الخادم عن كل حساب مرتبط مسجّل الدخول أو يحمل عضويات من الدليل. والشخص الذي عُطّل أو أُقفل أو أُزيل من الدليل، أو انتهت صلاحية كلمة مروره أو يجب تغييرها عند تسجيل الدخول التالي (غالبًا إعادة تعيين من مسؤول بعد اشتباه في اختراق) يُسجَّل خروجه في كل مكان ويفقد العضويات التي منحها الدليل؛ وتحدّث تغييرات المجموعات العضويات. ويستعيد الحساب المقفل عضوياته عند تسجيل دخوله التالي بعد فتح قفله. وحين يتعذر الوصول إلى الدليل، لا يتغير شيء. وحين تكون معظم الحسابات المفحوصة مفقودة (مثلًا بعد DN أساسي خاطئ)، لا يُنهى شيء ويعرض المسؤول التحذير. ويشغّل افحص الآن الفحص فورًا. ويعرض المسؤول نتيجة آخر فحص.

يستعلم كل فحص أيضًا عن أعضاء كل مجموعة مربوطة (تُحتسب المجموعات المتداخلة مع Active Directory، مع المجموعات المتداخلة) ويُهيّئ حسابات للأشخاص الذين ليس لديهم حساب بعد، وفق قواعد تسجيل الدخول نفسها (نشط، ونطاق بريد إلكتروني مسموح به، ولا استيلاء على حساب مرتبط في مكان آخر). ولا يُرسل أي بريد إلكتروني؛ يسجّل الشخص الدخول بحساب الشركة حين يحتاج إلى Holarch أول مرة، ويكون بالفعل في أقسامه، لذا يمكن مشاركة المشاريع معه قبل ذلك. ويُهيّئ الفحص الواحد 200 حساب على الأكثر؛ ويعرض المسؤول عدد الحسابات الإضافية التي تنتظر الفحص التالي. ولا يُستعلم بهذه الطريقة عن المجموعات المسماة بمعرّف SID فقط؛ ويوضع أفرادها عند تسجيل الدخول.

تسجيل الدخول بخطوتين مع دليل الشركة

تسجيل دخول الشركة هو الخطوة الأولى. فالمؤسسات التي تشترط تسجيل الدخول بخطوتين تظل تطلب الخطوة الثانية في Holarch (مفتاح مرور أو رمز)، والحسابات المفعّل فيها تسجيل الدخول بخطوتين تظل تؤكدها. فعّل اعتبار تسجيل الدخول بحساب الشركة تسجيل دخول بخطوتين فقط حين يحتاج حساب الشركة نفسه إلى عامل ثانٍ؛ وعندها يفي بشرط الخطوتين لدى كل مؤسسة في تلك الجلسة.

كل تسجيل دخول عبر الدليل، وكل رفض، وكل تغيير في الإعدادات مسجّل في سجل التدقيق (admin.directory-save، admin.directory-test، directory.account-ended) وفي سجلات تسجيل الدخول لكل حساب. ولا تُسجَّل كلمات المرور أبدًا.

الحدود وملاحظات الأمان

الحد: يستخدم تسجيل الدخول الموحد ربط HTTP-Redirect إلى موفّر الهوية وHTTP-POST للعودة إلى Holarch. ولا تُدعم طلبات المصادقة الموقّعة والمشفّرة، والتأكيدات المشفّرة، وتسجيل الخروج الموحد. وتُدعم مجموعات SCIM على الخوادم المستضافة ذاتيًا فقط (مجموعات SCIM والأقسام). ويسجّل دليل الشركة الدخول باسم المستخدم وكلمة المرور (ربط بسيط عبر TLS)؛ ولا يُدعم Kerberos ولا تسجيل الدخول المتكامل في Windows.

  • تحتاج تغييرات الإعدادات إلى تحقق حديث من كلمة المرور، وتُرسل بالبريد الإلكتروني إلى كل مسؤولي المؤسسة، وتُسجَّل في سجل التدقيق (sso.saml-save، sso.enable، sso.require، sso.domain-verify، scim.token-create…).
  • يجب أن تستخدم عناوين URL للبيانات الوصفية https على الإنترنت العام (وعلى خادم مستضاف ذاتيًا، يُسمح بالعناوين الداخلية أيضًا)؛ ويجلبها Holarch مرة واحدة، حين تختار قراءة البيانات الوصفية.
  • لا تُخزَّن رموز SCIM إلا بصيغة تجزئة.