Teilen über

Aktivieren Sie CORS-Richtlinien für kundenspezifische API-Management-Connectoren

GILT FÜR: Alle API Management-Ebenen

Cross-Origin Resource Sharing (CORS) ist ein HTTP-Header-basierter Mechanismus, der es einem Server ermöglicht, beliebige Ursprünge (Domäne, Schema oder Port) anzugeben - abgesehen von seinem eigenen -, bei denen ein Browser das Laden von Ressourcen erlauben sollte. Kunden können ihrer Web-APIs in Azure API Management eine CORS-Richtlinie hinzufügen, die einer Operation oder einer API unterstützung für die ursprungsübergreifende Ressourcenfreigabe hinzufügt, um domänenübergreifende Aufrufe von browserbasierten Clients zu ermöglichen.

Wenn Sie eine API aus der API-Verwaltung als benutzerdefinierten Connector in der Power Platform exportieren und browserbasierte Clients wie Power Apps oder Power Automate verwenden möchten, um die API aufzurufen, müssen Sie Ihre API so konfigurieren, dass cross-origin-Anforderungen von Power Platform-Anwendungen explizit aktiviert werden. In diesem Artikel wird erläutert, wie Sie die folgenden beiden erforderlichen Richtlinieneinstellungen konfigurieren:

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

Voraussetzungen

Hinzufügen einer CORS-Richtlinie zur API in der API-Verwaltung

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

  1. Melden Sie sich beim Azure-Portal an, und wechseln Sie zu Ihrer API-Verwaltungsinstanz.
  2. Wählen Sie im linken Menü APIs aus, und wählen Sie die API aus, die Sie als benutzerdefinierten Connector exportiert haben. Wenn Sie möchten, wählen Sie nur einen API-Vorgang aus, auf den die Richtlinie angewendet werden soll.
  3. Wählen Sie im Abschnitt Richtlinien und im Abschnitt Eingehende Verarbeitung die Option +Richtlinie hinzufügen aus.
    1. Wählen Sie Zulassen von Cross-Origin Resource Sharing (CORS).
    2. Fügen Sie den folgenden zulässigen Ursprung hinzu: https://make.powerapps.com.
    3. Wählen Sie Speichern aus.

Hinweis

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

Hinweis

Je nachdem, wie der benutzerdefinierte Connector in Power Platform-Anwendungen verwendet wird, müssen Sie möglicherweise weitere 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 der API-Verwaltung 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 mit dem CORS-Ursprung übereinstimmt, den Sie in der API-Verwaltung zugelassen haben.

Ausführliche Informationen zum Bearbeiten von Einstellungen eines benutzerdefinierten Connectors finden Sie unter Erstellen eines benutzerdefinierten Connectors von Grund auf neu.

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

  2. Wählen Sie im linken Bereich "Benutzerdefinierte Datenkonnektoren>" aus.

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

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

  5. Wählen Sie 3 aus. Definition.

  6. Wählen Sie in "Richtlinien" +Neue Richtlinie aus. Wählen Sie die folgenden Richtliniendetails aus, oder geben Sie sie ein.

    Setting Wert
    Name Ein Name Ihrer Wahl, z. B. set-origin-header
    Template HTTP-Header setzen
    Kopfzeilenname Ursprung
    Headerwert https://make.powerapps.com (dieselbe URL, die Sie in der API-Verwaltung konfiguriert haben)
    Aktion, wenn Kopfzeile vorhanden ist override
    Richtlinie ausführen Anforderung

    Screenshot des Erstellens einer Richtlinie im benutzerdefinierten Power Platform-Connector zum Festlegen eines Origin-Headers in HTTP-Anforderungen.

  7. Wählen Sie Connector aktualisieren aus.

  8. Wechseln Sie nach dem Festlegen der Richtlinie zu 5. Testseite zum Testen des benutzerdefinierten Connectors.

Verwandte Inhalte

  • Last updated on