Condividi tramite


Abilitare i criteri CORS per il connettore personalizzato di Gestione API

SI APPLICA A: Tutti i livelli di Gestione API

La condivisione di risorse tra le origini (CORS) è un meccanismo basato su intestazione HTTP che consente a un server di indicare qualsiasi origine (dominio, schema o porta) diversa da quella da cui un browser deve consentire il caricamento delle risorse. I clienti possono aggiungere un criterio CORS alle API Web in Gestione API di Azure, che aggiunge il supporto per la condivisione di risorse tra le origini a un'operazione o a un'API per consentire chiamate tra domini da client basati su browser.

Se si esporta un'API da Gestione API come connettore personalizzato in Power Platform e si vuole usare client basati su browser, tra cui Power Apps o Power Automate per chiamare l'API, è necessario configurare l'API per abilitare in modo esplicito le richieste tra le origini dalle applicazioni Power Platform. Questo articolo illustra come configurare le due impostazioni dei criteri necessarie seguenti:

  • Aggiungere un criterio CORS all'API
  • Aggiungere un criterio al connettore personalizzato che imposta un'intestazione Origin nelle richieste HTTP

Prerequisiti

Aggiungere criteri CORS all'API in Gestione API

Seguire questa procedura per configurare i criteri CORS in Gestione API.

  1. Accedere al portale di Azure e passare all'istanza di Gestione API.
  2. Nel menu a sinistra selezionare API e selezionare l'API esportata come connettore personalizzato. Se si vuole, selezionare solo un'operazione API a cui applicare i criteri.
  3. Nella sezione Politiche, nella sezione Elaborazione in ingresso, selezionare + Aggiungi politica.
    1. Selezionare Consenti condivisione risorse tra le origini (CORS).
    2. Aggiungere l'origine consentita seguente: https://make.powerapps.com.
    3. Seleziona Salva.

Annotazioni

Se si dispone già di un criterio CORS esistente a livello di servizio (tutte le API) per abilitare la console di test del portale per sviluppatori, è possibile aggiungere l'origine https://make.powerapps.com a tale criterio invece di configurare un criterio separato per l'API o l'operazione.

Annotazioni

A seconda del modo in cui il connettore personalizzato viene usato nelle applicazioni Power Platform, potrebbe essere necessario configurare più origini nei criteri CORS. Se si verificano problemi CORS durante l'esecuzione di applicazioni Power Platform, usare gli strumenti di sviluppo nel browser, la traccia in Gestione API o Application Insights per analizzare i problemi.

Aggiungere criteri al connettore personalizzato per impostare l'intestazione Origin

Aggiungere i criteri seguenti al connettore personalizzato nell'ambiente Power Platform. Il criterio imposta un'intestazione Origin in modo che corrisponda all'origine CORS consentita in Gestione API.

Per informazioni dettagliate sulla modifica delle impostazioni di un connettore personalizzato, vedere Creare un connettore personalizzato da zero.

  1. Accedere a Power Apps o Power Automate.

  2. Nel riquadro sinistro, selezionare dati>Connettori personalizzati.

  3. Selezionare il connettore dall'elenco dei connettori personalizzati.

  4. Per modificare il connettore personalizzato, selezionare l'icona a forma di matita (Modifica).

  5. Selezionare 3. Definizione.

  6. In Criteri selezionare + Nuovo criterio. Selezionare o immettere i dettagli della policy seguenti.

    Impostazione Value
    Nome Nome preferito, ad esempio set-origin-header
    Template Imposta intestazione HTTP
    Nome dell'intestazione Origine
    Valore intestazione https://make.powerapps.com (stesso URL configurato in Gestione API)
    Azione se l'intestazione esiste override
    Eseguire i criteri in Richiedi

    Screenshot della creazione di criteri nel connettore personalizzato di Power Platform per impostare un'intestazione Origin nelle richieste HTTP.

  7. Selezionare Aggiorna connettore.

  8. Dopo aver impostato il criterio, passare a 5. Pagina di test per testare il connettore personalizzato.