דלג לתוכן
Clevera Help Center

הגדרת SSO עם Okta

הגדרה שלב אחר שלב של Okta עבור כניסה יחידה (SSO) ל-Clevera, באמצעות SAML 2.0 או OpenID Connect: הגדרות אפליקציית Okta, אילו ערכי Okta מוזנים לאילו שדות ב-Clevera, הקצאת משתמשים ובדיקה.

עודכן ב-5 דקות קריאה

הגדר כניסה יחידה (SSO) בין Okta ל-Clevera כדי שהצוות שלך יוכל להתחבר באמצעות חשבון ה-Okta שלו. ניתן להתחבר באמצעות SAML 2.0 או OpenID Connect (OIDC); מדריך זה מלווה אותך בתהליך בשני הצדדים, ב-Okta ובשדות התואמים ב-Clevera.

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

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

  • אתה הבעלים של סביבת עבודה ב-Clevera בתוכנית מותאמת אישית.
  • אתה מנהל Okta שיכול ליצור אינטגרציות של אפליקציות ולהקצות אותן.
  • אתה מכיר את דומייני האימייל שהאנשים שלך משתמשים בהם ב-Okta, כגון acme.example.

פתח תחילה את תיבת הדו-שיח להגדרת Clevera, כדי שתוכל להעתיק ממנה ערכים: פתח את תפריט סביבת העבודה בחלק העליון של סרגל הצד, בחר הגדרות צוות, לאחר מכן אבטחה, ולחץ על הגדרת SSO. בחר ב-Okta כספק זהות.

שלב 1 של תיבת הדו-שיח להגדרת SSO עם Okta ו-SAML 2.0 שנבחרו, עם מזהה הישות (Entity ID), כתובת ה-ACS וכתובת ה-URL של המטא-נתונים להעתקה
העתק את שלושת הערכים האלה לספק הזהות שלך.

התחברות עם SAML 2.0

  1. יצירת האפליקציה ב-Okta

    בתוך קונסולת הניהול של Okta, עבור אל Applications → Applications ולחץ על Create App Integration. בחר ב-SAML 2.0 ולחץ על הבא. תן לה את השם Clevera ולחץ על הבא.

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

    תחת SAML Settings, מלא את הפרטים:

    שדה ב-Okta ערך מ-Clevera
    Single sign-on URL ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. השאר את Use this for Recipient URL and Destination URL מסומן.
    Audience URI (SP Entity ID) Entity ID / Audience URI (העתק אותו מתיבת הדו-שיח של Clevera; הוא מסתיים במזהה סביבת העבודה שלך)
    Default RelayState השאר ריק
    Name ID format EmailAddress
    Application username Email
  3. בדיקת חתימה

    לחץ על Show Advanced Settings וודא ש-Response ו-Assertion Signature שניהם Signed, ש-Signature Algorithm הוא RSA-SHA256, ו-Assertion Encryption הוא Unencrypted. Clevera דורשת שגם התגובה וגם האישור יהיו חתומים.

  4. הוספת מאפייני שם

    תחת Attribute Statements, הוסף את firstName עם הערך user.firstName ואת lastName עם הערך user.lastName. Clevera משתמשת בהם כדי לתת שמות לחשבונות חדשים. לחץ על הבא, ענה על שאלת המשוב של Okta לגבי אפליקציה פנימית, ולחץ על סיום.

  5. העתקת הערכים של Okta ל-Clevera

    בכרטיסיית ה-Sign On של האפליקציה, פתח את פרטי הגדרת ה-SAML (View SAML setup instructions, או More details בקונסולות חדשות יותר). ב-Clevera, הגדר את Protocol ל-SAML 2.0, לחץ על המשך, והדבק:

    ערך מ-Okta שדה ב-Clevera
    Identity Provider Issuer (או Issuer) IdP Entity ID
    Identity Provider Single Sign-On URL (או Sign on URL) SSO sign-in URL
    X.509 Certificate (או Signing Certificate) X.509 certificate

    השאר את Logout URL ריק אלא אם אתה משתמש בהתנתקות יחידה (single logout) של Okta.

    שלב 2 של תיבת הדו-שיח להגדרת SSO עם מזהה ה-IdP, כתובת ה-URL להתחברות והתעודה מלאים
    כתובת ה-URL להתנתקות היא אופציונלית.
  6. הקצאת משתמשים

    בכרטיסיית ה-Assignments של האפליקציה, לחץ על Assign והוסף את האנשים או הקבוצות שאמורים להשתמש ב-Clevera. אנשים שלא הוקצו לא יוכלו להתחבר דרך Okta.

