Ler em inglês

Partilhar via

Adicionar autenticação OAuth para acionadores de pedidos HTTP

  • Artigo

Pode utilizar o acionador Quando um pedido HTTP é recebido para acionar fluxos de trabalho ao enviar um pedido para um pedido HTTP para o ponto final gerado a partir do fluxo. Pode restringir o que os utilizadores podem acionar neste fluxo de trabalho assegurando que apenas os utilizadores autenticados podem acionar este fluxo de trabalho.

Nota

Esta caraterística está a ser implementada e pode ainda não estar disponível na sua região.

Escolher um parâmetro de autenticação

O acionador tem três modos para o parâmetro de autenticação:

  1. Qualquer utilizador no meu inquilino: assegura que qualquer utilizador no mesmo inquilino que o criador é capaz de acionar este fluxo de trabalho. Esta é a predefinição para todos os fluxos novos.
  2. Utilizadores específicos no meu inquilino: assegura que apenas IDs de utilizador específicos do mesmo inquilino só podem acionar este fluxo de trabalho. Pode fornecer endereços de e-mail dos utilizadores específicos no campo Utilizadores permitidos. Também pode fornecer IDs de objeto de utilizadores do principal do serviço, se pretender utilizar este fluxo para ser acionado apenas por utilizadores SPN (nome do principal do serviço).
  3. Qualquer pessoa: definição legada para este acionador que tenha acesso aberto sem qualquer suporte de autenticação adicional. Qualquer pessoa pode acionar este fluxo de trabalho se tiver acesso ao URL e ao esquema JSON associado.

Nota

Se selecionar a opção Utilizadores específicos no meu inquilino e deixar os utilizadores permitidos em branco, o âmbito de autenticação é limitado ao inquilino. Isto significa que qualquer utilizador no inquilino pode acionar este fluxo de trabalho.

Escolha as afirmações para o pedido HTTP

Se estiver a restringir que fluxo de trabalho seja acionado apenas por utilizadores autenticados, tem de garantir que o pedido HTTP contém as afirmações corretas. As afirmações necessárias estão na seguinte lista:

  • "aud":<audiência do serviço de fluxo>. É aqui que encontra os valores da audiência entre diferentes clouds. Mais informações: Valores de auditoria
  • "iss":<Emissor do solicitador>
  • "tid":<ID do inquilino do solicitador>
  • "oid":<ID do objeto do solicitador>. Opcional. Este campo só é necessário se tiver configurado o acionador para restringir a utilizadores específicos no inquilino.

Pode verificar as afirmações do seu pedido ao colar o token de portador no cabeçalho de autorização em https://jwt.io. Para mais informações sobre a extração de tokens de forma programática, aceda à Biblioteca de Autenticação da Microsoft (MSAL).

Valores de audiência

A tabela seguinte mostra os valores de audiência em diferentes clouds:

Tipo de cloud Valor de audiência
Cloud pública https://service.flow.microsoft.com/
Nuvem da Administração Pública (GCC) https://gov.service.flow.microsoft.us/
Nuvem da Comunidade Governamental High (GCCH) https://high.service.flow.microsoft.us/
China https://service.powerautomate.cn/
Department of Defense (DOD) https://service.flow.appsplatform.us/

Ver o parâmetro no estruturador

Dependendo da versão do estruturador, os parâmetros aparecem em localizações diferentes.

Nota

O Power Automate utiliza o estruturador de fluxos de cloud clássico ou o estruturador de fluxos de cloud com o Copilot. Para identificar o estruturador que está a utilizar, aceda à secção Nota em Compreender o novo estruturador de fluxos de cloud com capacidades de copiloto.

O parâmetro é apresentado no cartão.

Captura de ecrã de quem pode acionar o fluxo de cloud no estruturador clássico.