Especificar parâmetros de ligação

Antes de usar um conector no Microsoft Copilot Studio, Azure Logic Apps, Microsoft Power Automate ou Microsoft Power Apps, precisa de criar uma ligação autenticando-se ao serviço backend. Você define como a autenticação com o serviço de back-end acontece nos parâmetros de conexão durante a criação do conector. Para começar, vai ao separador Security no portal Power Automate ou Power Apps para especificar que tipo de autenticação queres usar ao criar a ligação.

Agora você tem a capacidade de gerenciar diretamente do Power Platform centro de administração. Aceda a autenticação nos serviços do Power Platform para saber mais.

Tipos de autenticação

Os diferentes tipos de autenticação atualmente suportados são:

  • Sem autenticação
  • autenticação Básica
  • Autenticação baseada em Chave de API
  • OAUTH 2,0

Importante

  • Se o seu conector usar OAuth, monitorize e renove regularmente o ID do cliente a expirar e as credenciais secretas do cliente para que os clientes possam continuar a usar o seu conector.
  • Quando atualiza o segredo do cliente, atualiza a versão do Swagger.
  • Submeta a atualização do conector um mês antes de o seu ID do cliente e o seu segredo do cliente expirarem.

Sem autenticação

O utilizador não necessita de qualquer autenticação para criar uma ligação ao conector. Um utilizador anónimo pode utilizar o seu conector neste caso.

Autenticação básica

Este é tipo de autenticação mais simples. O utilizador apenas precisa de fornecer o nome de utilizador e a palavra-passe para criar a ligação.

Captura de ecrã que mostra os campos para autenticação básica.

Os valores inseridos em Rótulo de parâmetro são os nomes dos campos "nome de utilizador" e "senha" que o utilizador vê ao criar a conexão. Para o exemplo anterior, isto é o que o utilizador vê ao criar uma ligação:

Captura de ecrã que mostra os valores ocultos nos campos de autenticação.

Autenticação baseada em chave de api

O utilizador não precisa de fornecer a chave de API ao criar a ligação. O campo Localização do parâmetro oferece a opção de enviar a chave da API para o seu serviço em cabeçalhos ou uma cadeia de caracteres de consulta quando a solicitação é feita.

Autenticação de Chave de API

O valor que você insere em Rótulo do parâmetro é o nome do campo que o utilizador vê. Por exemplo, a seguinte imagem é mostrada ao utilizador na hora de criação de ligação. Quando é efetuado um pedido ao seu serviço, adiciona-se um cabeçalho com o nome "ApiKey" e o valor tal como inserido pelo utilizador ao pedido.

Autenticação da chave de API

OAUTH 2,0

Este é o tipo usado com mais freqüência, que usa a estrutura de autenticação Oauth 2 para autenticar com o serviço. Para utilizar este tipo de autenticação, precisa de registar a aplicação no serviço para que esta possa receber tokens de acesso para os utilizadores. Por exemplo, Registar a candidatura em Microsoft Entra ID mostra como registar uma candidatura no serviço Microsoft Entra ID. Precisa de fornecer as seguintes informações:

  • Provedor de identidade: a interface do utilizador atualmente suporta vários provedores de identidade. Os gerais são Generic Oauth 2, que pode ser usado para qualquer serviço, e Microsoft Entra ID, que pode ser usado para todos os serviços Azure. Alguns fornecedores de identidade específicos, como Facebook, GitHub, Google, entre outros, também são suportados.

  • ID do cliente: a ID do cliente do aplicativo que você registrou no serviço.

  • Segredo do cliente: O segredo do cliente da aplicação que registou no serviço.

  • Url de autorização: o ponto final de autorização de API para efetuar a autenticação com o serviço.

  • Url do Token: o ponto final de API para obter o token de acesso após a autorização ter sido efetuada.

  • Atualizar URL: O endpoint da API para renovar o token de acesso após a sua expiração.

Nota

Atualmente, o tipo de concessão de credenciais de cliente não é suportado por conectores personalizados.

O exemplo seguinte demonstra a utilização do fornecedor de identidade Genérico Oauth 2 para autenticar com o serviço Microsoft Entra ID.

OAUTH 2,0

Durante o processo de criação da ligação, é pedido ao utilizador que introduza as credenciais para iniciar sessão no serviço. Estas credenciais são utilizadas pela aplicação para obter um token de autorização. Este token de autorização é enviado para o serviço através do Cabeçalho de autorização para cada pedido.

Enviar comentários

Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.

  • Last updated on