Μετάβαση στο κύριο περιεχόμενο

Single Sign-On για εγκατάσταση On-Premise

Αυτή η σελίδα απευθύνεται σε διαχειριστές εγκατάστασης on-premise του MonoChat. Εξηγεί πώς να επιτρέψετε στο προσωπικό σας να συνδέεται με τον πάροχο ταυτότητας (IdP) της εταιρείας σας μέσω OpenID Connect (OIDC), για παράδειγμα Microsoft Entra ID, Okta, Keycloak, AD FS ή Google Workspace.

Το single sign-on ρυθμίζεται για ολόκληρη την εγκατάσταση στις ρυθμίσεις του διακομιστή και όχι ανά χώρο εργασίας. Ένας λογαριασμός MonoChat μπορεί να ανήκει σε περισσότερους χώρους εργασίας και τα άτομα συνδέονται πριν επιλέξουν έναν. Η σύνδεση δίνει λογαριασμό, όχι πρόσβαση: ένα άτομο βλέπει έναν χώρο εργασίας μόνο αφού τον προσκαλέσει ο χώρος αυτός και του δώσει ρόλο.

Πώς λειτουργεί η σύνδεση​

Όταν κάποιος κάνει κλικ στο κουμπί SSO στη σελίδα σύνδεσης, το MonoChat ανοίγει τη σελίδα σύνδεσης του IdP σας σε αναδυόμενο παράθυρο. Αφού το άτομο συνδεθεί εκεί, ο IdP επιστρέφει το πρόγραμμα περιήγησης στο MonoChat με έναν κωδικό μίας χρήσης. Ο διακομιστής του MonoChat ανταλλάσσει τον κωδικό με ένα ID token και το ελέγχει πριν συνδέσει το άτομο:

  • Τα endpoints και τα κλειδιά υπογραφής του IdP διαβάζονται από το έγγραφο ανακάλυψής του, <issuer>/.well-known/openid-configuration, σε κάθε σύνδεση.
  • Η σύνδεση χρησιμοποιεί τη ροή authorization code με PKCE (S256), ένα state και ένα nonce. Ένα αίτημα σύνδεσης ισχύει για 10 λεπτά και μπορεί να χρησιμοποιηθεί μία φορά.
  • Το ID token πρέπει να είναι υπογεγραμμένο με ένα από τα κλειδιά του IdP και να φέρει τον issuer σας (iss), το client ID σας (aud), το nonce του αιτήματος και ημερομηνία λήξης (exp) που δεν έχει παρέλθει.
  • Το ID token πρέπει να περιέχει τη διεύθυνση e-mail του ατόμου (email). Η σύνδεση απορρίπτεται όταν ο IdP δηλώνει ότι η διεύθυνση δεν είναι επαληθευμένη (email_verified: false).

1. Καταχωρίστε το MonoChat στον πάροχο ταυτότητάς σας​

Δημιουργήστε μια εφαρμογή (έναν client) για το MonoChat στον IdP σας με αυτές τις τιμές:

Ρύθμιση στον IdPΤιμή
Τύπος εφαρμογήςΕφαρμογή web με client secret (confidential client)
Redirect URI σύνδεσηςhttps://<your MonoChat domain>/api/oauth/oidc/redirect
Τύπος grantAuthorization code
Scopesopenid email profile
Ταυτοποίηση client στο token endpointClient secret που αποστέλλεται με HTTP Basic authentication (client_secret_basic)
Redirect URI μετά την αποσύνδεσηhttps://<your MonoChat domain>/
URI για back-channel logouthttps://<your MonoChat domain>/api/oauth/oidc/backchannel-logout
URI για front-channel logout (μόνο αν ο IdP σας δεν έχει back-channel logout)https://<your MonoChat domain>/api/oauth/oidc/frontchannel-logout, με υποχρεωτική τη συνεδρία (iss και sid)

Βεβαιωθείτε ότι το ID token περιέχει το claim email. Σημειώστε το client ID, το client secret και τον issuer. Ο issuer είναι η τιμή issuer στο έγγραφο ανακάλυψης του IdP. Οι τυπικές μορφές:

Πάροχος ταυτότηταςIssuer
Microsoft Entra IDhttps://login.microsoftonline.com/<tenant id>/v2.0
Oktahttps://<your Okta domain>/oauth2/default, ή https://<your Okta domain>
Keycloakhttps://<your Keycloak host>/realms/<realm>
AD FS (2016 ή νεότερο)https://<your AD FS host>/adfs
Google Workspacehttps://accounts.google.com

Ανοίξτε το <issuer>/.well-known/openid-configuration σε ένα πρόγραμμα περιήγησης και αντιγράψτε ακριβώς την τιμή issuer, συμπεριλαμβανομένου ενός τελικού / αν υπάρχει. Το MonoChat αρνείται να συνδέσει οποιονδήποτε όταν οι δύο τιμές διαφέρουν.

