I want to add a User to IB Key with the QR Code displayed in my Client Portal (Android)

 
Requirements:
  • The IBKR Mobile app must be installed and IB Key Authentication already activated on this Android device.
  • For more information on the installation and activation on Android devices, please consult KB2277.

 

Instructions: 

1) On your Android device, open the IBKR Mobile app.

     1.a) If the app opens with the login screen (Figure 1), tap on Services on the top-left corner (red arrow) and proceed with step 2)

     1.b) If the app opens with your Home Page, Portfolio, Watchlists, or similar, tap on More on the top-left corner (Figure 2). Then tap on Two-Factor Authentication (Figure 3), followed by Add User (Figure 4) and proceed with step 3)

 

Figure 1                                                 Figure 2                                               Figure 3                         
    

Figure 4                                            

2) Tap on Authenticate (Figure 5) and then on Add User (Figure 6).

Figure 5                                                      Figure 6                                      
         

3) Read the instructions and then tap on SESSION ID (Figure 7).

Figure 7                                   


4) Tap QR CODE (Figure 8).

Figure 8                                            

5) Tap Allow if asked for permission to use the phone camera (Figure 9).

Figure 9                     

6) Point the lens of your smartphone camera towards the QR code (Figure 10). You don't need to "take a picture." When the code is in focus, it is automatically captured. If your phone does not seem to recognize the QR code try to move your phone closer or farther away to the QR code in order to gain focus. If your phone does not recognize the QR code, please see the section Possible Issues and solutions at the bottom of this article.

Figure 10

7) Provide your PIN then tap on ACTIVATE (Figure 11).

Figure 11                               

8) You will receive a message indicating the successful activation of IB Key. Tap DONE to confirm (Figure 12).

Figure 12                            

 

 

 

Possible issues and solutions

 

  • My smartphone did not manage to read the QR code. What should I do?

Make sure you have activated the switch "Scan QR codes" from the Camera Settings of your smartphone (Figure 13).

Figure 13

 

  • My phone activates the front camera. How can I switch to the rear one?

Usually there is a specific button in the camera view to switch from front to rear lenses (Figure 14).

Figure 14

 

  • During the IB Key activation, I receive an error message "An error has occurred. Please try again."

Figure 15

This error message (Figure 15) may indicate you are attempting to activate the IB Key for a user which was already enrolled. Please try to log that user in to the Client Portal again. If you receive a notification on your smartphone once you have entered the credentials and you are able to complete the authentication once you tap on that notification, then the user was already enrolled and you no longer need to follow the steps on this article.

Alternatively, the error message may be displayed when the QR code shown in the Client Portal was already used to attempt an activation and is expired. In this case, please log out of the Client Portal and log back in to obtain a fresh QR code.

 

References:
  • See KB2260 for instruction on how to activate and operate IBKR Mobile Authentication.
  • See KB2748 for instructions on how to recover IBKR Mobile Authentication.
  • See KB3236 for instructions on how to enable notifications for the IBKR Mobile app.
  • See KB3234 for troubleshooting missing IBKR Mobile notifications.
  • See KB3073 for instructions on how to migrate the IB Key / IBKR Mobile authentication to a new smartphone.