Povolení CORS pro interaktivní konzolu na portálu pro vývojáře služby API Management

PLATÍ PRO: Vývojář | Základní | Základní v2 | Standardní | Standardní v2 | Premium | Premium v2

Sdílení prostředků mezi zdroji (CORS) je mechanismus založený na hlavičce HTTP, který umožňuje serveru označit jakýkoli zdroj (doména, schéma nebo port), než je jeho vlastní, ze kterého by prohlížeč měl povolit načítání prostředků.

Pokud chcete návštěvníkům portálu pro vývojáře služby API Management umožnit použití interaktivní testovací konzoly na referenčních stránkách rozhraní API, povolte zásadu CORS pro rozhraní API ve vaší instanci služby API Management. Pokud název domény portálu pro vývojáře není povoleným zdrojem požadavků rozhraní API pro různé domény, zobrazí se uživatelům testovací konzoly chyba CORS.

V určitých scénářích můžete portál pro vývojáře nakonfigurovat jako proxy CORS místo povolení zásad CORS pro rozhraní API.

Požadavky

• Projděte si následující rychlý start: Vytvoření instance služby Azure API Management

Přejít k instanci služby API Management

1. Na portálu Azure vyhledejte a vyberte služby API Management:

   

2. Na stránce služby API Management vyberte instanci služby API Management:

   

Povolení zásad CORS pro rozhraní API

Můžete povolit nastavení pro automatickou konfiguraci zásad CORS pro všechna rozhraní API ve vaší instanci služby API Management. Zásady CORS můžete nakonfigurovat také ručně.

Poznámka:

Spustí se pouze jedna zásada CORS. Pokud zadáte více zásad CORS (například na úrovni rozhraní API a na úrovni všech rozhraní API), vaše interaktivní konzola nemusí fungovat podle očekávání.

Automatické povolení zásad CORS

1. V levé nabídce instance služby API Management v části Portál pro vývojáře vyberte Přehled portálu.
2. V části Povolit CORS se zobrazí stav konfigurace zásad CORS. Pole upozornění označuje chybějící nebo chybně nakonfigurovanou zásadu.
3. Pokud chcete CORS povolit na portálu pro vývojáře pro všechna rozhraní API, vyberte Povolit CORS.

Ruční povolení politiky CORS

1. Pokud chcete zobrazit vygenerovaný kód zásad, vyberte odkaz Ručně použít na globální úrovni.
2. V části Rozhraní API vaší instance služby API Management přejděte na všechna rozhraní API.
3. V části < vyberte ikonu />.
4. V editoru zásad vložte zásadu do <příchozí> části souboru XML. Ujistěte se, že hodnota původu<> odpovídá doméně portálu pro vývojáře.

Poznámka:

Pokud použijete zásadu CORS v oboru produktu místo oboru rozhraní API a vaše rozhraní API používá ověřování pomocí klíče předplatného prostřednictvím hlavičky, konzola nebude fungovat.

Prohlížeč automaticky vydá OPTIONS požadavek HTTP, který neobsahuje hlavičku s klíčem předplatného. Kvůli chybějícímu klíči předplatného nemůže služba API Management přidružit OPTIONS volání k produktu, takže nemůže použít zásady CORS.

Alternativním řešením je předat klíč předplatného v parametru dotazu.

Konfigurace CORS pro vlastní název domény

Pokud nakonfigurujete vlastní doménu pro portál pro vývojáře a chcete, aby návštěvníci používali testovací konzolu na referenčních stránkách rozhraní API, ujistěte se, že povolíte CORS pro vlastní název domény portálu pro vývojáře.

Při konfiguraci vlastní domény můžete v zásadách CORS povolit nastavení pro přidání zdroje pro vlastní doménu portálu pro vývojáře. Pokud už byl CORS pro výchozí doménu povolený, budou oba zdroje zahrnuté do zásad CORS. Nastavení zásad CORS můžete kdykoli změnit.

Možnost proxy SERVERU CORS

V některých scénářích (například pokud je brána služby API Management izolovaná v síti) můžete zvolit nakonfigurovat portál pro vývojáře jako samotný proxy server CORS místo povolování zásad CORS pro vaše rozhraní API. Proxy server CORS směruje volání rozhraní API interaktivní konzoly prostřednictvím back-endu portálu v instanci služby API Management.

Poznámka:

Pokud jsou rozhraní API zpřístupněná prostřednictvím brány v místním prostředí nebo je vaše služba ve virtuální síti, vyžaduje se připojení z back-endové služby portálu pro vývojáře služby API Management k bráně.

Pokud chcete nakonfigurovat proxy CORS, přejděte na vývojářský portál jako správce:

1. Na stránce Přehled vaší instance služby API Management vyberte Portál pro vývojáře. Portál pro vývojáře se otevře na nové kartě prohlížeče.
2. V levé nabídce rozhraní pro správu vyberte Stránky>Rozhraní API>Podrobnosti.
3. Na stránce Rozhraní API: Podrobnosti vyberte operaci: widget Podrobnosti a vyberte Upravit widget.
4. Vyberte Použít proxy server CORS.
5. Uložte změny na portál a znovu publikujte portál.

Konfigurace CORS pro portál pro vývojáře v místním prostředí

Pokud sami hostujete portál pro vývojáře, je k povolení CORS potřeba následující konfigurace:

• Pomocí možnosti backendUrl v konfiguračních souborech zadejte koncový bod backendu portálu. Jinak místní portál nezná umístění back-endové služby.

• Přidejte hodnoty domény Origin do konfigurace místního portálu a určete prostředí, kde je hostovaný místní portál. Další informace

Související obsah

• Další informace o konfiguraci zásad najdete v tématu Nastavení nebo úprava zásad.
• Podrobnosti o zásadách CORS najdete v referenčních informacích k zásadám cors .