Habilitar las políticas CORS para el conector personalizado de API Management

  • Artículo

SE APLICA A: todos los niveles de API Management

El Intercambio de Recursos de Origen Cruzado (CORS) es un mecanismo que usa encabezados HTTP para permitir a un servidor que indique cualquier origen (dominio, esquema o puerto) distinto del suyo propio a partir del que un explorador debe permitir la carga de recursos. Los clientes pueden agregar una directiva de CORS a sus API web en Azure API Management, que agrega compatibilidad con el Intercambio de Recursos de Origen Cruzado a una operación o una API para permitir llamadas entre dominios desde clientes basados en explorador.

Si exporta una API desde API Management como un conector personalizado en Power Platform y desea usar clientes basados en navegador, como Power Apps o Power Automate, para llamar a la API, debe configurar su API para permitir explícitamente las solicitudes de origen cruzado desde las aplicaciones de Power Platform. En este artículo se muestra cómo configurar las dos opciones de directiva necesarias:

  • Agregar una directiva de CORS a la API

  • Agregar una directiva al conector personalizado que establece un encabezado Origin en solicitudes HTTP

Prerrequisitos

Agregar una directiva de CORS a la API en API Management

Siga estos pasos para configurar la directiva de CORS en API Management.

  1. Inicie sesión en Azure Portal y vaya a la instancia de API Management.
  2. En el menú de la izquierda, seleccione API y elija la API que exportó como un conector personalizado. Si lo desea, seleccione solo una operación de API a la que aplicar la directiva.
  3. En la sección Directivas, dentro de la sección Procesamiento de entrada, seleccione + Agregar directiva.
    1. Habilitar el Intercambio de Recursos de Origen Cruzado (CORS).
    2. Agregue el siguiente origen permitido: https://make.powerapps.com.
    3. Seleccione Guardar.
  • Para obtener más información sobre la configuración de directiva, consulte Establecer o editar directivas.
  • Para más información sobre la directiva de CORS, consulte la referencia de la directiva cors.

Nota:

Si ya tiene una directiva de CORS existente a nivel de servicio (todas las API) para habilitar la consola de prueba del portal para desarrolladores, puede agregar el origen https://make.powerapps.com a esa directiva en lugar de configurar una directiva independiente para la API o la operación.

Nota:

En función de cómo se use el conector personalizado en las aplicaciones de Power Platform, es posible que tenga que configurar orígenes adicionales en la directiva de CORS. Si experimenta problemas de CORS al ejecutar aplicaciones de Power Platform, use las herramientas de desarrollo en el explorador, seguimiento en API Management, o Application Insights para investigar los problemas.

Agregar una directiva al conector personalizado para establecer el encabezado Origin

Agregue la siguiente directiva al conector personalizado en el entorno de Power Platform. La directiva establece un encabezado Origin para que coincida con el origen de CORS permitido en API Management.

Para obtener más información sobre la edición de la configuración de un conector personalizado, consulte Crear un conector personalizado desde cero.

  1. Iniciar sesión en Power Apps o Power Automate.

  2. En el panel izquierdo, seleccione Datos>Conectores personalizados.

  3. Seleccione el conector en la lista de conectores personalizados.

  4. Seleccione el icono de lápiz (Editar) para editar el conector personalizado.

  5. Seleccione 3. Definición.

  6. En Directivas, seleccione + Nueva directiva. Seleccione o especifique los siguientes detalles de directiva.

    Configuración Value
    Nombre Un nombre de su elección, como set-origin-header
    Plantilla Establecer encabezado HTTP
    Nombre de encabezado Origen
    Valor de encabezado https://make.powerapps.com (misma dirección URL que configuró en API Management)
    Acción si existe un encabezado override
    Ejecutar directiva con Solicitud

    Captura de pantalla de la creación de una directiva en el conector personalizado de Power Platform para establecer un encabezado Origin en solicitudes HTTP.

  7. Seleccione Actualizar conector.

  8. Después de establecer la directiva, vaya a 5. Página de prueba para probar el conector personalizado.

Pasos siguientes