Κέντρο βοήθειας Scribble Maps
Αλλαγή γλώσσας

SCIM Provisioning

Configuring SCIM User Provisioning

Το ScribbleMaps υποστηρίζει το SCIM 2.0 (System for Cross-domain Identity Management) για αυτοματοποιημένη παροχή και κατάργηση παροχής χρηστών. Αυτό σας επιτρέπει να συγχρονίζετε αυτόματα χρήστες από τον Πάροχο Ταυτότητας (IdP) στο ScribbleMaps, διασφαλίζοντας ότι η συμμετοχή στην ομάδα παραμένει συγχρονισμένη με τον κατάλογο του οργανισμού σας.

Το SCIM provisioning είναι διαθέσιμο στο 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) είναι ένα ανοιχτό πρότυπο που σας επιτρέπει αυτόματα να:

  • Παρέχετε χρήστες (Provision users) - Δημιουργείτε αυτόματα λογαριασμούς ScribbleMaps όταν ανατίθενται χρήστες στο IdP σας
  • Ενημερώνετε χρήστες - Διατηρείτε τις πληροφορίες χρηστών (όνομα, email) συγχρονισμένες
  • Καταργείτε την παροχή χρηστών (Deprovision users) - Απενεργοποιείτε αυτόματα λογαριασμούς όταν οι χρήστες αφαιρούνται από το IdP σας
  • Διαχειρίζεστε ρόλους - Αναθέτετε χρήστες σε ρόλους Admin ή Member μέσω της συμμετοχής σε ομάδες

Το SCIM λειτουργεί παράλληλα με το SSO (SAML/OIDC) για να παρέχει πλήρη διαχείριση του κύκλου ζωής ταυτότητας.

Πριν ξεκινήσετε

  • Πρέπει να είστε Team Owner για να ρυθμίσετε τις παραμέτρους του 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 σε ON

Σημείωση: Θα πρέπει να δημιουργήσετε ένα bearer token προτού ενεργοποιηθεί πλήρως το SCIM.

Βήμα 2: Δημιουργία Bearer Token

Το bearer token ταυτοποιεί τον Πάροχο Ταυτότητάς σας στο ScribbleMaps.

  1. Στη σελίδα ρυθμίσεων SCIM, κάντε κλικ στο Generate Token
  2. Αντιγράψτε το token αμέσως και αποθηκεύστε το με ασφάλεια

Σημαντικές Σημειώσεις Ασφαλείας:

  • Το token εμφανίζεται μόνο μία φορά - εάν το χάσετε, θα πρέπει να δημιουργήσετε ένα νέο
  • Αντιμετωπίστε αυτό το token όπως έναν κωδικό πρόσβασης - οποιοσδήποτε έχει το token μπορεί να διαχειριστεί τους χρήστες της ομάδας σας
  • Μπορείτε να ανακαλέσετε και να δημιουργήσετε ξανά το token ανά πάσα στιγμή εάν παραβιαστεί
  • Η ανάκληση ενός token διακόπτει αμέσως όλες τις λειτουργίες SCIM μέχρι να ρυθμιστεί ένα νέο token

Βήμα 3: Ρύθμιση παραμέτρων του Παρόχου Ταυτότητας

Χρησιμοποιήστε τα ακόλουθα στοιχεία για να ρυθμίσετε το ScribbleMaps ως εφαρμογή SCIM στο IdP σας:

Ρύθμιση Τιμή
SCIM Base URL https://api.scribblemaps.com/scim/v2
Authentication Method HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unique Identifier userName (email address)

Αναφορά SCIM Endpoints

Endpoint Σκοπός
/scim/v2/Users Παροχή και διαχείριση χρηστών
/scim/v2/Groups Διαχείριση συμμετοχής σε ρόλους/ομάδες
/scim/v2/ServiceProviderConfig Δυνατότητες SCIM (εντοπισμός)
/scim/v2/ResourceTypes Υποστηριζόμενοι τύποι πόρων (εντοπισμός)
/scim/v2/Schemas Σχήματα χρηστών και ομάδων (εντοπισμός)

Βήμα 4: Ορισμός Προεπιλεγμένης Ανάθεσης Προϊόντος (Προαιρετικό)

Μπορείτε να εκχωρείτε αυτόματα μια άδεια χρήσης προϊόντος στους χρήστες όταν αυτοί δημιουργούνται μέσω SCIM:

  1. Στη σελίδα ρυθμίσεων SCIM, βρείτε το Default Product Assignment
  2. Επιλέξτε ένα προϊόν:
    • None - Οι χρήστες δημιουργούνται χωρίς προϊόν (ανάθεση χειροκίνητα αργότερα)
    • Viewer - Πρόσβαση μόνο για προβολή
    • Pro Basic - Βασικές δυνατότητες επεξεργασίας
    • Pro Business - Πλήρης πρόσβαση σε όλες τις δυνατότητες
  3. Κάντε κλικ στο Save

