Partilhar via

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

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ê exportar uma API do Gerenciamento de API como um conector personalizado na Power Platform e quiser usar clientes baseados em navegador, incluindo Power Apps ou Power Automate para chamar a API, precisará 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 estes passos para configurar a política CORS na Gestão 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.

Observação

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.

Observação

Dependendo de como o conector personalizado é usado em aplicativos da Power Platform, talvez seja necessário configurar mais origens 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 uma 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. Inicie sessão nas Power Apps ou no Power Automate.

  2. No painel esquerdo, selecione Dados>Conectores Personalizados.

  3. Selecione seu conector na lista de conectores personalizados.

  4. Para editar o conector personalizado, selecione o ícone de lápis (Editar).

  5. Selecione 3. Definição.

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

    Configurações Valor
    Nome Um nome de sua escolha, como set-origin-header
    Modelo 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 Pedido

    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 a página 5. Teste para testar o conector personalizado.

Conteúdo relacionado

  • Last updated on