Rozwiązywanie problemów z błędami SSO i SCIM
Czego się dowiesz?
Dowiedz się, jak rozwiązywać problemy z błędami w logowaniu jednokrotnym (SSO) oraz w systemie System for Cross-domain Identity Management (SCIM) w Klaviyo. Ten artykuł jest przeznaczony dla osób, które znają SSO i SCIM, na przykład specjalistów IT.
Aby uzyskać więcej informacji, zapoznaj się z tym artykułem o konfigurowaniu logowania jednokrotnego.
Lista błędów i sposoby ich naprawy
Te tabele obejmują typowe błędy SSO i SCIM. Błędy zwykle pojawiają się, gdy brakuje informacji lub są one nieprawidłowe.
Aby znaleźć ustawienia SSO w Klaviyo, przejdź do Ustawienia > Zabezpieczenia. W sekcji Logowanie jednokrotne (SSO) kliknij Skonfiguruj SSO lub Edytuj konfigurację, aby skonfigurować połączenie. Użyj Ustawienia SSO, aby włączyć SSO, logowanie inicjowane przez dostawcę tożsamości (IdP) lub aprowizację JIT.
Błąd | Jak to naprawić |
Brak konfiguracji SSO dla {email} ({company_id}) | Dokończ konfigurację SSO w Klaviyo, a następnie kliknij Zapisz. |
SSO wyłączone dla {email} ({company_id}) | W Klaviyo wybierz Włącz SSO w sekcji Ustawienia SSO. |
Brak konfiguracji SSO dla ({company_id}) | Dokończ konfigurację SSO w Klaviyo, a następnie kliknij Zapisz. |
SSO wyłączone dla ({company_id}) | W Klaviyo wybierz Włącz SSO w sekcji Ustawienia SSO. |
Nie można przeprowadzić aprowizacji nowego użytkownika SSO dla {email} na koncie ({company_id}) (Aprowizacja Just-in-Time nie jest włączona) | Jeśli chcesz, aby Klaviyo tworzyło użytkowników, gdy po raz pierwszy logują się za pomocą SSO, wybierz aprowizację just-in-time (JIT) w sekcji Ustawienia SSO w Klaviyo. |
SSO inicjowane przez dostawcę tożsamości (IdP) jest wyłączone dla {email} ({company_id}) | Aby umożliwić użytkownikom rozpoczęcie logowania z poziomu dostawcy tożsamości (IdP), wybierz Logowanie inicjowane przez dostawcę tożsamości (IdP) w sekcji Ustawienia SSO w Klaviyo. |
Brak konfiguracji SSO dla ({company_id}) | Dokończ konfigurację SSO w Klaviyo, a następnie kliknij Zapisz. |
Nazwa w Klaviyo to {Klaviyo name}, co nie zgadza się z komunikatem SCIM od {dostawca tożsamości (IdP) name} | Jeśli użytkownik jest w wielu kontach Klaviyo, zaktualizuj jego imię i nazwisko w swoim dostawcy tożsamości (IdP), aby pasowały do Klaviyo. Możesz też poprosić użytkownika, aby zaktualizował swoje imię i nazwisko w Klaviyo, aby pasowały do Twojego dostawcy tożsamości (IdP). Następnie ponów próbę aktualizacji SCIM. |
Błędy konfiguracji SSO
Klaviyo wymaga podpisanych asercji SAML. Podpisanie odpowiedzi i zaszyfrowanie asercji są opcjonalne. Szyfrowane atrybuty indywidualne nie są obsługiwane.
Błąd | Jak to naprawić | ||
Nieobsługiwana wersja SAML | Przejdź do dostawcy tożsamości (IdP) SSO i zaktualizuj ustawienia do SAML 2.0. | ||
Brak atrybutu ID w odpowiedzi SAML | Upewnij się, że twój dostawca tożsamości (IdP) zawiera atrybut ID w elemencie SAML Response. To jest identyfikator odpowiedzi, a nie wystawca dostawcy tożsamości (IdP) ani adres e-mail użytkownika. | ||
Brak atrybutu roli | W swoim dostawcy tożsamości (IdP) uwzględnij atrybut roli w elemencie AttributeStatement asercji SAML. Użyj roli dla typu konta, które konfigurujesz. Poniżej wymieniono statyczne wartości ról dla kont i portfolio. Aprowizacja JIT nie może utworzyć właściciela ani właściciela portfolio ani przenieść własności. W przypadku istniejącego właściciela rola wysłana przez twojego dostawcę tożsamości (IdP) musi odpowiadać jego bieżącej roli właściciela. | ||
|
| ||
Odpowiedź SAML musi zawierać 1 asercję | Skonfiguruj dostawcę tożsamości (IdP) tak, aby wysyłał dokładnie 1 asercję w każdej odpowiedzi SAML. | ||
Nieprawidłowa odpowiedź SAML. Nie pasuje do saml-schema-protocol-2.0.xsd | Upewnij się, że Twoja odpowiedź SAML jest zgodna ze schematem SAML 2.0. | ||
Assertion musi zawierać element Conditions | Upewnij się, że asercja w odpowiedzi SAML od twojego dostawcy tożsamości (IdP) zawiera element Conditions. | ||
Asercja musi zawierać element AuthnStatement | Upewnij się, że odpowiedź SAML assertion dla dostawcy tożsamości (IdP) zawiera element AuthnStatement. | ||
W odpowiedzi znajduje się EncryptedAttribute, a ta procedura składowana nie obsługuje ich | Klaviyo nie obsługuje sytuacji, gdy atrybut jest zaszyfrowany. Sprawdź ustawienia dostawcy tożsamości (IdP) i upewnij się, że żaden atrybut nie jest zaszyfrowany. | ||
Odpowiedź ma pustą wartość w polu Destination | W swoim dostawcy tożsamości (IdP) ustaw miejsce docelowe na adres URL SSO Klaviyo wyświetlany w konfiguracji SSO w Klaviyo. Nazwa pola różni się w zależności od dostawcy. Popularne nazwy to „Reply URL”, „ACS URL”, „Assertion Consumer Service URL”, „Trusted URL” i „punkt końcowy URL”. | ||
%s nie jest prawidłową grupą odbiorców dla tej odpowiedzi | Upewnij się, że identyfikator odbiorców (Audience Id) w dostawcy tożsamości (IdP) dokładnie zgadza się z identyfikatorem URI odbiorców (Audience URI) (Identyfikator jednostki dostawcy usług) podanym w panelu konfiguracji SSO, łącznie z prefiksem https://. | ||
Nieprawidłowy wystawca w asercji/odpowiedzi (oczekiwano %(idpEntityId)s, otrzymano %(issuer)s) | W konfiguracji SSO w Klaviyo upewnij się, że dostawca tożsamości (IdP) Issuer jest zgodny z wystawcą (ID jednostki) w odpowiedzi SAML od Twojego dostawcy tożsamości (IdP), a następnie kliknij Zapisz. | ||
Atrybuty wygasły na podstawie wartości SessionNotOnOrAfter w elemencie AttributeStatement tej odpowiedzi | Spróbuj zalogować się ponownie. Jeśli to nie zadziała, wydłuż okno ważności odpowiedzi SAML w dostawca tożsamości (IdP), ponieważ może być zbyt krótkie. | ||
Na tej odpowiedzi nie znaleziono prawidłowego elementu SubjectConfirmation | Sprawdź, czy asercja zawiera prawidłowy element SubjectConfirmation z metodą bearer oraz SubjectConfirmationData. Zweryfikuj, czy jej odbiorca jest zgodny z adresem URL SSO Klaviyo, czy okres jej ważności obejmuje bieżący czas oraz czy każda wartość InResponseTo jest zgodna z odpowiedzią. | ||
Potwierdzenie odpowiedzi nie jest podpisane, a SP tego wymaga | W dostawcy tożsamości (IdP) włącz podpisywanie asercji SAML. Skontaktuj się ze swoim dostawcą tożsamości (IdP), jeśli potrzebujesz pomocy. | ||
Nie znaleziono podpisu. Odpowiedź SAML odrzucona | Upewnij się, że twój dostawca tożsamości (IdP) podpisuje asercję SAML. Podpisanie wyłącznie odpowiedzi nie spełnia wymogu Klaviyo dotyczącego podpisywania asercji. | ||
Nie powiodła się weryfikacja podpisu. Odpowiedź SAML odrzucona | W konfiguracji SSO w Klaviyo upewnij się, że certyfikat dostawcy tożsamości (IdP) jest zgodny z certyfikatem, którego Twój dostawca tożsamości (IdP) używa do podpisywania asercji SAML. Zapisz wszystkie zmiany, a następnie ponownie przetestuj logowanie jednokrotne (SSO). | ||
Nie znaleziono odpowiedzi SAML, obsługiwane jest tylko wiązanie HTTP_POST | Sprawdź, czy dostawca tożsamości (IdP) wysyła żądanie HTTP_POST. | ||
Po naprawieniu błędu SSO wróć do konfiguracji SSO w Klaviyo i kliknij Testuj SSO. To zapisuje ustawienia połączenia i ponownie testuje logowanie.
Inne wskazówki dotyczące rozwiązywania problemów
Otwórz listę rozwijaną, która najlepiej pasuje do problemu, z którym się mierzysz, aby uzyskać informacje o tym, jak go rozwiązać.
Nie mogę edytować roli użytkownika w Klaviyo
Jeśli włączone są SSO i aprowizacja just-in-time (JIT) lub włączony jest SCIM, role użytkowników są zarządzane przez twojego dostawcę tożsamości (IdP). Użytkownicy z listy wyjątków SSO nadal mogą mieć zmieniane role w Klaviyo.
Zaktualizuj rolę użytkownika w swoim dostawcy tożsamości (IdP). JIT przypisuje rolę przy następnym logowaniu użytkownika za pomocą SSO. Jeśli SCIM jest wyłączony i musisz zmienić rolę bezpośrednio w Klaviyo, wykonaj te kroki:
- W Ustawienia > Zabezpieczenia wyczyść Aprowizacja just-in-time (JIT) w sekcji Ustawienia SSO, a następnie kliknij Wyłącz, aby potwierdzić.
- Zaktualizuj rolę użytkownika w Klaviyo. Ustaw tę samą rolę w swoim dostawcy tożsamości (IdP), aby nie nadpisał on Twojej zmiany, gdy JIT zostanie ponownie włączony.
- Wybierz ponownie aprowizację just-in-time (JIT), aby włączyć ją z powrotem.
Nie widzę listy wyjątków
Aby zobaczyć listę zwolnień, musisz mieć skonfigurowane SSO. Instrukcje znajdziesz w naszym artykule o tym, jak włączyć SSO w Klaviyo.
Dodatkowe źródła
- Jak skonfigurować logowanie jednokrotne (SSO)
Dowiedz się, jak skonfigurować logowanie jednokrotne (SSO) dla konta lub portfolio Klaviyo. Obecnie w Klaviyo jest obsługiwane tylko logowanie jednokrotne dostarczane przez dostawcę tożsamości (IdP).
- Jak skonfigurować uwierzytelnianie wieloskładnikowe
Dowiedz się, jak skonfigurować uwierzytelnianie wieloskładnikowe, aby zwiększyć bezpieczeństwo Klaviyo konto lub portfolio. Po włączeniu uwierzytelnienia wieloskładnikowego logujesz się za pomocą nazwy użytkownika i hasła, a następnie weryfikujesz swoją tożsamość (np. poprzez wprowadzenie kodu).
- Jak skonfigurować aprowizację użytkowników SCIM
Dowiedz się, jak skonfigurować system do aprowizacji użytkowników SCIM w ramach zarządzania tożsamościami między domenami na koncie lub w portfolio.