Sdílet prostřednictvím


Kurz: Konfigurace nástroje Postman pro automatické zřizování uživatelů

Tento kurz popisuje kroky, které potřebujete provést v Nástroji Postman i v Microsoft Entra ID ke konfiguraci automatického zřizování uživatelů. Při konfiguraci microsoft Entra ID automaticky zřizuje a zřídí uživatele a skupiny pro Postman pomocí služby zřizování Microsoft Entra. Důležité podrobnosti o tom, co tato služba dělá, jak funguje, a nejčastější dotazy najdete v tématu Automatizace zřizování a rušení zřizování uživatelů pro aplikace SaaS pomocí Microsoft Entra ID.

Podporované funkce

  • Vytvořte uživatele v Nástroji Postman.
  • Odeberte uživatele v Nástroji Postman, pokud už nevyžadují přístup.
  • Udržovat atributy uživatele synchronizované mezi Microsoft Entra ID a Postman.
  • Zřizování skupin a členství ve skupinách v Nástroji Postman
  • Jednotné přihlašování k Postmanu (doporučeno).

Požadavky

Scénář popsaný v tomto kurzu předpokládá, že už máte následující požadavky:

Krok 1: Plánování nasazení zřizování

  1. Seznamte se s fungováním služby zřizování.
  2. Zjistěte, kdo bude v rozsahu zřizování.
  3. Určete, jaká data se mají mapovat mezi ID Microsoft Entra a Postmanem.

Krok 2: Konfigurace nástroje Postman pro podporu zřizování pomocí Microsoft Entra ID

Než začnete konfigurovat Postman tak, aby podporoval zřizování pomocí Microsoft Entra ID, budete muset vygenerovat token rozhraní API SCIM v konzole Postman Správa.

  1. Přejděte do konzoly Postman Správa tak, že se přihlásíte ke svému účtu Postman.

  2. Po přihlášení klikněte na tým na pravé straně a klikněte na Team Nastavení.

  3. Na bočním panelu vyberte Ověřování a pak zapněte přepínač zřizování SCIM.

    Snímek obrazovky se stránkou nastavení ověřování Postman

  4. Zobrazí se automaticky otevíraná zpráva s dotazem, jestli chcete zapnout zřizování SCIM, kliknutím na zapnout zapnutí zřizování SCIM povolte zřizování SCIM.

    Snímek obrazovky s modálním povolením zřizování SCIM

  5. Pokud chcete vygenerovat klíč rozhraní API SCIM, proveďte následující kroky:

    1. V části zřizování SCIM vyberte Vygenerovat klíč rozhraní API SCIM.

      Snímek obrazovky pro vygenerování klíče rozhraní API SCIM v Nástroji Postman

    2. Zadejte název klíče a klikněte na Generovat.

    3. Zkopírujte nový klíč rozhraní API pro pozdější použití a klikněte na Hotovo.

    Poznámka:

    Na tuto stránku se můžete vrátit a spravovat klíče rozhraní API SCIM. Pokud znovu vygenerujete existující klíč rozhraní API, budete mít při přepínání možnost zachovat první klíč aktivní.

    Poznámka:

    Pokud chcete pokračovat v povolování zřizování SCIM, přečtěte si téma Konfigurace SCIM pomocí Microsoft Entra ID. Pokud potřebujete další informace nebo pomoc s konfigurací SCIM, obraťte se na podporu Postmanu.

Přidejte postman z galerie aplikací Microsoft Entra a začněte spravovat zřizování pro Postman. Pokud jste dříve nastavili Postman pro jednotné přihlašování, můžete použít stejnou aplikaci. Při počátečním testování integrace se ale doporučuje vytvořit samostatnou aplikaci. Další informace o přidání aplikace z galerie najdete tady.

Krok 4: Definujte, kdo bude v oboru zřizování

Služba zřizování Microsoft Entra umožňuje určit rozsah, který bude zřízen na základě přiřazení k aplikaci nebo na základě atributů uživatele nebo skupiny. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí pro vaši aplikaci, na základě přiřazení, můžete k aplikaci přiřadit uživatele a skupiny pomocí následujících kroků. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí, pouze na základě atributů jednotlivých uživatelů nebo skupin, můžete použít filtr rozsahu, jak je popsáno tady.

  • Začněte v malém. Než se pustíte do zavádění pro všechny, proveďte testování s malou skupinou uživatelů a skupin. Pokud je obor zřizování nastavený na přiřazené uživatele a skupiny, můžete to řídit přiřazením jednoho nebo dvou uživatelů nebo skupin k aplikaci. Pokud je obor nastavený na všechny uživatele a skupiny, můžete zadat filtr oborů založený na atributech.

  • Pokud potřebujete další role, můžete aktualizovat manifest aplikace a přidat nové role.

