Emular autenticadores e depurar WebAuthn

Em vez de depurar a autenticação da Web em seu site ou aplicativo com autenticadores físicos, use a ferramenta WebAuthn para criar e interagir com autenticadores virtuais baseados em software.

Usando a ferramenta WebAuthn , você pode fazer o seguinte sem depender de autenticadores físicos:

• Emular autenticadores.
• Personalize os atributos dos autenticadores.
• Inspecionar estados de autenticadores.

Você pode emular autenticadores e depurar a API de autenticação da Web usando a ferramenta WebAuthn .

Configurar a ferramenta WebAuthn

1. Vá para uma página da Web que usa o WebAuthn. Por exemplo, abra o seguinte site de demonstração em uma nova janela ou guia do navegador: try-webauthn.appspot.com.

2. Entre no site.

3. Para abrir o DevTools, clique com o botão direito do mouse na página da Web e selecione Inspecionar. Ou pressione Ctrl+Shift+I (Windows, Linux) ou Command+Option+I (macOS). O DevTools é aberto.

4. No DevTools, na barra de ferramentas principal, selecione a guia WebAuthn . Se essa guia não estiver visível, clique no botão Mais guias () ou no botão Mais Ferramentas ().

   A ferramenta WebAuthn é aberta:

   

5. Na ferramenta WebAuthn , marque a caixa de seleção Habilitar ambiente de autenticador virtual . Uma nova seção chamada Novo autenticador é exibida:

   

6. Na seção Novo autenticador , configure as seguintes opções:

   Opção	Valor	Detalhes
   Protocol	CTAP2 ou U2F	O protocolo que o autenticador virtual usa para codificação e decodificação
   Transport	usb, nfc, ble, ou internal	O autenticador virtual simula o transporte selecionado para se comunicar com clientes a fim de obter uma declaração para uma credencial específica. Confira a enumeração de transporte do Authenticator
   Supports resident keys	Ativar (ou desativar) usando a caixa de seleção	Ative se o aplicativo Web depender de chaves residentes (também conhecidas como credenciais detectáveis do lado do cliente). Consulte Enumeração de requisitos de chave residente.
   Supports user verification	Ativar (ou desativar) usando a caixa de seleção	Ative se o aplicativo Web depender de autorização local usando modalidades de gesto como toque mais código PIN, entrada de senha ou reconhecimento biométrico. Ver verificação do usuário

7. Clique no botão Adicionar .

8. Uma nova seção do seu autenticador recém-criado é exibida:

   

A seção Authenticator inclui uma tabela de credenciais . A tabela ficará vazia até que uma credencial seja registrada no autenticador:

Registrar uma nova credencial

Para registrar uma nova credencial:

1. No site de demonstração, clique em Registrar nova credencial.

2. Uma nova credencial foi adicionada à tabela Credenciais na ferramenta WebAuthn:

   

No site de demonstração, clique no botão Autenticar . Verifique se a contagem de sinais da credencial na tabela Credenciais aumentou em 1, o que marca uma operação authenticatorGetAssertion bem-sucedida.

Para obter mais informações sobre o que a API de autenticação da Web está fazendo ao registrar uma nova credencial, consulte Criar uma nova credencial.

Exportar e remover credenciais

Para exportar ou remover uma credencial, clique no botão Exportar ou Remover.

Renomear um autenticador

Para renomear um autenticador:

1. Ao lado do nome do autenticador, clique no botão Editar .

2. Edite o nome e pressione Enter para salvar as alterações.

Definir o autenticador ativo

Um autenticador recém-criado é ativado automaticamente. Para usar outro autenticador virtual, clique no botão de opção Ativo ao lado do autenticador.

O DevTools dá suporte a apenas um autenticador virtual ativo em qualquer momento. Se você remover o autenticador ativo, outro não será ativado automaticamente.

Remover um autenticador virtual

Para remover um autenticador virtual, ao lado do autenticador, clique no botão Remover .

Este trabalho está licenciado sob uma Licença Creative Commons Atribuição 4.0 Internacional.