לאחר מכן סיים ב-Clevera: דומיינים ותפקידים.

התחברות עם OpenID Connect

  1. יצירת האפליקציה ב-Okta

    עבור אל Applications → Applications → Create App Integration. בחר ב-OIDC - OpenID Connect, לאחר מכן ב-Web Application, ולחץ על הבא.

  2. הגדרת ה-Redirect URI

    בתיבת הדו-שיח להגדרת Clevera, הגדר את Protocol ל-OpenID Connect והעתק את ה-Redirect URI (callback URL) מהתיבה האפורה. לאחר מכן מלא ב-Okta:

    שדה ב-Okta ערך
    App integration name Clevera
    Grant type Authorization Code
    Sign-in redirect URIs ה-Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
    Sign-out redirect URIs הסר את הדוגמה; השאר ריק
    Controlled access בחר מי יכול להשתמש באפליקציה, או Skip group assignment for now והקצה מאוחר יותר

    לחץ על שמירה.

  3. העתקת פרטי הגישה

    בכרטיסיית ה-General של האפליקציה, תחת Client Credentials, העתק את ה-Client ID ואת ה-Client secret. השאר את Client authentication מוגדר כ-Client secret.

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

    ב-Clevera, לחץ על המשך והזן:

    שדה ב-Clevera ערך
    Client ID ה-Client ID של Okta
    Client secret ה-Client secret של Okta
    Discovery URL https:// דומיין ה-Okta שלך /.well-known/openid-configuration, לדוגמה https://acme.okta.com/.well-known/openid-configuration

    אם אתה משתמש בשרת הרשאה מותאם אישית, השתמש ב-Discovery URL שלו במקום זאת, לדוגמה https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

    שלב 2 של תיבת הדו-שיח להגדרת SSO עבור OpenID Connect עם מזהה לקוח, סוד ו-Discovery URL
    עם Discovery URL, שדות נקודת הקצה נשארים מוסתרים.
  5. הקצאת משתמשים

    בכרטיסיית ה-Assignments, הקצה את האנשים או הקבוצות שאמורים להשתמש ב-Clevera.

סיום ב-Clevera

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

לאחר מכן, חברים מקלידים את אימייל העבודה שלהם בדף ההתחברות של Clevera ולוחצים על Continue with Okta.

פתרון בעיות

בעיה מה לבדוק
"SSO authentication failed…" מיד לאחר ההתחברות ל-Okta, עם SAML Response ו-Assertion Signature שניהם Signed; התעודה ב-Clevera היא תעודת החתימה הנוכחית של האפליקציה; ה-Audience URI תואם בדיוק ל-Entity ID של Clevera.
"SSO session expired. Please try again." לאחר לחיצה על אריח Clevera ב-Okta צפוי: ההתחברות חייבת להתחיל בדף ההתחברות של Clevera.
Okta אומרת שהמשתמש לא הוקצה לאפליקציה הקצה אותם בכרטיסיית ה-Assignments של האפליקציה.
"Your email domain is not authorized for this team's SSO." האימייל של האדם ב-Okta משתמש בדומיין שאינו נמצא ב-Allowed email domains. הוסף אותו ב-Clevera.
Okta מציגה שגיאת redirect URI (OIDC) Sign-in redirect URIs חייבים להיות בדיוק ה-Redirect URI (callback URL) מ-Clevera, https://app.clevera.ai/sso/oidc/callback.

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