Sdílet prostřednictvím

Vytvoření a správa pracovního prostoru ve službě Azure API Management

PLATÍ PRO: Premium | Premium v2

Nastavte pracovní prostor tak, aby tým rozhraní API mohl spravovat a produktizovat vlastní rozhraní API a současně poskytnout týmu platformy API nástroje pro sledování, řízení a údržbu platformy API Management. Po vytvoření pracovního prostoru a přiřazení oprávnění můžou spolupracovníci pracovního prostoru vytvářet a spravovat vlastní rozhraní API, produkty, předplatná a související prostředky.

Note

  • Nejnovější funkce pracovních prostorů jsou podporovány v rozhraní API Management REST API verze 2023-09-01-preview nebo novější.
  • Podrobnosti o cenách najdete v části API Management pricing.

Postupujte podle kroků v tomto článku:

  • Vytvoření pracovního prostoru služby API Management a přidružení brány pracovního prostoru pomocí webu Azure Portal
  • Volitelně můžete bránu pracovního prostoru izolovat ve virtuální síti Azure.
  • Přiřazení oprávnění k pracovnímu prostoru

Note

Prerequisites

  • Instance služby API Management. Pokud potřebujete, vytvořte ji v podporované vrstvě.
  • Role 'Vlastník' nebo 'Přispěvatel' ve skupině prostředků, ve které je nasazená instance API Management, nebo ekvivalentní oprávnění k vytváření prostředků ve skupině prostředků.
  • (Volitelné) Podsíť v nové nebo existující virtuální síti Azure za účelem izolace příchozího a odchozího provozu brány pracovního prostoru. Informace o možnostech konfigurace a požadavcích najdete v tématu Požadavky na síťové prostředky pro brány pracovního prostoru.

Vytvoření pracovního prostoru – portál

  1. Přihlaste se k webu Azure Portal a přejděte k vaší instanci služby API Management.

  2. V nabídce vlevo v části Rozhraní API vyberte Pracovní prostory> + Přidat.

  3. Na kartě Základy zadejte popisný název pro zobrazení, název prostředku a volitelný popis pracovního prostoru. Vyberte Další.

  4. Na kartě Brána nakonfigurujte nastavení pro bránu pracovního prostoru.

    Snímek obrazovky s vytvořením brány pracovního prostoru na portálu

    • Vyberte Vytvořit novou pro vytvoření nové brány pracovního prostoru, nebo vyberte Použít existující pro přidružení pracovního prostoru k existující bráně, kde jsou nasazeny další pracovní prostory.

    • Pokud se rozhodnete vytvořit novou bránu:

      • V podrobnostech brány zadejte nový název brány a vyberte počet jednotek škálování. Náklady na vstupní bránu jsou kalkulované na základě počtu jednotek. Další informace najdete v tématu o cenách služby API Management.

      • V části Síť vyberte konfiguraci sítě pro bránu pracovního prostoru.

        Important

        Pečlivě naplánujte konfiguraci sítě pracovního prostoru. Po vytvoření pracovního prostoru nemůžete změnit konfiguraci sítě.

      • Pokud vyberete příchozí veřejný přístup, odchozí privátní přístup (integrace virtuální sítě) nebo příchozí privátní přístup, odchozí privátní přístup (injektáž virtuální sítě), vyberte virtuální síť a podsíť pro izolaci brány pracovního prostoru nebo vytvořte nový. Požadavky na síť najdete v tématu Požadavky na síťové prostředky pro brány pracovních prostorů.

  5. Vyberte Další. Po dokončení ověření vyberte Vytvořit.

    Note

    Vytvoření nové brány pracovního prostoru, pokud je vybrána, může trvat až několik hodin. Pokud chcete sledovat průběh nasazení v portálu Azure, přejděte do skupiny prostředků brány. V nabídce vlevo v části Nastavení vyberte Nasazení.

