Przejdź do treści
Clevera Help Center

Konfiguracja SSO z Google Workspace

Przewodnik krok po kroku dotyczący konfiguracji logowania jednokrotnego (SSO) w Clevera za pomocą Google Workspace: klient OAuth dla OpenID Connect lub niestandardowa aplikacja SAML w konsoli administracyjnej Google, wraz z informacją, jakie wartości wpisać w poszczególne pola Clevera.

Zaktualizowano 5 min czytania

Skonfiguruj logowanie jednokrotne (SSO) między Google Workspace a Clevera, aby Twój zespół mógł logować się za pomocą służbowego konta Google. Możesz nawiązać połączenie za pomocą OpenID Connect (OIDC) przez klienta Google Cloud OAuth lub za pomocą SAML 2.0 przez niestandardową aplikację SAML w konsoli administracyjnej Google.

Konsole Google zmieniają się z czasem. Jeśli poniższa etykieta nie pasuje, poszukaj ustawienia o tym samym znaczeniu i skorzystaj z ogólnych przewodników, aby uzyskać pełną listę wartości: SAML, OIDC.

Zanim zaczniesz

  • Jesteś Właścicielem obszaru roboczego Clevera w ramach Planu niestandardowego.
  • W przypadku OIDC: możesz tworzyć klientów OAuth w projekcie Google Cloud, który należy do Twojej organizacji Google Workspace.
  • W przypadku SAML: jesteś superadministratorem Google Workspace.
  • Znasz swoje domeny Google Workspace, takie jak acme.example, w tym domeny dodatkowe.

Najpierw otwórz okno dialogowe konfiguracji Clevera: otwórz menu obszaru roboczego u góry paska bocznego, wybierz Ustawienia zespołu, następnie Bezpieczeństwo i kliknij Skonfiguruj SSO. Wybierz Google Workspace jako Dostawcę tożsamości.

Krok 1 okna dialogowego konfiguracji SSO z wybranym Google Workspace i SAML 2.0 oraz wartościami do skopiowania
W przypadku SAML 2.0 skopiuj te wartości do konsoli administracyjnej Google.

Połączenie przez OpenID Connect

  1. Ustaw aplikację jako wewnętrzną

    W konsoli Google Cloud wybierz projekt w swojej organizacji i otwórz Platformę uwierzytelniania Google (w starszych konsolach: Interfejsy API i usługi → Ekran zgody OAuth). Ustaw Odbiorców (typ użytkownika) na Wewnętrzny, aby logować się mogli tylko użytkownicy z Twojego Google Workspace. Wpisz nazwę aplikacji (Clevera) oraz e-mail pomocy technicznej.

  2. Utwórz klienta OAuth

    W oknie konfiguracji Clevera ustaw Protokół na OpenID Connect i skopiuj Identyfikator URI przekierowania (adres URL wywołania zwrotnego) z szarego pola. Następnie w Google otwórz Klienci (lub Interfejsy API i usługi → Dane logowania) i utwórz Identyfikator klienta OAuth:

    Pole Google Wartość
    Typ aplikacji Aplikacja internetowa
    Nazwa Clevera
    Autoryzowane identyfikatory URI przekierowania Identyfikator URI przekierowania (adres URL wywołania zwrotnego): https://app.clevera.ai/sso/oidc/callback

    Kliknij Utwórz i skopiuj Identyfikator klienta oraz Klucz tajny klienta.

  3. Wypełnij dane w Clevera

    W Clevera kliknij Kontynuuj i wprowadź:

    Pole Clevera Wartość
    Identyfikator klienta Identyfikator klienta Google
    Klucz tajny klienta Klucz tajny klienta Google
    Adres URL wykrywania https://accounts.google.com/.well-known/openid-configuration

Google wysyła oświadczenia email i name dla zakresów openid email profile, o które prosi Clevera, więc nie trzeba nic więcej mapować.

