Skip to content

Java Client for Twilio Authy Two-Factor Authentication (2FA) API

License

Notifications You must be signed in to change notification settings

needle-innovision/authy-java

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status codecov.io

Java Client for Twilio Authy Two-Factor Authentication (2FA) API

Documentation for Java usage of the Authy API lives in the official Twilio documentation.

The Authy API supports multiple channels of 2FA:

  • One-time passwords via SMS and voice.
  • Soft token (TOTP via the Authy App)
  • Push authentication via the Authy App

If you only need SMS and Voice support for one-time passwords, we recommend using the Twilio Verify API instead.

More on how to choose between Authy and Verify here.

Authy Quickstart

For a full tutorial, check out either of the Java Authy Quickstarts in our docs:

Authy Java Installation

Dependencies

This project uses json.org, you can find the json.org jar versions here

  • Ant: no need to include json.org since ant already includes it in the final jar.
  • Maven: need to include the json.org jar in your jar external libraries.

Usage

Add the library to the project by putting it in the dependencies section of your pom.xml:

<!-- https://mvnrepository.com/artifact/com.authy/authy-java -->
<dependency>
    <groupId>com.authy</groupId>
    <artifactId>authy-java</artifactId>
    <version>1.5.0</version>
</dependency>

To use the Authy client, import the API and initialize it with your production API Key found in the Twilio Console:

import com.authy.*;
import com.authy.api.*;

AuthyApiClient client = new AuthyApiClient("your-api-key")

authy api key in console

2FA Workflow

  1. Create a user
  2. Send a one-time password
  3. Verify a one-time password

OR

  1. Create a user
  2. Send a push authentication
  3. Check a push authentication status

Phone Verification

Phone verification now lives in the Twilio API and has Java support through the official Twilio helper libraries.

Legacy (V1) documentation here. Verify V1 is not recommended for new development. Please consider using Verify V2.

Copyright

Copyright (c) 2011-2020 Authy Inc. See LICENSE for further details.

About

Java Client for Twilio Authy Two-Factor Authentication (2FA) API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.8%
  • Shell 0.2%