الدخول الموحّد عبر SAML أو OIDC، وSCIM

الدخول الموحّد عبر SAML أو OIDC، وSCIMيتيح الدخول الموحّد لموظفيك تسجيل الدخول إلى IngevoraMirage عبر مزوّد الهوية في شركتك (Okta وMicrosoft Entra ID وGoogle Workspace وOneLogin وJumpCloud وغيرها). يُعدّه فريق IngevoraMirage لمساحة عمل واحدة بالتعاون مع قسم تقنية المعلومات لديك. راسلنا للبدء.ما نحتاجه منك

نطاقات البريد الإلكتروني التي يستخدمها موظفوك، مثل example.com. ينتمي كل نطاق إلى مساحة عمل واحدة، ونتحقق معك من أن شركتك تملكه. لا يمكن استخدام نطاقات البريد العامة مثل gmail.com.

SAML 2.0: البيانات الوصفية (metadata) لمزوّد الهوية، ملفَّ XML أو العنوانَ المنشورة عليه. نقرأ منها معرّف الكيان (entity ID) وعنوان تسجيل الدخول (ربط HTTP-Redirect) وشهادات التوقيع.

OpenID Connect: عنوان الجهة المُصدِرة (issuer URL) ومعرّف العميل (client ID) وسرّ العميل (client secret). سجّل عنوان إعادة التوجيه هذا لدى المزوّد: https://ingevoramirage.ingevora.com/auth/callback.

ما تُدخله لدى مزوّد الهوية (SAML)بعد حفظ الاتصال، نرسل إليك قيمتين لتطبيق SAML جديد:

الإعداد

القيمة

Entity ID (Audience)

https://mirage-api.ingevora.com/sso/saml/<connection id>

ACS URL (ربط HTTP-POST)

https://mirage-api.ingevora.com/sso/saml/<connection id>/acs

أرسل بريد العمل للشخص في NameID (بصيغة emailAddress)، أو في سمة اسمها email. ويُستخدم الاسم المعروض (displayName، أو givenName وsn) للحسابات الجديدة.يجب أن تكون كل استجابة موقّعة — الاستجابة كاملة أو الـassertion أو كلاهما — بشهادة من بياناتك الوصفية. نقبل الاستجابة فقط لتسجيل دخول بدأناه نحن (InResponseTo)، ومرة واحدة فقط، وضمن فارق توقيت لا يتجاوز 3 دقائق. لا يُدعم تسجيل الدخول الذي يبدأ من لوحة مزوّد الهوية: يبدأ الأشخاص من IngevoraMirage.عند تغيّر شهادة التوقيع لديك، أرسل إلينا البيانات الوصفية الجديدة قبل انتهاء الشهادة القديمة.كيف يسجّل الأشخاص الدخولفي صفحة تسجيل الدخول، يختار الشخص تسجيل الدخول عبر SSO ويُدخل بريد عمله. يحدّد نطاقُ البريد اتصالَك، فيسجّل الدخول لدى مزوّد الهوية، ثم يعود وقد سجّل دخوله.

يبقى التحقق بخطوتين ساريًا. إذا فعّلت الوثوق بالتحقق بخطوتين لدى هذا المزوّد، فإن تسجيل الدخول الذي يُثبت خطوتك الثانية يتجاوز خطوتنا: في SAML، قيمة AuthnContextClassRef تدل على طريقة متعددة العوامل (مثل http://schemas.microsoft.com/claims/multipleauthn أو https://refeds.org/profile/mfa)؛ وفي OpenID Connect، القيمة amr أو acr.

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

الحسابات عند أول تسجيل دخولعند تفعيل إنشاء الحسابات عند أول تسجيل دخول، يحصل من يستخدم أحد نطاقاتك وليس لديه حساب على حساب عند أول تسجيل دخول، وينضمّ إلى مساحة عملك بـدور الأشخاص الجدد (Designer أو Developer). لا تكون للحساب كلمة مرور، وتقبل شركتك الشروط نيابةً عنه. وتصله رسالة بريد إلكتروني: "أضافتك شركتك إلى ‹مساحة العمل›". يسري حدّ الأعضاء في خطتك: عندما تمتلئ مساحة العمل، يوضّح تسجيل الدخول ذلك ولا يُنشأ شيء.ومن دون هذا الخيار، يحتاج الأشخاص أولًا إلى دعوة من أحد المالكين.دليلك (SCIM 2.0)يستطيع دليلك إضافة الأشخاص وإزالتهم نيابةً عنك. نعطيك عنوان SCIM الأساسي ورمزًا:

الإعداد

القيمة

SCIM base URL

https://mirage-api.ingevora.com/scim/v2

المصادقة

ترويسة HTTP ‏Authorization: Bearer <token>

يُعرض الرمز مرة واحدة. احفظه في مزوّد الهوية فقط. يمكننا استبداله أو إلغاؤه في أي وقت، فيتوقف القديم فورًا.

المستخدمون فقط، دون مجموعات. قيمة userName هي بريد العمل للشخص على نطاقاتك.

الإنشاء يضيف الشخص إلى مساحة عملك بدور الأشخاص الجدد، وينشئ حسابه إن لم يكن لديه حساب (مع رسالة الترحيب نفسها).

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

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

ابحث عن شخص بـfilter=userName eq "pat@example.com". ويدعم PATCH الحقلَ active والاسم.

لكل رمز 300 طلب في الدقيقة كحدّ أقصى.

تأتي الأخطاء بصيغة أخطاء SCIM، مثل 409 عندما يكون الشخص في مساحة العمل بالفعل أو عند بلوغ حدّ الأعضاء في الخطة.صفحات ذات صلة

مساحات العمل والأدوار — الأدوار والدعوات وقواعد تسجيل الدخول في مساحة العمل.

البدء — عدستك الأولى، من تسجيل الدخول إلى أول طلب.