Partilhar via

Habilitar políticas CORS para o conector personalizado do Gerenciamento de API

  • Artigo

APLICA-SE A: Todas as camadas de gerenciamento de API

O compartilhamento de recursos entre origens (CORS) é um mecanismo baseado em cabeçalho HTTP que permite que um servidor indique qualquer origem (domínio, esquema ou porta) diferente da sua própria a partir da qual um navegador deve permitir o carregamento de recursos. Os clientes podem adicionar uma política CORS às suas APIs Web no Gerenciamento de API do Azure, que adiciona suporte ao compartilhamento de recursos entre origens a uma operação ou a uma API para permitir chamadas entre domínios de clientes baseados em navegador.

Se você exportou uma API do Gerenciamento de API como um conector personalizado na Power Platform e deseja usar clientes baseados em navegador, incluindo Power Apps ou Power Automate para chamar a API, você precisa configurar sua API para habilitar explicitamente solicitações entre origens de aplicativos da Power Platform. Este artigo mostra como definir as duas configurações de diretiva necessárias a seguir:

  • Adicionar uma política CORS à sua API

  • Adicionar uma política ao conector personalizado que define um cabeçalho Origin em solicitações HTTP

Pré-requisitos

Adicionar a política CORS à API no Gerenciamento de API

Siga estas etapas para configurar a política CORS no Gerenciamento de API.

  1. Entre no portal do Azure e vá para sua instância de Gerenciamento de API.
  2. No menu à esquerda, selecione APIs e selecione a API que você exportou como um conector personalizado. Se desejar, selecione apenas uma operação de API à qual aplicar a política.
  3. Na seção Políticas, na seção Processamento de entrada, selecione + Adicionar política.
    1. Selecione Permitir compartilhamento de recursos entre origens (CORS).
    2. Adicione a seguinte origem permitida: https://make.powerapps.com.
    3. Selecione Guardar.

Nota

Se você já tiver uma política CORS existente no nível de serviço (todas as APIs) para habilitar o console de teste do portal do desenvolvedor, poderá adicionar a https://make.powerapps.com origem a essa política em vez de configurar uma política separada para a API ou operação.

Nota

Dependendo de como o conector personalizado é usado em aplicativos da Power Platform, talvez seja necessário configurar origens adicionais na política CORS. Se você tiver problemas de CORS ao executar aplicativos da Power Platform, use ferramentas de desenvolvedor em seu navegador, rastreamento no Gerenciamento de API ou no Application Insights para investigar os problemas.

Adicionar política ao conector personalizado para definir o cabeçalho Origin

Adicione a seguinte política ao seu conector personalizado no ambiente da Power Platform. A política define um cabeçalho Origin para corresponder à origem do CORS permitida no Gerenciamento de API.

Para obter detalhes sobre como editar configurações de um conector personalizado, consulte Criar um conector personalizado do zero.

  1. Iniciar sessão no Power Apps ou no Power Automate.

  2. No painel esquerdo, selecione Conectores personalizados de dados>.

  3. Selecione seu conector na lista de conectores personalizados.

  4. Selecione o ícone de lápis (Editar) para editar o conector personalizado.

  5. Selecione 3. Definição.

  6. Em Políticas, selecione + Nova política. Selecione ou insira os seguintes detalhes da política.

    Definição Valor
    Nome Um nome de sua escolha, como set-origin-header
    Template Definir cabeçalho HTTP
    Nome do cabeçalho Origem
    Valor do cabeçalho https://make.powerapps.com (mesma URL que você configurou no Gerenciamento de API)
    Ação se o cabeçalho existir Substituir
    Executar política em Pedir

    Captura de ecrã da criação de políticas no conector personalizado da Power Platform para definir um cabeçalho Origin em pedidos HTTP.

  7. Selecione Atualizar conector.

  8. Depois de definir a política, vá para o 5. Página de teste para testar o conector personalizado.

Próximos passos