Panoramica sulla federazione SSO

La federazione SSO consente ai tuoi utenti di accedere a Criteo utilizzando il sistema di gestione delle identità già in uso nella tua organizzazione, senza bisogno di credenziali di Criteo separate. Una volta completata la configurazione, gli utenti del dominio federato vengono reindirizzati alla pagina di accesso del provider di identità quando accedono a Criteo.

Per la federazione, Criteo utilizza SAML 2.0. Due sistemi si scambiano metadati per stabilire un rapporto di fiducia:

Termine

Ruolo

Esempi di sistemi

Fornitore di servizi

Criteo, l’applicazione a cui vogliono accedere i tuoi utenti

—

Provider di identità

Il sistema di identità della tua organizzazione, che autentica gli utenti e invia a Criteo un’asserzione SAML

Okta, Microsoft Entra ID (Azure AD), AD FS

La federazione SSO è disponibile per tutti i clienti. Contatta la tua persona di riferimento presso Criteo per iniziare.

Prima di iniziare

Prima di contattare la tua persona di riferimento presso Criteo, ti preghiamo di procurarti quanto segue. Il team di Criteo ti chiederà queste informazioni nell’ambito del processo di onboarding:

Cosa

Dettagli

Domini da federare

I domini di email con cui gli utenti effettueranno l’accesso (ad esempio, latuaazienda.com). Puoi iniziare con uno e aggiungerne altri in seguito.

Utenti di prova

Un breve elenco di indirizzi email per verificare il corretto funzionamento dell’integrazione prima della messa in produzione. Tutti gli utenti che partecipano al test devono disporre di un account Criteo attivo prima di poter iniziare il test.

Tipo di provider di identità

Il provider di identità che utilizza la tua organizzazione e l’attributo SAML che invierai per la corrispondenza degli utenti. Criteo consiglia di utilizzare emailAddress.

Ambiente

Se intendi utilizzare un file di metadati separato per l’ambiente di produzione oppure se gli ambienti di test e di produzione condividono gli stessi metadati del provider di identità.

Data prevista per l’entrata in funzione

La data a partire dalla quale si desidera che l’SSO sia attivo per tutti gli utenti dei domini federati.

Come trovare i valori del provider di identità

Durante la procedura di onboarding, dovrai fornire a Criteo il tuo certificato di firma, l’ID entità del provider di identità e l’URL SSO. Il modo più veloce per identificare tutti e tre contemporaneamente è esportare il file XML dei metadati del provider di identità, che li contiene tutti. Le guide riportate di seguito ti spiegano come individuare questi valori per i provider di identità più comuni.

Okta

Il modo più veloce è scaricare direttamente l’XML con i metadati del provider di identità dalla propria applicazione SAML. Troverai così l’ID dell’entità, l’URL SSO e il certificato di firma in un unico file.

Dall’applicazione di Okta configurata per Criteo: vai su Accedi → Certificati di firma SAML → Azioni → Visualizza metadati del provider di identità, quindi salva il file XML.

Riferimento:

Microsoft Entra ID (Azure AD)

Due fonti forniscono i valori di cui Criteo ha bisogno:

  • Pagina SSO dell’app aziendale - fornisce l’URL di accesso, l’identificatore di Entra e la possibilità di scaricare il certificato. Accedi all’applicazione aziendale → pagina di configurazione dell’SSO.

  • Endpoint dei metadati della federazione a livello di tenant - spesso la fonte singola più veloce. DIsponibile all’indirizzo: https://login.microsoftonline.com/<tenant>/FederationMetadata/2007-06/FederationMetadata.xml

Riferimenti:

AD FS

AD FS è un software on-premises, quindi non esiste una guida unica rivolta ai clienti che indichi dove trovare i valori. Dovrai seguire due passaggi separati:

  • URL dei metadati di federazione - fornisce l’ID dell’entità e l’endpoint SSO.

  • Certificato di firma dei token - esportabile separatamente dalla console di gestione di AD FS alla voce Servizio → Certificati.

Se hai bisogno di assistenza per interpretare questi riferimenti, contatta la tua persona di riferimento presso Criteo.

Riferimenti:

​Cosa offre Criteo

Una volta avviata la procedura di onboarding, Criteo condivide un file di metadati del fornitore di servizi. Utilizzalo per configurare l’applicazione di Criteo nel tuo provider di identità. Contiene i seguenti valori:

Campo

Descrizione

URI dell’audience (ID entità)

Identificatore univoco per il servizio SSO di Criteo

URL di risposta (URL ACS)

L’URL di destinazione a cui il tuo provider di identità invia l’asserzione SAML dopo un accesso riuscito

Certificato X509

Certificato di firma di Criteo

Processo di onboarding dell’SSO

​Fase1: richiesta di onboarding

Contatta la tua persona di riferimento presso Criteo per avviare il processo di federazione dell’SSO. Una volta registrata la tua richiesta, tale persona di riferimento ti invierà un’email introduttiva contenente:

  • Il file dei metadati SP e i relativi valori chiave: l’URI dell’audience (ID entità), l’URL di risposta (URL ACS), il formato NameID e il certificato X509. Tali valori sono necessari per configurare Criteo come fornitore di servizi nel proprio provider di identità.

  • Un elenco di domande a cui Criteo richiede di rispondere prima di poter procedere con l’integrazione.

