Come richiedere la password del dispositivo

Vuoi migliorare la sicurezza della tua app mantenendo un'ottima usabilità? L'autenticazione locale potrebbe essere la soluzione giusta. Questa documentazione ti mostrerà come puoi chiedere agli utenti della tua applicazione di usare il PIN/impronta digitale/riconoscimento facciale del dispositivo prima di accedere alle sezioni della tua applicazione.

Abilitazione della funzionalità

Abilita l'autorizzazione alla biometria nelle impostazioni dei permessi. In caso contrario, questa funzionalità potrebbe funzionare solo parzialmente (niente Face ID) o interrompersi in modo imprevisto.

Utilizzo della funzione JavaScript

requestLocalAuthentication

Usa questa funzione per richiedere all'utente l'autenticazione.

La funzione restituisce un oggetto con un risultato booleano in caso di successo. Se la richiesta di autenticazione viene annullata o il dispositivo non può continuare, invece genera una stringa con un codice di errore.

<script>
    try {
        // This message will be displayed to the user along with the prompt.
        let reason = "Please authenticate to access this part of the app";

        // Returns a boolean. True if the authentication was successful, false if the authentication challenge failed.
        // If the prompt is canceled or the device cannot continue, an error string is thrown instead.
        let authenticationResult = (await requestLocalAuthentication(reason))["result"];
    }
    catch (e) {
        switch(e) {
            case "userCanceled":
                // The user canceled the prompt and didn't authenticate.
                break;
            case "authInProgress":
                // Another authentication request is already running.
                break;
            case "noCredentialsSet":
                // No biometrics, PIN, password, or pattern is configured.
                break;
            case "systemCanceled":
                // The system interrupted the authentication attempt, for example when the app gets closed.
                break;

            // All the errors below should be very rare in practice:

            case "timeout":
                // The authentication prompt timed out.
                break;
            case "uiUnavailable":
                // The system cannot show the authentication prompt right now.
                break;
            case "deviceError":
                // A device-level error prevented authentication.
                break;
            case "unknownError":
                // An unknown error occurred.
                break;
            default:
                // Any other error
                break;
        }
    }
</script>