Integrazione di Microsoft Entra SSO con Contentstack

  • Articolo

In questa esercitazione si apprenderà come integrare Contentstack con Microsoft Entra ID. Integrando Contentstack con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Contentstack.
  • Abilitare gli utenti per l'accesso automatico a Contentstack con gli account Microsoft Entra personali.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Per integrare Microsoft Entra ID con Contentstack, è necessario:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Sottoscrizione di Contentstack abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

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

  • Contentstack supporta l'accesso SSO avviato da SP e IDP .
  • Contentstack supporta il provisioning utenti JIT .

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

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare Contentstack nella casella di ricerca.
  4. Selezionare Contentstack nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli e seguire anche la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso SSO di Microsoft Entra per Contentstack

Configurare e testare l'accesso SSO di Microsoft Entra con Contentstack 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 Contentstack.

Per configurare e testare l'accesso SSO di Microsoft Entra con Contentstack, 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. Assegnare l'utente di test di Microsoft Entra : per abilitare B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di Contentstack: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Contentstack: per avere una controparte di B.Simon in Contentstack collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Microsoft Entra

Seguire questa procedura per abilitare Microsoft Entra SSO nell'interfaccia di amministrazione di Microsoft Entra.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come applicazione cloud Amministrazione istrator e passare ad Applicazioni> aziendali di identità.>

  2. Fare clic su + Nuova applicazione e cercare Contentstack e quindi fare clic su Crea. Dopo la creazione, passare a Configura accesso Single Sign-On o fare clic sul collegamento Single Sign-On dal menu a sinistra.

    Screenshot shows the new application creation.

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

    Screenshot shows how to select a single sign-on method.

  4. 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.

    Screenshot shows how to edit Basic SAML Configuration.

  5. Nella sezione Configurazione SAML di base è necessario eseguire alcuni passaggi. Per ottenere le informazioni necessarie per questi passaggi, è prima necessario passare all'applicazione Contentstack e creare il nome SSO e l'URL ACS nel modo seguente:

    a. Accedere all'account Contentstack, passare alla pagina Organizzazione Impostazioni e fare clic sulla scheda Single Sign-On.

    Screenshot shows the steps for Basic SAML Configuration.

    b. Immettere un nome SSO preferito e fare clic su Crea.

    Screenshot shows how to enter or create name.

    Nota

    Ad esempio, se il nome della società è "Acme, Inc". immettere "acme" qui. Questo nome verrà usato come una delle credenziali di accesso degli utenti dell'organizzazione durante l'accesso. Il nome SSO può contenere solo alfabeti (in lettere minuscole), numeri (0-9) e/o trattini (-).

    c. Quando si fa clic su Crea, verrà generato l'URL del servizio consumer di asserzione o l'URL ACS e altri dettagli, ad esempio ID entità, attributi e formato NameID.

    Screenshot shows generating the values to configure.

  6. Nella sezione Configurazione SAML di base incollare rispettivamente l'IDentità e l'URLACS generato nel set di passaggi precedente, rispetto alle sezioni Identificatore (ID entità) e URL di risposta e salvare le voci.

    1. Nella casella di testo Identificatore incollare il valore entity ID copiato da Contentstack.

      Screenshot shows how to paste the Identifier value.

    2. Nella casella di testo URL di risposta incollare l'URL ACS copiato da Contentstack.

      Screenshot shows how to paste the Reply URL.

  7. Questo è un passaggio facoltativo. Se si vuole configurare l'applicazione in modalità avviata da SP, immettere l'URL di accesso nella sezione URL di accesso:

    Screenshot shows how to paste the Sign on URL.

    Nota

    Quando si completa la configurazione dell'accesso SSO, ovvero l'URL di accesso, si trova l'URL di accesso. Screenshot shows how to enable the access page.

  8. L'applicazione Contentstack 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.

    Screenshot shows the image of attributes configuration.

  9. Oltre a quanto sopra, l'applicazione Contentstack prevede il passaggio di altri attributi nella risposta SAML, come illustrato di seguito. Anche questi attributi vengono prepopolati, ma è possibile esaminarli in base ai requisiti. Questo è un passaggio facoltativo.

    Nome Attributo di origine
    ruoli. user.assignedroles

    Nota

    Fare clic qui per sapere come configurare il ruolo in Microsoft Entra ID.

  10. 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.

    Screenshot shows the Certificate download link.

  11. Nella sezione Configura Contentstack copiare gli URL appropriati in base alle esigenze.

    Screenshot shows to copy configuration URLs.

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test nell'interfaccia di amministrazione di Microsoft Entra di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.
  2. Passare a Identità>Utenti>Tutti gli utenti.
  3. Selezionare Nuovo utente Crea nuovo utente> nella parte superiore della schermata.
  4. Nelle proprietà Utente seguire questa procedura:
    1. Nel campo Nome visualizzato immettere B.Simon.
    2. Nel campo Nome entità utente immettere .username@companydomain.extension Ad esempio: B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
    4. Selezionare Rivedi e crea.
  5. Seleziona Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra concedendole l'accesso a Contentstack.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Contentstack delle applicazioni aziendali delle applicazioni>>di identità.>
  3. Nella pagina di panoramica dell'app selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/gruppo, quindi utenti e gruppi nella finestra di dialogo Aggiungi assegnazione .
    1. 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.
    2. 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".
    3. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di Contentstack

  1. Accedere al sito aziendale di Contentstack come amministratore.

  2. Passare alla pagina Organization Impostazioni (Organizzazione) e fare clic sulla scheda Single Sign-On (Single Sign-On) nel menu a sinistra.

  3. Nella pagina Single Sign-On passare alla sezione SSO Configuration (Configurazione SSO) e seguire questa procedura:

    1. Immettere un nome SSO valido a scelta e fare clic su Crea.

      Screenshot shows settings of the configuration.

      Nota

      Ad esempio, se il nome della società è "Acme, Inc". immettere "acme" qui. Questo nome verrà usato come una delle credenziali di accesso degli utenti dell'organizzazione durante l'accesso. Il nome SSO può contenere solo alfabeti (in lettere minuscole), numeri (0-9) e/o trattini (-).

    2. Quando si fa clic su Crea, verrà generato l'URL del servizio consumer di asserzione o l'URL ACS e altri dettagli, ad esempio ID entità, attributi e formato NameID, quindi fare clic su Avanti.

      Screenshot shows the configuration values.

  4. Passare alla scheda Configurazione Idp e seguire questa procedura:

    Screenshot shows the login values from Identity.

    1. Nella casella di testo Single Sign-On URL (URL single sign-on) incollare l'URL di accesso copiato dall'interfaccia di amministrazione di Microsoft Entra.

    2. Aprire il certificato (Base64) scaricato dall'interfaccia di amministrazione di Microsoft Entra e caricarlo nel campo Certificato.

    3. Fare clic su Avanti.

  5. Successivamente, è necessario creare il mapping dei ruoli in Contentstack.

    Nota

    Sarà possibile visualizzare ed eseguire questo passaggio solo se il mapping dei ruoli IdP fa parte del piano Contentstack.

  6. Nella sezione Gestione utenti della pagina di installazione SSO di Contentstack verrà visualizzata la modalità Strict (autorizzare l'accesso agli utenti dell'organizzazione solo tramite l'accesso SSO) e il timeout della sessione (definire la durata della sessione per un utente connesso tramite SSO). Sotto queste opzioni verrà visualizzata anche l'opzione Avanzate Impostazioni.

    Screenshot shows User Management section.

  7. Fare clic sul Impostazioni avanzato per espandere la sezione Mapping dei ruoli IdP per eseguire il mapping dei ruoli IdP a Contentstack. Questo è un passaggio facoltativo.

  8. Nella sezione Aggiungi mapping ruoli fare clic sul collegamento + AGGIUNGI MAPPING RUOLO per aggiungere i dettagli di mapping di un ruolo IdP che include i dettagli seguenti:

    Screenshot shows how to add the mapping details.

    1. In IdP Role Identifier (Identificatore ruolo IdP) immettere l'identificatore di gruppo/ruolo IdP (ad esempio "sviluppatori"), che è possibile usare il valore del manifesto.

    2. Per Ruoli organizzazione selezionare Amministrazione o Ruolo membro per il gruppo/ruolo mappato.

    3. Per le autorizzazioni a livello di stack (facoltativo) assegnare stack e i ruoli a livello di stack corrispondenti a questo ruolo. Analogamente, è possibile aggiungere altri mapping dei ruoli per l'organizzazione Contentstack. Per aggiungere un nuovo mapping dei ruoli, fare clic su + AGGIUNGI MAPPING RUOLO e immettere i dettagli.

    4. Mantenere vuoto il delimitatore di ruolo come ID Microsoft Entra restituisce in genere i ruoli in una matrice.

    5. Selezionare infine la casella di controllo Enable IdP Role Mapping (Abilita mapping ruolo IdP) per abilitare la funzionalità e fare clic su Avanti.

    Nota

    Per altre informazioni, vedere la guida all'accesso Single Sign-On di Contentstack.

  9. Prima di abilitare l'accesso SSO, è consigliabile testare le impostazioni SSO configurate finora. Per farlo, effettua i seguenti passaggi:

    1. Fare clic sul pulsante Test SSO per passare alla pagina Accesso di Contentstack tramite SSO in cui è necessario specificare il nome SSO dell'organizzazione.
    2. Fare quindi clic su Continua per passare alla pagina di accesso del provider di identità.
    3. Accedere al proprio account e, se si è in grado di accedere al provider di identità, il test ha esito positivo.
    4. Al termine della connessione, verrà visualizzato un messaggio di operazione riuscita come indicato di seguito.

    Screenshot shows the successful test connection.

  10. Dopo aver testato le impostazioni SSO, fare clic su Abilita SSO per abilitare l'accesso SSO per l'organizzazione contentstack.

    Screenshot shows the enable testing section.

  11. Dopo l'abilitazione, gli utenti possono accedere all'organizzazione tramite SSO. Se necessario, è anche possibile disabilitare l'accesso SSO da questa pagina.

    Screenshot shows disabling the access page.

Creare l'utente di test di Contentstack

In questa sezione viene creato un utente di nome Britta Simon in Contentstack. Contentstack supporta il provisioning utenti JIT, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in Contentstack, ne viene creato uno nuovo dopo l'autenticazione.

Testare l'accesso 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 Test this application (Testa questa applicazione) nell'interfaccia di amministrazione di Microsoft Entra. Verrà eseguito il reindirizzamento all'URL di accesso di Contentstack, in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di Contentstack e avviare il flusso di accesso da questa posizione.

Avviato da IDP:

  • Fare clic su Test this application (Testa questa applicazione) nell'interfaccia di amministrazione di Microsoft Entra e si dovrebbe accedere automaticamente all'istanza di Contentstack per cui si è configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Quando si fa clic sul riquadro di Contentstack nella App personali, se è stato configurato in modalità SP, si dovrebbe essere reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso e, se configurato in modalità IDP, si dovrebbe accedere automaticamente all'istanza di Contentstack per cui si è configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato Contentstack, è 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 sessione con app Microsoft Defender per il cloud.