Inoltra questa email alle persone responsabili di queste operazioni nel tuo team informatico, in modo che possano avviare la configurazione del provider di identità.

Fase 2: configurazione del provider di identità e della risposta

Utilizzando il file di metadati SP fornito da Criteo, configura Criteo come fornitore di servizi nel tuo provider di identità. Se il tuo provider di identità supporta il caricamento dei metadati, puoi utilizzare direttamente il file. In caso contrario, inserisci manualmente i singoli valori nella configurazione SAML.

Una volta completata la configurazione del tuo provider di identità, rispondi all’email introduttiva fornendo quanto segue:

  1. Il file dei metadati del tuo provider di identità: allega il file XML alla tua risposta. In alternativa, è possibile specificare i valori singolarmente:

    • ID entità del provider di identità

    • URL dell’endpoint dell’SSO

    • Certificato di firma

  2. Domini da federare: i domini email che devono utilizzare l’SSO (ad es., @latuaazienda.com)

  3. Provider di identità: il nome (ad esempio, Microsoft Entra ID, Okta, AD FS)

  4. Identificativo utente: l’attributo SAML che Criteo utilizzerà per la corrispondenza degli utenti. Criteo consiglia di utilizzare emailAddress

  5. Utenti di prova: gli indirizzi email degli utenti che testeranno l’SSO prima del lancio

  6. Ambiente: se si intende fornire un file di metadati separato per l’ambiente di produzione

  7. Data prevista per l’entrata in funzione (facoltativo)

Fase 3: verifica e configurazione da parte di Criteo

Il team Criteo esamina la tua risposta e verifica i dettagli tecnici. Se dovesse mancare qualcosa o ci fossero punti poco chiari, ti contatteremo direttamente per risolvere il problema prima di procedere.

Una volta completata la convalida, Criteo configura l’SSO per gli utenti di prova da te indicati e ti comunica che è possibile dare inizio alla fase di test.

Fase 4: Test di attivazione

Criteo abilita l’SSO solo per gli utenti selezionati per il test, non ancora per tutti gli utenti del dominio. Riceverai un URL via email per iniziare il test.

Per ottenere risultati ottimali, ogni utente dovrebbe verificare il funzionamento dell’SSO seguendo la procedura riportata di seguito:

  1. Apri una finestra in incognito per impedire l’utilizzo dei cookie o delle sessioni esistenti.

  2. Vai su account.criteo.com e inserisci il tuo indirizzo email di lavoro.

  3. Ti reindirizzeremo alla pagina di accesso della tua azienda.

  4. Accedi utilizzando le credenziali della tua azienda (non quelle del tuo account di Criteo).

  5. Una volta completata con successo l’autenticazione, verrà visualizzata la pagina Informazioni account con i tuoi dati personali. Ciò conferma che il test SSO è andato a buon fine.

Una volta completato il test, potrai accedere alla tua piattaforma Criteo come di consueto.

In questa fase, l’SSO viene attivato per ciascun utente. Gli altri utenti continueranno ad accedere come di consueto fino al momento del lancio.

Fase 5: Test

Gli utenti di prova effettuano l’accesso tramite l’URL fornito da Criteo e verificano che:

  • Vengono reindirizzati alla pagina di accesso del tuo provider di identità.

  • Dopo aver effettuato l’accesso, vengono reindirizzati al proprio account di Criteo.

  • Possono visualizzare gli account e i dati corretti.

Se dovessi riscontrare qualche problema, invia a Criteo delle schermate o i messaggi di errore tramite la stessa conversazione email. L’integrazione può essere annullata su richiesta durante questa fase.

Fase 6: attivazione

Quando tutti gli utenti di prova saranno in grado di effettuare l’accesso correttamente, Criteo attiverà l’SSO per tutti gli utenti dei tuoi domini federati alla data concordata.

Se dovesse verificarsi un problema dopo la messa in produzione, contatta Criteo per ripristinare la configurazione precedente o correggere il problema.

Manutenzione continua del sistema SSO

Alcuni campi vengono impostati durante la fase iniziale di inserimento e raramente devono essere modificati. Altri richiedono aggiornamenti periodici per tutta la durata dell’integrazione.

Modificati raramente

Questi parametri vengono impostati durante la fase di onboarding e rimangono costanti:

  • ID entità del fornitore di servizi

  • ACS del fornitore di servizi/URL di risposta

  • ID entità del provider di identità

  • Attributo SAML utilizzato per la corrispondenza degli utenti

​Aggiornati nel corso del tempo

Campo

Perché cambia

Certificato di firma digitale del provider di servizi Criteo

Valido per cinque anni dalla data di emissione. Criteo ti avviserà quando sarà necessario effettuare il rinnovo.

Il certificato di firma del tuo provider di identità

La durata varia a seconda della configurazione del proprio provider di identità. Aggiornalo prima della scadenza: invia in anticipo a Criteo il file dei metadati aggiornato.

Domini di email federati

Dopo l’attivazione, è possibile aggiungere nuovi domini o rimuovere quelli obsoleti.

Metadati del provider di identità

Potrebbe essere necessario un aggiornamento in caso di migrazione dei sistemi del provider di identità o di un cambiamento di ambiente.

Per aggiornare uno qualsiasi di questi campi dopo la messa in produzione, contatta la tua persona di riferimento presso Criteo.