Przejdź do treści
Centrum pomocy Clevera

Konfiguracja SSO z Okta

Przewodnik krok po kroku dotyczący konfiguracji logowania jednokrotnego (SSO) w Clevera przy użyciu Okta, z wykorzystaniem SAML 2.0 lub OpenID Connect: ustawienia aplikacji w Okta, przypisywanie wartości Okta do odpowiednich pól w Clevera, przypisywanie użytkowników oraz testowanie.

Zaktualizowano 6 min czytania

Skonfiguruj logowanie jednokrotne (SSO) między Okta a Clevera, aby Twój zespół mógł logować się za pomocą swojego konta Okta. Możesz połączyć się za pomocą SAML 2.0 lub OpenID Connect (OIDC); ten przewodnik przeprowadzi Cię przez oba procesy po stronie Okta oraz wskaże odpowiadające im pola w Clevera.

Konsola administracyjna Okta okresowo się zmienia. Jeśli poniższa etykieta nie odpowiada temu, co widzisz, 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.
  • Jesteś administratorem Okta, który może tworzyć integracje aplikacji i przypisywać je.
  • Znasz domeny e-mail, których używają Twoi pracownicy w Okta, na przykład acme.example.

Najpierw otwórz okno dialogowe konfiguracji Clevera, aby móc skopiować z niego wartości: otwórz menu obszaru roboczego u góry paska bocznego, wybierz Ustawienia zespołu, następnie Bezpieczeństwo i kliknij Skonfiguruj SSO. Wybierz Okta jako Dostawcę tożsamości.

Krok 1 okna dialogowego konfiguracji SSO z wybranym Okta i SAML 2.0 oraz identyfikatorem jednostki (Entity ID), adresem URL ACS i adresem URL metadanych do skopiowania
Skopiuj te trzy wartości do swojego dostawcy tożsamości.

Połączenie przez SAML 2.0

  1. Utwórz aplikację w Okta

    W konsoli administracyjnej Okta przejdź do Applications → Applications i kliknij Create App Integration. Wybierz SAML 2.0 i kliknij Dalej. Nazwij ją Clevera i kliknij Dalej.

  2. Wprowadź wartości Clevera

    W sekcji SAML Settings wypełnij:

    Pole Okta Wartość z Clevera
    Single sign-on URL ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. Pozostaw zaznaczone Use this for Recipient URL and Destination URL.
    Audience URI (SP Entity ID) Entity ID / Audience URI (skopiuj z okna dialogowego Clevera; kończy się identyfikatorem Twojego obszaru roboczego)
    Default RelayState Pozostaw puste
    Name ID format EmailAddress
    Application username Email
  3. Sprawdź podpisywanie

    Kliknij Show Advanced Settings i sprawdź, czy Response oraz Assertion Signature są ustawione na Signed, Signature Algorithm na RSA-SHA256, a Assertion Encryption na Unencrypted. Clevera wymaga, aby zarówno odpowiedź, jak i asercja były podpisane.

  4. Dodaj atrybuty nazwy

    W sekcji Attribute Statements dodaj firstName z wartością user.firstName oraz lastName z wartością user.lastName. Clevera używa ich do nazywania nowych kont. Kliknij Dalej, odpowiedz na pytanie Okta dotyczące opinii o aplikacji wewnętrznej i kliknij Zakończ.

  5. Skopiuj wartości Okta do Clevera

    Na karcie Sign On aplikacji otwórz szczegóły konfiguracji SAML (View SAML setup instructions lub More details w nowszych konsolach). W Clevera ustaw Protocol na SAML 2.0, kliknij Kontynuuj i wklej:

    Wartość Okta Pole Clevera
    Identity Provider Issuer (lub Issuer) IdP Entity ID
    Identity Provider Single Sign-On URL (lub Sign on URL) SSO sign-in URL
    X.509 Certificate (lub Signing Certificate) X.509 certificate

    Pozostaw Logout URL puste, chyba że używasz wylogowania jednokrotnego Okta.

    Krok 2 okna dialogowego konfiguracji SSO z wypełnionym identyfikatorem IdP Entity ID, adresem URL logowania i certyfikatem
    Adres URL wylogowania jest opcjonalny.
  6. Przypisz użytkowników

    Na karcie Assignments aplikacji kliknij Assign i dodaj osoby lub grupy, które powinny korzystać z Clevera. Osoby, które nie zostały przypisane, nie będą mogły zalogować się przez Okta.

