מרכז העזרה של Scribble Maps
שינוי שפה

הקצאת משתמשים באמצעות SCIM

הגדרת הקצאת משתמשים באמצעות SCIM

ScribbleMaps תומכת ב-SCIM 2.0 (System for Cross-domain Identity Management) להקצאה והסרת הקצאה אוטומטיות של משתמשים. כך ניתן לסנכרן משתמשים אוטומטית מספק הזהויות (IdP) שלך אל ScribbleMaps ולוודא שחברות הצוות נשארת מסונכרנת עם ספריית הארגון שלך.

הקצאת משתמשים באמצעות SCIM זמינה בכתובת team.scribblemaps.com וחינמית לחלוטין.

תוכן עניינים

  1. מהו SCIM?
  2. לפני שמתחילים
  3. צעד 1: הפעלת SCIM ב-ScribbleMaps
  4. צעד 2: יצירת Bearer Token
  5. צעד 3: הגדרת ספק הזהויות שלך
  6. צעד 4: הגדרת הקצאת מוצר כברירת מחדל
  7. צעד 5: בדיקה והקצאת משתמשים
  8. מדריכים לפי ספק
  9. פעולות SCIM נתמכות
  10. ניהול מחזור החיים של משתמשים
  11. פתרון בעיות

מהו SCIM?

SCIM (System for Cross-domain Identity Management) הוא תקן פתוח המאפשר לך לבצע אוטומטית את הפעולות הבאות:

  • הקצאת משתמשים - יצירה אוטומטית של חשבונות ScribbleMaps כאשר משתמשים מוקצים ב-IdP שלך
  • עדכון משתמשים - שמירה על סנכרון פרטי המשתמש (שם, אימייל)
  • הסרת הקצאת משתמשים - השבתה אוטומטית של חשבונות כאשר משתמשים מוסרים מה-IdP שלך
  • ניהול תפקידים - הקצאת משתמשים לתפקיד מנהל מערכת או חבר באמצעות חברות בקבוצה

SCIM פועל לצד SSO (SAML/OIDC) כדי לספק ניהול מלא של מחזור החיים של הזהות.

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

  • עליך להיות בעל הצוות כדי להגדיר SCIM
  • נדרשת גישה לקונסולת הניהול של ספק הזהויות שלך
  • ה-IdP שלך חייב לתמוך ב-SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud ועוד)
  • מומלץ להגדיר SSO לפני SCIM לקבלת חוויית המשתמש הטובה ביותר

צעד 1: הפעלת SCIM ב-ScribbleMaps

  1. התחבר/י אל team.scribblemaps.com
  2. עבור/י אל SCIM Provisioning (בסרגל הצד השמאלי)
  3. הפעל/י את המתג Enable SCIM למצב פעיל

הערה: יהיה עליך ליצור Bearer Token לפני שניתן יהיה להפעיל את SCIM באופן מלא.

צעד 2: יצירת Bearer Token

ה-Bearer Token מאמת את ספק הזהויות שלך מול ScribbleMaps.

  1. בדף הגדרות SCIM, לחיצה על יצירה (Generate Token)
  2. העתק/י את האסימון מיד ושמור/י אותו במקום מאובטח

הערות אבטחה חשובות:

  • האסימון מוצג פעם אחת בלבד - אם תאבד/י אותו, יהיה עליך ליצור אסימון חדש
  • התייחס/י לאסימון זה כמו לסיסמה - כל מי שברשותו האסימון יכול לנהל את משתמשי הצוות שלך
  • ניתן לבטל וליצור מחדש את האסימון בכל עת אם הוא נחשף
  • ביטול אסימון עוצר מיד את כל פעולות ה-SCIM עד שיוגדר אסימון חדש

צעד 3: הגדרת ספק הזהויות שלך

השתמש/י בפרטים הבאים כדי להגדיר את ScribbleMaps כיישום SCIM ב-IdP שלך:

הגדרה ערך
SCIM Base URL https://api.scribblemaps.com/scim/v2
שיטת אימות HTTP Header / Bearer Token
כותרת Authorization Bearer YOUR_TOKEN_HERE
מזהה ייחודי userName (כתובת אימייל)

מדריך נקודות הקצה של SCIM

נקודת קצה מטרה
/scim/v2/Users הקצאה וניהול של משתמשים
/scim/v2/Groups ניהול חברות בתפקידים/קבוצות
/scim/v2/ServiceProviderConfig יכולות SCIM (גילוי)
/scim/v2/ResourceTypes סוגי משאבים נתמכים (גילוי)
/scim/v2/Schemas סכמות משתמשים וקבוצות (גילוי)

צעד 4: הגדרת הקצאת מוצר כברירת מחדל (אופציונלי)

