Esta página foi traduzida automaticamente. Leia a versão original em inglês aqui.

Cheatsheet de Passkeys. Guias práticos, padrões de implementação e KPIs para programas de passkeys.
Ao desenvolver a autenticação com chaves de acesso, um dos principais componentes é testar a autenticação entre dispositivos (CDA) por meio de um código QR. Embora o sistema operacional lide com a funcionalidade principal, várias caixas de diálogo e etapas adicionais podem ser necessárias, como solicitar aos usuários que criem uma chave de acesso local após a conclusão da autenticação entre dispositivos. Essas diferenças resultam em variações no fluxo que devem ser testadas. O fluxo de teste mais importante é Android / iPhone -> Windows. É claro que os testes finais devem ser realizados com dispositivos Windows 11 reais, mas, durante o desenvolvimento, a Virtualização Parallels costuma ser usada em dispositivos macOS.
Receba uma avaliação gratuita de passkeys em 15 minutos.
Teste de CDA de chaves de acesso no Parallels no Mac
Como funciona a Autenticação entre Dispositivos (CDA) por meio de chaves de acesso durante os testes no Parallels, especificamente em uma máquina virtual Windows 11 executada em um Mac?
Vamos descobrir como isso pode ser feito, pois, no momento, a implementação do Parallels não funciona com a CDA de chaves de acesso.
Artigos recentes
📖
Chaves de acesso no Parallels: testando a autenticação entre dispositivos em uma VM Windows 11 no Mac
⚙️
9 bibliotecas de implementação de servidor WebAuthn comparadas
⚙️
Client Hints e User-Agents no Chrome, Safari e Firefox
⚙️
Guia de consulta rápida de chaves de acesso para desenvolvedores
👤
Como excluir uma chave de acesso na Apple, Windows e Android
Antes de iniciar a Autenticação entre Dispositivos (CDA) com chaves de acesso em um Windows 11 / Parallels sendo executado em um Mac, você precisará configurar o ambiente adequadamente. Aqui está um guia passo a passo para começar:
Se você ainda não instalou o Windows 11 no Parallels, precisará fazê-lo. Observe que a instalação do Windows 10 não é mais viável devido à falta de builds ARM. O Parallels suporta o Windows 11 apenas em Macs com Apple Silicon (M1/M2). O Windows 11 fica disponível automaticamente caso você tenha uma licença acessível.
Usar o adaptador Bluetooth do macOS não funciona. Portanto, para testar a CDA via chaves de acesso, é necessário um adaptador Bluetooth 5.0 externo, já que o Parallels não pode usar o Bluetooth integrado do Mac para essa funcionalidade. Eis o que você precisa:
Assine nosso Substack de passkeys para receber as últimas novidades.
Siga estas etapas para configurar o adaptador Bluetooth para uso com a VM Windows 11:
Na primeira vez que a VM Windows tentar acessar o adaptador Bluetooth, o macOS poderá solicitar a confirmação dessa ação. Certifique-se de permitir o acesso para que o adaptador Bluetooth possa funcionar corretamente dentro da VM e clique em "Sempre Permitir" (Always Allow):
Após a conclusão dessas etapas, sua VM Windows 11 estará equipada para executar a autenticação entre dispositivos baseada em Bluetooth, que é necessária para testes de chaves de acesso.
Se desejar verificar rapidamente se a sua Autenticação CDA funciona, vá em frente e use o Passkeys Debugger.
Como é possível ver abaixo, authenticatorAttachment está definido como cross-platform, nós concluímos com sucesso uma CDA em nossa VM Windows 11.
Experimente fluxos de passkeys no Passkeys Debugger.
Testar a Autenticação entre Dispositivos (CDA) com chaves de acesso em uma máquina virtual Windows 11 rodando no Parallels é possível, mas requer alguma configuração extra de hardware. Embora o Parallels ofereça um bom ambiente para testes do autenticador de plataforma, o processo de CDA não funcionará de imediato devido às limitações do Bluetooth integrado do Mac. Portanto, a pergunta
Como funciona a Autenticação entre Dispositivos (CDA) por meio de chaves de acesso durante os testes no Parallels, especificamente em uma máquina virtual Windows 11 executada em um Mac?
foi respondida na postagem do blog.
Para ativar a Autenticação entre Dispositivos (CDA) por meio de chaves de acesso em uma VM Windows 11 no Parallels, um adaptador Bluetooth USB externo é essencial. O Parallels não consegue aproveitar a funcionalidade de Bluetooth interno do Mac para essa finalidade, de forma que o uso de um adaptador Bluetooth (como o ASUS USB-BT500) é a etapa crucial para que tudo funcione.
Seguindo as instruções de configuração para o adaptador e testando os fluxos de chave de acesso, você pode concluir a CDA com sucesso dentro de uma VM Windows 11, confirmando a capacidade do sistema de lidar com a autenticação entre dispositivos. De acordo com a nossa experiência, é muito importante testar também ambientes Windows 10. No momento, isso só é viável de forma confiável com sistemas Windows 10 reais.
Um agradecimento especial a Christopher Harrell por nos indicar a solução correta junto à FIDO Alliance.
Corbado é a Authentication Intelligence Platform para times de CIAM que rodam autenticação consumer em escala. Mostramos o que logs de IDP e ferramentas genéricas de analytics não enxergam: quais dispositivos, versões de SO, navegadores e gerenciadores de credenciais suportam passkeys, por que os registros não viram logins, onde o fluxo WebAuthn falha e quando uma atualização de SO ou navegador quebra silenciosamente o login — tudo sem substituir Okta, Auth0, Ping, Cognito ou seu IDP interno. Dois produtos: Corbado Observe adiciona observabilidade para passkeys e qualquer outro método de login. Corbado Connect entrega passkeys gerenciados com analytics integrado (junto ao seu IDP). VicRoads roda passkeys para mais de 5M de usuários com Corbado (+80% de ativação de passkey). Fale com um especialista em Passkeys →
O Parallels não pode usar o adaptador Bluetooth embutido no Mac para Autenticação entre Dispositivos por chave de acesso. Trata-se de uma limitação fundamental da camada de virtualização, o que significa que a CDA via código QR falhará, a menos que um adaptador Bluetooth externo seja conectado e atribuído à VM.
Você precisa de um adaptador Bluetooth 5.0 USB, como o ASUS USB-BT500, e um adaptador USB para USB-C a fim de conectá-lo a um Mac moderno. Depois de conectado, o adaptador deve ser atribuído à VM Windows 11 nas Preferências do Parallels Desktop, e o macOS deve ser configurado para sempre permitir o acesso da VM ao dispositivo.
Após concluir a cerimônia da chave de acesso, verifique se o valor authenticatorAttachment na resposta da asserção está definido como 'cross-platform'. Você pode inspecionar isso usando o Passkeys Debugger (Depurador de chaves de acesso) em passkeys-debugger.io, que mostra a resposta de asserção completa analisada.
Não. O Parallels é compatível apenas com o Windows 11 em Macs com Apple Silicon (M1/M2) e não há compilações ARM para o Windows 10. Os testes de CDA com chaves de acesso de forma confiável no Windows 10 requerem um dispositivo Windows 10 físico e real.
Veja como a Corbado se encaixa na sua implementação de passkeys e no stack de autenticação atual.
Explorar a Console
Artigos relacionados
Índice