Następnie dokończ konfigurację w Clevera: domeny i role.

Połączenie przez OpenID Connect

  1. Utwórz aplikację w Okta

    Przejdź do Applications → Applications → Create App Integration. Wybierz OIDC - OpenID Connect, następnie Web Application i kliknij Dalej.

  2. Ustaw identyfikator URI przekierowania

    W oknie dialogowym konfiguracji Clevera ustaw Protocol na OpenID Connect i skopiuj Redirect URI (callback URL) z szarego pola. Następnie wypełnij w Okta:

    Pole Okta Wartość
    App integration name Clevera
    Grant type Authorization Code
    Sign-in redirect URIs Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
    Sign-out redirect URIs Usuń przykład; pozostaw puste
    Controlled access Wybierz, kto może korzystać z aplikacji, lub Skip group assignment for now i przypisz później

    Kliknij Zapisz.

  3. Skopiuj poświadczenia

    Na karcie General aplikacji, w sekcji Client Credentials, skopiuj Client ID oraz Client secret. Pozostaw Client authentication ustawione na Client secret.

  4. Wypełnij w Clevera

    W Clevera kliknij Kontynuuj i wprowadź:

    Pole Clevera Wartość
    Client ID Client ID z Okta
    Client secret Client secret z Okta
    Discovery URL https:// Twoja domena Okta /.well-known/openid-configuration, na przykład https://acme.okta.com/.well-known/openid-configuration

    Jeśli używasz niestandardowego serwera autoryzacji, użyj jego własnego adresu URL wykrywania (discovery URL), na przykład https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

    Krok 2 okna dialogowego konfiguracji SSO dla OpenID Connect z identyfikatorem klienta, kluczem tajnym i adresem URL wykrywania
    Dzięki adresowi URL wykrywania pola punktów końcowych pozostają ukryte.
  5. Przypisz użytkowników

    Na karcie Assignments przypisz osoby lub grupy, które powinny korzystać z Clevera.

Zakończ w Clevera

  1. W sekcji Domains & roles dodaj każdą domenę e-mail, którą posiadają Twoi użytkownicy Okta, wybierz Create accounts on first sign-in oraz Default role for new SSO members.
  2. W sekcji Przejrzyj kliknij Save configuration.
  3. Kliknij Run test, włącz Enable SSO i zaloguj się jako przypisany użytkownik testowy w oknie prywatnym, zaczynając od strony logowania Clevera.
  4. Gdy wszystko będzie działać dla wszystkich, włącz Require SSO, jeśli chcesz, aby SSO było jedyną metodą logowania.

Członkowie wpisują wtedy swój służbowy adres e-mail na stronie logowania Clevera i klikają Continue with Okta.

Rozwiązywanie problemów

Problem Co sprawdzić
"SSO authentication failed…" zaraz po zalogowaniu przez Okta, przy użyciu SAML Response i Assertion Signature są Signed; certyfikat w Clevera jest aktualnym certyfikatem podpisywania aplikacji; Audience URI dokładnie odpowiada identyfikatorowi Entity ID w Clevera.
"SSO session expired. Please try again." po kliknięciu kafelka Clevera w Okta Oczekiwane zachowanie: logowanie musi rozpocząć się na stronie logowania Clevera.
Okta informuje, że użytkownik nie jest przypisany do aplikacji Przypisz go na karcie Assignments aplikacji.
"Your email domain is not authorized for this team's SSO." Adres e-mail użytkownika w Okta używa domeny, której nie ma w Allowed email domains. Dodaj ją w Clevera.
Okta pokazuje błąd identyfikatora URI przekierowania (OIDC) Sign-in redirect URIs musi być dokładnie taki sam jak Redirect URI (callback URL) z Clevera, https://app.clevera.ai/sso/oidc/callback.

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