Postman configureren voor automatische voorziening van gebruikers met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Postman als Microsoft Entra ID voor het configureren van automatische gebruikersprovisioning. Wanneer geconfigureerd, verzorgt en verwijdert Microsoft Entra ID gebruikers en groepen automatisch voor Postman met behulp van de Microsoft Entra-inrichtingsservice. Voor meer informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, zie Gebruikersprovisionering en -deprovisioning voor SaaS-toepassingen automatiseren met Microsoft Entra ID.

Ondersteunde mogelijkheden

• Gebruikers maken in Postman.
• Verwijder gebruikers in Postman wanneer ze geen toegang meer nodig hebben.
• Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Postman.
• Groepen en groepslidmaatschappen beheren in Postman.
• eenmalige aanmelding bij Postman (aanbevolen).

Benodigdheden

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, cloudtoepassingsbeheerderof toepassingseigenaar.
• Een Postman-tenant op het Enterprise-abonnement.
• Een gebruikersaccount in Postman met beheerdersmachtigingen.

Stap 1: Plan uw implementatie van voorzieningen

1. Leer meer over hoe de provisioningdienst werkt.
2. Bepalen wie zich in bereik bevindt voor het inrichten van.
3. Bepaal welke gegevens u wilt toewijzen tussen Microsoft Entra ID en Postman.

Stap 2: Postman configureren ter ondersteuning van inrichting met Microsoft Entra-id

Voordat u Postman configureert ter ondersteuning van het inrichten met Microsoft Entra-id, moet u een SCIM API-token genereren in de Postman-beheerconsole.

Notitie

Ga naar de pagina Overzicht van Postman SCIM-inrichtingom de stappen te volgen van SCIM-inrichting inschakelen in Postman.

1. Navigeer naar Postman-beheerconsole door u aan te melden bij uw Postman-account.

2. Nadat u bent aangemeld, selecteert u Team aan de rechterkant en selecteert u Teaminstellingen.

3. Selecteer Verificatie in de zijbalk en schakel vervolgens de SCIM-inrichting in met de schakelaar.

   

4. U ontvangt een pop-upbericht waarin u wordt gevraagd of u SCIM-inrichting wilt inschakelen, selecteert u inschakelen om SCIM-inrichting in te schakelen.

   

5. Voer de volgende stappen uit om de SCIM API-sleutel te genereren:

   1. Selecteer SCIM API-sleutel genereren in de sectie SCIM-voorziening.

      

   2. Voer de naam van de sleutel in en selecteer Genereren.

   3. Kopieer de nieuwe API-sleutel voor later gebruik en selecteer Gereed.

   Notitie

   U kunt deze pagina opnieuw bezoeken om uw SCIM API-sleutels te beheren. Als u een bestaande API-sleutel opnieuw genereert, kunt u de eerste sleutel actief houden terwijl u overschakelt.

   Notitie

   Zie SCIM-provisioning configureren met Microsoft Entra IDals u SCIM-provisioning wilt blijven inschakelen. Voor meer informatie of hulp bij het configureren van SCIM neemt contact op met de ondersteuning van Postman.

Stap 3: Postman toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Voeg Postman toe vanuit de Microsoft Entra-toepassingsgalerie om te beginnen met het inrichten voor Postman. Als u Postman eerder hebt ingesteld voor Single Sign-On, kunt u dezelfde applicatie gebruiken. We raden u echter aan om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie. Klik hier voor meer informatie over het toevoegen van een toepassing uit de galerie.

Stap 4: Bepaal wie binnen de scope van voorzieningen 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 bereikfiltergebruiken.

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

Stap 5: Automatische inrichting van gebruikers configureren voor Postman

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en/of groepen in TestApp te maken, bij te werken en uit te schakelen op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.

Automatische gebruikersinrichting configureren voor Postman in Microsoft Entra ID:

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

2. Navigeer naar Entra ID>Enterprise apps

   

3. Selecteer Postman-in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Stel Inrichtingsmodus in op Automatisch.

   

6. Voer in de sectie Beheerdersgegevenshttps://api.getpostman.com/scim/v2/ in als de URL van uw Postman-tenant en uw SCIM API-sleutel als het geheime token. Selecteer Test Verbinding om zeker te stellen dat Microsoft Entra ID verbinding kan maken met Postman. Als de verbinding mislukt, moet u controleren of uw Postman-account beheerdersmachtigingen heeft en probeer het opnieuw.

   

7. Voer in het veld E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de inrichtingsfoutmeldingen zou moeten ontvangen en schakel het selectievakje Een e-mailmelding verzenden als een fout optreedt in.

   

8. Selecteer Opslaan.

9. Selecteer in de sectie Koppelingen de optie Microsoft Entra-gebruikers synchroniseren naar Postman.

10. Controleer in de sectie Kenmerktoewijzingen de gebruikerskenmerken die vanuit Microsoft Entra-id met Postman worden gesynchroniseerd. De kenmerken die zijn geselecteerd als overeenkomende eigenschappen, worden gebruikt om de gebruikersaccounts in Postman te matchen voor updatebewerkingen. Als u ervoor kiest om het doelkenmerk dat overeenkomt mette wijzigen, moet u ervoor zorgen dat de Postman-API gebruikers kan filteren op basis van dat kenmerk. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk	Typ	Ondersteund voor filteren	Vereist door Postman
    gebruikersnaam	Draad	✓	✓
    actief	Booleaan		✓
    naam.gegevenNaam	Draad		✓
    naam.familienaam	Draad		✓

11. Selecteer onder de sectie Toewijzingen de optie Microsoft Entra-groepen synchroniseren naar Postman.

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

    Kenmerk	Typ	Ondersteund voor filteren	Vereist door Postman
    weergavenaam	Draad	✓	✓
    leden	Referentie

13. Raadpleeg artikel over bereikfiltersvoor de volgende instructies om bereikfilters te configureren.

14. Als u de Microsoft Entra-inrichtingsservice voor Postman wilt inschakelen, wijzigt u de Inrichtingsstatus in Op in de sectie Instellingen.

    

15. Definieer de gebruikers en/of groepen die u aan Postman wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen.

    

16. Als u klaar bent om te configureren, selecteert u Opslaan.

    

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

Stap 6: Uw implementatie bewaken

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

1. Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
2. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
3. Als de configuratie in een ongezonde staat lijkt te verkeren, gaat de toepassing in quarantaine. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Meer middelen

• Gebruikersaccounts inrichten voor bedrijfsapps.
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?.

Verwante inhoud

• Informatie over het controleren van logboeken en het ophalen van rapporten over inrichtingsactiviteit