Krok 5: Konfigurace automatického zřizování uživatelů pro Postman

Tato část vás provede postupem konfigurace služby zřizování Microsoft Entra pro vytvoření, aktualizaci a zakázání uživatelů a/nebo skupin v aplikaci TestApp na základě přiřazení uživatelů a/nebo skupin v Microsoft Entra ID.

Konfigurace automatického zřizování uživatelů pro Postman v Microsoft Entra ID:

  1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.

  2. Přejděte k podnikovým aplikacím identit>>

    Snímek obrazovky s oknem Podnikové aplikace

  3. V seznamu aplikací vyberte Postman.

    Snímek obrazovky s odkazem Postman v seznamu Aplikace

  4. Vyberte kartu Zřizování.

    Snímek obrazovky s kartou Zřizování

  5. Nastavte Režim zřizování na hodnotu Automaticky.

    Snímek obrazovky s automatickou kartou Zřizování

  6. V části Správa Přihlašovací údaje zadejte https://api.getpostman.com/scim/v2/ jako adresu URL tenanta Postman a klíč rozhraní API SCIM jako tajný token. Klikněte na test Připojení ion a ujistěte se, že se Microsoft Entra ID může připojit k Nástroji Postman. Pokud připojení selže, ujistěte se, že váš účet Postman má Správa oprávnění a zkuste to znovu.

    Snímek obrazovky s tokenem

  7. Do pole Oznamovací e-mail zadejte e-mailovou adresu osoby nebo skupiny, na kterou by se měla odesílat oznámení o chybách zřizování, a zaškrtněte políčko Když dojde k selhání, poslat oznámení e-mailem.

    Snímek obrazovky s e-mailem s oznámením

  8. Zvolte Uložit.

  9. V části Mapování vyberte Synchronizovat uživatele Microsoft Entra s Postmanem.

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Postman v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti slouží ke shodě uživatelských účtů v Nástroji Postman pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, budete muset zajistit, aby rozhraní Postman API podporovalo filtrování uživatelů na základě tohoto atributu. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ Podporováno pro filtrování Požadováno uživatelem Postman
    userName String
    active Logická hodnota
    name.givenName String
    name.familyName String
  11. V části Mapování vyberte Synchronizovat skupiny Microsoft Entra s Postmanem.

  12. Zkontrolujte atributy skupiny, které jsou synchronizovány z Microsoft Entra ID do Postman v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti se používají ke shodě skupin v nástroji Postman pro operace aktualizace. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ Podporováno pro filtrování Požadováno uživatelem Postman
    displayName String
    členové Reference
  13. Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.

  14. Pokud chcete povolit službu zřizování Microsoft Entra pro Postman, změňte stav zřizování na Zapnuto v Nastavení části.

    Snímek obrazovky se zapnutým zapnutým stavem zřizování

  15. Definujte uživatele nebo skupiny, které chcete zřídit pro Postman, výběrem požadovaných hodnot v oboru v části Nastavení.

    Snímek obrazovky s oborem zřizování

  16. Až budete připravení zřídit, klikněte na Uložit.

    Snímek obrazovky s uložením konfigurace zřizování

Tato operace zahájí cyklus počáteční synchronizace všech uživatelů a skupin definovaných v nabídce Rozsah v části Nastavení. Počáteční cyklus trvá déle než následné cykly, ke kterým dochází přibližně každých 40 minut, pokud je spuštěná služba zřizování Microsoft Entra.

Krok 6: Monitorování nasazení

Po dokončení konfigurace zřizování můžete své nasazení monitorovat pomocí následujících prostředků:

  • Pomocí protokolů zřizování určete, kteří uživatelé byli úspěšně nebo neúspěšně zřízeni.
  • Zkontrolujte indikátor průběhu a podívejte se na stav cyklu zřizování a na jeho blízkosti.
  • Pokud se zdá, že konfigurace zřizování je v pořádku, aplikace přejde do karantény. Další informace o stavech karantény najdete tady.

Další materiály

Další kroky