Po dokončení nasazení se nový pracovní prostor zobrazí v seznamu na stránce Pracovní prostory . Vyberte pracovní prostor a spravujte jeho nastavení a prostředky.

Note

  • Pokud chcete zobrazit název hostitele modulu runtime brány a další podrobnosti o bráně, vyberte pracovní prostor na portálu. V části Nasazení a infrastruktura vyberte Brány a vyberte název brány pracovního prostoru.
  • Během vytváření brány pracovního prostoru nebudou volání API pracovního prostoru prováděná během běhu úspěšná.

Přiřazení uživatelů k pracovnímu prostoru – portál

Po vytvoření pracovního prostoru přiřaďte uživatelům oprávnění ke správě prostředků pracovního prostoru. Každému uživateli pracovního prostoru musí být přiřazena funkce RBAC v rámci služby a funkce RBAC v rámci pracovního prostoru nebo mu musí být udělena ekvivalentní oprávnění pomocí vlastních rolí.

Pokud chcete spravovat bránu pracovního prostoru, doporučujeme také uživatelům pracovního prostoru přiřadit roli RBAC zadanou v Azure s oborem brány pracovního prostoru.

Note

Pro snadnější správu nastavte skupiny Microsoft Entra tak, aby přiřadily oprávnění pracovního prostoru více uživatelům.

Přiřazení role s vymezeným oborem služby

  1. Přihlaste se k webu Azure Portal a přejděte k vaší instanci služby API Management.

  2. V nabídce vlevo vyberte Řízení přístupu (IAM)>+ Přidat.

  3. Každému členu pracovního prostoru přiřaďte jednu z následujících rolí vymezených službou:

    • Vývojář rozhraní API pro pracovní prostor služby API management
    • Produktový manažer API pro pracovní prostor služby správy API

Přiřazení role s vymezeným pracovním prostorem

  1. V nabídce vaší instance služby API Management v části Rozhraní API vyberte Pracovní prostory> název pracovního prostoru, který jste vytvořili.

  2. V okně Pracovního prostoru vyberte Řízení přístupu (IAM)>+ Přidat.

  3. Přiřaďte členům pracovního prostoru jednu z následujících rolí vymezených pracovním prostorem, aby mohli spravovat rozhraní API pracovního prostoru a další prostředky.

    • Čtenář pracovního prostoru služby API Management
    • Přispěvatel pracovního prostoru služby API Management
    • Vývojář rozhraní API pro pracovní prostor služby API Management
    • API Management Workspace API Product Manager

Přiřazení role s vymezeným oborem brány

  1. Přihlaste se k webu Azure Portal a přejděte k vaší instanci služby API Management.

  2. V nabídce vlevo v části Rozhraní API vyberte Pracovní prostory> název vašeho pracovního prostoru.

  3. V levé nabídce pracovního prostoru vyberte Brány a vyberte bránu pracovního prostoru.

  4. V nabídce vlevo vyberte Řízení přístupu (IAM)>+ Přidat.

  5. Každému členu pracovního prostoru přiřaďte jednu z následujících rolí. Pokud chcete zobrazit nastavení brány, doporučujeme minimálně přiřadit roli Čtenář . Vlastníci a přispěvatelé můžou spravovat nastavení brány, včetně škálování brány.

    • Owner
    • Contributor
    • Reader

Povolit nastavení diagnostiky pro monitorování rozhraní API pracovního prostoru

Nakonfigurujte nastavení pro shromažďování protokolů služby Azure Monitor pro pracovní prostor a jejich odesílání do pracovního prostoru služby Log Analytics, aby tým pracovního prostoru mohl monitorovat vlastní rozhraní API, zatímco tým platformy API má přístup k centralizovaným protokolům pro instanci služby API Management. Podívejte se na následující diagram:

Diagram federovaného protokolování ve službě API Management

