Co je Azure API Management?

Tento článek obsahuje přehled běžných scénářů a klíčových komponent Azure API Management. Azure API Management je hybridní multicloudová platforma pro správu rozhraní API napříč všemi prostředími. Jako platforma jako služba API Management podporuje celý životní cyklus rozhraní API.

Tip

Pokud už API Management znáte a jste připravení začít, projděte si tyto zdroje informací:

Scénáře

Rozhraní API umožňují digitální prostředí, zjednodušují integraci aplikací, podporují nové digitální produkty a umožňují opakované použití a univerzální přístupnost dat a služeb. S rostoucím nárůstem a rostoucí závislostí na rozhraních API je organizace potřebují spravovat jako prvotřídní prostředky během svého životního cyklu.

Diagram znázorňující roli rozhraní API v propojených prostředích

Azure API Management pomáhá zákazníkům řešit tyto výzvy:

  • Abstraktní rozmanitost a složitost architektury back-endu od uživatelů rozhraní API
  • Zabezpečené zveřejnění služeb hostovaných v Azure a mimo azure jako rozhraní API
  • Ochrana, zrychlení a sledování rozhraní API
  • Povolení zjišťování a využívání rozhraní API interními a externími uživateli

Mezi obvyklé scénáře patří:

  • Odemknutí starších prostředků – rozhraní API slouží k abstrakci a modernizaci starších back-endů a k jejich zpřístupnění z nových cloudových služeb a moderních aplikací. Rozhraní API umožňují inovace bez rizika, nákladů a zpoždění migrace.
  • Integrace aplikací orientovaných na rozhraní API – rozhraní API jsou snadno využitelná, založená na standardech a samopopisují mechanismy pro zveřejnění dat, aplikací a procesů a přístup k nich. Zjednodušují a snižují náklady na integraci aplikací.
  • Vícekanálová uživatelská prostředí – Rozhraní API se často používají k povolení uživatelských prostředí, jako jsou webové, mobilní, nositelné nebo aplikace internetu věcí. Opětovné použití rozhraní API ke zrychlení vývoje a návratnosti návratnosti
  • Integrace B2B – Rozhraní API vystavená partnerům a zákazníkům snižují bariéru při integraci obchodních procesů a výměně dat mezi obchodními entitami. Rozhraní API eliminují režii spojenou s integrací typu point-to-point. Zejména s povoleným samoobslužným zjišťováním a onboardingem jsou rozhraní API primárními nástroji pro škálování integrace B2B.

API Management komponent

Azure API Management se skládá z brány rozhraní API, roviny správy a portálu pro vývojáře. Tyto komponenty jsou hostované v Azure a ve výchozím nastavení jsou plně spravované. API Management je k dispozici na různých úrovních, které se liší kapacitou a funkcemi.

Diagram znázorňující klíčové komponenty Azure API Management

Brána rozhraní API

Všechny požadavky z klientských aplikací se nejprve dostanou do brány rozhraní API, která je pak předá příslušným back-endovým službám. Brána rozhraní API funguje jako fasáda back-endových služeb a umožňuje poskytovatelům rozhraní API abstrahovat implementace rozhraní API a vyvíjet back-endovou architekturu, aniž by to mělo dopad na uživatele rozhraní API. Brána umožňuje konzistentní konfiguraci směrování, zabezpečení, omezování, ukládání do mezipaměti a pozorovatelnosti.

Konkrétně brána:

Brána v místním prostředí

S bránou v místním prostředí můžou zákazníci nasadit bránu rozhraní API do stejných prostředí, kde hostují svá rozhraní API, aby optimalizovali provoz rozhraní API a zajistili dodržování místních předpisů a pokynů. Brána v místním prostředí umožňuje zákazníkům s hybridní infrastrukturou IT spravovat rozhraní API hostovaná místně a napříč cloudy z jedné API Management služby v Azure.

Brána v místním prostředí je zabalená jako kontejner Dockeru založený na Linuxu a běžně se nasazuje do Kubernetes, včetně Azure Kubernetes Service a Kubernetes s podporou Azure Arc.

Další informace:

Rovina správy

Poskytovatelé rozhraní API komunikují se službou prostřednictvím roviny správy, která poskytuje úplný přístup k možnostem API Management služby.

Zákazníci komunikují s rovinou správy prostřednictvím nástrojů Azure, mezi které patří Azure Portal, Azure PowerShell, Azure CLI, rozšíření Visual Studio Code nebo klientské sady SDK v několika oblíbených programovacích jazycích.

Rovinu správy použijte k:

  • Zřízení a konfigurace nastavení služby API Management
  • Definování nebo import schémat rozhraní API z široké škály zdrojů, včetně specifikací OpenAPI, výpočetních služeb Azure nebo back-endů WebSocket nebo GraphQL
  • Zabalení rozhraní API do produktů
  • Nastavení zásad , jako jsou kvóty nebo transformace v rozhraních API
  • Získání přehledů z analýz
  • Správa uživatelů

Portál pro vývojáře

Opensourcový portál pro vývojáře je automaticky vygenerovaný a plně přizpůsobitelný web s dokumentací k vašim rozhraním API.

