Bypass Biometric Authentication (Android)
Reading time: 7 minutes
tip
Aprenda e pratique Hacking AWS:
HackTricks Training AWS Red Team Expert (ARTE)
Aprenda e pratique Hacking GCP: 
HackTricks Training GCP Red Team Expert (GRTE)
Aprenda e pratique Hacking Azure: 
HackTricks Training Azure Red Team Expert (AzRTE)
Supporte o HackTricks
- Confira os planos de assinatura!
 - Junte-se ao 💬 grupo do Discord ou ao grupo do telegram ou siga-nos no Twitter 🐦 @hacktricks_live.
 - Compartilhe truques de hacking enviando PRs para o HackTricks e HackTricks Cloud repositórios do github.
 
Método 1 – Bypass sem Uso de Objeto Crypto
O foco aqui está no callback onAuthenticationSucceeded, que é crucial no processo de autenticação. Pesquisadores da WithSecure desenvolveram um script Frida, permitindo o bypass do CryptoObject NULL em onAuthenticationSucceeded(...). O script força um bypass automático da autenticação por impressão digital ao invocar o método. Abaixo está um trecho simplificado demonstrando o bypass em um contexto de Impressão Digital Android, com a aplicação completa disponível no GitHub.
biometricPrompt = new BiometricPrompt(this, executor, new BiometricPrompt.AuthenticationCallback() {
@Override
public void onAuthenticationSucceeded(@NonNull BiometricPrompt.AuthenticationResult result) {
Toast.makeText(MainActivity.this,"Success",Toast.LENGTH_LONG).show();
}
});
Comando para executar o script Frida:
frida -U -f com.generic.insecurebankingfingerprint --no-pause -l fingerprint-bypass.js
Método 2 – Abordagem de Tratamento de Exceções
Outro Frida script da WithSecure aborda a contornagem do uso inseguro de objetos criptográficos. O script invoca onAuthenticationSucceeded com um CryptoObject que não foi autorizado por uma impressão digital. Se o aplicativo tentar usar um objeto de cifra diferente, isso acionará uma exceção. O script se prepara para invocar onAuthenticationSucceeded e tratar a javax.crypto.IllegalBlockSizeException na classe Cipher, garantindo que os objetos subsequentes usados pelo aplicativo sejam criptografados com a nova chave.
Comando para executar o script Frida:
frida -U -f com.generic.insecurebankingfingerprint --no-pause -l fingerprint-bypass-via-exception-handling.js
Ao chegar na tela de impressão digital e na iniciação de authenticate(), digite bypass() no console do Frida para ativar o bypass:
Spawning com.generic.insecurebankingfingerprint...
[Android Emulator 5554::com.generic.insecurebankingfingerprint]-> Hooking BiometricPrompt.authenticate()...
Hooking BiometricPrompt.authenticate2()...
Hooking FingerprintManager.authenticate()...
[Android Emulator 5554::com.generic.insecurebankingfingerprint]-> bypass()
Método 3 – Frameworks de Instrumentação
Frameworks de instrumentação como Xposed ou Frida podem ser usados para interceptar métodos de aplicativos em tempo de execução. Para autenticação por impressão digital, esses frameworks podem:
- Simular os Callbacks de Autenticação: Ao interceptar os métodos 
onAuthenticationSucceeded,onAuthenticationFailedouonAuthenticationErrordoBiometricPrompt.AuthenticationCallback, você pode controlar o resultado do processo de autenticação por impressão digital. - Contornar o SSL Pinning: Isso permite que um atacante intercepte e modifique o tráfego entre o cliente e o servidor, potencialmente alterando o processo de autenticação ou roubando dados sensíveis.
 
Exemplo de comando para Frida:
frida -U -l script-to-bypass-authentication.js --no-pause -f com.generic.in
Método 4 – Engenharia Reversa & Modificação de Código
Ferramentas de engenharia reversa como APKTool, dex2jar e JD-GUI podem ser usadas para descompilar um aplicativo Android, ler seu código-fonte e entender seu mecanismo de autenticação. Os passos geralmente incluem:
- Descompilando o APK: Converter o arquivo APK para um formato mais legível por humanos (como código Java).
 - Analisando o Código: Procurar pela implementação da autenticação por impressão digital e identificar possíveis fraquezas (como mecanismos de fallback ou verificações de validação inadequadas).
 - Recompilando o APK: Após modificar o código para contornar a autenticação por impressão digital, o aplicativo é recompilado, assinado e instalado no dispositivo para testes.
 
Método 5 – Usando Ferramentas de Autenticação Personalizadas
Existem ferramentas e scripts especializados projetados para testar e contornar mecanismos de autenticação. Por exemplo:
- Módulos MAGISK: MAGISK é uma ferramenta para Android que permite aos usuários fazer root em seus dispositivos e adicionar módulos que podem modificar ou falsificar informações em nível de hardware, incluindo impressões digitais.
 - Scripts Personalizados: Scripts podem ser escritos para interagir com o Android Debug Bridge (ADB) ou diretamente com o backend do aplicativo para simular ou contornar a autenticação por impressão digital.
 
