Especificar parâmetros de ligação

Antes de usar um conector em Microsoft Copilot Studio, Aplicativos Lógicos Microsoft Power Automate do Azure, ou Microsoft Power Apps você precisa criar uma conexão autenticando no serviço de back-end. 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, vá para a guia Segurança no Power Automate portal ou Power Apps para especificar qual tipo de autenticação você deseja usar ao criar a conexão.

Agora você tem a capacidade de gerenciar diretamente do Power Platform centro de administração. Vá para autenticação em Power Platform serviços 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

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 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:

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.

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 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 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,Registrar o aplicativo em Microsoft Entra ID mostra como registrar um aplicativo com o Microsoft Entra serviço de 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 do Azure. Alguns fornecedores de identidade específicos, como o Facebook, o GitHub, a Google, etc., 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 de extremidade de autorização da API para autenticação com o serviço.

• URL do token: o ponto de extremidade da API para obter o token de acesso após a autorização ter sido feita.

• Atualizar Url: O ponto de extremidade da API para atualizar o token de acesso depois que ele expirar.

O exemplo a seguir demonstra o uso do fornecedor de identidade Generic Oauth 2 para autenticar com o Microsoft Entra serviço de 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 fornecer comentários, vá para Enviar problemas ou obter ajuda com conectores e selecione seu tipo de feedback.