Adicionar autenticação de usuário final a um bot do Power Virtual Agents

[This topic is pre-release documentation and is subject to change.]

Você pode habilitar a autenticação do usuário diretamente de uma conversa de bot do Power Virtual Agents. Isso significa que você pode solicitar que um usuário entre usando o logon único, recupere um token de usuário para esse usuário e, em seguida, use esse token para recuperar as informações do usuário em um sistema back-end.

Importante

Antes de usar este recurso, você deve seguir as instruções de configuração da autenticação do usuário final.

Pré-requisitos

Adicionar autenticação de usuário a um tópico

Insira o modelo do nó de autenticação:

  1. Vou para a página Tópicos do bot que você deseja editar.

  2. Abra a Tela de criação do tópico ao qual você deseja adicionar o modelo de autenticação.

  3. Selecione o ícone de mais (+) para adicionar um nó de mensagem. Digite o que o bot deve dizer para indicar que uma experiência de entrada está prestes a ocorrer.

    Captura de tela da adição de um nó

  4. Abaixo do nó da mensagem que você acabou de criar, selecione o ícone de mais (+), selecione Chamar uma ação e selecione Autenticar.

    Selecionar Autenticar

  5. Uma vez selecionado, vários novos nós serão adicionados automaticamente. Esses nós incluem um nó Autenticar principal, seguido por nós para bot, um caminho de êxito e falha.

    Novos nós

Nó Autenticar

O nó Autenticar é o local em que o usuário, se ainda não estiver conectado, deverá fornecer um cartão de entrada.

Solicitar a entrada

Depois que o usuário digitar seu nome de usuário e senha no prompt (hospedado pelo provedor de identidade), poderá ser solicitado que você digite um código de validação, dependendo do canal. Alguns canais, como o Microsoft Teams, não exigem que o usuário insira um código de validação.

O nó Autenticar gera como saída duas variáveis: IsLoggedIn e AuthToken.

Variável IsLoggedIn

A variável IsLoggedIn indica se o usuário está conectado (como resultado da entrada ou se conectado - esse é o caminho de êxito de entrada) ou não está conectado (o que resultaria no caminho da falha de entrada).

IsLoggedIn é uma variável do tipo booliano que contém o status de entrada do usuário. Você pode usar essa variável para criar lógica de ramificação em seus tópicos que verifica se há uma entrada bem-sucedida (por exemplo, no modelo já fornecido como parte da adição do nó Autenticar) ou buscar oportunamente informações do usuário apenas se o usuário estiver conectado.

Variável AuthToken

A variável AuthToken contém o token do usuário, obtido após a entrada do usuário. Você pode passar essa variável para fluxos do Power Automate para que eles possam se conectar a APIs de back-end e buscar as informações do usuário ou executar ações em nome do usuário.

Aviso

Certifique-se de passar a variável AuthToken apenas para fontes confiáveis. Ele contém informações de autenticação do usuário que, se comprometidas, podem prejudicar o usuário.

Não use AuthToken em nós Mensagem ou em fluxos nos quais você não confia.

Uso de AuthToken sem um nó Autenticar

As variáveis IsLoggedIn e AuthToken estão disponíveis, mesmo se você não usar o modelo fornecido pela entrada de menu Chamar uma ação. Se você passar a variável AuthToken sem primeiro fazer com que o usuário passe pelo nó Autenticar, o usuário será solicitado a entrar nessa etapa.

Isso pode ser útil se você sempre espera que o usuário esteja conectado ou se está sendo redirecionado de outro tópico. Sugerimos que você use o modelo fornecido pela entrada Chamar uma ação para tratar casos em que o usuário não consegue entrar.

Observação

Se o usuário sair no meio de uma conversa, será solicitado que você entre novamente se o tópico chegar a um nó que usa a variável AuthToken.

Caminho de êxito

O caminho de êxito equivale a onde IsLoggedIn = True e contas para quando o usuário entrou com êxito (ou já estava conectado).

Se você tiver uma lógica que use a variável AuthToken (por exemplo, para conectar-se a um sistema de back-end usando um fluxo para recuperar as informações de um usuário), ela deverá seguir esse caminho.

Caminho de falha

O caminho da falha equivale a qualquer condição diferente de IsLoggedIn = True. Na maioria dos casos, isso ocorre porque o usuário não entrou, usou a senha incorreta ou cancelou a experiência de entrada.

Você deve adicionar qualquer lógica que queira tratar neste caso. Como exemplo, fornecemos opções para tentar novamente ou escalonar para um agente humano. Você deve personalizar isso para seu cenário e uso específicos.

Como testar seu tópico

Você deve testar seu tópico usando um usuário real configurado no seu provedor de identidade. Verifique se os caminhos de êxito e falha de entrada são exercitados, para que não haja surpresas se o usuário não entrar ou se houver um erro na experiência de entrada do provedor de identidade.