Biometric Authentication in Flutter Apps

Biometric authentication is when the user’s fingerprints, facial patterns, and voice are used to verify their identity. Biometric authentication can now be found in almost every phone. Instead of typing a password, we can just authenticate by tap the fingerprint. In this article, we’ll look into how to implement Fingerprint Authentication in flutter apps

About local_auth:

This Flutter plugin allows us to perform user authentication locally, on-device.

The canCheckBiometrics method is used to see if local authentication is available or not on the device. If the device can check biometrics, it returns true.

bool canCheckBiometrics =
    await localAuth.canCheckBiometrics;

The following biometric types are currently in use:

  • BiometricType.face
  • BiometricType.fingerprint

getAvailableBiometrics method is used to get the list of enrolled biometrics.

List availableBiometrics =
    await auth.getAvailableBiometrics();

In the returned list may contain the possibilities of BiometricType.face, BiometricType.fingerprint, and BiometricType.iris (not yet implemented).

Let’s have a deeper look at the authenticate() method, which uses biometric authentication.

  Future authenticate({
    required String localizedReason,
    bool useErrorDialogs = true,
    bool stickyAuth = false,
    AndroidAuthMessages androidAuthStrings = const AndroidAuthMessages(),
    IOSAuthMessages iOSAuthStrings = const IOSAuthMessages(),
    bool sensitiveTransaction = true,
    bool biometricOnly = false,

String localizedReason: This parameter allows the user to get a message when being promoted for authentication. For example message as ‘Please scan your fingerprint to access MyApp’. It can not be empty.

bool useErrorDialogs: If True is set, the system will handle any issues that arise during the authentication process. For example, If a fingerprint reader is present on the phone but no fingerprint is registered, the plugin will try to direct the user to the settings to add one. Any issue that cannot be resolved by the user, such as the lack of a biometric sensor on the device, will be returned as a [PlatformException].

If we don’t want to use error dialogues by default, we can simply set the useErrorDialogs = false. However, we must deal with the error message that is thrown during authentication.

AndroidAuthMessages androidAuthStrings: Using the constructors [AndroidAuthStrings] and [IOSAuthStrings], we can customize the messages in the dialogs. We can have an idea by looking at the code snippets below.

    const errorString = const AndroidAuthMessages(
        signInTitle: "Login to Home page",
        cancelButton: 'cancel',
        goToSettingsButton: 'settings',
        goToSettingsDescription: 'Please register your Fingerprint'); 
     authenticated = await auth.authenticate(
          localizedReason: 'Let OS determine authentication method',
          useErrorDialogs: false,
          androidAuthStrings: errorString);

bool stickyAuth: When an application goes into the background for whatever reason while authentication is in progress, [stickyAuth] is used. Authentication must be halted at that point for security reasons. If stickyAuth is set to true, when the app is restarted, authentication is continued. If it is set to false (the default), a failure message is sent back to Dart as soon as the app is halted.

bool sensitiveTransaction: When [sensitiveTransaction] is set to true, platform-specific safeguards are enabled. For example, after recognizing the user’s face, Android displays a confirmation window to ensure that the user wants to unlock their phone.

bool biometricOnly: When [biometricOnly] is set to true, non-biometric local authentication methods such as pin, passcode, and passcode are disabled.

we can disable the local authentication in android manually

void _cancelAuthentication() {

Implementation of Biometric Authentication


  • local_auth package
  • Any IDE (Android studio or VS code)
  • Device with fingerprint sensor

Project setup:

  1. Create a new flutter project in your favorite IDE, and remove the boilerplate code. Ref link
  2. Add the local_auth dependency in pubspec.yaml file, and install it by running pub get.
    sdk: flutter
  local_auth: ^1.1.8

3. Instead of using FlutterActivity in the manifest file, we must use Flutter FragmentActivity.


import android.os.Bundle;
import io.flutter.plugins.flutter_plugin_android_lifecycle.FlutterAndroidLifecyclePlugin;
import io.flutter.plugins.localauth.LocalAuthPlugin;

public class MainActivity extends FlutterFragmentActivity {
    protected void onCreate(Bundle savedInstanceState) {

Or Update MainActivity.kt:

import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugins.GeneratedPluginRegistrant

class MainActivity: FlutterFragmentActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {

4. USE_FINGERPRINT permissions should be added to the android manifest file.

<manifest xmlns:android=""
  <uses-permission android:name="android.permission.USE_FINGERPRINT"/>

5. And Add the following code into the main.dart file

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:local_auth/local_auth.dart';

void main() {
//flutterant - Biometric Authentication 
class MyApp extends StatefulWidget {
  _MyAppState createState() => _MyAppState();

class _MyAppState extends State {
  final LocalAuthentication auth = LocalAuthentication();

  String _authorized = 'Not Authorized';
  bool _isAuthenticating = false;

  Future _authenticate() async {
    bool authenticated = false;
    try {
      setState(() {
        _isAuthenticating = true;
        _authorized = 'Authenticating';
      authenticated = await auth.authenticate(
          localizedReason: 'Let OS determine authentication method',
          useErrorDialogs: true,
          stickyAuth: true);
      setState(() {
        _isAuthenticating = false;
    } on PlatformException catch (e) {
      setState(() {
        _isAuthenticating = false;
        _authorized = "Error - ${e.message}";
    if (!mounted) return;

        () => _authorized = authenticated ? 'Authorized' : 'Not Authorized');

  void _cancelAuthentication() async {
    await auth.stopAuthentication();
    setState(() => _isAuthenticating = false);
//flutterant - Biometric Authentication 
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Biometric Authentication'),
        body: Center(
          child: Column(
            children: [
              Text('Current State: $_authorized\n'),
                  ? ElevatedButton(
                      onPressed: _cancelAuthentication,
                      child: Row(
                        mainAxisSize: MainAxisSize.min,
                        children: [
                          Text("Cancel Authentication"),
                  : Column(
                      children: [
                          child: Row(
                            mainAxisSize: MainAxisSize.min,
                            children: [
                          onPressed: _authenticate,
//flutterant - Biometric Authentication 

6. Implementation part has been done, let’s run the application and see the output

Thanks for reading !!!  🙂

Leave a Comment