Ke shromažďování protokolů služby Azure Monitor pro pracovní prostor jsou potřeba nastavení diagnostiky na úrovni služby i pracovního prostoru:

  1. Nejprve povolte nastavení diagnostiky na úrovni služby pro shromažďování protokolů brány služby API Management, pokud nastavení ještě není povolené. Doporučujeme odesílat protokoly do pracovního prostoru služby Log Analytics. Další informace najdete v tématu Konfigurace nastavení diagnostiky pro službu API Management.

  2. Potom povolte nastavení diagnostiky na úrovni pracovního prostoru pro odesílání protokolů brány služby API Management do stejného pracovního prostoru služby Log Analytics. Toto nastavení shromažďuje protokoly pro všechny brány pracovního prostoru přidružené k tomuto pracovnímu prostoru.

    Important

    Nastavení diagnostiky na úrovni služby konfiguruje protokolování napříč instancí služby API Management, včetně pracovních prostorů s povoleným nastavením diagnostiky na úrovni pracovního prostoru. Pokud nepovolíte nastavení diagnostiky na úrovni pracovního prostoru, nebudou se protokoly brány pracovního prostoru shromažďovat ani agregovat do Log Analytics.

    Note

    Ve výchozím nastavení nemají členové týmu pracovního prostoru, kterým byly přiřazeny vestavěné role RBAC pracovního prostoru, oprávnění k úpravě nastavení diagnostiky v pracovním prostoru. Tým platformy API má tato oprávnění.

Aby bylo možné konfigurovat diagnostické nastavení pracovního prostoru pro sběr protokolů brány na úrovni pracovního prostoru:

  1. Přihlaste se k webu Azure Portal a přejděte k vaší instanci služby API Management.

  2. V nabídce vlevo v části Rozhraní API vyberte Pracovní prostory> název vašeho pracovního prostoru.

  3. V levé nabídce pracovních prostorů v části Monitorování vyberte Nastavení>diagnostiky+ Přidat nastavení diagnostiky.

  4. Na stránce Nastavení diagnostiky zadejte nebo vyberte podrobnosti nastavení:

    1. Název nastavení diagnostiky: Zadejte popisný název.
    2. Skupiny kategorií: Volitelně můžete vybrat svůj scénář.
    3. V části Kategorie: Vyberte protokoly související s bránou ApiManagement a shromážděte protokoly brány pro rozhraní API v tomto pracovním prostoru.
    4. V části Podrobnosti o cíli vyberte, že chcete odesílat protokoly do stejného pracovního prostoru Služby Log Analytics zadaného v nastavení diagnostiky na úrovni služby a v jiných nastaveních diagnostiky na úrovni pracovního prostoru.
    5. Vyberte Uložit.

Note

  • V současné době je možné shromažďovat pouze protokoly brány pro pracovní prostory.
  • Přejděte k protokolům na úrovni pracovního prostoru tím, že v levé nabídce pracovního prostoru vyberete Monitoring>Protokoly.

Začínáme s pracovním prostorem

V závislosti na své roli v pracovním prostoru můžou mít uživatelé oprávnění vytvářet rozhraní API, produkty, předplatná a další prostředky nebo mají přístup jen pro čtení k některým nebo všem z nich.

Pokud chcete začít spravovat, chránit a publikovat rozhraní API v pracovním prostoru, přečtěte si následující doprovodné materiály.

Resource Guide
APIs Kurz: Import a publikování prvního rozhraní API
Products Kurz: Vytvoření a publikování produktu
Subscriptions Předplatná ve službě Azure API Management

Vytváření předplatných ve službě API Management
Policies Kurz: Transformace a ochrana rozhraní API

Zásady ve službě Azure API Management

Nastavení nebo úprava zásad služby API Management
Pojmenované hodnoty Správa tajemství pomocí pojmenovaných hodnot
Backends Použití back-endů ve službě Azure API Management
Fragmenty zásad Opakované použití konfigurací zásad v definicích zásad služby API Management
Schemas Ověření obsahu
Groups Vytváření a používání skupin ke správě vývojářských účtů
Notifications Konfigurace oznámení a šablon oznámení

Související obsah

  • Last updated on