הגדרת SSO עם Google Workspace

הגדר כניסה יחידה (SSO) בין Google Workspace לבין Clevera כדי שהצוות שלך יוכל להתחבר באמצעות חשבון העבודה שלהם ב-Google. ניתן להתחבר באמצעות OpenID Connect (OIDC) דרך לקוח OAuth של Google Cloud, או באמצעות SAML 2.0 דרך אפליקציית SAML מותאמת אישית במסוף הניהול של Google.

המסופים של Google משתנים מעת לעת. אם תווית כלשהי להלן אינה תואמת, חפש את ההגדרה בעלת המשמעות הזהה, והשתמש במדריכים הכלליים לרשימה המלאה של הערכים: SAML, OIDC.

לפני שמתחילים#

• אתה הבעלים של סביבת עבודה ב-Clevera בתוכנית מותאמת אישית.
• עבור OIDC: באפשרותך ליצור לקוחות OAuth בפרויקט Google Cloud השייך לארגון ה-Google Workspace שלך.
• עבור SAML: אתה מנהל מערכת ראשי (Super Admin) ב-Google Workspace.
• אתה מכיר את דומייני ה-Google Workspace שלך, כגון acme.example, כולל דומיינים משניים.

פתח תחילה את תיבת הדו-שיח להגדרה ב-Clevera: פתח את תפריט סביבת העבודה בחלק העליון של סרגל הצד, בחר הגדרות צוות, לאחר מכן אבטחה, ולחץ על Set up SSO. בחר ב-Google Workspace כ-Identity provider.

התחברות עם OpenID Connect#

1. הגדרת האפליקציה כפנימית#

   במסוף Google Cloud, בחר פרויקט בארגון שלך ופתח את Google Auth Platform (במסופים ישנים יותר, APIs & Services → OAuth consent screen). הגדר את ה-Audience (סוג משתמש) ל-Internal, כך שרק חשבונות ב-Google Workspace שלך יוכלו להתחבר. מלא את שם האפליקציה (Clevera) ואת אימייל התמיכה.

2. יצירת לקוח ה-OAuth#

   בתיבת הדו-שיח להגדרה של Clevera, הגדר את Protocol ל-OpenID Connect והעתק את ה-Redirect URI (callback URL) מהתיבה האפורה. לאחר מכן, ב-Google, פתח את Clients (או APIs & Services → Credentials) וצור OAuth client ID:

   שדה ב-Google	ערך
   Application type	Web application
   Name	Clevera
   Authorized redirect URIs	ה-Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback

   לחץ על Create והעתק את ה-Client ID ואת ה-Client secret.

3. מילוי הפרטים ב-Clevera#

   ב-Clevera, לחץ על Continue והזן:

   שדה ב-Clevera	ערך
   Client ID	ה-Client ID של Google
   Client secret	ה-Client secret של Google
   Discovery URL	https://accounts.google.com/.well-known/openid-configuration

Google שולחת את תביעות ה-email וה-name עבור ה-openid email profile scopes ש-Clevera מבקשת, כך שאין צורך במיפוי נוסף.

התחברות עם SAML 2.0#

1. הוספת אפליקציית SAML מותאמת אישית#

   במסוף הניהול של Google, עבור אל Apps → Web and mobile apps, לחץ על Add app ובחר Add custom SAML app. תן לה את השם Clevera ולחץ על Continue.

2. העתקת הערכים של Google ל-Clevera#

   ב-Google Identity Provider details, העתק את הערכים ל-Clevera (הגדר תחילה את Protocol ל-SAML 2.0 ולחץ על Continue):

   ערך ב-Google	שדה ב-Clevera
   Entity ID	IdP Entity ID
   SSO URL	SSO sign-in URL
   Certificate	X.509 certificate

   לחץ על Continue ב-Google.

3. הזנת הערכים של Clevera#

   ב-Service provider details:

   שדה ב-Google	ערך
   ACS URL	https://app.clevera.ai/sso/saml/callback
   Entity ID	Entity ID / Audience URI מתיבת הדו-שיח של Clevera
   Start URL	השאר ריק
   Signed response	מסומן ב-V
   Name ID format	EMAIL
   Name ID	Basic Information → Primary email

   לחץ על Continue.

4. מיפוי השמות#

   ב-Attribute mapping, מפה את First name ל-firstName ואת Last name ל-lastName. לחץ על Finish.

5. הפעלת האפליקציה#

   פתח את ה-User access של האפליקציה, בחר ON for everyone (או עבור יחידות ארגוניות או קבוצות שאמורות להשתמש ב-Clevera) ולחץ על Save. Google מציינת שייתכן שיחלוף זמן מה עד שהשינויים יחולו.

סיום ב-Clevera#

1. ב-Domains & roles, הוסף כל דומיין של Google Workspace שהאנשים שלך משתמשים בו. בחר Create accounts on first sign-in ואת ה-Default role for new SSO members.
2. ב-Review, לחץ על Save configuration.
3. לחץ על Run test, הפעל את Enable SSO, והתחבר כמשתמש בדיקה בחלון פרטי, החל מדף ההתחברות של Clevera.
4. כאשר זה עובד עבור כולם, הפעל את Require SSO אם ברצונך ש-SSO תהיה הדרך היחידה להיכנס. פעולה זו גם מכבה את Continue with Google עבור אותם חברים.

חברים מקלידים את אימייל העבודה שלהם בדף ההתחברות של Clevera ולוחצים על Continue with Google Workspace.

פתרון בעיות#

הודעות נוספות: פתרון בעיות התחברות ב-SSO.

קשור#