Risolvi gli errori SSO e SCIM
Cosa imparerai
Scopri come risolvere i problemi relativi agli errori per single sign-on (SSO) e system for cross-domain identity management (SCIM) con Klaviyo. Questo articolo è pensato per chi ha familiarità con SSO e SCIM, ad esempio i professionisti IT.
Per ulteriori informazioni, consulta questo articolo su come configurare il single sign-on.
Elenco di errori e come risolverli
Queste tabelle coprono gli errori SSO e SCIM più comuni. Gli errori tendono a verificarsi quando mancano informazioni o sono errate.
Per trovare le impostazioni SSO di Klaviyo, vai su Impostazioni > Sicurezza. In Single sign-on (SSO), fai clic su Configura SSO o Modifica configurazione per configurare la connessione. Usa Impostazioni SSO per abilitare SSO, l'accesso avviato dal provider di identità (IdP) o il provisioning JIT.
Errore | Come risolvere il problema |
Configurazione SSO mancante per {email} ({company_id}) | Completa la configurazione SSO in Klaviyo, poi fai clic su Salva. |
SSO disabilitato per {email} ({company_id}) | In Klaviyo, seleziona Abilita SSO in Impostazioni SSO. |
Configurazione SSO mancante per ({company_id}) | Completa la configurazione SSO in Klaviyo, poi fai clic su Salva. |
SSO disabilitato per ({company_id}) | In Klaviyo, seleziona Abilita SSO in Impostazioni SSO. |
Impossibile effettuare il provisioning di un nuovo utente SSO per {email} nell’account ({company_id}) (provisioning just-in-time non abilitato) | Se vuoi che Klaviyo crei gli utenti quando accedono per la prima volta con SSO, seleziona Provisioning just-in-time (JIT) in Impostazioni SSO in Klaviyo. |
L'SSO avviato dal provider di identità (IdP) è disattivato per {email} ({company_id}) | Per consentire agli utenti di avviare l’accesso dal tuo provider di identità (IdP), seleziona Accesso avviato da IdP in Impostazioni SSO in Klaviyo. |
Configurazione SSO mancante per ({company_id}) | Completa la configurazione SSO in Klaviyo, poi fai clic su Salva. |
Il nome in Klaviyo è {Klaviyo name}, che non corrisponde al messaggio SCIM di {IdP name} | Per un utente con più account Klaviyo, aggiorna nome e cognome nel tuo provider di identità (IdP) in modo che corrispondano a quelli in Klaviyo. In alternativa, chiedi all'utente di aggiornare il proprio nome in Klaviyo in modo che corrisponda a quello nel tuo provider di identità (IdP). Quindi riprova l'aggiornamento SCIM. |
Errori di configurazione SSO
Klaviyo richiede asserzioni SAML firmate. La firma della risposta e la crittografia dell'asserzione sono facoltative. Gli attributi crittografati individuali non sono supportati.
Errore | Come risolvere il problema | ||
Versione SAML non supportata | Vai al provider SSO del tuo provider di identità (IdP) e aggiorna a SAML 2.0. | ||
Attributo ID mancante nella risposta SAML | Assicurati che il provider di identità (IdP) includa un attributo ID sull’elemento SAML Response. Questo è l’identificatore della risposta, non l’emittente del provider di identità (IdP) né l’indirizzo e-mail dell’utente. | ||
Attributo role mancante | Nel provider di identità (IdP), includi un attributo di ruolo in AttributeStatement dell’asserzione SAML. Usa un ruolo per il tipo di account che stai configurando. I valori statici di account e dei ruoli portfolio sono elencati di seguito. Il provisioning JIT non può creare un Proprietario o un Proprietario del portfolio, né trasferire la proprietà. Per un proprietario esistente, il ruolo inviato dal tuo provider di identità (IdP) deve corrispondere al suo ruolo attuale di proprietario. | ||
|
| ||
La risposta SAML deve contenere 1 asserzione | Configura il provider di identità (IdP) in modo che invii esattamente 1 asserzione in ogni risposta SAML. | ||
Risposta SAML non valida. Non corrisponde a saml-schema-protocol-2.0.xsd | Assicurati che la tua risposta SAML sia conforme allo schema SAML 2.0. | ||
L'asserzione deve includere un elemento Conditions | Assicurati che l’asserzione della risposta SAML per il tuo provider di identità (IdP) includa un elemento Conditions. | ||
L'asserzione deve includere un elemento AuthnStatement | Assicurati che l'asserzione della risposta SAML per il tuo provider di identità (IdP) includa un elemento AuthnStatement. | ||
Nella risposta è presente un EncryptedAttribute e questo SP non li supporta. | Klaviyo non supporta gli attributi crittografati. Controlla le impostazioni del provider di identità (IdP) e assicurati che nessun attributo sia crittografato. | ||
La risposta ha un valore Destination vuoto | Nel tuo provider di identità (IdP), imposta la destinazione sull’ URL SSO di Klaviyo mostrato nella configurazione SSO di Klaviyo. Il nome del campo varia in base al provider. I nomi comuni includono "Reply URL", "ACS URL", "Assertion Consumer Service URL", "Trusted URL" e "Endpoint URL". | ||
%s non è un pubblico valido per questa risposta | Assicurati che l'ID pubblico nel tuo provider di identità (IdP) corrisponda esattamente all'URI del pubblico (ID entità del provider di servizi) fornito nel pannello di configurazione SSO, incluso il prefisso https://. | ||
Emittente non valido nell’asserzione/risposta (previsto %(idpEntityId)s, ricevuto %(issuer)s) | Nella configurazione SSO di Klaviyo, assicurati che Emittente IdP corrisponda all’emittente (ID entità) nella risposta SAML del tuo provider di identità (IdP), poi fai clic su Salva. | ||
Gli attributi sono scaduti, in base a SessionNotOnOrAfter dell’AttributeStatement di questa risposta | Prova ad accedere di nuovo. Se non funziona, estendi la finestra di scadenza della risposta SAML nel provider di identità (IdP), perché potrebbe essere troppo breve. | ||
In questa risposta non è stato trovato un SubjectConfirmation valido | Verifica che l’asserzione contenga un SubjectConfirmation valido con il metodo bearer e SubjectConfirmationData. Verifica che il relativo destinatario corrisponda all’ URL SSO di Klaviyo, che il relativo periodo di validità includa l’ora corrente e che qualsiasi valore InResponseTo corrisponda alla risposta. | ||
L’asserzione della risposta non è firmata e l’SP la richiede | Nel tuo provider di identità (IdP), attiva la firma per le asserzioni SAML. Contatta il provider di identità (IdP) se hai bisogno di aiuto. | ||
Nessuna firma trovata. Risposta SAML rifiutata | Assicurati che il tuo provider di identità (IdP) firmi l'asserzione SAML. Firmare solo la risposta non soddisfa il requisito di Klaviyo per la firma dell’asserzione. | ||
Convalida della firma non riuscita. Risposta SAML rifiutata | Nella configurazione SSO di Klaviyo, assicurati che il certificato IdP corrisponda al certificato che il tuo provider di identità (IdP) utilizza per firmare le asserzioni SAML. Salva tutte le modifiche, poi testa di nuovo l’SSO. | ||
Risposta SAML non trovata, è supportato solo il binding HTTP_POST | Verifica che il provider di identità (IdP) invii una richiesta HTTP_POST. | ||
Dopo aver corretto un errore SSO, torna alla configurazione SSO di Klaviyo e fai clic su Test SSO. In questo modo salvi le impostazioni di connessione e testi di nuovo l’accesso.
Altri suggerimenti per la risoluzione dei problemi
Apri il menu a discesa che corrisponde meglio al problema che stai riscontrando per informazioni su come risolverlo.
Non riesco a modificare il ruolo di un utente in Klaviyo
Se SSO e il provisioning just-in-time (JIT) sono abilitati, oppure SCIM è abilitato, i ruoli utente vengono gestiti tramite il tuo provider di identità (IdP). Per gli utenti nell’elenco di esenzione SSO, i ruoli possono comunque essere modificati in Klaviyo.
Aggiorna il ruolo dell’utente nel tuo provider di identità (IdP). JIT applica il ruolo al prossimo accesso dell’utente con SSO. Se SCIM è disattivato e devi modificare un ruolo direttamente in Klaviyo, segui questi passaggi:
- In Impostazioni > Sicurezza, deseleziona provisioning just-in-time (JIT) in Impostazioni SSO, quindi fai clic su Disattiva per confermare.
- Aggiorna il ruolo dell’utente in Klaviyo. Imposta lo stesso ruolo nel tuo provider di identità (IdP), in modo che non sovrascriva la modifica quando JIT viene riattivato.
- Seleziona di nuovo provisioning just-in-time (JIT) per riattivarlo.
Non riesco a visualizzare l’elenco delle esenzioni
Per visualizzare l'elenco delle esenzioni, devi aver configurato l'SSO. Per istruzioni, consulta il nostro articolo su come abilitare l'SSO in Klaviyo.
Risorse aggiuntive
- Come configurare il Single Sign-On (SSO)
Scopri come configurare il single sign-on (SSO) per il tuo account o portfolio Klaviyo. Al momento, in Klaviyo è supportato solo il single sign-on del provider di identità (IdP).
- Come impostare l'autenticazione a più fattori (MFA)
Scopri come configurare l'autenticazione a più fattori (MFA) per rendere il tuo account o portfolio Klaviyo più sicuro. Con l'autenticazione a più fattori abilitata, accedi utilizzando un nome utente e una password, quindi verifica la tua identità (ad esempio inserendo un codice).
- Come configurare il provisioning degli utenti SCIM
Scopri come configurare un sistema per il provisioning degli utenti per la gestione delle identità tra domini (SCIM) in un account o portfolio.