Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/line/webauthn-kotlin

WebAuthn Kotlin is an open-source toolkit for secure, password-less authentication in mobile apps. Developed in Kotlin, it integrates seamlessly with native Android apps, adhering to WebAuthn 2.0 standards for enhanced security and user experience.
https://github.com/line/webauthn-kotlin

authenticator fido2 kotlin passwordless security webauthn

Last synced: 3 months ago
JSON representation

WebAuthn Kotlin is an open-source toolkit for secure, password-less authentication in mobile apps. Developed in Kotlin, it integrates seamlessly with native Android apps, adhering to WebAuthn 2.0 standards for enhanced security and user experience.

Awesome Lists containing this project

README 

        
# WebAuthn Kotlin



WebAuthn Kotlin is an open source toolkit for secure, password-less authentication in mobile apps. Developed in Kotlin, it integrates seamlessly with native Android apps and adheres to WebAuthn 2.0 standards, boosting security and user experience.



Designed to align with modern Android development, the SDK offers easy integration and customization. It equips developers with tools for advanced authentication, such as device credentials and biometrics, simplifying logins and enhancing security.



## Components



### PublicKeyCredential

The `PublicKeyCredential` serves as the client within the authentication framework, interacting with the authenticator to carry out the authentication process and communicating with the relying party. It supports two primary operations for secure, password-less authentication:



- **create()**: Starts the process of generating new asymmetric key credentials via an authenticator.

- **get()**: Prompts the user to authenticate with a relying party using their existing credentials.



We offer two classes that inherit from PublicKeyCredential. Each class uses different types of authenticators.



- **Biometric**: Manages public key credentials using the biometric authenticator. It facilitates secure user verification by leveraging biometric data.

- **DeviceCredential**: Manages public key credentials using the device credential authenticator. It supports a combination of biometric data and device-based credentials like PINs or patterns for authentication.



### RelyingParty



The `RelyingParty` establishes communication with your server to manage access to secure applications. In FIDO2, it generates and handles authentication requests, verifies responses from authenticators, and maintains user credentials, ensuring secure, password-less interactions between the client and server.

Library users must implement the `RelyingParty` interface themselves.



### CredentialSourceStorage

The `CredentialSourceStorage` is an interface that defines the behavior of a database for handling a public key credential source and its signature counter.



## Requirements

- Android >= 9 (Pie) / API level >= 28



## Usage



### Step 1: Implement the `RelyingParty` Interface



First, you need to create an implementation of the `RelyingParty` interface. This interface is crucial for handling communication with your server's FIDO2-compatible endpoints.



To help you get started with your implementation, we recommend checking out a sample application available on GitHub:



* [webauthndemo-kotlin/RelyingParty](https://github.com/line/webauthndemo-kotlin/blob/main/app/src/main/java/com/lycorp/webauthn/sample/network/Fido2RelyingPartyImpl.kt)



This sample provides a practical example of how to implement the `RelyingParty` interface in a real-world Android application. It will give you insights into integrating FIDO2 functionalities effectively with your server setup.



### Step 2: Implement the `CredentialSourceStorage` Interface



Next, you need to create an implementation of the `CredentialSourceStorage ` interface to manage credential source and signature counter.



To help you get started with your implementation, we recommend checking out a sample application available on GitHub:



* [webauthndemo-kotlin/CredentialSourceStorage](https://github.com/line/webauthndemo-kotlin/blob/main/app/src/main/java/com/lycorp/webauthn/sample/data/database/RoomCredentialSourceStorage.kt)



### Step 3: Initialize `PublicKeyCredential`

Once you have your relying party and credential storage implementation ready, you can initialize the public key credential.



```kotlin

val rp = YourRelyingParty()

val db = YourCredentialSourceStorage()



// You can use a biometric.

val publicKeyCredential = Biometric(

    rpClient = rp,

    db = db,

    activity = activity

)



// ,or you can use a device credential.

val publicKeyCredential = DeviceCredential(

    rpClient = rp,

    db = db,

    activity = activity

)

```



Here, activity refers to the instance of your current Activity from which you are initiating the authentication process. This allows the `PublicKeyCredential` to interact with the user interface for authentication.



### Step 4: Register and Authenticate Credentials

Before using the `create` and `get` methods of `publicKeyCredential`, configure `options` and `fido2PromptInfo` according to your needs. These configurations will be used for both registration and authentication processes.



When you call the `create` method to register a new credential, or the `get` method to authenticate using an existing credential, the methods will return a `Result` type:



#### Registering a Credential

Register a new credential using the `create` method:



```kotlin

val result: Result = publicKeyCredential.create(

    options = registrationOptions,

    fido2PromptInfo = fido2PromptInfo,

)

```



#### Authenticating with a Credential

Authenticate using an existing credential with the `get` method:



```kotlin

val result: Result = publicKeyCredential.get(

    options = authenticationOptions,

    fido2PromptInfo = fido2PromptInfo,

)

```



## License

Apache License 2.0. See [`LICENSE`](./LICENSE).



## Contact Information



We are dedicated to making our work open-source to assist with your specific needs. We are eager to learn how this library is being utilized and the issues it resolves for you. To communicate, we recommend the following approach:



*   For reporting bugs, proposing improvements, or asking questions about the library, please utilize the [**Issues**](https://github.com/line/webauthn-kotlin/issues) section of our GitHub repository. Your feedback is invaluable in helping us address your concerns more effectively and enhances the community's experience.



Please avoid sharing any sensitive or confidential information in the issues. If there is a need to discuss sensitive matters, please indicate so in your issue, and we will arrange a more secure communication method.