2. Προσθέστε τις ρυθμίσεις​

Προσθέστε τα μπλοκ oidc στις ρυθμίσεις του διακομιστή και επανεκκινήστε το MonoChat. Το δημόσιο μπλοκ μπαίνει κάτω από το public.oauth, το μυστικό μπλοκ κάτω από το oauth:

{
"oauth": {
"oidc": {
"clientSecret": "<client secret>",
"autoCreateAccounts": true,
"allowedEmailDomains": ["company.com"]
}
},
"public": {
"oauth": {
"oidc": {
"issuer": "https://login.microsoftonline.com/<tenant id>/v2.0",
"clientId": "<client id>",
"redirectPath": "/api/oauth/oidc/redirect",
"scope": "openid email profile",
"buttonLabel": "Sign in with Company SSO"
}
}
}
}
ΡύθμισηΤι κάνει
public.oauth.oidc.issuerΟ issuer από το βήμα 1
public.oauth.oidc.clientIdΤο client ID από το βήμα 1
public.oauth.oidc.redirectPathΗ διαδρομή του redirect URI από το βήμα 1
public.oauth.oidc.scopeΤα scopes που ζητά το MonoChat
public.oauth.oidc.buttonLabelΤο κείμενο του κουμπιού σύνδεσης. Αν είναι κενό, εμφανίζεται το «Sign in with SSO» στη γλώσσα του ατόμου
oauth.oidc.clientSecretΤο client secret. Παραμένει στον διακομιστή
oauth.oidc.autoCreateAccountsΤο true δημιουργεί τον λογαριασμό MonoChat κατά την πρώτη σύνδεση ενός ατόμου με SSO, ακόμη και όταν η εγγραφή γίνεται μόνο με πρόσκληση (public.disableSignup)
oauth.oidc.allowedEmailDomainsΜόνο άτομα των οποίων η διεύθυνση e-mail ανήκει σε ένα από αυτά τα domains μπορούν να συνδεθούν μέσω SSO. Παραλείψτε το για να επιτρέψετε όλα τα domains

Το κουμπί SSO εμφανίζεται τότε στη σελίδα σύνδεσης.

Ποιος μπορεί να συνδεθεί​

  • Νέα άτομα. Με autoCreateAccounts: true, η πρώτη σύνδεση ενός ατόμου με SSO δημιουργεί τον λογαριασμό του. Χωρίς αυτό, ο λογαριασμός δημιουργείται μόνο όταν το public.disableSignup είναι απενεργοποιημένο ή όταν το άτομο συνδέεται από μια πρόσκληση.
  • Άτομα που έχουν ήδη λογαριασμό με την ίδια διεύθυνση e-mail. Με oauth.autoMerge: true, η πρώτη σύνδεση με SSO συνδέει το SSO με τον υπάρχοντα λογαριασμό, αλλά μόνο όταν το ID token δηλώνει ότι η διεύθυνση είναι επαληθευμένη (email_verified: true). Διαφορετικά, και πάντα χωρίς autoMerge, το MonoChat ζητά από το άτομο να συνδεθεί μία φορά με τον κωδικό πρόσβασής του και συνδέει τότε το SSO με τον λογαριασμό· η αποδοχή πρόσκλησης σε έναν χώρο εργασίας κάνει επίσης τη σύνδεση. Το Microsoft Entra ID και το AD FS δεν στέλνουν το email_verified, οπότε με αυτά κρατήστε ενεργή τη σύνδεση με κωδικό πρόσβασης μέχρι να συνδέσουν όλοι το SSO ή προσκαλέστε ξανά τα άτομα.
  • Επιτρεπόμενα domains. Με allowedEmailDomains, μια διεύθυνση σε οποιοδήποτε άλλο domain απορρίπτεται. Για το Google Workspace (issuer https://accounts.google.com), το MonoChat ελέγχει το claim hd, το domain Workspace του λογαριασμού, αντί για τη διεύθυνση e-mail, επειδή ένας προσωπικός λογαριασμός Google μπορεί να χρησιμοποιεί διεύθυνση σε οποιοδήποτε domain.

Κάντε το SSO τη μοναδική μέθοδο σύνδεσης​

  1. Ορίστε το public.auth.methods σε ["oidc"]. Η σελίδα σύνδεσης εμφανίζει τότε μόνο το κουμπί SSO και ο διακομιστής απορρίπτει τη σύνδεση με κωδικό πρόσβασης και μέσω κοινωνικών δικτύων.
  2. Οι root super users (χρήστες με τον ρόλο root super στον root χώρο εργασίας) μπορούν ακόμη να συνδεθούν με τον κωδικό πρόσβασής τους στο /auth/signin?fallback=1, ώστε η εγκατάσταση να μη μείνει ποτέ κλειδωμένη αν ο IdP είναι εκτός λειτουργίας.
  3. Για να εμποδίσετε τους νέους λογαριασμούς SSO να ανοίγουν δικούς τους χώρους εργασίας, ορίστε το public.disableTenantCreation σε true. Μόνο άτομα με τον κατάλληλο ρόλο σε έναν χώρο εργασίας μπορούν τότε να δημιουργούν χώρους εργασίας κάτω από αυτόν.

Αποσύνδεση​

Για όσους συνδέθηκαν μέσω SSO, η αποσύνδεση λειτουργεί και προς τις δύο κατευθύνσεις:

  • Αποσύνδεση από το MonoChat. Το MonoChat στέλνει το πρόγραμμα περιήγησης στη σελίδα αποσύνδεσης του IdP σας (end_session_endpoint στο έγγραφο ανακάλυψης) με το client ID και το redirect URI μετά την αποσύνδεση. Ο IdP τερματίζει τη συνεδρία του και επιστρέφει το άτομο στο MonoChat. Αν το έγγραφο ανακάλυψης δεν έχει end_session_endpoint, το MonoChat αποσυνδέει το άτομο μόνο από το MonoChat.
  • Αποσύνδεση στον IdP. Με back-channel logout, ο IdP στέλνει στο MonoChat ένα υπογεγραμμένο logout token. Το MonoChat ελέγχει την υπογραφή, τον issuer, το client ID, το συμβάν αποσύνδεσης και τον χρόνο έκδοσής του (το πολύ 10 λεπτά πριν), καθώς και ότι δεν περιέχει nonce. Στη συνέχεια τερματίζει κάθε σύνδεση στο MonoChat που προήλθε από εκείνη τη συνεδρία του IdP (sid), σε κάθε συσκευή. Ένα token που αναφέρει μόνο το άτομο (sub) τερματίζει όλες τις συνδέσεις SSO του. Με front-channel logout, ο IdP ανοίγει το front-channel URI στο πρόγραμμα περιήγησης του ατόμου με iss και sid, και το MonoChat τερματίζει με τον ίδιο τρόπο τις συνδέσεις εκείνης της συνεδρίας.

Μια σύνδεση του ίδιου ατόμου με κωδικό πρόσβασης δεν επηρεάζεται.

Δίκτυο​

  • Κρατήστε προσβάσιμα τα /api/oauth/oidc/authorize και το redirectPath σας για τα άτομα που συνδέονται. Και τα δύο ανοίγουν στο πρόγραμμα περιήγησής τους.
  • Ο διακομιστής του MonoChat πρέπει να έχει πρόσβαση μέσω HTTPS στο έγγραφο ανακάλυψης, στο token endpoint και στο σύνολο κλειδιών (jwks_uri) του IdP σας.
  • Με back-channel logout, οι διακομιστές του IdP σας πρέπει να έχουν πρόσβαση στο /api/oauth/oidc/backchannel-logout του MonoChat.

Περιορισμοί​

  • Η εφαρμογή MonoChat για κινητά δεν προσφέρει ακόμη SSO. Αν κάνετε το SSO τη μοναδική μέθοδο σύνδεσης, οι εκπρόσωποι δεν μπορούν να συνδεθούν στην εφαρμογή για κινητά.

Έλεγχος της ρύθμισής σας​

  1. Ανοίξτε τη σελίδα σύνδεσης και κάντε κλικ στο κουμπί SSO. Συνδεθείτε στον IdP σας· το αναδυόμενο παράθυρο κλείνει και είστε συνδεδεμένοι στο MonoChat.
  2. Συνδεθείτε με ένα άτομο που δεν έχει ακόμη λογαριασμό MonoChat και επιβεβαιώστε ότι ο λογαριασμός δημιουργείται (ή απορρίπτεται, αν δεν ενεργοποιήσατε το autoCreateAccounts).
  3. Αν ορίσατε allowedEmailDomains, δοκιμάστε ένα άτομο σε άλλο domain και επιβεβαιώστε ότι η σύνδεση απορρίπτεται.
  4. Αν ορίσατε το public.auth.methods, επιβεβαιώστε ότι η σύνδεση με κωδικό πρόσβασης απορρίπτεται και ότι ένας root super user μπορεί ακόμη να συνδεθεί στο /auth/signin?fallback=1.
  5. Αποσυνδεθείτε από το MonoChat και επιβεβαιώστε ότι μεταφέρεστε στη σελίδα αποσύνδεσης του IdP σας και μετά πίσω στο MonoChat, και ότι ο IdP σας ζητά να συνδεθείτε ξανά.
  6. Συνδεθείτε στο MonoChat μέσω SSO, αποσυνδεθείτε στον IdP σας στο ίδιο πρόγραμμα περιήγησης και επιβεβαιώστε ότι το MonoChat σας αποσυνδέει. Ένα δεύτερο πρόγραμμα περιήγησης που συνδέθηκε με δική του συνεδρία IdP παραμένει συνδεδεμένο, εκτός αν ο IdP σας τερματίζει κάθε συνεδρία του ατόμου.