Delen via

Integratie van eenmalige aanmelding van Microsoft Entra met Contentful

  • Artikel

In dit artikel leert u hoe u Contentful integreert met Microsoft Entra ID. Wanneer u Contentful integreert met Microsoft Entra ID, kunt u het volgende doen:

  • In Microsoft Entra-id bepalen wie toegang heeft tot Contentful.
  • Ervoor zorgen dat gebruikers automatisch met hun Microsoft Entra-account worden aangemeld bij Contentful.
  • Beheer uw accounts op één centrale locatie.

Vereisten

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

  • Een Contentful-abonnement waarvoor single sign-on (SSO) is ingeschakeld.

Beschrijving van scenario

In dit artikel configureer en test je Microsoft Entra SSO in een testomgeving.

  • Contentful ondersteunt SSO geïnitieerd door SP en IDP.
  • Contentful biedt ondersteuning voor Just-In-Time-inrichting van gebruikers.
  • Contentful ondersteunt het geautomatiseerd inrichten van gebruikers.

Notitie

De id van deze toepassing is een vaste tekenreekswaarde zodat maar één instantie in één tenant kan worden geconfigureerd.

Voor het configureren van de integratie van Contentful in Microsoft Entra ID moet u Contentful vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een Cloudtoepassingsbeheerder.
  2. Blader naar Identiteit>Toepassingen>Ondernemingstoepassingen>Nieuwe toepassing.
  3. Typ in de sectie Toevoegen uit de galerie in het zoekvak: Contentful.
  4. Selecteer Contentful in de resultaten en voeg vervolgens de app toe. Wacht een paar seconden terwijl de app aan je tenant wordt toegevoegd.

U kunt ook alternatieve de Enterprise App Configuration Wizard gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en ook de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Microsoft Entra SSO voor Contentful configureren en testen

Configureer en test Microsoft Entra SSO met Contentful met een testgebruiker genaamd B.Simon. SSO werkt wanneer u een koppelingsrelatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in Contentful.

Om Microsoft Entra SSO met Contentful te configureren en te testen, voert u de volgende stappen uit:

  1. Configureer Microsoft Entra SSO - zodat uw gebruikers deze functie kunnen gebruiken.
    1. Een Microsoft Entra-testgebruiker maken : eenmalige aanmelding van Microsoft Entra testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen eenmalige aanmelding van Microsoft Entra te gebruiken.
  2. Eenmalige aanmelding voor Contentful configureren: als u de instellingen voor eenmalige aanmelding aan de toepassingszijde wilt configureren.
    1. Testgebruiker voor Contentful maken: als u een tegenhanger van B.Simon in Contentful wilt hebben die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
  3. Eenmalige aanmelding testen: om te controleren of de configuratie werkt.

Microsoft Entra SSO configureren

