Padrões de autenticação

Os suplementos podem exigir que os usuários entrem ou se inscrevam para acessar recursos. Os controles de autenticação comuns incluem campos e botões de nome de usuário e senha que iniciam fluxos de credenciais que não são da Microsoft. Uma experiência de autenticação simples e eficiente ajuda os usuários a começar rapidamente.

Práticas recomendadas

Fazer	Não fazer
Antes de entrar, descreva o valor do suplemento ou demonstre a funcionalidade sem exigir uma conta.	Espere que os usuários entrem sem entender o valor e os benefícios do seu suplemento.
Oriente os usuários pelos fluxos de autenticação com um botão principal bem visível em cada tela.	Chame atenção para as tarefas secundárias e terciárias com outros botões e chamadas para ação.
Use rótulos de botão claros que descrevam tarefas específicas, como “Entrar” ou “Criar conta”.	Use rótulos de botão vagos, como "Enviar" ou "Introdução".
Use uma caixa de diálogo para concentrar a atenção do usuário em formulários de autenticação.	Sobrecarregue seu painel de tarefas com uma experiência de primeira execução e formulários de autenticação.
Encontre pequenas eficiências no fluxo, como caixas de entrada com foco automático.	Adicione etapas desnecessárias à interação, como exigir que os usuários cliquem nos campos do formulário.
Forneça uma maneira para os usuários saírem e se autenticarem novamente.	Force os usuários a fazer a desinstalação para alternar identidades.

Fluxo de autenticação

Use esse fluxo para orientar os usuários da primeira experiência de execução para uma entrada concluída.

1. Placemat de primeira execução: coloque o botão de entrada como uma chamada clara para ação na experiência de primeira execução do suplemento.

   

2. Caixa de diálogo de opções do provedor de identidade: exiba uma lista clara de provedores de identidade, incluindo um formulário de nome de usuário e senha, se aplicável. A interface do usuário do suplemento pode ser bloqueada enquanto a caixa de diálogo de autenticação está aberta.

   

3. Entrada do provedor de identidade: o provedor de identidade tem sua própria interface do usuário. O Microsoft Entra ID é compatível com a personalização das páginas de entrada e do painel de acesso para manter a aparência consistente com o seu serviço. Para obter mais informações, consulte Configurar a identidade visual da sua empresa.

   

4. Progresso: indique o progresso enquanto as configurações e a interface do usuário são carregadas.

   

Observação

Ao usar o Microsoft Entra ID, você pode usar um botão de entrada personalizado com a marca para temas claros e escuros. Para obter mais informações, consulte Fluxo de código de autorização OAuth 2.0 e a plataforma de identidade da Microsoft.

Fluxo de autenticação de logon único

Observação

A API de logon único tem suporte no momento para Word, Excel, Outlook e PowerPoint. Para obter mais informações sobre o suporte ao logon único, consulte Conjuntos de requisitos de IdentityAPI. Se você estiver trabalhando com um suplemento do Outlook, certifique-se de habilitar a autenticação moderna para a locação do Microsoft 365. Para obter informações sobre como fazer isso, consulte Habilitar ou desabilitar a autenticação moderna para Outlook no Exchange Online.

Use o logon único para uma experiência mais tranquila para o usuário final. A identidade do usuário no Office (uma conta da Microsoft ou uma identidade do Microsoft 365) é usada para entrar em seu suplemento. Como resultado, os usuários entram apenas uma vez. Isso remove conflitos na experiência e faz com que os clientes comecem a usar o suplemento sem dificuldades.

1. Quando um suplemento é instalado, o usuário vê uma janela de consentimento semelhante à seguinte:

   

   Observação

   O editor do suplemento controla o logotipo, as cadeias de caracteres e os escopos de permissão incluídos na janela de consentimento. A Microsoft pré-configura a IU da janela de consentimento.

2. Depois que o usuário dá consentimento, o suplemento é carregado e pode extrair e exibir informações específicas do usuário.

   

Confira também

• Desenvolver um suplemento do Office com SSO