Git Product home page Git Product logo

android-goldfinger's Introduction

Goldfinger Build Status

Important

This version is compatible with androidx.biometric. If you do not want to use androidx.biometric, feel free to use older version of Goldfinger.

Quick guide

Add mavenCentral

To include Goldfinger in your project, you have to add buildscript dependencies in your project level build.gradle:

buildscript {
    repositories {
        mavenCentral()
    }
}

Add dependency

implementation 'co.infinum:goldfinger:2.1.0'

Initialize

Goldfinger.Builder(context).build()

Check prerequisites

if (goldfinger.canAuthenticate(@AuthenticatorTypes int authenticators)) {
  /* Authenticate */
}

Build params

PromptParams are directly linked to BiometricPrompt.PromptInfo so be sure to read which parameters are required.

Goldfinger.PromptParams params = new Goldfinger.PromptParams.Builder(activity)
  .title("Title")
  .negativeButtonText("Cancel")
  .description("Description")
  .subtitle("Subtitle")
  .build();

I also suggest looking at ValidateUtils class to understand what is allowed by the Biometric library.

Authenticate

goldfinger.authenticate(params, new Goldfinger.Callback() {
    @Override
    public void onError(@NonNull Exception e) {
        /* Critical error happened */
    }

    @Override
    public void onResult(@NonNull Goldfinger.Result result) {
        /* Result received */
    }
});

You can see all Goldfinger methods here.

Rx module

Goldfinger has separate Rx module in case you want to use reactive approach.

Add dependencies

implementation 'co.infinum:goldfinger:2.1.0'
implementation 'co.infinum:goldfinger-rx:2.1.0'

Initialize

RxGoldfinger.Builder(context).build()

Authenticate

goldfinger.authenticate(params).subscribe(new DisposableObserver<Goldfinger.Result>() {

  @Override
  public void onComplete() {
    /* Fingerprint authentication is finished */
  }

  @Override
  public void onError(Throwable e) {
    /* Critical error happened */
  }

  @Override
  public void onNext(Goldfinger.Result result) {
    /* Result received */
  }
});

You can see all RxGoldfinger methods here.

Configuration

If you don’t like default implementations, you can easily modify them using Goldfinger.Builder object.

Goldfinger.Builder(context)
  .logEnabled(true)
  .cipherFactory(factory)
  .cipherCrypter(crypter)
  .build()

Important: Both Factory and Crypter should use same object type. If MacFactory is used, be sure to also provide MacCrypter!

Factory (Cipher, Mac, Signature)

Factory class should be used to create Cipher/Mac/Signature which will be used internally when CryptoObject is created.

new CipherFactory() {
  @Nullable
  @Override
  public Cipher createEncryptionCrypter(String key) {
     /* Create Cipher for encryption */
  }

  @Nullable
  @Override
  public Cipher createDecryptionCrypter(String key) {
    /* Create Cipher for decryption */
  }
};

Goldfinger will default to AesCipherFactory if other implementation is not provided.

Crypter (Cipher, Mac, Signature)

Crypter class should be used to encrypt/decrypt data with Cipher/Mac/Signature which was created with Factory above.

new CipherCrypter() {
  @Nullable
  @Override
  public String encrypt(@NonNull Cipher crypter, @NonNull String value) {
    /* Encrypt data with given crypter */
  }

  @Nullable
  @Override
  public String decrypt(@NonNull Cipher crypter, @NonNull String value) {
    /* Decrypt data with given crypter */
  }
};

Goldfinger will default to Base64CipherCrypter if other implementation is not provided.

Logging

Logging is off by default. You can enable it by calling Goldfinger.Builder(context).logEnabled(true).

Known issues

  • Android Oreo does not throw KeyPermanentlyInvalidatedException - Link

Contributing

Feedback and code contributions are very much welcome. Just make a pull request with a short description of your changes. By making contributions to this project you give permission for your code to be used under the same license.

License

Copyright 2018 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.

android-goldfinger's People

Contributors

aksi0m avatar domagojkorman avatar jonatanplesko avatar mariciv avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.