Połączenie przez SAML 2.0

  1. Dodaj niestandardową aplikację SAML

    W konsoli administracyjnej Google przejdź do Aplikacje → Aplikacje internetowe i mobilne, kliknij Dodaj aplikację i wybierz Dodaj niestandardową aplikację SAML. Nazwij ją Clevera i kliknij Kontynuuj.

  2. Skopiuj wartości Google do Clevera

    W sekcji Szczegóły dostawcy tożsamości Google skopiuj wartości do Clevera (najpierw ustaw Protokół na SAML 2.0 i kliknij Kontynuuj):

    Wartość Google Pole Clevera
    Identyfikator jednostki Identyfikator jednostki IdP
    Adres URL SSO Adres URL logowania SSO
    Certyfikat Certyfikat X.509

    Kliknij Kontynuuj w Google.

  3. Wprowadź wartości Clevera

    W sekcji Szczegóły dostawcy usług:

    Pole Google Wartość
    Adres URL ACS https://app.clevera.ai/sso/saml/callback
    Identyfikator jednostki Identyfikator jednostki / Identyfikator URI odbiorców z okna dialogowego Clevera
    Adres URL startowy Pozostaw puste
    Podpisana odpowiedź Zaznaczone
    Format identyfikatora nazwy EMAIL
    Identyfikator nazwy Podstawowe informacje → Główny adres e-mail

    Kliknij Kontynuuj.

  4. Mapuj nazwy

    W sekcji Mapowanie atrybutów zmapuj Imię na firstName, a Nazwisko na lastName. Kliknij Zakończ.

  5. Włącz aplikację

    Otwórz Dostęp użytkowników aplikacji, wybierz WŁ. dla wszystkich (lub dla jednostek organizacyjnych bądź grup, które powinny korzystać z Clevera) i kliknij Zapisz. Google informuje, że zastosowanie zmian może chwilę potrwać.

Zakończ w Clevera

  1. W sekcji Domeny i role dodaj każdą domenę Google Workspace, z której korzystają Twoi użytkownicy. Wybierz Twórz konta przy pierwszym logowaniu oraz Domyślną rolę dla nowych członków SSO.
  2. W sekcji Przejrzyj kliknij Zapisz konfigurację.
  3. Kliknij Uruchom test, włącz Włącz SSO i zaloguj się jako użytkownik testowy w oknie prywatnym, zaczynając od strony logowania Clevera.
  4. Gdy wszystko będzie działać, włącz Wymagaj SSO, jeśli chcesz, aby SSO było jedynym sposobem logowania. Wyłączy to również opcję Kontynuuj przez Google dla tych członków.

Członkowie wpisują swój służbowy adres e-mail na stronie logowania Clevera i klikają Kontynuuj przez Google Workspace.

Rozwiązywanie problemów

Problem Co sprawdzić
Google wyświetla „Error 400: redirect_uri_mismatch” Autoryzowane identyfikatory URI przekierowania muszą być dokładnie takie same jak Identyfikator URI przekierowania (adres URL wywołania zwrotnego) z Clevera, https://app.clevera.ai/sso/oidc/callback.
Google twierdzi, że aplikacja jest ograniczona do użytkowników w organizacji Osoba nie jest zalogowana na konto z Twojego Workspace.
„SSO authentication failed…” po zalogowaniu przez Google (SAML) Podpisana odpowiedź jest zaznaczona; certyfikat w Clevera pasuje do aktualnego certyfikatu aplikacji; Identyfikator jednostki dokładnie pasuje do Clevera. Jeśli problem nadal występuje, połącz się przez OIDC.
„Sesja SSO wygasła. Spróbuj ponownie.” po otwarciu Clevera z menu aplikacji Google Oczekiwane zachowanie: logowanie musi rozpocząć się na stronie logowania Clevera.
Google twierdzi, że aplikacja nie jest skonfigurowana dla użytkownika (SAML) Włącz aplikację dla ich jednostki organizacyjnej lub grupy w Dostęp użytkowników.
„Twoja domena e-mail nie jest autoryzowana dla SSO tego zespołu.” Dodaj ich domenę, w tym domeny dodatkowe, do Dozwolonych domen e-mail.

Więcej komunikatów: Rozwiązywanie problemów z logowaniem SSO.