Método 6 – Hook Frida Universal para BiometricPrompt (API 28-34)
Em 2023, um script Frida da comunidade chamado Universal-Android-Biometric-Bypass apareceu no CodeShare. O script intercepta todas as sobrecargas de BiometricPrompt.authenticate() assim como o legado FingerprintManager.authenticate() e aciona diretamente onAuthenticationSucceeded() com um AuthenticationResult fabricado contendo um CryptoObject nulo. Como se adapta dinamicamente aos níveis de API, ainda funciona no Android 14 (API 34) se o aplicativo alvo não realizar verificações criptográficas no CryptoObject retornado.
# Install the script from CodeShare and run it against the target package
frida -U -f com.target.app --no-pause -l universal-android-biometric-bypass.js
Key ideas
- Tudo acontece no espaço do usuário – nenhum exploit de kernel ou root é necessário.
 - O ataque permanece totalmente silencioso para a UI: o diálogo biométrico do sistema nunca aparece.
 - Mitigação: sempre verifique 
result.cryptoObjecte seu cifrador/assinatura antes de desbloquear recursos sensíveis. 
Method 7 – Downgrade / Fallback Manipulation
A partir do Android 11, os desenvolvedores podem especificar quais autenticadores são aceitáveis através de setAllowedAuthenticators() (ou o mais antigo setDeviceCredentialAllowed()). Um ataque de runtime hooking pode forçar o campo de bits allowedAuthenticators para o valor mais fraco BIOMETRIC_WEAK | DEVICE_CREDENTIAL:
// Frida one-liner – replace strong-only policy with weak/device-credential
var PromptInfoBuilder = Java.use('androidx.biometric.BiometricPrompt$PromptInfo$Builder');
PromptInfoBuilder.setAllowedAuthenticators.implementation = function(flags){
return this.setAllowedAuthenticators(0x0002 | 0x8000); // BIOMETRIC_WEAK | DEVICE_CREDENTIAL
};
Se o aplicativo não validar posteriormente o AuthenticationResult retornado, um atacante pode simplesmente pressionar o botão de fallback PIN/Pattern ou até mesmo registrar uma nova biometria fraca para obter acesso.
Método 8 – CVEs de Nível de Fornecedor / Kernel
Fique atento aos boletins de segurança do Android: vários bugs recentes do lado do kernel permitem escalonamento de privilégios local através do HAL de impressão digital e efetivamente desativam ou encurtam o pipeline do sensor. Exemplos incluem:
- CVE-2023-20995 – erro de lógica em 
captureImagedeCustomizedSensor.cpp(Pixel 8, Android 13) permitindo a bypass de desbloqueio sem interação do usuário. - CVE-2024-53835 / CVE-2024-53840 – “possível bypass biométrico devido a uma causa raiz incomum” corrigido no boletim de Pixel de dezembro de 2024.
 
Embora essas vulnerabilidades visem a tela de bloqueio, um testador com root pode encadeá-las com falhas em nível de aplicativo para contornar biométricas dentro do aplicativo também.
Lista de Verificação de Fortalecimento para Desenvolvedores (Notas Rápidas para Pentester)
- Aplique 
setUserAuthenticationRequired(true)esetInvalidatedByBiometricEnrollment(true)ao gerar chaves do Keystore. Uma biometria válida é então necessária antes que a chave possa ser usada. - Rejeite um 
CryptoObjectcom null ou cifra / assinatura inesperada; trate isso como um erro fatal de autenticação. - Ao usar 
BiometricPrompt, prefiraBIOMETRIC_STRONGe nunca recorra aBIOMETRIC_WEAKouDEVICE_CREDENTIALpara ações de alto risco. - Fixe a versão mais recente do 
androidx.biometric(≥1.2.0-beta02) – lançamentos recentes adicionam verificações automáticas de cifra nula e restringem combinações de autenticadores permitidas. 
Referências
tip
Aprenda e pratique Hacking AWS:
HackTricks Training AWS Red Team Expert (ARTE)
Aprenda e pratique Hacking GCP: 
HackTricks Training GCP Red Team Expert (GRTE)
Aprenda e pratique Hacking Azure: 
HackTricks Training Azure Red Team Expert (AzRTE)
Supporte o HackTricks
- Confira os planos de assinatura!
 - Junte-se ao 💬 grupo do Discord ou ao grupo do telegram ou siga-nos no Twitter 🐦 @hacktricks_live.
 - Compartilhe truques de hacking enviando PRs para o HackTricks e HackTricks Cloud repositórios do github.
 
HackTricks