SSO — przykłady dla Keycloak, Microsoft Entra ID i Google
Skopiujesz gotowy fragment konfiguracji dla swojego dostawcy tożsamości.
Gadka nie ma osobnych integracji dla poszczególnych dostawców: z każdym rozmawia standardowym protokołem OIDC. Poniżej znajdziesz wartości issuer i uwagi dla trzech popularnych dostawców. Pełny opis pól i kroków: Logowanie SSO przez OIDC.
We wszystkich przykładach adres zwrotny do zarejestrowania u dostawcy to:
https://gadka.example.com:6543/v1/auth/oidc/callbackKeycloak
Z Keycloakiem Gadka jest testowana na co dzień.
- W wybranym realmie utwórz klienta OpenID Connect z uwierzytelnianiem klienta (klient poufny) i standardowym przepływem (Authorization Code).
- Dodaj adres zwrotny podany wyżej.
- Skopiuj sekret klienta do pliku na serwerze.
- id: keycloak
tenant_slug: firma
display_name: Keycloak
issuer: https://sso.example.com/realms/firma
client_id: gadka
client_secret_file: /etc/gadka/oidc-client-secretUpewnij się, że konta użytkowników w Keycloaku mają zweryfikowany adres e-mail.
Microsoft Entra ID
- Zarejestruj aplikację z platformą typu Web i adresem zwrotnym podanym wyżej.
- Utwórz sekret klienta i zapisz go w pliku na serwerze.
- W
issuerwstaw identyfikator swojego katalogu (tenant ID):
- id: entra
tenant_slug: firma
display_name: Microsoft Entra ID
issuer: https://login.microsoftonline.com/<tenant-id>/v2.0
client_id: <id aplikacji>
client_secret_file: /etc/gadka/oidc-client-secretGoogle Workspace
- W konsoli Google Cloud utwórz identyfikator klienta OAuth typu aplikacja internetowa.
- Dodaj adres zwrotny podany wyżej.
- id: google
tenant_slug: firma
display_name: Google
issuer: https://accounts.google.com
client_id: <id klienta>
client_secret_file: /etc/gadka/oidc-client-secret
auto_provision: true
allowed_email_domains: [example.com]Sprawdzenie
Po restarcie serwera (sudo systemctl restart gadka) na ekranie logowania pojawi się przycisk Zaloguj przez … z nazwą z display_name. Błędy połączenia z dostawcą znajdziesz w logu: journalctl -u gadka -n 50.