Adicionar autenticação OAuth para gatilhos de solicitação HTTP

Use o gatilho Quando uma solicitação HTTP for recebida para iniciar fluxos de trabalho enviando uma solicitação para o ponto de extremidade de solicitação HTTP gerado a partir do fluxo. Você pode restringir quem pode disparar esse fluxo de trabalho garantindo que somente usuários autenticados possam disparar esse fluxo de trabalho.

Note

Este recurso está sendo implementado e pode ainda não estar disponível na sua região.

Escolha um parâmetro de autenticação

O gatilho possui três modos para o parâmetro de autenticação:

  1. Qualquer usuário em meu locatário: garante que qualquer usuário no mesmo locatário que o criador possa disparar esse fluxo de trabalho. Essa configuração é o padrão para quaisquer novos fluxos.
  2. Usuários específicos em meu locatário: garante que apenas IDs de usuário específicas do mesmo locatário possam disparar esse fluxo de trabalho. Insira endereços de email dos usuários específicos no campo Usuários permitidos . Você também pode inserir IDs de objeto de usuários da entidade de serviço se pretende usar esse fluxo para ser disparado somente por usuários SPN (nome da entidade de serviço).
  3. Qualquer pessoa: configuração legada para esse gatilho que tem acesso aberto sem qualquer suporte de autenticação adicional. Qualquer pessoa pode acionar esse fluxo de trabalho se tiver acesso à URL e ao esquema JSON associado.

Note

Se você selecionar a opção Usuários específicos em meu locatário e deixar os usuários permitidos em branco, o escopo de autenticação será limitado ao locatário. Isso significa que qualquer usuário do locatário pode acionar esse fluxo de trabalho.

Escolha as declarações para sua solicitação HTTP

Se você restringir o fluxo de trabalho a ser disparado somente por usuários autenticados, verifique se a solicitação HTTP contém as declarações corretas. As reivindicações obrigatórias estão na seguinte lista:

  • "aud": <público do serviço de fluxo de dados>. É aqui que você encontra os valores do público-alvo em diferentes ambientes em nuvem. Mais informações: Valores do público-alvo
  • "iss": <Emissor do requerente>
  • "tid": <ID do locatário do solicitante>
  • "oid": <id de objeto do solicitante>. Opcional. Esse campo será necessário somente se você tiver configurado o gatilho para restringir a usuários específicos dentro do locatário.

Você pode verificar as reivindicações da sua solicitação colando o token do portador no cabeçalho de autorização em https://jwt.io. Para obter mais informações sobre como extrair os tokens programaticamente, acesse o Biblioteca de Autenticação da Microsoft (MSAL).

Valores do público-alvo

A tabela a seguir mostra os valores de audiência entre nuvens diferentes. Os valores de audiência devem ser uma correspondência exata, incluindo barras finais.

Tipo de nuvem Valor do público-alvo
Nuvem pública https://service.flow.microsoft.com/
GCC (Government Community Cloud) https://gov.service.flow.microsoft.us/
Nuvem da Comunidade Governamental Alto Nível (GCCH) https://high.service.flow.microsoft.us/
China https://service.powerautomate.cn/
Departamento de Defesa (DOD) https://service.flow.appsplatform.us/

Visualize o parâmetro no designer

Dependendo da versão do seu designer, os parâmetros aparecem em locais diferentes.

Power Automate permite usar o novo designer ou o designer clássico para configurar o fluxo na nuvem. As etapas são semelhantes em ambos os designers. Saiba mais (com exemplos) em Identificar diferenças entre o novo designer e o designer clássico.

O parâmetro aparece no painel de configuração à esquerda.

Captura de tela de quem pode acionar o fluxo da nuvem no designer com o Copilot.

  • Last updated on