Compartilhar via

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

APLICA-SE A: todas as camadas do Gerenciamento de API

O CORS (compartilhamento de recursos entre origens) é um mecanismo baseado em cabeçalho HTTP que permite que um servidor indique quaisquer origens (domínio, esquema ou porta) que não sejam as próprias das quais 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 de compartilhamento de recursos entre origens a uma operação ou a uma API, permitindo que clientes baseados em navegador façam chamadas entre domínios.

Se você exportar uma API do Gerenciamento de API como um conector personalizado no Power Platform e quiser usar clientes baseados em navegador, incluindo o Power Apps ou o Power Automate para chamar a API, você precisará configurar sua API para habilitar explicitamente solicitações entre origens de aplicativos do Power Platform. Este artigo mostra como definir as duas configurações de política necessárias a seguir:

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

Pré-requisitos

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

Siga os passos para configurar a política CORS no Gerenciamento de APIs.

  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 você quiser, 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 CORS (compartilhamento de recursos entre origens).
    2. Adicione a seguinte origem permitida: https://make.powerapps.com.
    3. Clique em Salvar.
  • Para obter mais informações sobre como configurar uma política, consulte Definir ou editar políticas.
  • Para obter detalhes sobre a política CORS, consulte a referência de política CORS.

Observação

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

Observação

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

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

Adicione a política a seguir ao conector personalizado em seu ambiente do 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 as configurações de um conector personalizado, consulte Criar um conector personalizado do zero.

  1. Entre no 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 lápis (Editar).

  5. Selecione 3. Definição.

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

    Configurações Value
    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 Solicitação

    Captura de tela da criação de política no conector personalizado do Power Platform para definir um cabeçalho Origin em solicitações HTTP.

  7. Selecione Atualizar um conector.

  8. Depois de definir a política, vá para a página 5. Teste para verificar o conector personalizado.

Conteúdo relacionado

  • Last updated on