ניתן להקצות אוטומטית רישיון מוצר למשתמשים כאשר הם מוקצים באמצעות SCIM:

  1. בדף הגדרות SCIM, מצא/י את Default Product Assignment
  2. בחירה של מוצר:
    • ללא - משתמשים נוצרים ללא מוצר (ניתן להקצות ידנית מאוחר יותר)
    • צופה - גישה לצפייה בלבד
    • Pro Basic - תכונות עריכה רגילות
    • Pro Business - גישה מלאה לתכונות
  3. לחיצה על שמירה

הערה: משתמשים יוקצו למוצר רק אם יש מושבים זמינים. אם אין מושבים זמינים, המשתמש נוצר אך נשאר ללא הקצאה.

צעד 5: בדיקה והקצאת משתמשים

  1. בספק הזהויות שלך, השתמש/י בתכונה Test Connection כדי לוודא את קישוריות ה-SCIM
  2. הקצה/י משתמש בדיקה ליישום ScribbleMaps ב-IdP שלך
  3. ודא/י שהמשתמש מופיע ברשימת חברי הצוות ב-ScribbleMaps
  4. לאחר האישור, הקצה/י משתמשים או קבוצות נוספים לפי הצורך

מדריכים לפי ספק

Okta

  1. בקונסולת הניהול של Okta, עבור/י אל Applications > Browse App Catalog
  2. חפש/י את "SCIM 2.0 Test App (Header Auth)" או צור/י יישום SCIM מותאם אישית
  3. עבור/י ללשונית Provisioning > Configure API Integration
  4. סמן/י Enable API integration
  5. הגדרה:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: הדבקה של אסימון ה-SCIM שלך מ-ScribbleMaps
  6. לחיצה על Test API Credentials לאימות
  7. עבור/י אל Provisioning > To App והפעל/י:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. עבור/י ללשונית Assignments כדי להקצות משתמשים או קבוצות

Microsoft Entra ID (Azure AD)

  1. בפורטל Azure, עבור/י אל Microsoft Entra ID > Enterprise Applications
  2. בחר/י את יישום ScribbleMaps שלך (או צור/י אחד)
  3. עבור/י אל Provisioning > תחילת העבודה
  4. הגדר/י את Provisioning Mode ל-Automatic
  5. תחת Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: הדבקה של אסימון ה-SCIM שלך מ-ScribbleMaps
  6. לחיצה על Test Connection לאימות
  7. הגדר/י Mappings עבור מאפייני משתמש
  8. הגדר/י את Provisioning Status ל-On
  9. עבור/י אל Users and groups כדי להקצות משתמשים

OneLogin

  1. ב-OneLogin Admin, עבור/י אל Applications > Add App
  2. חפש/י את "SCIM Provisioner with SAML (SCIM v2 Core)" או דומה לו
  3. עבור/י ללשונית Configuration
  4. הגדרה:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: הדבקה של אסימון ה-SCIM שלך מ-ScribbleMaps
  5. עבור/י ללשונית Provisioning והפעל/י הקצאה
  6. עבור/י ללשונית Users כדי להקצות משתמשים

JumpCloud

  1. ב-JumpCloud Admin, עבור/י אל SSO Applications
  2. לחיצה על + כדי להוסיף יישום חדש
  3. בחירה ב-Custom SCIM
  4. הגדרה:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: הדבקה של אסימון ה-SCIM שלך מ-ScribbleMaps
    • Authentication: Bearer Token
  5. לחיצה על Test Connection
  6. הגדר/י מיפויי מאפיינים
  7. הקצה/י קבוצות משתמשים ליישום

פעולות SCIM נתמכות

פעולות משתמשים

פעולה שיטה נתמך תיאור
List Users GET /Users כן אחזור כל המשתמשים עם עימוד וסינון
Get User GET /Users/{id} כן אחזור משתמש ספציפי לפי מזהה
Create User POST /Users כן הקצאת משתמש חדש
Replace User PUT /Users/{id} כן עדכון מלא של מאפייני המשתמש
Update User PATCH /Users/{id} כן עדכון חלקי של מאפייני המשתמש
Delete User DELETE /Users/{id} כן השבתת משתמש (מחיקה רכה)

פעולות קבוצות

פעולה שיטה נתמך תיאור
List Groups GET /Groups כן מחזיר את קבוצות התפקידים מנהל מערכת וחבר
Get Group GET /Groups/{id} כן אחזור קבוצה עם רשימת החברים
Update Group PATCH /Groups/{id} כן הוספה/הסרה של חברים בקבוצות תפקידים
Create Group POST /Groups לא אינו נתמך (התפקידים קבועים)

מאפייני משתמש נתמכים

מאפיין SCIM שדה ב-ScribbleMaps חובה
userName כתובת אימייל כן
externalId מזהה חיצוני מה-IdP לא
name.givenName שם פרטי לא
name.familyName שם משפחה לא
displayName שם תצוגה לא
active סטטוס החשבון לא
emails[].value כתובת אימייל לא

