Condividi tramite


Configurare Contentful per l'accesso Single Sign-On con Microsoft Entra ID

Questo articolo illustra come integrare Contentful con Microsoft Entra ID. Integrando Contentful con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Contentful.
  • Consenti ai tuoi utenti di accedere automaticamente a Contentful con i loro account Microsoft Entra.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

  • Sottoscrizione abilitata per l'accesso singolo (SSO) di Contentful.

Descrizione dello scenario

In questo articolo viene configurato e testato l'accesso SSO di Microsoft Entra in un ambiente di test.

  • Contentful supporta l'SSO avviato da SP e IDP.
  • Contentful supporta il Just In Time provisioning degli utenti.
  • Contentful supporta il provisioning automatizzato degli utenti.

Nota

L'identificatore di questa applicazione è un valore stringa fisso, quindi è possibile configurare una sola istanza in un tenant.

Per configurare l'integrazione di Contentful in Microsoft Entra ID, è necessario aggiungere Contentful dalla raccolta al proprio elenco di app SaaS gestite.

  1. Accedi al Centro di amministrazione di Microsoft Entra come almeno Amministratore delle applicazioni cloud.
  2. Naviga su Entra ID>Applicazioni aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare Contentful nella casella di ricerca.
  4. Selezionare Contentful nei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tuo tenant.

In alternativa, è anche possibile usare la Procedura guidata di configurazione delle app aziendali. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare i ruoli e procedere alla configurazione dell'accesso SSO. Scopri di più sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per Contentful

Configurare e testare l'accesso SSO di Microsoft Entra con Contentful usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in Contentful.

Per configurare e testare l'accesso SSO di Microsoft Entra con Contentful, seguire questa procedura:

  1. Configurare l'accesso Single Sign-On di Microsoft Entra per consentire agli utenti di usare questa funzionalità.
    1. Creare un utente di test di Microsoft Entra per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
    2. Assegna l'utente di prova di Microsoft Entra per consentire a B.Simon di utilizzare il Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di Contentful: per configurare le impostazioni del Single Sign-On nell'applicazione.
    1. Creare l'utente di test di Contentful : per avere una controparte di B.Simon in Contentful collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare il Single Sign-On di Microsoft Entra

Seguire questa procedura per abilitare l'accesso Single Sign-On di Microsoft Entra.

  1. Accedi al Centro di amministrazione di Microsoft Entra come almeno Amministratore delle applicazioni cloud.

  2. Passare a Entra ID>Enterprise apps>Contentful>Single Sign-On.

  3. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

  4. Nella pagina Configura accesso Single Sign-On con SAML, selezionare l'icona a forma di matita accanto a Configurazione SAML di Base per modificare le impostazioni.

    Modificare la configurazione SAML di base

  5. Nella sezione Configurazione SAML di base, se si vuole configurare l'applicazione in modalità avviata da IDP, seguire questa procedura:

    a) Nella casella di testo URL di risposta, copiare l'URL del servizio consumer di asserzione (ACS) dalla pagina di configurazione di SSO in Contentful. Sarà simile al seguente: https://be.contentful.com/sso/<organization_id>/consume.

  6. Selezionare Imposta URL aggiuntivi e seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da SP :

    a) Nella casella di testo URL di accesso copiare lo stesso URL del servizio di consumatore di asserzioni (ACS). Sarà simile al seguente: https://be.contentful.com/sso/<organization_id>/login.

    Nota

    Questi valori non sono reali. Aggiorna questi valori con l'URL di risposta effettivo e l'URL di accesso copiando l'URL del servizio consumer di asserzione (ACS) dalla pagina di configurazione SSO in Contentful.

  7. L'applicazione Contentful prevede un formato specifico per le asserzioni SAML. È quindi necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi del token SAML. Lo screenshot seguente mostra l'elenco degli attributi predefiniti.

    immagine

  8. Oltre quelli elencati in precedenza, l'applicazione Contentful prevede il passaggio di altri attributi nella risposta SAML. Tali attributi sono indicati di seguito. Anche questi attributi vengono precompilati, ma è possibile esaminarli secondo le proprie esigenze.

    Nome Attributo di origine
    posta elettronica user.nomeutenteprincipale
  9. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare Certificato (Base64) e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    Link per il download del certificato

  10. Nella sezione Configura Contentful copiare l'URL di accesso per configurare l'accesso Single Sign-On di Contentful.

Creare e assegnare un utente di test di Microsoft Entra

Segui le linee guida nel quickstart per creare e assegnare un account utente per creare un account di test chiamato B.Simon.

Configurare il Single Sign-On di Contentful

Per configurare l'accesso Single Sign-On sul lato di Contentful, seguire questa procedura.

  1. In Contentful, vai alla pagina di configurazione dell'accesso Single Sign-On in Organization Settings (Impostazioni dell'organizzazione).
  2. Selezionare Configura SSO.
  3. Copiare e incollare l'URL di accesso dalla sezione Configura Contentful in Microsoft Entra ID.
  4. Copiare e incollare il certificato dal file di certificato Base64 scaricato da Microsoft Entra ID.
  5. Configurare un nome SSO per l'accesso avviato da SP.
  6. Selezionare Abilita SSO.

Se il servizio non funziona, contattare il team di supporto di Contentful.

Creare l'utente di test di Contentful

In questa sezione viene creato un utente di nome B.Simon in Contentful. Contentful supporta il provisioning degli utenti just-in-time, che è abilitato per impostazione predefinita. Non ci sono compiti per te in questa sezione. Se non esiste già un utente in Contentful, ne viene creato uno nuovo dopo l'autenticazione.

Contentful supporta il provisioning automatico degli utenti, puoi trovare più dettagli qui su come configurare il provisioning automatico degli utenti.

Testare SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

Avviato da SP:

  • Selezionare Test this application, questa opzione reindirizza all'URL di accesso di Contentful dove è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di Contentful e avviare il flusso di accesso da lì.

Avviato da IDP:

  • Selezionare Test this application (Testa questa applicazione) e si dovrebbe accedere automaticamente all'istanza di Contentful per cui si è configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Quando si seleziona il riquadro Contentful in Le mie app, se è stato configurato in modalità SP, si viene reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di login. Se configurato in modalità IDP, si accede automaticamente all'istanza di Contentful per cui si è configurato l'SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Dopo aver configurato Contentful, è possibile applicare il controllo sessione che consente di proteggere in tempo reale l'esfiltrazione e l'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo della sessione con Microsoft Defender for Cloud Apps.