Skonfiguruj OIDC SSO
OIDC jest alternatywą dla SAML do łączenia się z dostawcą tożsamości. Obydwa umożliwiają Twojemu zespołowi logowanie się przy użyciu istniejących kont firmowych; OIDC to bardziej nowoczesny protokół preferowany przez niektórych dostawców. Jeśli nie jesteś pewien, którego użyć, użyj SAML — jest to opcja domyślna i działa z każdym obsługiwanym dostawcą. Wybierz OIDC, gdy Twój dostawca go zaleca lub gdy SAML nie jest dla Ciebie opcją.
Konfiguracja ma taki sam kształt jak w przypadku SAML — skonfiguruj, zweryfikuj swoją domenę, przetestuj, a następnie włącz — z kilkoma szczegółami specyficznymi dla OIDC.
Zanim zaczniesz
- Konto administratora z uprawnieniami do zarządzania logowaniem jednokrotnym.
- Dostęp do konsoli administracyjnej dostawcy tożsamości.
- Domena, którą możesz zweryfikować (domena e-mail, za pomocą której loguje się Twój zespół).
Otwórz kreator konfiguracji
- Przejdź do Zarządzanie użytkownikami → Jednokrotne logowanie.
- Wybierz Skonfiguruj jednokrotne logowanie.
- Wybierz swojego dostawcę, a następnie zmień protokół na OIDC.
Wymień się ustawieniami z dostawcą tożsamości
-
Utwórz nową aplikację OIDC (lub „OpenID Connect”) w konsoli swojego dostawcy. Kliv pokazuje adres URL przekierowania do wklejenia.
-
Twój dostawca przekazuje Ci identyfikator klienta, sekret klienta (client secret) i adres URL wystawcy (adres internetowy identyfikujący usługę logowania Twojego dostawcy). Wklej wszystkie trzy do Kliv.
-
Adres URL wystawcy musi dokładnie odpowiadać Twojemu dostawcy, znak po znaku. To najczęstsze źródło błędów:
- Adresy wystawcy w Microsoft Entra są specyficzne dla Twojego tenanta i zawierają długi identyfikator — skopiuj go z własnej aplikacji, nie używaj ponownie identyfikatora z przewodnika.
- Google publikuje swój adres wystawcy w więcej niż jednej formie; użyj dokładnie tego, który pokazuje Twoja konsola.
Jeśli adres wystawcy choć trochę się różni, prawidłowe logowania zostaną odrzucone. Poniższy krok testowy powie Ci, czy to jest przyczyną problemu.
Kliv zapisuje to jako wersję roboczą — skonfigurowaną, ale nieaktywną. Twój zespół będzie logował się w taki sam sposób, jak dzisiaj, dopóki nie skończysz.
Zweryfikuj swoją domenę
Podobnie jak w przypadku SAML, Kliv nie utworzy kont u Twojego dostawcy, dopóki nie udowodnisz, że kontrolujesz domenę e-mail. Wykonaj kroki z Zweryfikuj swoją domenę, a następnie wróć tutaj, gdy pojawi się status Zweryfikowano.
Przetestuj prawdziwym logowaniem
- Wybierz Logowanie testowe.
- Zaloguj się u swojego dostawcy dokładnie tak, jak zrobi to Twój zespół.
- W przypadku powodzenia Kliv rejestruje test i odblokowuje Włącz.
- W przypadku niepowodzenia Kliv pokazuje, co było oczekiwane, a co faktycznie otrzymano, dzięki czemu możesz naprawić adres wystawcy, sekret lub przekierowanie — zobacz Rozwiąż problem z nieudanym logowaniem SSO.
Włączanie
Po pomyślnym logowaniu testowym wybierz Włącz. Osoby w Twojej zweryfikowanej domenie są teraz przekierowywane do Twojego dostawcy, aby się zalogować, a pierwsze logowanie automatycznie tworzy standardowe konto członkowskie.
Nowi członkowie uzyskują dostęp tylko na poziomie członka — bez podwyższonej roli, chyba że skonfigurujesz mapowanie grup.
Uwaga dotycząca tożsamości użytkownika
OIDC identyfikuje każdą osobę na podstawie stabilnej pary wartości od Twojego dostawcy, a nie na podstawie jej adresu e-mail. Jest to celowe: oznacza to, że dana osoba zachowuje to samo konto Kliv, nawet jeśli zmieni się jej adres e-mail, a także oznacza, że Kliv nie zależy od tego, czy Twój dostawca oznaczy wiadomość e-mail jako „zweryfikowaną” (niektórzy dostawcy nie wysyłają tego w przypadku kont służbowych). Nie musisz niczego w tym celu konfigurować — warto po prostu wiedzieć, dlaczego zmieniony adres e-mail nie powoduje utworzenia zduplikowanego konta.