Spis treści dokumentacji

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

  1. Utwórz aplikację typu web (klient poufny, z sekretem).
  2. 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
  1. Zezwól na zakresy openid, email i profile.
  2. 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-secret

Krok 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]
PoleZnaczenie
idunikalny identyfikator dostawcy, używany w adresach
tenant_slugworkspace, do którego loguje ten dostawca
display_nametekst na przycisku Zaloguj przez …
issueradres wystawcy, dokładnie taki jak w tokenach
discovery_urlopcjonalnie: adres IdP widziany z serwera, gdy różni się od publicznego
client_id, client_secret_filedane aplikacji z kroku 1
auto_provisiontrue zakłada konto członka przy pierwszym logowaniu
allowed_email_domainsdomeny 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 gadka

Otwó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 email oraz email_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_provision jest 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 amr z wartością mfa lub otp), 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.

Co dalej