Integrazione dell'accesso unico (SSO) di Microsoft Entra con Contentful
In questo articolo si apprenderà 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:
- Un account utente di Microsoft Entra con una sottoscrizione attiva. Chi non ha ancora un account può crearlo gratuitamente.
- Uno dei ruoli 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'accesso 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.
Aggiungi Contentful dalla selezione
Per configurare l'integrazione di Contentful in Microsoft Entra ID, è necessario aggiungere Contentful dalla raccolta al proprio elenco di app SaaS gestite.
- Accedi al Centro di amministrazione di Microsoft Entra come almeno Amministratore delle applicazioni cloud.
- Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
- Nella sezione Aggiungi dalla raccolta digitare Contentful nella casella di ricerca.
- 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 Configurazione guidata app aziendali. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni 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:
-
Configurare l'accesso Single Sign-On di Microsoft Entra per consentire agli utenti di usare questa funzionalità.
- Creare un utente di test di Microsoft Entra per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
- Assegnare l'utente di test di Microsoft Entra per permettere a B.Simon di utilizzare l'accesso singolo di Microsoft Entra.
-
Configurare l'accesso Single Sign-On di Contentful: per configurare le impostazioni del Single Sign-On nell'applicazione.
- Creare utente di test di Contentful: per avere una controparte di B.Simon in Contentful collegata alla rappresentazione di un utente in Microsoft Entra.
- 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.
Accedi al Centro di amministrazione di Microsoft Entra con almeno i privilegi di Amministratore delle applicazioni cloud.
Passare a Identità>Applicazioni>Applicazioni aziendali>Contentful>Accesso singolo.
Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.
Nella pagina Configura l'accesso Single Sign-On con SAML fare clic sull'icona della matita per modificare le impostazioni di Configurazione SAML di base.
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
.Fare clic su Impostare 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 non sono i valori 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.
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.
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 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.
Nella sezione Configura Contentful copiare l'URL di accesso per configurare l'accesso Single Sign-On di Contentful.
Creare un utente di test di Microsoft Entra
In questa sezione verrà creato un utente di test di nome B.Simon.
- Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.
- Passare a Identità>Utenti>Tutti gli utenti.
- Selezionare Nuovo utente>Crea nuovo utente nella parte superiore della schermata.
- In Proprietà utente seguire questa procedura:
- Nel campo Nome visualizzato inserire
B.Simon
. - Nel campo Nome principale utente, immettere username@companydomain.extension. Ad esempio:
B.Simon@contoso.com
. - Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
- Selezionare Rivedi e crea.
- Nel campo Nome visualizzato inserire
- Seleziona Crea.
Assegna l'utente di test di Microsoft Entra
In questa sezione abiliterai B.Simon all'uso del Single Sign-On concedendo l'accesso a Contentful.
- Accedi al centro di amministrazione di Microsoft Entra come minimo come Amministratore dell'applicazione cloud.
- Passare a Identità>Applicazioni>Applicazioni di impresa>Contentful.
- Nella pagina della panoramica dell'app selezionare Utenti e gruppi.
- Selezionare Aggiungi utente/gruppo, quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
- Nella finestra di dialogo Utenti e gruppi selezionare B.Simon dall'elenco degli utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
- Se si prevede che agli utenti venga assegnato un ruolo, è possibile selezionarlo nell'elenco a discesa Selezionare un ruolo. Se per questa app non è stato configurato alcun ruolo, il ruolo selezionato è "Accesso predefinito".
- Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.
Configurare il Single Sign-On di Contentful
Per configurare l'accesso Single Sign-On sul lato di Contentful, seguire questa procedura.
- In Contentful, vai alla pagina di configurazione dell'accesso Single Sign-On in Organization Settings (Impostazioni dell'organizzazione).
- Fare clic su Set up SSO (Configura SSO).
- Copiare e incollare l'URL di accesso dalla sezione Configura Contentful in Microsoft Entra ID.
- Copiare e incollare il certificato dal file di certificato Base64 scaricato da Microsoft Entra ID.
- Configurare un nome SSO per l'accesso avviato da SP.
- Fare clic su Enable SSO (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 è necessario alcun intervento dell'utente 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:
Fare clic su Testa questa applicazione, verrà eseguito il reindirizzamento all'URL di accesso di Contentful, nel quale è 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:
- Fare clic su 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 fai clic sul riquadro Contentful nelle mie app, se configurato in modalità SP, verrai reindirizzato alla pagina di accesso dell'applicazione per avviare il flusso di accesso e, se configurato in modalità IDP, verrai autenticato automaticamente all'istanza di Contentful per cui hai configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.
Contenuto correlato
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.