OIDC / SSO — تسجيل الدخول عبر مزوّد الهوية

Premium

تسجيل الدخول عبر SSO (OIDC / OAuth2): يسجّل مستخدموكم الدخول إلى Omniscol بحساب مؤسستهم بدل كلمة مرور خاصة، فيكفيهم معرّف واحد، ويتم تفعيل الحسابات وتعطيلها مركزيًا مع كل التحاق أو مغادرة، وتُطبَّق سياسة الأمان (المصادقة متعددة العوامل، انتهاء الصلاحية…) انطلاقًا من نظام المعلومات لديكم. يدعم Omniscol كلاً من Google Workspace وMicrosoft Entra ID وKeycloak وأي مزوّد متوافق مع OIDC.

يتيح OpenID Connect (OIDC)، المبني على OAuth2، لمستخدميكم تسجيل الدخول إلى Omniscol بحساب مؤسستهم بدل كلمة مرور خاصة بـ Omniscol. وله ثلاث فوائد: كلمة مرور واحدة تُحفظ، وتعطيل مركزي للحساب عند التحاق أي شخص بالمؤسسة أو مغادرته، وتطبيق تلقائي لسياسة الأمان (المصادقة متعددة العوامل، طول كلمة المرور، انتهاء الصلاحية…) التي يديرها نظام المعلومات.

تصف هذه الصفحة SSO للمستخدمين: تسجيل دخول الأشخاص إلى Omniscol عبر مزوّد الهوية لديكم. أما الحالة المعاكسة، أي أن يكون Omniscol خادم OAuth2 / OIDC تتصل به خدمات خارجية، مع شاشة إدارة العملاء الخاصة به، فتجدونها في صفحة OAuth2 / OIDC (المزوّد).

المزوّدون المدعومون

يدعم Omniscol:

  • Google Workspace،
  • Microsoft Entra ID (المعروف سابقًا باسم Azure AD)،
  • Keycloak،
  • مزوّد OIDC عام عبر عنوان issuer / discovery URL (أي مزوّد متوافق مع OIDC).

الإعداد في Omniscol

في وحدة الإدارة ← إعدادات، قسم الأمان، يفتح الزر إعداد شاشة إعداد OIDC التي تتيح تعريف المزوّد:

  • الاسم المعروض — النص الذي سيظهر على زر تسجيل الدخول (مثلًا المتابعة عبر Google).
  • نوع المزوّد — Google أو Microsoft Entra ID (Azure AD) أو Keycloak أو OIDC عام.
  • Tenant / issuer — tenant Microsoft لـ Entra ID، أو عنوان issuer لـ Keycloak ولمزوّدي OIDC العامين. ثم يكتشف التطبيق بيانات OIDC الوصفية تلقائيًا.
  • Client ID وClient secret — يتم الحصول عليهما بإنشاء تطبيق لدى المزوّد (راجعوا وثائق المزوّد).
  • الصلاحيات (Scopes) — القيمة الافتراضية openid profile email. أضيفوا الصلاحيات الخاصة بالمزوّد عند الحاجة.
  • النطاقات المسموح بها — قائمة اختيارية بمجالات البريد الإلكتروني المقبولة عند تسجيل الدخول عبر SSO؛ وإذا تُركت فارغة، لا يُطبَّق أي تصفية بحسب المجال.
  • عنوان URL لإعادة التوجيه — يعطيكم Omniscol القيمة الدقيقة التي تُنسخ في إعداد المزوّد (وكذلك عنوان إعادة التوجيه بعد تسجيل الخروج إذا طلبه المزوّد).
  • تسجيل الدخول عبر SSO فقط — بعد تأكيد SSO، يرفض هذا الخيار تسجيل الدخول بكلمة مرور Omniscol، باستثناء حسابات الطوارئ الموضحة أدناه.

يُحدَّد إعداد SSO الحالي على مستوى حساب المدرسة.

وصول الطوارئ (break-glass)

في وضع تسجيل الدخول عبر SSO فقط، يُرفض تسجيل الدخول بكلمة مرور Omniscol: يمر الجميع عبر مزوّد الهوية. وإذا أصبح هذا المزوّد غير متاح — بسبب عطل أو انتهاء صلاحية السر أو خطأ في الإعداد — فسيُحجب الوصول إلى Omniscol عن الجميع.