Snímek obrazovky API Management vývojářského portálu – režim správce

Poskytovatelé rozhraní API můžou přizpůsobit vzhled portálu pro vývojáře přidáním vlastního obsahu, přizpůsobením stylů a přidáním značky. Rozšiřte portál pro vývojáře o vlastní hostování.

Vývojáři aplikací pomocí opensourcového portálu pro vývojáře vyhledávají rozhraní API, nasadí je, aby je mohli používat a naučí se je využívat v aplikacích. (Rozhraní API je také možné exportovat do Power Platform , aby je mohli zjišťovat a používat vývojáři z občanů.)

Pomocí portálu pro vývojáře můžou vývojáři:

  • Přečtěte si dokumentaci k rozhraní API.
  • Volání rozhraní API prostřednictvím interaktivní konzoly
  • Vytvoření účtu a přihlášení k odběru klíčů rozhraní API
  • Přístup k analýzám jejich vlastního využití
  • Stažení definic rozhraní API
  • Správa klíčů rozhraní API

Integrace se službami Azure

API Management se integruje s mnoha doplňkovými službami Azure a vytváří podniková řešení, včetně:

Další informace:

Klíčové koncepty

Rozhraní API

Rozhraní API jsou základem instance služby API Management. Každé rozhraní API představuje sadu operací dostupných vývojářům aplikací. Každé rozhraní API obsahuje odkaz na back-endovou službu, která implementuje rozhraní API, a její operace se mapují na back-endové operace.

Operace ve službě API Management jsou vysoce konfigurovatelné a umožňují kontrolu nad mapováním adres URL, parametry dotazů a cest, obsahem požadavků a odezev a ukládáním operací do mezipaměti.

Další informace:

Produkty

Rozhraní API se k vývojářům dostávají prostřednictvím produktů. Produkty v API Management mají jedno nebo více rozhraní API a můžou být otevřené nebo chráněné. Chráněné produkty vyžadují klíč předplatného, zatímco otevřené produkty je možné využívat volně.

Jakmile je produkt připravený k použití pro vývojáře, můžete ho publikovat. Jakmile ho publikují, můžou si ho vývojáři zobrazit nebo přihlásit k odběru. Schválení předplatného se konfiguruje na úrovni produktu a může buď vyžadovat schválení správcem, nebo může být automatické.

Další informace:

Skupiny

Ke správě viditelnosti produktů pro vývojáře se používají skupiny. API Management má následující předdefinované skupiny:

  • Správci – Spravujte instance služby API Management a vytvářejte rozhraní API, operace a produkty, které používají vývojáři.

    Správci předplatného Azure jsou členy této skupiny.

  • Vývojáři – ověření uživatelé portálu pro vývojáře, kteří vytvářejí aplikace pomocí rozhraní API. Vývojáři mají přístup k portálu pro vývojáře a vytvářejí aplikace, které volají operace rozhraní API.

  • Hosté – neověření uživatelé portálu pro vývojáře, například potenciální zákazníci, kteří navštíví portál pro vývojáře. Můžete jim udělit omezený přístup jenom ke čtení, například k zobrazení rozhraní API bez možnosti jeho volání.

Správci můžou také vytvářet vlastní skupiny nebo používat externí skupiny v přidruženém tenantovi Azure Active Directory , aby vývojářům poskytli přehled a přístup k produktům API. Můžete například vytvořit vlastní skupinu pro vývojáře v partnerské organizaci pro přístup ke konkrétní podmnožině rozhraní API v produktu. Uživatel může patřit do více než jedné skupiny.

Další informace:

Vývojáři

Vývojáři představují uživatelské účty v instanci služby API Management. Správci můžou vytvořit vývojáře nebo je pozvat, aby se připojili, nebo se můžou zaregistrovat z portálu pro vývojáře. Každý vývojář je členem jedné nebo několika skupin a může se přihlásit k odběru produktů, které jsou pro tyto skupiny viditelné.

Když se vývojáři přihlásí k odběru produktu, udělí se jim primární a sekundární klíč produktu pro použití při volání rozhraní API produktu.

Další informace:

Zásady

Pomocí zásad může vydavatel rozhraní API změnit chování rozhraní API prostřednictvím konfigurace. Zásady představují kolekci příkazů, které se postupně provádí na základě požadavku nebo odezvy z rozhraní API. Mezi oblíbené příkazy patří převod formátu z XML na JSON a omezení četnosti volání, které omezuje počet příchozích hovorů od vývojáře. Úplný seznam najdete v tématu zásady API Management.

Výrazy zásad můžete použít jako hodnoty atributů nebo textové hodnoty v libovolných zásadách API Management (pokud zásady neurčí jinak). Některé zásady, například řízení toku a nastavená proměnná, jsou založené na výrazech zásad.

Zásady se dají použít v různých oborech v závislosti na vašich potřebách: globální (všechna rozhraní API), produkt, konkrétní rozhraní API nebo operace rozhraní API.

Další informace:

Další kroky

Dokončete následující rychlý start a začněte používat Azure API Management: