Delen via

Zelfstudie: Contentful configureren voor automatische gebruikersinrichting

  • Artikel

In dit artikel worden de stappen beschreven die u moet uitvoeren in Contentful en in Microsoft Entra ID om automatische inrichting van gebruikers te configureren. Wanneer deze is geconfigureerd, richt Microsoft Entra ID gebruikers en groepen automatisch in op Contentful met behulp van de Microsoft Entra-inrichtingsservice. Voor belangrijke informatie over wat deze service doet en hoe deze werkt, en voor veelgestelde vragen, raadpleegt u Het inrichten en ongedaan maken van inrichting van gebruikers automatiseren voor SaaS-toepassingen met Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Gebruikers maken in Contentful
  • Gebruikers uit Contentful verwijderen wanneer ze geen toegang meer nodig hebben
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Contentful
  • Groepen en groepslidmaatschappen inrichten in Contentful
  • Eenmalige aanmelding bij Contentful (aanbevolen)

Vereisten

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

Implementatie van de inrichting plannen

  1. Lees hoe de inrichtingsservice werkt.
  2. Bepaal wie u wilt opnemen in het bereik voor inrichting.
  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 Servicegebruiker-account. Alle inrichtingsmachtigingen voor Azure worden verstrekt via dit account. U wordt aangeraden Eigenaar te kiezen als organisatierol voor dit account.

  2. Meld u aan bij Contentful als de Servicegebruiker.

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

    Schermopname van het menu Organisatie-instellingen in Contentful, met Gebruikersinrichting gemarkeerd onder Toegangshulpprogramma's.

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

  5. Selecteer Persoonlijk toegangstoken genereren.

    Schermopname van de SCIM-URL om een persoonlijk toegangstoken te 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 deze waarden en sla ze op. U voert deze waarden in op het tabblad Inrichten van uw Contentful-toepassing.

    Schermopname van het deelvenster Persoonlijk toegangstoken, met C F P A T en de tijdelijke aanduiding van het token gemarkeerd.

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

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 voor het eerst te testen. Meer informatie over een toepassing toevoegen vanuit de galerie.

Definiëren wie u wilt opnemen in het bereik voor inrichting

U kunt de Microsoft Entra-inrichtingsservice gebruiken om te bepalen wie wordt 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 wordt ingericht voor uw toepassing op basis van toewijzing, voert u de volgende stappen uit om gebruikers en groepen aan de toepassing toe te wijzen.

Als u ervoor kiest om uitsluitend te bepalen wie wordt ingericht op basis van kenmerken van de gebruiker of groep, gebruikt u een bereikfilter om voorwaardelijke regels te definiëren voor het inrichten van gebruikersaccounts.

  • Wanneer u gebruikers en groepen toewijst aan Contentful, moet u een andere rol dan Standaardtoegang selecteren. Gebruikers met de rol Standaardtoegang worden uitgesloten van inrichting en worden in de inrichtingslogboeken gemarkeerd als niet-effectief bevoegd. Als de rol 'Standaardtoegang' de enige beschikbare rol voor de toepassing is, kunt u het manifest van de toepassing bijwerken om meer rollen toe te voegen.
  • Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het inrichtingsbereik is ingesteld op toegewezen gebruikers en groepen, kunt u het bereik beheren door een of twee gebruikers of groepen aan de toepassing toe te wijzen. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van kenmerken opgeven.

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 gebruikersinrichting configureren voor Contentful in Microsoft Entra-id

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>.

    Schermopname van het menu Ondernemingstoepassingen in de Azure Portal met Alle toepassingen gemarkeerd.

  3. Selecteer Contentful in de lijst met toepassingen.

    Schermopname van de eerste 20 geretourneerde resultaten in de lijst Toepassingen.

  4. Selecteer het tabblad Inrichten.

    Schermopname van de sectie Beheren in het linkermenu met het tabblad Inrichten gemarkeerd.

  5. Stel Inrichtingsmodus in op Automatisch.

    Schermopname van de opties van Inrichtingsmodus met Automatisch gemarkeerd.

  6. Voer in de sectie Referenties voor beheerder waarden in voor de tenant-URL en het geheime token voor Contentful. Selecteer Test Verbinding maken ion om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Contentful. Als de verbinding mislukt, controleert u of uw Contentful-account beheerdersmachtigingen heeft. Probeer het daarna opnieuw.

    Schermopname van de tekstvakken voor de tenant-URL en het geheime token, met de knop Verbinding testen gemarkeerd.

  7. Voer bij E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de inrichtingsfoutmeldingen zou moeten ontvangen. Zet vervolgens een vinkje in het selectievakje Een e-mail verzenden wanneer er een fout optreedt.

    Schermopname van het tekstvak E-mailmelding.

  8. Selecteer Opslaan.

  9. Selecteer in de sectie Toewijzingen Microsoft Entra-gebruikers synchroniseren met Contentful.

  10. Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die zijn gesynchroniseerd van Microsoft Entra-id naar Contentful. 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 API van Contentful het filteren van gebruikers op basis van dat kenmerk kan ondersteunen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk Type Ondersteund voor filteren
    gebruikersnaam String ✓
    name.givenName String
    name.familyName String

  11. Selecteer In de sectie Toewijzingen microsoft Entra-groepen synchroniseren met Contentful.

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

    Kenmerk Type Ondersteund voor filteren
    displayName String ✓
    leden Verwijzing

  13. Als u bereikfilters wilt instellen, voert u de stappen uit die worden beschreven in de zelfstudie over bereikfilters.

  14. Als u de Microsoft Entra-inrichtingsservice voor Contentful wilt inschakelen, selecteert u in de sectie Instellingen voor inrichtingsstatus de optie Aan.

    Schermopname van de schakelaar voor Inrichtingsstatus.

  15. Als u de gebruikers of groepen wilt definiëren die u voor Contentful wilt inrichten, selecteert u in de sectie Instellingen bij Bereik de relevante optie.

    Schermopname van de opties waaruit u kunt kiezen in het deelvenster Bereik.

  16. Selecteer Opslaan als u klaar bent voor het inrichten.

    Schermopname van de knop Opslaan en de knop Annuleren.

Met deze bewerking wordt de eerste synchronisatiecyclus gestart van alle gebruikers en groepen die zijn gedefinieerd in Bereik onder Instellingen. De eerste cyclus duurt langer dan volgende cycli, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd.

Uw implementatie bewaken

Nadat u het inrichten hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te controleren:

  • Bekijk de inrichtingslogboeken om te bepalen welke gebruikers al dan niet met succes zijn ingericht.
  • Controleer de voortgangsbalk om de status van de inrichtingscyclus te bekijken en te zien of deze al bijna is voltooid.
  • Als het configureren van de inrichting een foutieve status lijkt te hebben, wordt de toepassing in quarantaine geplaatst. Meer informatie over quarantainestatussen.

Volgende stappen