Digits: Sign in with Phone Number

Digits lets people create an account or sign into your app using nothing but their phone number on iOS and Android. Built using the same global, reliable infrastructure Twitter uses, Digits will verify the user’s phone number with a simple customizable user interface that easily integrates into your app.

Digits extends your existing user/profile database. A successful Digits account creation will return a stable userID to attach or match with your user record, and an oAuth token for the device. A verified phone number is also returned for convenience, but the user’s number may change at any time and should not be used for authentication.

We plan to extend Digits to include web login support, as well as the ability for users to find their friends via their address books.

Release notes:

• Access your account on Digits website

• Phone numbers are rate limited to normal consumer usage.

Set up Kit

Note

This section may be skipped if you initialized with the Twitter Kit

Update your project’s build script to include necessary dependencies and repository:

dependencies {
    compile('com.digits.sdk.android:digits:1.3.0@aar') {
        transitive = true;
    }
}

Next, initialize Digits and its dependency Twitter as a part of Fabric.with() in your application’s onCreate() method. Pass the TwitterAuthConfig for your application to the Twitter constructor.

// DemoApplication.java
import io.fabric.sdk.android.Fabric;
import com.twitter.sdk.android.core.TwitterCore;
import com.twitter.sdk.android.core.TwitterAuthConfig;
import com.digits.sdk.android.Digits;
...

@Override
public void onCreate() {
    super.onCreate();
    TwitterAuthConfig authConfig =  
            new TwitterAuthConfig(TWITTER_KEY, TWITTER_SECRET);
    Fabric.with(this, new TwitterCore(authConfig), new Digits());
}

Set up DigitsAuthButton

The first step in obtaining a Digits authentication token in your app is to add a button. Inside your layout, add a Digits button with the following code:

<com.digits.sdk.android.DigitsAuthButton
     android:id="@+id/auth_button"
     android:layout_width="wrap_content"
     android:layout_height="wrap_content" />

This will render a button that looks like:

Configure the button in an Activity

In the Activity or Fragment that displays the button, you need to create and attach an AuthCallback to the button.

// MainActivity.java
import com.digits.sdk.android.AuthCallback;
import com.digits.sdk.android.DigitsAuthButton;
import com.digits.sdk.android.DigitsException;
import com.digits.sdk.android.DigitsSession;
...

DigitsAuthButton digitsButton = 
        (DigitsAuthButton) findViewById(R.id.auth_button);
digitsButton.setCallback(new AuthCallback() {
   @Override
   public void success(DigitsSession session, 
                                    String phoneNumber) {
       // Do something with the session
   }

   @Override
   public void failure(DigitsException exception) {
       // Do something on failure
   }
});

Prefill the user’s phone number

This is an optional feature. Adding the permission below, in the AndroidManifest.xml, allows Digits to prefill the phone number therefore making the login process easier.

<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

Automate reading the SMS pin

This is an optional feature. Adding the permission below, in the AndroidManifest.xml, allows Digits to read the SMS pin therefore making the login process easier.

<uses-permission android:name="android.permission.RECEIVE_SMS"/>