Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.2.0

flutter_locker

Protege suas senhas no keychain usando autenticação biométrica (impressão digital, Touch ID, Face ID...)

AndroidiOS
Downloads em 30 dias
4 mil
Curtidas
50
Pontos Pub
160

Instalar pacote

flutter pub add flutter_locker

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Flutter Locker é um pacote seguro para armazenar e recuperar dados sensíveis usando cofres de chaves específicos da plataforma com autenticação biométrica (impressão digital, Touch ID, Face ID). Ele utiliza recursos nativos de segurança no Android e no iOS para proteger segredos como chaves de API ou tokens. O pacote garante que os dados permaneçam criptografados e acessíveis apenas após uma verificação biométrica bem-sucedida, aumentando a segurança do aplicativo sem comprometer a experiência do usuário. Ideal para aplicativos que exigem armazenamento local de alta segurança.

Casos de uso

  • Armazene chaves de API com segurança
  • Proteja as credenciais do usuário
  • Habilite o acesso biométrico a dados sensíveis
  • Armazene chaves de criptografia localmente
  • Implementar gerenciamento de sessão seguro

Principais recursos

  • Integração de autenticação biométrica
  • Uso de cadeia de blocos nativa da plataforma
  • Armazenamento local criptografado
  • API simples para acesso seguro
  • Falha de biometria aciona o fallback automático para senha

Indicado para

  • Aplicativos que lidam com dados de usuário sensíveis
  • Aplicações financeiras ou de saúde
  • Aplicativos com alta carga de autenticação
  • Aplicativos que exigem armazenamento local seguro
  • Desenvolvedores priorizando a privacidade do usuário

Considerações

  • Requer suporte de hardware biométrico
  • Limitado às plataformas Android e iOS
  • Pode exigir tratamento adicional de permissões
  • Não adequado para ambientes não biométricos
  • Depende dos mecanismos de segurança do sistema operacional subjacente

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Flutter Locker🔒

Locker

Flutter plugin that secures your secrets in keychain using biometric authentication (Fingerprint, Touch ID, Face ID...).

It uses:

Table of contents

Migrate to 2.1.0

The models now accept named parameters instead of unnamed, e.g.:

RetrieveSecretRequest(
  key: 'key',
  androidPrompt: AndroidPrompt(title: 'title', cancelLabel: 'cancel'),
  iOsPrompt: IOsPrompt(touchIdText: 'description'),
)

Usage

FlutterLocker.supportsBiometricAuthentication();

Checks if the devices has biometric capabilities no matter if they are configured and turned on.

FlutterLocker.canAuthenticate();

Checks if the devices has biometric capabilities that are configured and turned on.

await FlutterLocker.save(SaveSecretRequest(
  key: 'key',
  secret: 'secret',
  androidPrompt: AndroidPrompt(title: 'Authenticate', cancelLabel: 'Cancel'),
));

Saves the secret. On Android prompt is shown, while on iOS there is no need for the prompt when saving.

await FlutterLocker.retrieve(RetrieveSecretRequest(
  key: key,
  androidPrompt: AndroidPrompt(title: 'Authenticate', cancelLabel: 'Cancel'),
  iOsPrompt: IOsPrompt(touchIdText: 'Authenticate'),
));

Retrieves the secret. You need to provide a prompt for Android and iOS. Prompt for iOS is used only with TouchID. FaceID uses strings from Info.plist.

await FlutterLocker.delete('key');

Deletes the secret.

Exceptions

For common exceptions, a LockerException is thrown.

Use LockerException.reason to find out what went wrong:

  • secretNotFound - Happens when you try to retrieve a secret that was never saved for that key
  • authenticationCanceled - User canceled the authentication prompt
  • authenticationFailed - User failed authentication, e.g. by too many wrong attempts

For other exception, a PlatformException is thrown. You can use PlatformException.message to get more info.

Notes

  • iOS only: app will not show authentication dialog when saving (authentication will always succeed)
  • please follow Locker and Goldfinger setup to prevent any issues

Setup

iOS

To use Locker you need to add the NSFaceIDUsageDescription to you Info.plist.

If NSFaceIDUsageDescription is not provided, the app will crash with the following error:

This app has crashed because it attempted to access privacy-sensitive data without a usage description.  The app's Info.plist must contain an NSFaceIDUsageDescription key with a string value explaining to the user how the app uses this data.
Android

Ensure MainActivity extends FlutterFragmentActivity.

class MainActivity: FlutterFragmentActivity() {
    // ...
}

When showing authentication prompt, the app might crash on some Samsung devices if you don't use an appropriate theme: https://github.com/infinum/flutter-plugins-locker/commit/fcb1f6401d89f860d24ea9a75027d62a03e87926.

Contributing

We believe that the community can help us improve and build better a product. Please refer to our contributing guide to learn about the types of contributions we accept and the process for submitting them.

To ensure that our community remains respectful and professional, we defined a code of conduct that we expect all contributors to follow.

We appreciate your interest and look forward to your contributions.

License

Copyright 2024 Infinum

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Credits

Maintained and sponsored by Infinum.

Categorias

Repositório-fonte

Projetos que usam este pacote