Självstudie: Konfigurera Postman för automatisk användaretablering

I den här självstudien beskrivs de steg du behöver utföra i både Postman- och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När microsoft Entra-ID konfigureras etableras och avetableras användare och grupper automatiskt till Postman med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

• Skapa användare i Postman.
• Ta bort användare i Postman när de inte längre behöver åtkomst.
• Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Postman.
• Etablera grupper och gruppmedlemskap i Postman.
• Enkel inloggning till Postman (rekommenderas).

Förutsättningar

Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:

• En Microsoft Entra-klientorganisation.
• En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
• En Postman-klientorganisation i Enterprise-planen.
• Ett användarkonto i Postman med administratörsbehörighet.

Steg 1: Planera etableringsdistributionen

1. Lär dig mer om hur etableringstjänsten fungerar.
2. Ta reda på vem som finns i etableringsomfånget.
3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Postman.

Steg 2: Konfigurera Postman för att stödja etablering med Microsoft Entra-ID

Innan du börjar konfigurera Postman för att stödja etablering med Microsoft Entra-ID måste du generera en SCIM API-token i Postman Admin Console.

Kommentar

Du kan gå till sidan Postman SCIM-etableringsöversikt för att läsa Aktivera SCIM-etablering i Postman-steg .

1. Navigera till Postman Admin Console genom att logga in på ditt Postman-konto.

2. När du har loggat in klickar du på Team till höger och klickar på Team Inställningar.

3. Välj Autentisering i sidofältet och aktivera sedan växlingsknappen SCIM-etablering .

   

4. Du får ett popup-meddelande som frågar om du vill aktivera SCIM-etablering och klickar på Aktivera för att aktivera SCIM-etablering.

   

5. Utför följande steg för att generera EN SCIM API-nyckel:

   1. Välj Generera SCIM API-nyckel i avsnittet SCIM-etablering .

      

   2. Ange namnet på nyckeln och klicka på Generera.

   3. Kopiera din nya API-nyckel för senare användning och klicka på Klar.

   Kommentar

   Du kan gå tillbaka till den här sidan för att hantera dina SCIM API-nycklar. Om du återskapar en befintlig API-nyckel har du möjlighet att hålla den första nyckeln aktiv medan du växlar över.

   Kommentar

   Information om hur du fortsätter att aktivera SCIM-etablering finns i Konfigurera SCIM med Microsoft Entra-ID. Kontakta Postman-supporten om du vill ha mer information eller hjälp med att konfigurera SCIM.

Steg 3: Lägg till Postman från Microsoft Entra-programgalleriet

Lägg till Postman från Microsoft Entra-programgalleriet för att börja hantera etablering till Postman. Om du tidigare har konfigurerat Postman för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vem som ska finnas i omfånget för etablering

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren/gruppen. Om du väljer att omfånget som ska etableras till din app ska baseras på tilldelning, kan du använda följande steg för att tilldela användare och grupper till programmet. Om du väljer att omfånget endast ska etableras baserat på attribut för användaren eller gruppen, kan du använda ett omfångsfilter enligt beskrivningen här.

• Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper kan du ange ett attributbaserat omfångsfilter.

• Om du behöver fler roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till Postman

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i TestApp baserat på användar- och/eller grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för Postman i Microsoft Entra-ID:

1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

2. Bläddra till Identity>Applications Enterprise-program>

   

3. I programlistan väljer du Postman.

   

4. Välj fliken Etablering.

   

5. Ange Etableringsläge som Automatiskt.

   

6. Under avsnittet Administratörsautentiseringsuppgifter anger du https://api.getpostman.com/scim/v2/ som din Postman-klient-URL och din SCIM API-nyckel som hemlig token. Klicka på Testa Anslut ion för att se till att Microsoft Entra-ID kan ansluta till Postman. Om anslutningen misslyckas kontrollerar du att ditt Postman-konto har administratörsbehörighet och försöker igen.

   

7. I fältet E-postavisering anger du e-postadressen till den person eller grupp som ska ta emot meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel uppstår.

   

8. Välj Spara.

9. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Postman.

10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Postman i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Postman för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Postman-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut	Typ	Stöds för filtrering	Krävs av Postman
    userName	String	✓	✓
    aktiv	Booleskt		✓
    name.givenName	String		✓
    name.familyName	String		✓

11. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till Postman.

12. Granska de gruppattribut som synkroniseras från Microsoft Entra-ID till Postman i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha grupperna i Postman för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut	Typ	Stöds för filtrering	Krävs av Postman
    displayName	String	✓	✓
    medlemmar	Referens

13. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.

14. Om du vill aktivera Microsoft Entra-etableringstjänsten för Postman ändrar du etableringsstatusen till På i avsnittet Inställningar.

    

15. Definiera de användare och/eller grupper som du vill etablera till Postman genom att välja önskade värden i Omfång i avsnittet Inställningar.

    

16. När du är redo att etablera klickar du på Spara.

    

Åtgärden startar den initiala synkroniseringscykeln för alla användare och grupper som har definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid att utföra än efterföljande cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser till att övervaka distributionen:

• Använd etableringsloggarna för att avgöra vilka användare som har etablerats eller misslyckats.
• Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras.
• Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantänstatus här.

Fler resurser

• Hantera etablering av användarkonton för Enterprise Apps.
• Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?.

Nästa steg

• Lär dig hur du granskar loggar och hämtar rapporter om etableringsaktivitet.