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:
- Tenant Microsoft Entra.
- Jedna z následujících rolí: Application Správa istrator, Cloud Application Správa istrator nebo Application Owner.
- Tenant Postman v plánu Enterprise.
- Uživatelský účet v Nástroji Postman s oprávněními Správa
Krok 1: Plánování nasazení zřizování
- Seznamte se s fungováním služby zřizování.
- Zjistěte, kdo bude v rozsahu zřizování.
- 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.
Poznámka:
Na stránce s přehledem zřizování Postman SCIM najdete informace o povolení zřizování SCIM v krocích Postmanu.
Přejděte do konzoly Postman Správa tak, že se přihlásíte ke svému účtu Postman.
Po přihlášení klikněte na tým na pravé straně a klikněte na Team Nastavení.
Na bočním panelu vyberte Ověřování a pak zapněte přepínač zřizování SCIM.
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.
Pokud chcete vygenerovat klíč rozhraní API SCIM, proveďte následující kroky:
V části zřizování SCIM vyberte Vygenerovat klíč rozhraní API SCIM.
Zadejte název klíče a klikněte na Generovat.
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.
Krok 3: Přidání nástroje Postman z galerie aplikací Microsoft Entra
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:
Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.
Přejděte k podnikovým aplikacím identit>>
V seznamu aplikací vyberte Postman.
Vyberte kartu Zřizování.
Nastavte Režim zřizování na hodnotu Automaticky.
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.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.
Zvolte Uložit.
V části Mapování vyberte Synchronizovat uživatele Microsoft Entra s Postmanem.
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 ✓ V části Mapování vyberte Synchronizovat skupiny Microsoft Entra s Postmanem.
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 Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.
Pokud chcete povolit službu zřizování Microsoft Entra pro Postman, změňte stav zřizování na Zapnuto v Nastavení části.
Definujte uživatele nebo skupiny, které chcete zřídit pro Postman, výběrem požadovaných hodnot v oboru v části Nastavení.
Až budete připravení zřídit, klikněte na Uložit.
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
- Správa zřizování uživatelských účtů pro podnikové aplikace
- Co je přístup k aplikacím a jednotné přihlašování pomocí Microsoft Entra ID?.