Spis treści dokumentacji

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/callback

Keycloak

Z Keycloakiem Gadka jest testowana na co dzień.

  1. W wybranym realmie utwórz klienta OpenID Connect z uwierzytelnianiem klienta (klient poufny) i standardowym przepływem (Authorization Code).
  2. Dodaj adres zwrotny podany wyżej.
  3. 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-secret

Upewnij się, że konta użytkowników w Keycloaku mają zweryfikowany adres e-mail.

Microsoft Entra ID

  1. Zarejestruj aplikację z platformą typu Web i adresem zwrotnym podanym wyżej.
  2. Utwórz sekret klienta i zapisz go w pliku na serwerze.
  3. W issuer wstaw 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-secret

Google Workspace

  1. W konsoli Google Cloud utwórz identyfikator klienta OAuth typu aplikacja internetowa.
  2. 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.

Co dalej