Σημείωση: Στους χρήστες θα εκχωρηθεί προϊόν μόνο εάν υπάρχουν διαθέσιμες θέσεις. Εάν δεν υπάρχουν διαθέσιμες θέσεις, ο χρήστης δημιουργείται αλλά παραμένει χωρίς ανάθεση.

Βήμα 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: Επικολλήστε το ScribbleMaps SCIM token σας
  6. Κάντε κλικ στο Test API Credentials για επαλήθευση
  7. Μεταβείτε στο Provisioning > To App και ενεργοποιήστε:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Μεταβείτε στην καρτέλα Assignments για να αναθέσετε χρήστες ή ομάδες

Microsoft Entra ID (Azure AD)

  1. Στο Azure Portal, μεταβείτε στο Microsoft Entra ID > Enterprise Applications
  2. Επιλέξτε την εφαρμογή σας ScribbleMaps (ή δημιουργήστε μία)
  3. Μεταβείτε στο Provisioning > Get Started
  4. Ορίστε το Provisioning Mode σε Automatic
  5. Κάτω από το Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Επικολλήστε το ScribbleMaps SCIM token σας
  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: Επικολλήστε το ScribbleMaps SCIM token σας
  5. Μεταβείτε στην καρτέλα Provisioning και ενεργοποιήστε το provisioning
  6. Μεταβείτε στην καρτέλα Users για να αναθέσετε χρήστες

JumpCloud

  1. Στο JumpCloud Admin, μεταβείτε στο SSO Applications
  2. Κάντε κλικ στο + για να προσθέσετε μια νέα εφαρμογή
  3. Επιλέξτε Custom SCIM
  4. Ρυθμίστε τις παραμέτρους:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Επικολλήστε το ScribbleMaps SCIM token σας
    • Authentication: Bearer Token
  5. Κάντε κλικ στο Test Connection
  6. Ρυθμίστε τις αντιστοιχίσεις χαρακτηριστικών (attribute mappings)
  7. Αναθέστε ομάδες χρηστών στην εφαρμογή

Υποστηριζόμενες Λειτουργίες SCIM

Λειτουργίες Χρηστών

Λειτουργία Μέθοδος Υποστηρίζεται Περιγραφή
List Users GET /Users Ναι Ανάκτηση όλων των χρηστών με σελιδοποίηση και φιλτράρισμα
Get User GET /Users/{id} Ναι Ανάκτηση συγκεκριμένου χρήστη βάσει ID
Create User POST /Users Ναι Παροχή νέου χρήστη
Replace User PUT /Users/{id} Ναι Πλήρης ενημέρωση των χαρακτηριστικών του χρήστη
Update User PATCH /Users/{id} Ναι Μερική ενημέρωση των χαρακτηριστικών του χρήστη
Delete User DELETE /Users/{id} Ναι Απενεργοποίηση χρήστη (soft delete)

Λειτουργίες Ομάδων

Λειτουργία Μέθοδος Υποστηρίζεται Περιγραφή
List Groups GET /Groups Ναι Επιστρέφει τις ομάδες ρόλων Admin και Member
Get Group GET /Groups/{id} Ναι Ανάκτηση ομάδας με λίστα μελών
Update Group PATCH /Groups/{id} Ναι Προσθήκη/αφαίρεση μελών από ομάδες ρόλων
Create Group POST /Groups Όχι Δεν υποστηρίζεται (οι ρόλοι είναι σταθεροί)

Υποστηριζόμενα Χαρακτηριστικά Χρήστη

Χαρακτηριστικό SCIM Πεδίο ScribbleMaps Απαιτείται
userName Διεύθυνση email Ναι
externalId Εξωτερικό αναγνωριστικό IdP Όχι
name.givenName Όνομα Όχι
name.familyName Επώνυμο Όχι
displayName Όνομα εμφάνισης Όχι
active Κατάσταση λογαριασμού Όχι
emails[].value Διεύθυνση email Όχι

Υποστηριζόμενα Φίλτρα

Φίλτρο Παράδειγμα
Φιλτράρισμα βάσει email userName eq "[email protected]"
Φιλτράρισμα βάσει εξωτερικού ID externalId eq "12345"
Φιλτράρισμα βάσει κατάστασης active eq true

Διαχείριση Κύκλου Ζωής Χρηστών

Όταν ένας Χρήστης Λαμβάνει Παροχή (Provisioned)

  1. Δημιουργείται ένας νέος λογαριασμός μέλους ομάδας στο ScribbleMaps
  2. Οι πληροφορίες χρήστη (όνομα, email) συμπληρώνονται από το IdP σας
  3. Εάν έχει ρυθμιστεί ένα προεπιλεγμένο προϊόν και υπάρχουν διαθέσιμες θέσεις, εκχωρείται αυτόματα μια άδεια χρήσης
  4. Ο χρήστης μπορεί να συνδεθεί αμέσως μέσω SSO (εάν έχει ρυθμιστεί)

Όταν ένας Χρήστης Ενημερώνεται

  1. Τα χαρακτηριστικά χρήστη (όνομα, όνομα εμφάνισης) ενημερώνονται ώστε να ταιριάζουν με το IdP σας
  2. Οι αλλαγές email συγχρονίζονται (εκτός εάν ο χρήστης έχει συνδέσει τον λογαριασμό του)

