Notes

This assumes that you already have a Toopher account and the mobile application (images shown are Toopher v1.0.1 on iOS 6.0.1).

Create a new Requester on the Toopher web site

Navigate to the Toopher Dev site: https://dev.toopher.com/requesters/

Press the "Create a new requester" button in the top right.

Fill in your information and "Create requester"

You will be redirected to the Requesters page again.

Insert your key and secret in the demo file

Edit the demo file and insert your Requester's key and secret.

Create a new pairing phrase from the mobile app

Open the Toopher mobile app

Press the plus sign (+) in the top right corner of the app, which will present a new pairing phrase.

Take note of the pairing phrase.

Run the demo

Open a terminal and run the demo. For example in Ruby:

ruby demo/toopher_demo.rb

Still in the command line, enter the pairing phrase from the mobile app when prompted.

Now, the demo will query your app for permission.

Accept the request on the mobile app

Press "Grant" on the phone.

Verify that the pairing succeeded

Switch back to the running demo and you should see a successful response (in this case, "paired successfully!").

Continue running the demo

All subsequent requests will trigger an authentication request on the mobile app.

Next steps

This demonstrates the user and administrator actions when setting up Toopher. From here, you can easily add two-factor authentication to your sites!