Σύνδεση

Συχνές ερωτήσεις για την παροχή SCIM

Αυτοματοποιήστε την παροχή χρηστών στην ομάδα σας στο Cliqer με το SCIM 2.0.

Το 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 εκτελεί ήπια κατάργηση παροχής:

  1. Ο χρήστης αφαιρείται από την ομάδα σας.
  2. Αν ο λογαριασμός δεν ανήκει σε καμία άλλη ενεργή ομάδα, αναστέλλεται, ώστε το άτομο να μην μπορεί πλέον να συνδεθεί.
  3. Τα δεδομένα του λογαριασμού διατηρούνται. Η εκ νέου αποστολή active: true (ή η εκ νέου δημιουργία) επαναφέρει τη συμμετοχή στην ομάδα.

Έτσι, η κατάργηση παροχής ενός χρήστη σε μία ομάδα δεν τον αποκλείει ποτέ από άλλη ομάδα στην οποία ανήκει.

Πώς παρακολουθώ την παροχή;

Ο πίνακας Δραστηριότητα παροχής στη σελίδα Ασφάλεια είναι μια ζωντανή ροή: κάθε δημιουργία, ενημέρωση, απενεργοποίηση και διαγραφή εμφανίζεται σε πραγματικό χρόνο (οι δημιουργίες, οι απενεργοποιήσεις/διαγραφές και τα σφάλματα επισημαίνονται με διαφορετικό χρώμα). Αυτός είναι ο πίνακας παρακολούθησης του SCIM· δεν χρειάζεται να ενεργοποιήσετε τίποτα επιπλέον.

Ασφάλεια

  • Τα διακριτικά αποθηκεύονται μόνο ως κατακερματισμός SHA-256, γι' αυτό το Cliqer δεν μπορεί να σας εμφανίσει ξανά ένα διακριτικό.
  • Όλα τα τελικά σημεία SCIM απαιτούν HTTPS και το διακριτικό bearer.
  • Κάθε λειτουργία περιορίζεται στην ομάδα του διακριτικού· ένα διακριτικό δεν μπορεί ποτέ να διαβάσει ή να αλλάξει τους χρήστες άλλης ομάδας.

Αντιμετώπιση προβλημάτων

  • 401 Unauthorized: το διακριτικό λείπει, είναι λανθασμένο ή έχει ανακληθεί. Δημιουργήστε νέο.
  • 404 σε χρήστη: ο χρήστης δεν είναι μέλος της ομάδας του διακριτικού. Το SCIM βλέπει μόνο τους χρήστες της δικής σας ομάδας.
  • Ο χρήστης δεν δημιουργήθηκε: ελέγξτε ότι το userName είναι έγκυρη διεύθυνση email.

Σχετικά θέματα