Parâmetros de ligação

Antes de utilizar um conector no Azure Logic Apps, no Microsoft Power Automate ou no Microsoft Power Apps, precisa de criar uma ligação ao autenticar-se no serviço de back-end. Esta informação sobre a forma como acontece a autenticação com o serviço de back-end deve ser definida durante a criação do conector, como parte dos parâmetros de ligação. Ao criar um conector personalizado com a interface de utilizador no portal do Power Automate ou Power Apps, no separador Segurança, pode especificar o tipo de autenticação que quer utilizar ao criar a ligação.

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

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.

Os valores que introduzir na Etiqueta do parâmetro serão os nomes dos campos "nome de utilizador" e "palavra-passe" que o utilizador vê durante a criação da ligação. Para o exemplo anterior, isto é o que o utilizador vê ao criar uma ligaçã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 permite-lhe enviar a chave de API para o serviço nos cabeçalhos ou numa cadeia de consulta quando é realizado um pedido.

O valor que introduzir em Etiqueta de parâmetros é 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 serviço, são adicionados um cabeçalho com o nome "ApiKey" e o valor conforme introduzido pelo utilizador.

Oauth 2.0

Este é o tipo utilizado com mais frequência, que utiliza a estrutura de autenticação Oauth 2 para efetuar a autenticação 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 aplicação no Microsoft Entra ID mostra como registar uma aplicação com o serviço Microsoft Entra ID. Precisa de fornecer as seguintes informações:

• Fornecedor de identidades: a interface de utilizador atualmente suporta múltiplos fornecedores de identidades. As gerais são Oauth 2 Genérico, que podem ser utilizadas para qualquer serviço e Microsoft Entra ID, que pode ser utilizado para todos os serviços do Azure. Alguns fornecedores de identidade específicos, como o Facebook, o GitHub, a Google, etc., também são suportados.

• ID de cliente: o ID de cliente da aplicação que registou 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 da 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 ponto final de API para atualizar o token de acesso após expiração.

Nota

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

O exemplo seguinte demonstra como utilizar o fornecedor de identidade Oauth 2 Genérico para se autenticar no serviço Microsoft Entra ID.

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.