שאלות נפוצות על הקצאת משתמשים ב-SCIM

הקצאה אוטומטית של משתמשים לצוות Cliqer שלכם באמצעות SCIM 2.0.

SCIM יוצר, מעדכן ומשבית באופן אוטומטי את חברי הצוות שלכם מתוך ספק הזהויות. הוא חלק מתוכנית Enterprise, או מתוסף Enterprise בתוכניות Presenter, Studio HD, Studio 4K ו-Studio 8K, והצוות שלכם מגדיר אותו בנתיב לוח הבקרה ← צוות ← אבטחה (/dash/team/security). נדרשת הרשאת הצוות ניהול אבטחה.

איך זה עובד בקצרה?

ה-IdP שלכם קורא לנקודות הקצה של SCIM 2.0 ב-Cliqer עם טוקן Bearer.
הטוקן מזהה את הצוות שלכם: אין מזהה צוות בכתובת ה-URL, כך שאתם משתמשים באותה כתובת בסיס כמו כולם, והטוקן מגביל את כל הפעולות לצוות שלכם.
משתמשים שהוקצו הופכים לחברים בצוות שלכם. השבתת משתמש מסירה אותו מהצוות.

איך מגדירים את זה?

הנפקת טוקן

עוברים אל צוות ← אבטחה ← הקצאת SCIM ולוחצים על הנפקת טוקן.

העתקת הטוקן עכשיו

מעתיקים את הטוקן מיד: הוא מוצג פעם אחת בלבד. לאחר מכן יוצגו תמיד רק 4 התווים האחרונים.

הזנת הטוקן ב-IdP

בהגדרות ההקצאה של ה-IdP שלכם, מזינים:

Base URL / Tenant URL: https://<your-cliqer-host>/api/scim/v2
Bearer token: הטוקן שהנפקתם זה עתה.

הפעלת ההקצאה

מפעילים את ההקצאה (ולפי הצורך ממפים מאפיינים).

החלפה או ביטול

החלפה = הנפקת טוקן חדש, עדכון ה-IdP ולאחר מכן ביטול הטוקן הישן.
ביטול משבית טוקן באופן מיידי. לא ניתן לעולם להשתמש שוב בטוקנים שבוטלו.

אילו פעולות נתמכות?

פעולה	נקודת קצה
יצירה	`POST /api/scim/v2/Users`
הצגת רשימה / סינון	`GET /api/scim/v2/Users?filter=userName eq "user@co"`
קריאה	`GET /api/scim/v2/Users/{id}`
החלפה	`PUT /api/scim/v2/Users/{id}`
עדכון חלקי	`PATCH /api/scim/v2/Users/{id}`
השבתה / מחיקה	`DELETE /api/scim/v2/Users/{id}`
יכולות	`GET /api/scim/v2/ServiceProviderConfig`

הסינון תומך ב-userName eq "..." (שבו משתמשים Okta ו-Entra ID למניעת כפילויות). פעולות מרוכזות (Bulk) והקצאת קבוצות אינן נתמכות.

באילו מאפייני משתמש נעשה שימוש?

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "userName": "user@company.com",
  "name": { "givenName": "John", "familyName": "Doe" },
  "emails": [{ "primary": true, "value": "user@company.com" }],
  "active": true,
  "externalId": "employee-123"
}

השדות userName (אימייל), name.givenName, name.familyName, active ו-externalId ממופים. מאפיינים אחרים מתקבלים, אך המערכת מתעלמת מהם.

מה קורה בעת השבתה?

שליחת active: false (באמצעות PATCH) או DELETE מבצעת ביטול הקצאה רך:

המשתמש מוסר מהצוות שלכם.
אם החשבון אינו שייך לאף צוות פעיל אחר, הוא מושעה כך שהאדם לא יוכל עוד להתחבר.
נתוני החשבון נשמרים. שליחה חוזרת של active: true (או יצירה מחדש) משחזרת את החברות בצוות.

המשמעות היא שביטול הקצאה של משתמש בצוות אחד לעולם אינו חוסם את גישתו לצוות אחר שהוא חבר בו.

איך עוקבים אחר ההקצאה?

החלונית פעילות הקצאה בדף האבטחה היא פיד חי: כל יצירה, עדכון, השבתה ומחיקה מופיעים בזמן אמת (יצירה, השבתה/מחיקה ושגיאות מסומנות בצבעים שונים). זהו לוח הבקרה למעקב אחר SCIM; אין צורך להפעיל שום דבר נוסף.

אבטחה

הטוקנים נשמרים רק כגיבוב SHA-256, ולכן Cliqer אינה יכולה להציג לכם טוקן שוב.
כל נקודות הקצה של SCIM מחייבות HTTPS ואת טוקן ה-Bearer.
כל פעולה מוגבלת לצוות של הטוקן; טוקן לעולם אינו יכול לקרוא או לשנות משתמשים של צוות אחר.

פתרון בעיות

401 Unauthorized: הטוקן חסר, שגוי או בוטל. יש להנפיק טוקן חדש.
404 על משתמש: המשתמש אינו חבר בצוות של הטוקן. SCIM רואה רק את המשתמשים של הצוות שלכם.
המשתמש לא נוצר: יש לוודא ש-userName הוא כתובת אימייל תקינה.

נושאים קשורים

תפקידי צוות (RBAC)

שליטה במה שחברי הצוות יכולים לנהל באמצעות תפקידים מובנים ומותאמים אישית.

תוכנית אב לפתרון

סקירת הארכיטקטורה של Cliqer לצוותי IT ורכש: רכיבים, מודל פריסה, זהויות, ריבוי דיירים ודרישות רשת.