Όταν Καταργείται η Παροχή ενός Χρήστη (Deprovisioned)

  1. Ο λογαριασμός του χρήστη απενεργοποιείται (soft delete)
  2. Όλες οι άδειες χρήσης προϊόντων αφαιρούνται, ελευθερώνοντας θέσεις
  3. Όλες οι ενεργές συνεδρίες ακυρώνονται αμέσως
  4. Ο χρήστης δεν μπορεί πλέον να συνδεθεί
  5. Τα δεδομένα και οι χάρτες του χρήστη διατηρούνται (δεν διαγράφονται)
  6. Ο λογαριασμός μπορεί να επανενεργοποιηθεί εάν γίνει εκ νέου παροχή (re-provisioned) του χρήστη

Διαχείριση Ρόλων μέσω Ομάδων

Το ScribbleMaps εκθέτει δύο ομάδες ρόλων μέσω SCIM:

ID Ομάδας Ρόλος Δικαιώματα
admin Διαχειριστής Διαχείριση ρυθμίσεων ομάδας, χρηστών και χρέωσης
member Μέλος Τυπική πρόσβαση μέλους ομάδας

Για να ορίσετε έναν χρήστη ως διαχειριστή, προσθέστε τον στην ομάδα admin μέσω SCIM PATCH. Ο ρόλος Owner δεν μπορεί να τροποποιηθεί μέσω SCIM.

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

Συνήθη Θέματα

"401 Unauthorized" ή "Invalid token"

  • Βεβαιωθείτε ότι το bearer token είναι σωστό και δεν έχει ανακληθεί
  • Βεβαιωθείτε ότι το token μεταβιβάζεται στην κεφαλίδα Authorization ως Bearer YOUR_TOKEN
  • Ελέγξτε εάν το token έχει λήξει (εάν είχε οριστεί ημερομηνία λήξης)
  • Δημιουργήστε ένα νέο token εάν χρειάζεται

"409 Conflict" - Ο χρήστης υπάρχει ήδη

  • Υπάρχει ήδη ένας χρήστης με αυτό το email στην ομάδα σας
  • Εάν ο υπάρχων χρήστης είχε απενεργοποιηθεί, το SCIM θα τον επανενεργοποιήσει αυτόματα
  • Ελέγξτε για διπλότυπες διευθύνσεις email στο IdP σας

"400 Bad Request" - Λείπει απαιτούμενο πεδίο

  • Βεβαιωθείτε ότι το userName (email) περιλαμβάνεται στο αίτημα
  • Βεβαιωθείτε ότι η μορφή του email είναι έγκυρη
  • Ελέγξτε τη ρύθμιση παραμέτρων αντιστοίχισης χαρακτηριστικών (attribute mapping) του IdP σας

Οι χρήστες δημιουργήθηκαν αλλά δεν έχει εκχωρηθεί προϊόν

  • Ελέγξτε εάν έχει ρυθμιστεί ένα προεπιλεγμένο προϊόν στις ρυθμίσεις SCIM
  • Βεβαιωθείτε ότι έχετε διαθέσιμες θέσεις για το προεπιλεγμένο προϊόν
  • Μπορείτε να εκχωρήσετε προϊόντα στους χρήστες χειροκίνητα στο Team Settings

Οι αλλαγές χρηστών δεν συγχρονίζονται

  • Ορισμένα IdP συγχρονίζονται βάσει προγράμματος (π.χ. κάθε 40 λεπτά για το Azure AD)
  • Δοκιμάστε να επιβάλετε έναν χειροκίνητο συγχρονισμό στο IdP σας
  • Βεβαιωθείτε ότι το SCIM είναι ακόμα ενεργοποιημένο και το token είναι έγκυρο

Η δοκιμή σύνδεσης απέτυχε

  • Βεβαιωθείτε ότι το SCIM Base URL είναι ακριβώς https://api.scribblemaps.com/scim/v2
  • Ensure there are no trailing slashes or typos
  • Ελέγξτε εάν το δίκτυο/τείχος προστασίας σας επιτρέπει εξερχόμενο HTTPS προς το api.scribblemaps.com
     

Χρειάζεστε Βοήθεια;

Εάν αντιμετωπίζετε προβλήματα με το SCIM provisioning, επικοινωνήστε με την ομάδα υποστήριξής μας παρέχοντας:

  • Το όνομα της Ομάδας σας (Team name)
  • Τον Πάροχο Ταυτότητας (Identity Provider) που χρησιμοποιείτε
  • Τυχόν μηνύματα σφάλματος από τα αρχεία καταγραφής παροχής (provisioning logs) του IdP σας
  • Στιγμιότυπα οθόνης της ρύθμισης παραμέτρων του SCIM σας (με καλυμμένο το token)

Είμαστε εδώ για να σας βοηθήσουμε να ρυθμίσετε το SCIM provisioning για τον οργανισμό σας.

Τελευταία ενημέρωση