حساب الطوارئ ("break-glass") هو الضمانة ضد هذا الحجب: حساب مسؤول مسموح له بتسجيل الدخول بكلمة مرور Omniscol حتى عندما يكون وضع SSO الحصري مفعّلًا.

  • في ملف حساب مسؤول، وعندما يكون خيار تسجيل الدخول عبر SSO فقط مفعّلًا، يظهر مربع اختيار وصول الطوارئ (SSO فقط). يسمح تحديده لهذا الحساب بتسجيل الدخول بكلمة مرور إذا كان مزوّد الهوية غير متاح. ولا يمكن ذلك إلا لحسابات المسؤولين.
  • ويحتفظ دعم Omniscol من جهته بوصول طوارئ مستقل.

عيّنوا حساب طوارئ واحدًا على الأقل قبل تفعيل وضع SSO الحصري، واحفظوا كلمة مروره في مكان آمن: فهو شبكة الأمان لديكم إذا تعطل مزوّد الهوية.

الإعداد لدى المزوّد (أمثلة)

Google Workspace

  1. Google Cloud Console > APIs & Services > Credentials.
  2. أنشئوا معرّف OAuth 2.0 من نوع تطبيق ويب.
  3. الصقوا عنوان إعادة التوجيه الذي يقدّمه Omniscol في Authorized redirect URIs.
  4. احصلوا على Client ID وClient secret لنسخهما في Omniscol.

Microsoft Entra ID

  1. بوابة Azure > Entra ID > App registrations.
  2. New registration من نوع Web، مع عنوان إعادة التوجيه الخاص بـ Omniscol.
  3. Certificates & secrets > أنشئوا client secret.
  4. API permissions > أضيفوا openid وprofile وemail.
  5. احصلوا على Application (client) ID والسر.

Keycloak

  1. Realm > Clients > Create client من نوع OpenID Connect.
  2. Valid redirect URIs: العنوان الذي يقدّمه Omniscol.
  3. Credentials > احصلوا على client secret.

الربط بحسابات Omniscol

عندما ينقر مستخدم على زر SSO، يقوم Omniscol بما يلي:

  1. يعيد توجيهه إلى المزوّد،
  2. يستخرج عنوان بريده الإلكتروني بعد المصادقة،
  3. يبحث عن حساب Omniscol له العنوان البريدي نفسه.

إذا كان الحساب موجودًا ونشطًا، يتم تسجيل دخول المستخدم. وإلا يُرفض الوصول. والنتيجة: لكي يعمل SSO، يجب أن يكون المستخدمون موجودين في Omniscol بعنوان البريد الإلكتروني الصحيح — فالإنشاء ليس تلقائيًا في Omniscol افتراضيًا.

الإنشاء التلقائي للحسابات

الإنشاء التلقائي للحسابات عند أول تسجيل دخول عبر SSO (just-in-time provisioning) ليس السلوك الافتراضي لشاشة الإعداد. وإذا لزم هذا الوضع، فيجب الاتفاق عليه مع Omniscol.

طريقة العمل

إعداد مزوّد OIDC / SSO

  1. يتيح OIDC / SSO لمستخدميكم تسجيل الدخول بحساب مؤسستهم (Google Workspace وMicrosoft Entra ID وKeycloak وOkta…). ويختلف الجزء الخاص بالمزوّد باختلاف المزوّد.

  2. لدى المزوّد، أنشئوا أولًا تطبيق OIDC من نوع تطبيق ويب: احصلوا على Client ID وClient secret، وانسخوا عنوان URL لإعادة التوجيه الذي يقدّمه Omniscol في Authorized redirect URIs لدى المزوّد.

  3. في Omniscol، افتحوا الإعدادات ثم إعداد OIDC. أدخلوا الاسم المعروض (نص زر تسجيل الدخول)، ونوع المزوّد، وissuer أو tenant بحسب الحالة، وClient ID، وClient secret، والصلاحيات (scopes) (الافتراضي: openid profile email).

  4. انقروا على زر اختبار. تحققوا من أن الإعداد يعمل. يجري Omniscol ذهابًا وإيابًا عبر OIDC؛ وفي حال وجود خطأ في discovery أو في السر أو في إعادة التوجيه، تكون رسالة الخطأ واضحة.

  5. احفظوا. يظهر زر تسجيل الدخول عبر SSO في صفحة تسجيل الدخول عندما يكون الإعداد مفعّلًا.

  6. مهم: يجب أن تكون الحسابات موجودة في Omniscol بعنوان البريد الإلكتروني الصحيح. يطابق تسجيل الدخول عبر SSO بحسب البريد الإلكتروني؛ ولا إنشاء تلقائي للحسابات افتراضيًا.

انظر أيضًا