Logowanie SSO przez OIDC
Podłączysz firmowego dostawcę tożsamości, żeby pracownicy logowali się do Gadki jednym kontem.
Gadka obsługuje logowanie przez OpenID Connect (OIDC) z dowolnym zgodnym dostawcą tożsamości (IdP). Dostawców konfigurujesz w pliku serwera. Na ekranie logowania pojawia się wtedy przycisk Zaloguj przez ….
Zanim zaczniesz
- Dostęp administratora do IdP.
- Dostęp root do serwera Gadki.
- Utworzony workspace. Zobacz Pierwsze uruchomienie.
Krok 1. Zarejestruj aplikację w IdP
- Utwórz aplikację typu web (klient poufny, z sekretem).
- Jako adres zwrotny (redirect URI) podaj publiczny adres Gadki z końcówką
/v1/auth/oidc/callback:
https://gadka.example.com:6543/v1/auth/oidc/callback- Zezwól na zakresy
openid,emailiprofile. - Zanotuj adres wystawcy (issuer), identyfikator klienta i sekret.
Krok 2. Zapisz sekret na serwerze
sudo install -o root -g gadka -m 0640 /dev/null /etc/gadka/oidc-client-secret
sudo nano /etc/gadka/oidc-client-secretKrok 3. Dodaj dostawcę do konfiguracji
W /etc/gadka/gadka.yaml, w sekcji auth:
auth:
oidc:
providers:
- id: firma-sso
tenant_slug: firma
display_name: Firmowe SSO
issuer: https://sso.example.com/realms/firma
client_id: gadka
client_secret_file: /etc/gadka/oidc-client-secret
auto_provision: false
allowed_email_domains: [example.com]| Pole | Znaczenie |
|---|---|
id | unikalny identyfikator dostawcy, używany w adresach |
tenant_slug | workspace, do którego loguje ten dostawca |
display_name | tekst na przycisku Zaloguj przez … |
issuer | adres wystawcy, dokładnie taki jak w tokenach |
discovery_url | opcjonalnie: adres IdP widziany z serwera, gdy różni się od publicznego |
client_id, client_secret_file | dane aplikacji z kroku 1 |
auto_provision | true zakłada konto członka przy pierwszym logowaniu |
allowed_email_domains | domeny e-mail dopuszczone przy auto_provision |
Pola id, tenant_slug, display_name, issuer i client_id są wymagane.
Krok 4. Uruchom serwer ponownie i przetestuj
sudo systemctl restart gadkaOtwórz ekran logowania, wpisz domenę i workspace. Pod polami powinien pojawić się przycisk Zaloguj przez Firmowe SSO.
Jak Gadka dopasowuje konta
- IdP musi przekazać w tokenie
emailorazemail_verified: true. Bez zweryfikowanego adresu logowanie jest odrzucane. - Istniejące konto w Gadce jest łączone z kontem w IdP po adresie e-mail przy pierwszym logowaniu SSO.
- Gdy konta nie ma, a
auto_provisionjest wyłączone, użytkownik zobaczy: To konto nie ma dostępu do tego workspace. Poproś administratora o zaproszenie. - Konto założone automatycznie dostaje rolę Członek i liczy się do limitu licencji. Role zmieniasz w Gadce; Gadka nie mapuje ról ani grup z IdP.
- Jeśli IdP potwierdza w tokenie logowanie wieloskładnikowe (claim
amrz wartościąmfalubotp), sesja spełnia wymóg drugiego składnika dla administratorów.
Atrybuty profilu z IdP
Pola profilu możesz wypełniać z tokenu:
attributes: { title: job_title, department: department, phone: phone_number, timezone: zoneinfo }
force_attributes: [department]Dozwolone pola to title, department, phone i timezone. Wartości są zapisywane przy każdym logowaniu. Pole zmienione ręcznie przez użytkownika zachowuje jego wartość, chyba że jest na liście force_attributes.