Volg deze stappen om Microsoft Entra SSO in te schakelen.

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

  2. Blader naar Identity>Applicaties>Enterprise-applicaties>Contentful>Single sign-on.

  3. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

  4. Op de pagina Eenmalige aanmelding instellen met SAML klikt u op het potloodpictogram voor Standaard-SAML-configuratie om de instellingen te bewerken.

    Standaard SAML-configuratie bewerken

  5. In het gedeelte Standaard SAML-configuratie voert u de volgende stappen uit als u de toepassing in de door IDP geïnitieerde modus wilt configureren:

    a. Kopieer in het tekstvak Antwoord-URL de ACS-URL (Assertion Consumer Service) van de pagina SSO Setup in Contentful. Deze ziet er als volgt uit: https://be.contentful.com/sso/<organization_id>/consume.

  6. Klik op Extra URL's instellen en voer de volgende stap uit als u de toepassing in de door SP geïnitieerde modus wilt configureren:

    a. Kopieer in het tekstvak Aanmeldings-URL dezelfde ACS-URL. Deze ziet er als volgt uit: https://be.contentful.com/sso/<organization_id>/login.

    Notitie

    Dit zijn geen echte waarden. Werk deze waarden bij met de juiste antwoord-URL en aanmeldings-URL door de ACS-URL te kopiëren van de SSO Setup-pagina in Contentful.

  7. In Contentful worden de SAML-asserties in een specifieke indeling verwacht. Hiervoor moet u aangepaste kenmerktoewijzingen toevoegen aan de configuratie van uw SAML-tokenkenmerken. In de volgende schermafbeelding wordt de lijst met standaardkenmerken weergegeven.

    image

  8. Bovendien verwacht Contentful nog enkele kenmerken die als SAML-antwoord moeten worden doorgestuurd. Deze worden hieronder weergegeven. Deze kenmerken worden ook vooraf ingevuld, maar u kunt ze controleren volgens uw vereisten.

    Naam Bronkenmerk
    e-mailadres user.userprincipalname

  9. Op de pagina Eenmalige aanmelding met SAML instellen in de sectie SAML-handtekeningcertificaat gaat u naar Certificaat (Base64) en selecteert u Downloaden om het certificaat te downloaden en op te slaan op uw computer.

    De link om het certificaat te downloaden

  10. In de sectie Contentful instellen, kopieer de aanmeldings-URL om Contentful SSO te configureren.

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruikersbeheerder.
  2. Blader naar Identiteit>Gebruikers>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker>Maak nieuwe gebruiker bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld WeergavenaamB.Simon in.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. Bijvoorbeeld: B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Controleren + maken.
  5. Selecteer Aanmaken.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie geeft u B.Simon toestemming om eenmalige aanmelding te gebruiken door toegang te verlenen tot Contentful.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een Cloudtoepassingsbeheerder.
  2. Blader naar Identity>Toepassingen>Bedrijfstoepassingen>Contentful.
  3. Selecteer gebruikers en groepen op de overzichtspagina van de app.
  4. Selecteer Gebruiker/groep toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
    2. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
    3. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

Contentful SSO configureren

Volg deze stappen voor het configureren van eenmalige aanmelding in Contentful.

  1. Ga in Contentful naar de pagina SSO Setup in Organization Settings.
  2. Klik op Set up SSO.
  3. Kopieer en plak de aanmeldings-URL uit de sectie Contentful instellen in Microsoft Entra-id.
  4. Kopieer en plak het certificaat uit het Base64-certificaatbestand dat u hebt gedownload van Microsoft Entra-id.
  5. Stel een SSO-naam in voor bij SP-geïnitieerde login.
  6. Klik op Enable SSO.

Als dat niet werkt, neemt u contact op met het ondersteuningsteam van Contentful.

Testgebruiker maken voor Contentful

In deze sectie wordt een gebruiker met de naam B.Simon gemaakt in Contentful. Contentful biedt ondersteuning voor just-in-time-inrichting van gebruikers, wat standaard is ingeschakeld. Er is geen actie-item voor u in deze sectie. Als er nog geen gebruiker in Contentful bestaat, wordt er een nieuwe gemaakt nadat deze is geverifieerd.

Contentful ondersteunt ook automatische inrichting van gebruikers. Meer details over het configureren van automatische inrichting van gebruikers vindt u hier.

Test SSO

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

Door SP geïnitieerd

  • Klik op Deze toepassing testen. U wordt omgeleid naar de aanmeldings-URL van Contentful, waar u de aanmeldingsstroom kunt initiëren.

  • Ga rechtstreeks naar de aanmeldings-URL van Contentful en initieer hier de aanmeldingsstroom.

IDP geïnitieerd:

  • Klik op Test deze toepassing, en u wordt automatisch aangemeld bij het exemplaar van Contentful waarvoor u de SSO hebt ingesteld.

U kunt ook Mijn apps van Microsoft gebruiken om de toepassing in een willekeurige modus te testen. Wanneer u in Mijn apps op de tegel Contentful klikt en deze is geconfigureerd in de SP-modus, wordt u doorgestuurd naar de aanmeldingspagina van de applicatie om de inlogprocedure te starten. Als deze is geconfigureerd in de IDP-modus, wordt u automatisch aangemeld bij het Contentful-exemplaar waarvoor u eenmalige aanmelding (SSO) hebt ingesteld. Zie Introduction to My Apps (Inleiding tot Mijn apps) voor meer informatie over Mijn apps.

Verwante inhoud

Nadat u Contentful hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.