מסננים נתמכים

סינון דוגמה
סינון לפי אימייל userName eq "[email protected]"
סינון לפי מזהה חיצוני externalId eq "12345"
סינון לפי סטטוס active eq true

ניהול מחזור החיים של משתמשים

כאשר משתמש מוקצה

  1. נוצר חשבון חבר צוות חדש ב-ScribbleMaps
  2. פרטי המשתמש (שם, אימייל) מאוכלסים מה-IdP שלך
  3. אם הוגדר מוצר ברירת מחדל ויש מושבים זמינים, רישיון מוקצה אוטומטית
  4. המשתמש יכול להתחבר מיד באמצעות SSO (אם הוגדר)

כאשר משתמש מתעדכן

  1. מאפייני המשתמש (שם, שם תצוגה) מתעדכנים בהתאם ל-IdP שלך
  2. שינויי אימייל מסונכרנים (אלא אם המשתמש קישר את חשבונו)

כאשר מוסרת הקצאת משתמש

  1. חשבון המשתמש מושבת (מחיקה רכה)
  2. כל רישיונות המוצר מוסרים והמושבים מתפנים
  3. כל ההפעלות הפעילות מבוטלות מיד
  4. המשתמש אינו יכול עוד להתחבר
  5. נתוני המשתמש והמפות נשמרים (לא נמחקים)
  6. ניתן להפעיל מחדש את החשבון אם המשתמש מוקצה שוב

ניהול תפקידים באמצעות קבוצות

ScribbleMaps חושפת שתי קבוצות תפקידים באמצעות SCIM:

מזהה קבוצה תפקיד הרשאות
admin מנהל מערכת ניהול הגדרות הצוות, המשתמשים והחיוב
member חבר גישה רגילה של חבר צוות

כדי להגדיר משתמש כמנהל מערכת, הוסף/י אותו לקבוצה admin באמצעות SCIM PATCH. את התפקיד בעלים לא ניתן לשנות באמצעות SCIM.

פתרון בעיות

בעיות נפוצות

"401 Unauthorized" או "Invalid token"

  • ודא/י שה-Bearer Token נכון ולא בוטל
  • ודא/י שהאסימון מועבר בכותרת Authorization בפורמט Bearer YOUR_TOKEN
  • בדוק/י אם תוקף האסימון פג (אם הוגדר תוקף)
  • צור/י אסימון חדש לפי הצורך

"409 Conflict" - המשתמש כבר קיים

  • משתמש עם אימייל זה כבר קיים בצוות שלך
  • אם המשתמש הקיים הושבת, SCIM יפעיל אותו מחדש אוטומטית
  • בדוק/י אם יש כתובות אימייל כפולות ב-IdP שלך

"400 Bad Request" - שדה חובה חסר

  • ודא/י ש-userName (אימייל) נכלל בבקשה
  • ודא/י שפורמט האימייל תקין
  • בדוק/י את הגדרות מיפוי המאפיינים ב-IdP שלך

משתמשים נוצרו אך לא הוקצה להם מוצר

  • בדוק/י אם מוצר ברירת מחדל מוגדר בהגדרות SCIM
  • ודא/י שיש לך מושבים זמינים עבור מוצר ברירת המחדל
  • ניתן להקצות מוצרים למשתמשים ידנית בהגדרות הצוות

שינויים במשתמשים אינם מסונכרנים

  • חלק מה-IdP מסנכרנים לפי לוח זמנים (למשל, כל 40 דקות ב-Azure AD)
  • נסה/י לאלץ סנכרון ידני ב-IdP שלך
  • ודא/י ש-SCIM עדיין מופעל ושהאסימון תקף

בדיקת החיבור נכשלת

  • ודא/י שה-SCIM Base URL הוא בדיוק https://api.scribblemaps.com/scim/v2
  • ודא/י שאין לוכסן בסוף הכתובת או שגיאות כתיב
  • בדוק/י שהרשת/חומת האש שלך מאפשרת HTTPS יוצא אל api.scribblemaps.com
     

זקוק/ה לעזרה?

אם נתקלת בבעיות בהקצאת משתמשים באמצעות SCIM, אנא פנה/י לצוות התמיכה שלנו וצרף/י:

  • את שם הצוות שלך
  • את ספק הזהויות שבו אתה משתמש
  • כל הודעות שגיאה מיומני ההקצאה של ה-IdP שלך
  • צילומי מסך של הגדרות ה-SCIM שלך (כשהאסימון מוסתר)

אנחנו כאן כדי לעזור לך להגדיר הקצאת משתמשים באמצעות SCIM עבור הארגון שלך.

עודכן לאחרונה