6 Χρήστες και πρόσβαση API
Το Sophea Portal διαχειρίζεται τους χρήστες, τις προσκλήσεις, τις Ομάδες και την πρόσβαση σε Χώρους εργασίας. Το Nous λαμβάνει την προκύπτουσα ιδιότητα μέλους και τον ρόλο Χώρου εργασίας, ώστε να εξουσιοδοτεί τη συνομιλία και τη διαχείριση. Χρησιμοποιήστε αυτή τη σελίδα για να επαληθεύσετε ότι η πρόσβαση του Portal έχει φτάσει στο Nous και για να διαχειριστείτε προσωπικά διακριτικά και κλειδιά API λογαριασμών υπηρεσίας.
Για οδηγίες σχετικά με την πρόσκληση χρηστών, την εκχώρηση άμεσης πρόσβασης σε Χώρο εργασίας ή την παροχή πρόσβασης μέσω Ομάδας, ανατρέξτε στην ενότητα Οργανισμοί και πρόσβαση σε Χώρους εργασίας.
6.1 Επαλήθευση συγχρονισμένων χρηστών
Ανοίξτε τις Ρυθμίσεις και επιλέξτε Χρήστες & Αιτήματα ή μεταβείτε στη διεύθυνση /app/admin/users.
Ο πίνακας χρηστών εμφανίζει τα άτομα που είναι επί του παρόντος γνωστά σε αυτόν τον Χώρο εργασίας Nous, συμπεριλαμβανομένων του email, του συγχρονισμένου ρόλου και της κατάστασης λογαριασμού. Αντιμετωπίστε τον ως επιφάνεια επαλήθευσης και όχι ως πηγή αλήθειας για την πρόσβαση.
Αν η πρόσβαση άλλαξε στο Portal, αλλά το Nous εξακολουθεί να εμφανίζει την προηγούμενη κατάσταση:
- Επιβεβαιώστε ότι το άτομο εξακολουθεί να έχει ενεργή πηγή πρόσβασης στο Portal.
- Ελέγξτε τις άμεσες εκχωρήσεις και κάθε Ομάδα στην οποία ανήκει. Η αφαίρεση μίας πηγής δεν αφαιρεί την πρόσβαση όταν παραμένει κάποια άλλη.
- Ζητήστε από το άτομο να ανοίξει ξανά τον Χώρο εργασίας από το Portal, ώστε να συγχρονιστεί η τρέχουσα αντιστοίχιση λογαριασμού.
- Αν η κατάσταση εξακολουθεί να διαφέρει, αναφέρετε στην υποστήριξη της Sophea το όνομα του Χώρου εργασίας, το email του χρήστη, τον αναμενόμενο ρόλο και την πηγή πρόσβασης που εμφανίζεται στο Portal.
Μην προσκαλείτε επανειλημμένα το άτομο και μη δημιουργείτε δεύτερο λογαριασμό. Οι προσκλήσεις συνδέονται με την προσκεκλημένη διεύθυνση email και οι διπλότυπες ταυτότητες δυσκολεύουν τον έλεγχο της πρόσβασης.
6.2 Διαγραφή συγχρονισμένου χρήστη
Για έναν ανενεργό λογαριασμό στην ενότητα Χρήστες, επιλέξτε Delete User και ελέγξτε την προειδοποίηση πριν από την επιβεβαίωση. Αφαιρέστε πρώτα την πρόσβαση στον Χώρο εργασίας από το Portal· η διαγραφή λογαριασμού Nous είναι οριστική ενέργεια εκκαθάρισης. Αφαιρεί τον λογαριασμό και το ιστορικό συνεδριών. Τα αρχεία στα οποία είχε πρόσβαση μόνο ο συγκεκριμένος χρήστης διαγράφονται. Τα αρχεία που παραμένουν κοινόχρηστα μέσω έργου ή agent διατηρούνται για όσους εξακολουθούν να έχουν πρόσβαση. Η διαγραφή δεν μπορεί να αναιρεθεί.
Η διαγραφή ενός ατόμου αφαιρεί επίσης ό,τι παραχωρούσε η δική του σύνδεση στην αναζήτηση:
- Οι ιδιωτικές συνδέσεις που δημιούργησε με τη δική του σύνδεση διαγράφονται. Το Nous σας ζητά να δοκιμάσετε ξανά σε λίγα λεπτά, όσο ενημερώνεται η αναζήτηση· επιλέξτε ξανά Delete User μέχρι να ολοκληρωθεί.
- Μια σύνδεση του Χώρου εργασίας που εξακολουθεί να χρησιμοποιεί τη σύνδεσή του εμποδίζει τη διαγραφή. Διαγράψτε τη ή συνδέστε την ξανά στο Portal με άλλον λογαριασμό και δοκιμάστε ξανά.
- Η πρόσβαση που παραχωρεί στο email του το ίδιο το σύστημα προέλευσης, όπως τα δικαιώματα SharePoint ή Google Drive που διαβάζει μια σύνδεση με συγχρονισμό δικαιωμάτων, δεν είναι προσωπική και διατηρείται.
Μετά τη διαγραφή, καμία σύνδεση του Portal δεν μπορεί να συνδεθεί ξανά με τον λογαριασμό αυτού του email, ακόμη κι αν αργότερα προστεθεί κάποιος με το ίδιο email. Το άτομο αυτό μπορεί πάντως να προσθέσει τη δική του προσωπική σύνδεση από το Nous.
6.3 Κατανόηση των ρόλων Nous
Το Portal υπολογίζει τον ενεργό ρόλο Χώρου εργασίας πριν συγχρονίσει τον λογαριασμό στο Nous.
| Ρόλος Nous | Τυπική σημασία στον Χώρο εργασίας | Δυνατότητες |
|---|---|---|
| Admin | Κάτοχος ή διαχειριστής Χώρου εργασίας | Διαχείριση ρυθμίσεων Χώρου εργασίας, συνδέσεων, συνόλων εγγράφων, agents, ενεργειών, ενσωματώσεων και συγχρονισμένων χρηστών. |
| Basic | Μέλος Χώρου εργασίας | Χρήση συνομιλίας, έργων, διαθέσιμης γνώσης και κοινόχρηστων agents. Τα μέλη μπορούν επίσης να δημιουργούν δικά τους έργα και agents όπου είναι ενεργοποιημένο το προϊόν. |
| Limited | Περιορισμένος λογαριασμός υπηρεσίας | Ανάγνωση υποστηριζόμενων πόρων και αποστολή μηνυμάτων συνομιλίας χωρίς γενικά δικαιώματα διαχείρισης. |
Οι ρόλοι Οργανισμού και οι ενεργοί ρόλοι Χώρου εργασίας διαφέρουν. Ένας διαχειριστής Οργανισμού αποκτά δικαιώματα διαχειριστή Χώρου εργασίας σε όλους τους ενεργούς Χώρους εργασίας αυτού του Οργανισμού. Ένας άμεσος διαχειριστής Χώρου εργασίας διαχειρίζεται μόνο τον συγκεκριμένο Χώρο εργασίας και δεν αποκτά διαχείριση χρηστών ή Ομάδων Οργανισμού.
6.4 Προσωπικά διακριτικά API
Κάθε μέλος Χώρου εργασίας μπορεί να δημιουργήσει προσωπικό διακριτικό στο Nous. Ανοίξτε το μενού χρήστη, επιλέξτε Ρυθμίσεις Χρήστη > Λογαριασμοί & Πρόσβαση και μετά Δημιουργία διακριτικού. Ονομάστε το διακριτικό, επιλέξτε διάρκεια ισχύος και αντιγράψτε την τιμή του όταν εμφανιστεί. Το Nous εμφανίζει ολόκληρη την τιμή μόνο μία φορά. Τα διακριτικά που δημιουργούνται εδώ αρχίζουν με nous_pat_.
Το προσωπικό διακριτικό ενεργεί ως ο κάτοχός του στον τρέχοντα Χώρο εργασίας Nous. Η διαθεσιμότητα agents, τα ευρετηριασμένα έγγραφα και οι συνδεδεμένες πηγές ακολουθούν την πρόσβαση αυτού του ατόμου. Αποθηκεύστε το διακριτικό σε διαχειριστή μυστικών και ανακαλέστε το από την ίδια οθόνη όταν δεν χρειάζεται πια. Το διακριτικό αφορά το API συνομιλίας του Nous.
Για αιτήματα, παραμέτρους και επόμενα μηνύματα, δείτε τη Χρήση του API συνομιλίας του Nous.
6.5 Λογαριασμοί υπηρεσίας
Οι λογαριασμοί υπηρεσίας αντιπροσωπεύουν δέσμες ενεργειών, προγραμματισμένες εργασίες και ενσωματώσεις που καλούν το API του Nous χωρίς συνεδρία προγράμματος περιήγησης. Περιορίζονται στον Χώρο εργασίας και χρησιμοποιούν διακριτικά bearer.
Ο οδηγός API συνομιλίας του Nous ισχύει και για τα διακριτικά λογαριασμών υπηρεσίας.
Ανοίξτε Ρυθμίσεις > Λογαριασμοί Υπηρεσίας ή μεταβείτε στη διεύθυνση /app/admin/service-accounts.
6.5.1 Δημιουργία λογαριασμού υπηρεσίας
- Επιλέξτε New Service Account (Νέος λογαριασμός υπηρεσίας).
- Πληκτρολογήστε ένα όνομα που προσδιορίζει το σύστημα και τον σκοπό, για παράδειγμα
Nightly policy check. - Επιλέξτε δικαιώματα Basic ή Limited. Οι λογαριασμοί υπηρεσίας Admin παρέχονται μέσω του Portal και όχι από αυτή τη σελίδα του Nous.
- Επιλέξτε Create Account (Δημιουργία λογαριασμού).
- Αντιγράψτε ή κατεβάστε αμέσως το διακριτικό και αποθηκεύστε το σε διαχειριστή μυστικών.
Στείλτε το διακριτικό ως διαπιστευτήριο bearer:
curl -H "Authorization: Bearer $SOPHEA_SERVICE_TOKEN" \
https://nous.example.com/api/me6.5.2 Επιλογή του ελάχιστου ρόλου
- Ο ρόλος Admin μπορεί να καλεί διαχειριστικά endpoints. Χρησιμοποιήστε τον μόνο όταν η ενσωμάτωση πρέπει να αλλάζει τη ρύθμιση του Χώρου εργασίας.
- Ο ρόλος Basic είναι η προεπιλογή για αυτοματισμούς που χρειάζονται συνηθισμένα API επιπέδου χρήστη.
- Ο ρόλος Limited είναι κατάλληλος για ενσωματώσεις που χρειάζονται μόνο υποστηριζόμενες λειτουργίες ανάγνωσης και συνομιλίας.
Δημιουργήστε ξεχωριστούς λογαριασμούς υπηρεσίας για διαφορετικά συστήματα. Έτσι, κάθε ενσωμάτωση αποκτά ανεξάρτητη ταυτότητα ελέγχου και μπορείτε να εναλλάξετε ή να ανακαλέσετε ένα διακριτικό χωρίς να διακόψετε τις άλλες.
6.5.3 Εναλλαγή ή ανάκληση διακριτικού
- Χρησιμοποιήστε την επιλογή Regenerate (Νέα δημιουργία) όταν ένα διακριτικό μπορεί να έχει εκτεθεί ή φτάνει στην ημερομηνία εναλλαγής του. Το προηγούμενο διακριτικό παύει αμέσως να λειτουργεί.
- Χρησιμοποιήστε την επιλογή Delete Account (Διαγραφή λογαριασμού) όταν η ενσωμάτωση αποσύρεται. Οι υπάρχουσες εγγραφές ελέγχου εξακολουθούν να αποδίδονται σε αυτόν τον λογαριασμό υπηρεσίας. Αν ο λογαριασμός υπηρεσίας έχει προσωπικές συνδέσεις, το Nous τις αφαιρεί πρώτα και σας ζητά να δοκιμάσετε ξανά σε λίγα λεπτά.
Μετά από κάθε εναλλαγή, επιβεβαιώστε ότι το σύστημα που πραγματοποιεί τις κλήσεις χρησιμοποιεί το νέο διακριτικό πριν θεωρήσετε την ενέργεια ολοκληρωμένη.