كيفية تكوين SAML SSO مع Google Workspace

في هذا الدليل، سنستخدم Google Workspace كمزوّد لتسجيل الدخول الأحادي (SSO)، مع بروتوكول Security Assertion Markup Language (SAML) كبروتوكول الهوية المفضّل لدينا.

ندعم حاليًا المصادقة التي تبدأ من جهة الخدمة (SP) والمصادقة التي تبدأ من مزود الهوية (IdP). فيما يتعلق بتزويد المستخدمين، راجع SCIM.

تُعد هذه الميزة جزءًا من خطط الفريق والمؤسسات.

الخطوة 1: إنشاء تطبيق SAML في Google Workspace

• في وحدة تحكم Google Workspace الخاصة بالمسؤولين، انتقل إلى Admin > Apps > Web and mobile apps.
• انقر على Add app ثم انقر على Add custom SAML app.
• يجب عليك تقديم اسم لتطبيقك في حقل “اسم التطبيق”.
• انقر على Continue.

الخطوة 2: تكوين Hugging Face باستخدام تفاصيل مزوّد الهوية من Google

• تحتوي الشاشة التالية في إعدادات Google على معلومات تسجيل الدخول الأحادي (SSO) لتطبيقك.
• في إعدادات مؤسستك على Hugging Face، انتقل إلى علامة التبويب SSO واختر بروتوكول SAML.
• انسخ رابط SSO من Google إلى حقل رابط تسجيل الدخول على Hugging Face.
• انسخ الشهادة من Google إلى الحقل المقابل على Hugging Face. يجب أن تكون الشهادة العامة بالصيغة التالية:
  تم النسخ

  -----BEGIN CERTIFICATE-----
  {certificate}
  -----END CERTIFICATE-----

• في إعداد مساحة عمل Google Workspace، انقر على Continue.

الخطوة 3: تكوين Google بتفاصيل SP الخاصة بـ Hugging Face

• في شاشة “تفاصيل مزوّد الخدمة”، ستحتاج إلى Assertion Consumer Service URL وSP Entity ID من إعدادات SSO الخاصة بك في Hugging Face. انسخهما إلى حقول ACS URL وEntity ID المقابلة في Google.
• تأكد من ضبط ما يلي:
  • تحقّق من خانة الاستجابة الموقّعة.
  • صيغة معرّف الاسم: EMAIL
  • معرّف الاسم: Basic Information > Primary email

• انقر على Continue.

الخطوة 4: تعيين السمات

• في شاشة “Attribute mapping” (تعيين السمات)، انقر على Add mapping وقم بإعداد السمات التي تريد إرسالها. هذه الخطوة اختيارية وتعتمد على ما إذا كنت تريد استخدام Role Mapping (تعيين الأدوار) أو Resource Group Mapping (تعيين مجموعات الموارد) على Hugging Face.

• انقر على Finish.

الخطوة 5: اختبار وتمكين تسجيل الدخول الأحادي

قبل إجراء الاختبار، تأكد من منح الوصول إلى التطبيق للمستخدمين المناسبين في وحدة تحكم إدارة Google Workspace ضمن إعدادات “وصول المستخدم” الخاصة بالتطبيق. يجب أن يكون لدى المسؤول الذي يجري الاختبار صلاحية الوصول. قد يستغرق تطبيق تغييرات وصول المستخدم بضع دقائق على Google Workspace.

• الآن، في إعدادات تسجيل الدخول الموحّد (SSO) الخاصة بك على Hugging Face، انقر على “تحديث واختبار تكوين SAML”.
• يجب أن يتم تحويلك إلى شاشة تسجيل الدخول الخاصة بجوجل. بعد تسجيل الدخول، سيتم تحويلك إلى صفحة إعدادات مؤسستك.
• ستؤكد علامة الصح الخضراء بالقرب من محدد SAML نجاح الاختبار.
• بمجرد نجاح الاختبار، يمكنك تفعيل تسجيل الدخول الأحادي لمنظمتك بالنقر على زر تفعيل.
• بمجرد التفعيل، يجب على أعضاء منطمتك إكمال تدفق المصادقة عبر SSO الموصوف في قسم كيف يعمل.

Update on GitHub