Mi-Token provides software tokens that can be configured on IOS devices using the Mi-Token Authenticator App (also available for Android).


This article describes how to configure a software token on a blank (no Mi-Token components installed) iOS device. If you already have the Mi-Token authenticator app installed, skip part 1 and follow the instructions in part 2.


It is important that during the Token configuration process your phone has an active internet connection.


1) Preparing your device for a software token


Since the Mi-Token Authenticator is an iOS App, it can be installed virtually on any mobile device running the iOS Operating system, i.e., you can use an iPhone or an iPad.


Download and install the latest version of Mi-Token Authenticator from the Apple Store:


Mi-Token Authenticator on the App Store (apple.com)



Mi-Token Authenticator on the Apple Store Play Store as seen on a Desktop Computer


Mi-Token Authenticator on the Apple Store as seen on a mobile device


Press the install button to have the device download and install the software. Depending on your device and internet connection speed, it may take a few minutes to finish.




2) Configuring a software token from a URL


When you request your administrator for a new software token, you will be provided with a URL sent by the tokens manager by email or a message. Click the given URL. The device will open the browser and navigate to the Mi-Token mobile services website. The following is a sample screenshot of the site on a mobile phone:



Click the "Activate Mi-Token" button on the screen. If you already have the app installed, the device will open the Mi-Token Authenticator app and start the setup process:


Click Open to continue.



The first time you open the Authenticator app it will request writing permissions to you. Please agree on the requested permissions to continue.


Once the privileges have been granted, the app requests a confirmation to configure the new token:



The app will request you to give a name to the newly created token. This name is for your identification, so you know what installation the token belongs to since the Authenticator App allows you to have more than one token on the same device.


Enter a Token Name and Click IMPORT to continue. The device will begin the configuration process.

(Use only letters & numbers)






Once you have defined the token's name, click the Import button.


The first time (only the first one) you configure a new token, the app offers you to set a password. This password is to enhance security and it will be requested any time you open the app. This is optional. If you want to skip defining a password, click the "NO, THANK YOU!" button to proceed.




When finished, the app will take you to the token's screen, where you can see the changing 6-digit code and a 30-second counter. When the counter reaches zero, it will restart and a new 6-digit code will be shown.




3) Configure a new token with a QR Code


Sometimes when a user tries to install a new token, when the phone opens the mobile services website it will not launch the Mi-Token Authenticator App.



In such cases, you can try to use the app's built-in QR code scanner. To do so, you need to transform the token's URL (the one provided to you by the administrator) into a QR code.


Copy the token URL and open the following website:


QR Code Generator | Create Your Free QR Codes (qr-code-generator.com) 


Paste the token URL in the site's text box, it will automatically generate the QR code and draw it on the top right corner:



Open the Authenticator App on the device. If there are no previous tokens configured, it will show the main screen as follows:



Click the Scan button located on the bottom right corner of the screen:



Enter a Token name and press Scan QR-Code






The first time the app need access to the camera to scan de QR codes, click OK



The scan screen will open. At the center of the screen, the device's camera will show what is within the lens.



Point the device's camera to look at the QR code, try to center it on the camera viewport. The app will process the code and retrieve the token's information.



You have successfully created a token from a QR Code.




4) Selecting a token in a multi-token configuration


If you have more than one token installed on your device, it will let you know that there is more than one configuration and request you to select one when you open the app. Click the OK button to proceed:




The app will show you the list of existing tokens. Select one to continue:




The app will take you to the token screen for the selected configuration: