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 |
| Τύπος grant | Authorization code |
| Scopes | openid email profile |
| Ταυτοποίηση client στο token endpoint | Client secret που αποστέλλεται με HTTP Basic authentication (client_secret_basic) |
| Redirect URI μετά την αποσύνδεση | https://<your MonoChat domain>/ |
| URI για back-channel logout | https://<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 ID | https://login.microsoftonline.com/<tenant id>/v2.0 |
| Okta | https://<your Okta domain>/oauth2/default, ή https://<your Okta domain> |
| Keycloak | https://<your Keycloak host>/realms/<realm> |
| AD FS (2016 ή νεότερο) | https://<your AD FS host>/adfs |
| Google Workspace | https://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 (issuerhttps://accounts.google.com), το MonoChat ελέγχει το claimhd, το domain Workspace του λογαριασμού, αντί για τη διεύθυνση e-mail, επειδή ένας προσωπικός λογαριασμός Google μπορεί να χρησιμοποιεί διεύθυνση σε οποιοδήποτε domain.
Κάντε το SSO τη μοναδική μέθοδο σύνδεσης
- Ορίστε το
public.auth.methodsσε["oidc"]. Η σελίδα σύνδεσης εμφανίζει τότε μόνο το κουμπί SSO και ο διακομιστής απορρίπτει τη σύνδεση με κωδικό πρόσβασης και μέσω κοινωνικών δικτύων. - Οι root super users (χρήστες με τον ρόλο root super στον root χώρο εργασίας) μπορούν ακόμη να συνδεθούν με τον κωδικό πρόσβασής τους στο
/auth/signin?fallback=1, ώστε η εγκατάσταση να μη μείνει ποτέ κλειδωμένη αν ο IdP είναι εκτός λειτουργίας. - Για να εμποδίσετε τους νέους λογαριασμούς 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.