Aktivieren von CORS-Richtlinien für den benutzerdefinierten API Management-Connector

GILT FÜR: Alle API Management-Ebenen

CORS (Cross-Origin Resource Sharing) ist ein auf HTTP-Header basierender Mechanismus, der es einem Server ermöglicht, alle anderen Ursprünge (Domäne, Schema oder Port) anzugeben, von denen ein Browser das Laden von Ressourcen zulassen soll. Kunden können ihren Web-APIs in Azure API Management eine CORS-Richtlinie hinzufügen, wodurch einem Vorgang oder einer API die Unterstützung für die ressourcenübergreifende Ressourcenfreigabe hinzugefügt wird, um domänenübergreifende Aufrufe von browserbasierten Clients zuzulassen.

Wenn Sie eine API aus API Management als benutzerdefinierten Connector in Power Platform exportiert haben und browserbasierte Clients wie Power Apps oder Power Automate zum Aufrufen der API verwenden möchten, müssen Sie Ihre API so konfigurieren, dass ursprungsübergreifende Anforderungen von Power Platform-Anwendungen explizit aktiviert werden. In diesem Artikel erfahren Sie, wie Sie die folgenden beiden erforderlichen Richtlinieneinstellungen konfigurieren:

• Hinzufügen einer CORS-Richtlinie zu Ihrer API

• Hinzufügen einer Richtlinie zu Ihrem benutzerdefinierten Connector, die einen Origin-Header für HTTP-Anforderungen festlegt

Voraussetzungen

• Bearbeiten Sie den folgenden Schnellstart: Erstellen einer neuen Azure API Management-Dienstinstanz
• Exportieren einer API aus Ihrer API Management-Instanz in eine Power Platform-Umgebung als benutzerdefinierter Connector

Hinzufügen einer CORS-Richtlinie zur API in API Management

Führen Sie die folgenden Schritte aus, um die CORS-Richtlinie in API Management zu konfigurieren.

1. Melden Sie sich beim Azure-Portal an, und wechseln Sie zu Ihrer API Management-Instanz.
2. Wählen Sie im linken Menü APIs und dann die API aus, die Sie als benutzerdefinierten Connector exportiert haben. Bei Bedarf wählen Sie nur einen API-Vorgang aus, auf den Sie die Richtlinie anwenden möchten.
3. Wählen Sie im Abschnitt Richtlinien im Abschnitt Eingehende Verarbeitung die Option + Richtlinie hinzufügen aus.
   1. Wählen Sie Ursprungsübergreifende Ressourcenfreigabe (CORS) zulassen aus.
   2. Fügen Sie den folgenden zulässigen Ursprung hinzu: https://make.powerapps.com.
   3. Wählen Sie Speichern aus.

• Weitere Informationen zum Konfigurieren einer Richtlinie finden Sie unter Festlegen oder Bearbeiten von Richtlinien.
• Ausführliche Informationen zur CORS-Richtlinie finden Sie in der CORS-Richtlinienreferenz.

Hinweis

Wenn Sie bereits über eine vorhandene CORS-Richtlinie auf Dienstebene (alle APIs) verfügen, um die Testkonsole des Entwicklerportals zu aktivieren, können Sie dieser Richtlinie den https://make.powerapps.com-Ursprung hinzufügen, anstatt eine separate Richtlinie für die API oder den Vorgang zu konfigurieren.

Hinweis

Abhängig davon, wie der benutzerdefinierte Connector in Power Platform-Anwendungen verwendet wird, müssen Sie möglicherweise zusätzliche Ursprünge in der CORS-Richtlinie konfigurieren. Wenn beim Ausführen von Power Platform-Anwendungen CORS-Probleme auftreten, verwenden Sie Entwicklertools in Ihrem Browser, die Ablaufverfolgung in API Management oder Application Insights, um die Probleme zu untersuchen.

Hinzufügen einer Richtlinie zum benutzerdefinierten Connector zum Festlegen des Origin-Headers

Fügen Sie Ihrem benutzerdefinierten Connector in Ihrer Power Platform-Umgebung die folgende Richtlinie hinzu. Die Richtlinie legt einen Origin-Header so fest, dass er dem CORS-Ursprung entspricht, den Sie in API Management zugelassen haben.

Einzelheiten zur Bearbeitung der Einstellungen eines benutzerdefinierten Connectors finden Sie unter Erstellen eines benutzerdefinierten Connectors ohne Vorlage.

1. Melden Sie sich bei Power Apps oder Power Automate an.

2. Wählen Sie im linken Bereich Daten>Benutzerdefinierte Connectors aus.

3. Wählen Sie Ihren Connector aus der Liste der benutzerdefinierten Connectors aus.

4. Wählen Sie das Bleistiftsymbol (Bearbeiten) aus, um den benutzerdefinierten Verbinder zu bearbeiten.

5. Wählen Sie 3. Definition aus.

6. Wählen Sie unter Richtlinien die Option + Neue Richtlinie aus. Wählen Sie die folgenden Details der Richtlinie aus oder geben Sie sie ein.

   Einstellung	Wert
   Name	Ein Name Ihrer Wahl, z. B. set-origin-header.
   Vorlage	HTTP-Header setzen
   Headername	Ursprung
   Headerwert	https://make.powerapps.com (gleiche URL, die Sie in API Management konfiguriert haben).
   Aktion, wenn Header vorhanden ist	override
   Richtlinie ausführen	Anforderung

   

7. Wählen Sie Connector aktualisieren aus.

8. Wechseln Sie nach dem Festlegen der Richtlinie zur Seite 5. Test, um den benutzerdefinierten Connector zu testen.

Nächste Schritte

• Informieren Sie sich ausführlicher über Power Platform.
• Weitere Informationen zum Erstellen und Verwenden von benutzerdefinierten Connectors