Włączanie zasad CORS dla łącznika niestandardowego usługi API Management

DOTYCZY: Wszystkie warstwy usługi API Management

Współużytkowanie zasobów między źródłami (CORS) to mechanizm oparty na nagłówku HTTP, który umożliwia serwerowi wskazanie wszelkich źródeł (domen, schematów lub portów), z których przeglądarka powinna zezwalać na ładowanie zasobów. Klienci mogą dodawać zasady MECHANIZMU CORS do swoich internetowych interfejsów API w usłudze Azure API Management, co dodaje obsługę udostępniania zasobów między źródłami do operacji lub interfejsu API w celu umożliwienia wywołań między domenami z klientów opartych na przeglądarce.

Jeśli interfejs API został wyeksportowany z usługi API Management jako łącznik niestandardowy w usłudze Power Platform i chcesz używać klientów opartych na przeglądarce, w tym usługi Power Apps lub Power Automate do wywoływania interfejsu API, musisz skonfigurować interfejs API w celu jawnego włączenia żądań między źródłami z aplikacji platformy Power Platform. W tym artykule przedstawiono sposób konfigurowania następujących dwóch niezbędnych ustawień zasad:

  • Dodawanie zasad CORS do interfejsu API

  • Dodawanie zasad do łącznika niestandardowego, który ustawia nagłówek źródła dla żądań HTTP

Wymagania wstępne

  • Wykonaj procedury przedstawione w następującym przewodniku Szybki start: Tworzenie wystąpienia usługi Azure API Management
  • Eksportowanie interfejsu API z wystąpienia usługi API Management do środowiska platformy Power Platform jako łącznika niestandardowego

Dodawanie zasad CORS do interfejsu API w usłudze API Management

Wykonaj następujące kroki, aby skonfigurować zasady CORS w usłudze API Management.

  1. Zaloguj się do witryny Azure Portal i przejdź do wystąpienia usługi API Management.
  2. W menu po lewej stronie wybierz pozycję Interfejsy API i wybierz interfejs API wyeksportowany jako łącznik niestandardowy. Jeśli chcesz, wybierz tylko operację interfejsu API, do której mają zostać zastosowane zasady.
  3. W sekcji Zasady w sekcji Przetwarzanie przychodzące wybierz pozycję + Dodaj zasady.
    1. Wybierz pozycję Zezwalaj na współużytkowanie zasobów między źródłami (CORS).
    2. Dodaj następujące dozwolone źródło: https://make.powerapps.com.
    3. Wybierz pozycję Zapisz.

Uwaga

Jeśli masz już istniejące zasady CORS na poziomie usługi (wszystkie interfejsy API), aby włączyć konsolę testową portalu dla deweloperów, możesz dodać https://make.powerapps.com źródło do tych zasad zamiast konfigurować oddzielne zasady dla interfejsu API lub operacji.

Uwaga

W zależności od sposobu użycia łącznika niestandardowego w aplikacjach platformy Power Platform może być konieczne skonfigurowanie dodatkowych źródeł w zasadach MECHANIZMU CORS. Jeśli występują problemy z mechanizmem CORS podczas uruchamiania aplikacji platformy Power Platform, użyj narzędzi deweloperskich w przeglądarce, śledzenia w usłudze API Management lub aplikacji Szczegółowe informacje w celu zbadania problemów.

Dodawanie zasad do łącznika niestandardowego w celu ustawienia nagłówka źródła

Dodaj następujące zasady do łącznika niestandardowego w środowisku platformy Power Platform. Zasady ustawia nagłówek źródła, aby był zgodny z źródłem mechanizmu CORS dozwolonym w usłudze API Management.

Aby uzyskać szczegółowe informacje na temat edytowania ustawień łącznika niestandardowego, zobacz Tworzenie łącznika niestandardowego od podstaw.

  1. Zaloguj się w Power Apps lub Power Automate.

  2. W okienku po lewej stronie wybierz pozycję Niestandardowe>Połączenie danych.

  3. Wybierz łącznik z listy łączników niestandardowych.

  4. Wybierz ikonę ołówka (Edytuj), aby edytować łącznik niestandardowy.

  5. Wybierz pozycję 3. Definicja.

  6. W obszarze Zasady wybierz pozycję + Nowe zasady. Wybierz lub wprowadź następujące szczegóły zasad.

    Ustawienie Wartość
    Nazwisko Wybrana nazwa, taka jak set-origin-header
    Template Ustaw nagłówek HTTP
    Nazwa nagłówka Źródło
    Wartość nagłówka https://make.powerapps.com (ten sam adres URL, który został skonfigurowany w usłudze API Management)
    Akcja, jeśli nagłówek istnieje override
    Uruchom zasady w Zażądaj

    Zrzut ekranu przedstawiający tworzenie zasad w łączniku niestandardowym platformy Power Platform w celu ustawienia nagłówka Origin w żądaniach HTTP.

  7. Wybierz pozycję Aktualizuj łącznik.

  8. Po ustawieniu zasad przejdź do 5. Strona testowa w celu przetestowania łącznika niestandardowego.

Następne kroki