Configurare Contentful per il provisioning automatico degli utenti con Microsoft Entra ID

Questo articolo descrive i passaggi da completare in Contentful e in Microsoft Entra ID per configurare il provisioning automatico degli utenti. Quando configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning di utenti e gruppi in Contentful usando il servizio di provisioning di Microsoft Entra. Per informazioni dettagliate sul funzionamento di questo servizio e per leggere le risposte a domande frequenti, vedere Automatizzare il provisioning e il deprovisioning utenti in applicazioni SaaS con Microsoft Entra ID.

Capacità supportate

  • Creare utenti in Contentful
  • Rimuovere gli utenti in Contentful quando non richiedono più l'accesso
  • Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Contentful
  • Gestire i gruppi e le appartenenze ai gruppi in Contentful
  • Accesso unico a Contentful (scelta consigliata)

Prerequisiti

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

Pianificare la distribuzione del provisioning

  1. Scopri come funziona il servizio di provisioning.
  2. Determinare chi rientra nell'ambito per la fornitura.
  3. Determinare quali dati mappare tra Microsoft Entra ID e Contentful.

Configurare Contentful per supportare il provisioning con Microsoft Entra ID

  1. In Contentful creare un account utente del servizio . Tutte le autorizzazioni di provisioning per Azure vengono fornite tramite questo account. È consigliabile scegliere Proprietario come ruolo dell'organizzazione per questo account.

  2. Accedere a Contentful come utente del servizio.

  3. Nel menu a sinistra selezionare Impostazioni dell'organizzazione>Access Tools>Provisioning degli utenti.

    Screenshot del menu delle Impostazioni dell'organizzazione in Contentful, con il provisioning degli utenti evidenziato sotto Strumenti di accesso.

  4. Copiare e salvare l'URL SCIM. Questo valore verrà immesso nel portale di Azure nella scheda Provisioning dell'applicazione Contentful.

  5. Selezionare Genera token di accesso personale.

    Screenshot che mostra l'URL SCIM per generare un token di accesso personale.

  6. Nella finestra modale immettere un nome per il token di accesso personale e quindi selezionare Genera.

  7. Vengono generati l'URL SCIM e il token segreto. Copiare e salvare questi valori. Questi valori verranno immessi nella scheda Provisioning dell'applicazione Contentful.

    Screenshot del pannello Token di Accesso Personale, con C F P A T e il nome segnaposto del token evidenziati.

In caso di domande durante la configurazione del provisioning nella console di amministrazione di Contentful, contattare il supporto di Contentful.

Per gestire il provisioning in Contentful, aggiungere Contentful dalla galleria delle applicazioni di Microsoft Entra. Se in precedenza è stato configurato Contentful per l'accesso Single Sign-On, è possibile usare la stessa applicazione. È tuttavia consigliabile creare un'app separata per testare inizialmente l'integrazione. Informazioni su come aggiungere un'applicazione nella raccolta.

Definire chi è nell'ambito del provisioning

Il servizio di provisioning di Microsoft Entra consente di delimitare chi viene fornito in base all'assegnazione all'applicazione o in base agli attributi degli utenti o dei gruppi. Se si sceglie di definire l'ambito dell'app in base all'assegnazione, è possibile utilizzare i passaggi per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito del provisioning in base esclusivamente agli attributi dell'utente o del gruppo, è possibile usare un filtro di ambito.

  • Iniziare con pochi elementi. Eseguire il test con un piccolo insieme di utenti e gruppi prima di distribuirlo a tutti. Quando l'ambito per il provisioning è impostato su utenti e gruppi assegnati, è possibile controllarlo assegnando uno o due utenti o gruppi all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributi.

  • Se sono necessari ruoli aggiuntivi, è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Configurare il provisioning automatico degli utenti in Contentful

Questa sezione illustra i passaggi per configurare il servizio di provisioning Di Microsoft Entra per creare, aggiornare e disabilitare utenti e gruppi in un'app di test in base alle assegnazioni di utenti o gruppi in Microsoft Entra ID.

Configurare il provisioning automatico di utenti per Contentful in Microsoft Entra ID

  1. Accedi al Interfaccia di amministrazione di Microsoft Entra come almeno un amministratore di applicazioni cloud.

  2. Naviga a Entra ID>applicazioni aziendali.

    Screenshot che mostra il menu Applicazioni aziendali nel portale di Azure, con Tutte le applicazioni evidenziate.

  3. Nell'elenco delle applicazioni selezionare Contentful.

    Screenshot che mostra i primi 20 risultati restituiti nell'elenco Delle applicazioni.

  4. Selezionare la scheda Provisioning.

    Screenshot della scheda Provisioning evidenziata nella sezione Gestisci del menu a sinistra.

  5. Selezionare + Nuova configurazione.

    Screenshot della scheda Configurazione automatica.

  6. Nel campo URL del Tenant, inserisci l'URL del Contentful Tenant e il token segreto. Selezionare Test Connection per assicurarsi che Microsoft Entra ID possa connettersi a Contentful. Se la connessione non riesce, verificare che l'account Contentful disponga delle autorizzazioni di amministratore necessarie e riprovare.

    Screenshot della connessione di test del provisioning.

  7. Selezionare Crea per creare la configurazione.

  8. Selezionare Proprietà nella pagina Panoramica .

  9. Nel campo Email di notifica immettere l'indirizzo di posta elettronica di una persona che deve ricevere le notifiche di errore di fornitura e selezionare la casella di controllo Invia una notifica di posta elettronica quando si verifica un errore.

    Screenshot delle proprietà di provisioning.

  10. Selezionare Mapping attributi nel pannello sinistro e selezionare utenti.

  11. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Contentful nella sezione Attribute-Mapping. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Contentful per le operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente, è necessario assicurarsi che l'API Contentful supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per confermare le modifiche.

    Attributo TIPO Supportato per il filtraggio
    nome utente Stringa
    nome.nomeDato Stringa
    nome.cognome Stringa
  12. Nella sezione Mapping attributi è necessario esaminare gli attributi del gruppo che sono sincronizzati da Microsoft Entra ID a Contentful. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Contentful per le operazioni di aggiornamento. Selezionare il pulsante Salva per confermare le modifiche.

    Attributo TIPO Supportato per il filtraggio
    nome visualizzato Stringa
    Membri Riferimento
  13. Per configurare i filtri di ambito, vedere le istruzioni fornite nell'articolo Filtro di ambito.

  14. Usare il provisioning su richiesta per convalidare la sincronizzazione con un numero ridotto di utenti prima di distribuire in modo più ampio nell'organizzazione.

  15. Quando si è pronti per procedere al provisioning, selezionare Avvia il provisioning nella pagina Panoramica.

Monitora la distribuzione

Dopo aver configurato il provisioning, usare le risorse seguenti per monitorare la distribuzione:

  1. Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning correttamente o in modo non riuscito
  2. Controlla la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
  3. Se la configurazione del provisioning sembra essere in cattivo stato, l'applicazione entra in quarantena. Per saperne di più sugli stati di quarantena, consulta l'articolo relativo al provisioning delle applicazioni con stato di quarantena.