Contentful configureren voor automatische gebruikersvoorziening met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in Contentful en in Microsoft Entra ID om automatische gebruikersvoorziening te configureren. Wanneer deze is geconfigureerd, voorziet en verwijdert Microsoft Entra ID gebruikers en groepen automatisch naar Contentful door gebruik te maken van de Microsoft Entra-voorzieningsservice. Voor belangrijke informatie over wat deze service doet en hoe deze werkt, en voor veelgestelde vragen, raadpleegt u Automatiseer het inrichten en uitschrijven van gebruikers voor SaaS-applicaties met Microsoft Entra ID.

Ondersteunde mogelijkheden

Vereiste voorwaarden

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

• een Microsoft Entra-tenant.
• Een van de volgende rollen: Toepassingsbeheerder, Cloudtoepassingsbeheerder of Toepassingseigenaar.
• Een Contentful-organisatieaccount met een abonnement dat ondersteuning biedt voor voorzieningen voor SCIM (System for Cross-Domain Identity Management). Als u vragen hebt over het abonnement van uw organisatie, neemt u contact op met Contentful Support.

Voorzieningsimplementatie plannen

1. Meer informatie over hoe de leveringsservice werkt.
2. Bepaal wie binnen de reikwijdte van de voorziening valt.
3. Bepaal welke gegevens moeten worden toegewezen tussen Microsoft Entra ID en Contentful.

Contentful configureren ter ondersteuning van inrichting met Microsoft Entra-id

1. Maak in Contentful een servicegebruikersaccount . Alle inrichtingsmachtigingen voor Azure worden verstrekt via dit account. U wordt aangeraden Eigenaar te kiezen als organisatierol voor dit account.

2. Meld u als servicegebruiker aan bij Contentful.

3. Selecteer in het linkermenu Organisatie-instellingen>Toegangshulpprogramma's>voor gebruikersinrichting.

   

4. Kopieer en sla de SCIM-URL op. U voert deze waarde in Azure Portal in op het tabblad Inrichten van uw Contentful-toepassing.

5. Selecteer Persoonlijk toegangstoken genereren.

   

6. Voer in het modale venster een naam in voor uw persoonlijke toegangstoken en selecteer Vervolgens Genereren.

7. De SCIM-URL en het geheime token worden gegenereerd. Kopieer en sla deze waarden op. U voert deze waarden in op het tabblad Inrichten van uw Contentful-toepassing.

   

Als u vragen hebt tijdens het configureren van inrichting in de Contentful-beheerconsole, neemt u contact op met de ondersteuning van Contentful.

Contentful toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Als u het inrichten voor Contentful wilt beheren, voegt u Contentful toe vanuit de Microsoft Entra-toepassingsgalerie. Als u Contentful eerder hebt ingesteld voor eenmalige aanmelding, kunt u dezelfde toepassing gebruiken. We raden u echter aan een afzonderlijke app te maken om de integratie in eerste instantie te testen. Meer informatie over het toevoegen van een toepassing in de galerie.

Bepaal wie binnen de scope van voorziening valt

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie is ingericht op basis van toewijzing aan de toepassing of op basis van kenmerken van de gebruiker of groep. Als u ervoor kiest om te bepalen wie voor uw app is ingericht op basis van toewijzing, kunt u de stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen is ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfilter gebruiken.

• Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het bereik voor inrichting is ingesteld op toegewezen gebruikers en groepen, kunt u dit beheren door een of twee gebruikers of groepen toe te wijzen aan de app. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van kenmerken opgeven.

• Als u extra rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Automatische gebruikersinrichting configureren voor Contentful

In deze sectie wordt u begeleid bij de stappen voor het instellen van de Microsoft Entra-inrichtingsservice om gebruikers en groepen in een test-app te maken, bij te werken en uit te schakelen op basis van gebruikers- of groepstoewijzingen in Microsoft Entra ID.

Automatische gebruikersprovisioning configureren voor Contentful in Microsoft Entra ID

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.

2. Navigeer naar Entra ID>Enterprise apps.

   

3. Selecteer Contentful in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Selecteer + Nieuwe configuratie.

   

6. Voer in het veld Tenant URL uw Contentful Tenant URL en Secret Token in. Selecteer Test Connection om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Contentful. Als de verbinding mislukt, moet u ervoor zorgen dat uw Contentful-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

   

7. Selecteer Maken om uw configuratie te maken.

8. Selecteer Eigenschappen op de pagina Overzicht .

9. Voer in het veld E-mailmelding het e-mailadres in van een persoon die de meldingen over inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt .

   

10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

11. Controleer in de sectie Attribute-Mapping de gebruikerskenmerken die vanuit Microsoft Entra ID met Contentful worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Contentful te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Contentful-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Eigenschap	Typologie	Ondersteund voor filteren
    gebruikersnaam	Snaar / Touwtje	✓
    naam.gegevenNaam	Snaar / Touwtje
    naam.familienaam	Snaar / Touwtje

12. Controleer in de sectie Kenmerktoewijzing de groepskenmerken die zijn gesynchroniseerd van Microsoft Entra-id naar Contentful. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in Contentful te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Eigenschap	Typologie	Ondersteund voor filteren
    weergaveNaam	Snaar / Touwtje	✓
    leden	Referentie

13. Als u bereikfilters wilt configureren, raadpleegt u de instructies in het artikel Bereikfilter.

14. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

15. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

1. Gebruik de provisioning logs om te bepalen welke gebruikers wel of niet succesvol zijn geprovisioneerd.
2. Controleer de voortgangsbalk om de status van de implementatiecyclus te bekijken en te zien hoe dicht deze bij voltooiing is.
3. Als de toepassingsconfiguratie in een ongezonde toestand lijkt te verkeren, wordt de applicatie in quarantaine geplaatst. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over de inrichtingsactiviteit
• Inrichting van gebruikersaccounts voor Enterprise Apps beheren
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?