Συχνές ερωτήσεις για την παροχή SCIM
Το SCIM δημιουργεί, ενημερώνει και απενεργοποιεί αυτόματα τα μέλη της ομάδας σας από τον
πάροχο ταυτότητας (IdP). Περιλαμβάνεται στο πρόγραμμα Enterprise ή στο πρόσθετο Enterprise για τα Presenter, Studio HD, Studio 4K και Studio 8K, και η ρύθμισή του γίνεται από την
ομάδα σας στο Πίνακας ελέγχου → Ομάδα → Ασφάλεια (/dash/team/security). Χρειάζεστε το
δικαίωμα ομάδας Διαχείριση ασφάλειας.
Πώς λειτουργεί με μια ματιά;
- Ο IdP σας καλεί τα τελικά σημεία SCIM 2.0 του Cliqer με ένα διακριτικό bearer.
- Το διακριτικό προσδιορίζει την ομάδα σας: δεν υπάρχει αναγνωριστικό ομάδας στο URL, επομένως χρησιμοποιείτε την ίδια βασική διεύθυνση 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) | PATCH /api/scim/v2/Users/{id} |
| Απενεργοποίηση / διαγραφή | DELETE /api/scim/v2/Users/{id} |
| Δυνατότητες | GET /api/scim/v2/ServiceProviderConfig |
Το φιλτράρισμα υποστηρίζει userName eq "..." (το χρησιμοποιούν τα Okta και Entra ID για την αποφυγή διπλοεγγραφών).
Οι μαζικές λειτουργίες και η παροχή ομάδων (Group) δεν υποστηρίζονται.
Ποια χαρακτηριστικά χρήστη χρησιμοποιούνται;
{
"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 (email), name.givenName, name.familyName, active και
externalId αντιστοιχίζονται. Τα υπόλοιπα χαρακτηριστικά γίνονται δεκτά και αγνοούνται.
Τι συμβαίνει κατά την απενεργοποίηση;
Η αποστολή active: false (μέσω PATCH) ή ενός DELETE εκτελεί ήπια
κατάργηση παροχής:
- Ο χρήστης αφαιρείται από την ομάδα σας.
- Αν ο λογαριασμός δεν ανήκει σε καμία άλλη ενεργή ομάδα, αναστέλλεται, ώστε το άτομο να μην μπορεί πλέον να συνδεθεί.
- Τα δεδομένα του λογαριασμού διατηρούνται. Η εκ νέου αποστολή
active: true(ή η εκ νέου δημιουργία) επαναφέρει τη συμμετοχή στην ομάδα.
Έτσι, η κατάργηση παροχής ενός χρήστη σε μία ομάδα δεν τον αποκλείει ποτέ από άλλη ομάδα στην οποία ανήκει.
Πώς παρακολουθώ την παροχή;
Ο πίνακας Δραστηριότητα παροχής στη σελίδα Ασφάλεια είναι μια ζωντανή ροή: κάθε δημιουργία, ενημέρωση, απενεργοποίηση και διαγραφή εμφανίζεται σε πραγματικό χρόνο (οι δημιουργίες, οι απενεργοποιήσεις/διαγραφές και τα σφάλματα επισημαίνονται με διαφορετικό χρώμα). Αυτός είναι ο πίνακας παρακολούθησης του SCIM· δεν χρειάζεται να ενεργοποιήσετε τίποτα επιπλέον.
Ασφάλεια
- Τα διακριτικά αποθηκεύονται μόνο ως κατακερματισμός SHA-256, γι' αυτό το Cliqer δεν μπορεί να σας εμφανίσει ξανά ένα διακριτικό.
- Όλα τα τελικά σημεία SCIM απαιτούν HTTPS και το διακριτικό bearer.
- Κάθε λειτουργία περιορίζεται στην ομάδα του διακριτικού· ένα διακριτικό δεν μπορεί ποτέ να διαβάσει ή να αλλάξει τους χρήστες άλλης ομάδας.
Αντιμετώπιση προβλημάτων
- 401 Unauthorized: το διακριτικό λείπει, είναι λανθασμένο ή έχει ανακληθεί. Δημιουργήστε νέο.
- 404 σε χρήστη: ο χρήστης δεν είναι μέλος της ομάδας του διακριτικού. Το SCIM βλέπει μόνο τους χρήστες της δικής σας ομάδας.
- Ο χρήστης δεν δημιουργήθηκε: ελέγξτε ότι το
userNameείναι έγκυρη διεύθυνση email.