Two-factor authentication setup for reseller accounts

Two-factor authentication (2FA) gives an additional level of security for your reseller account. In addition to entering a password, the user will provide an additional means of identification from a separate category of credentials; either a time-based token obtained through an app or a token received via SMS. You may have both types of 2FA enabled at once. The most recently-enabled type will be the default method unless you change the default login method.

Note: If you previously shared a single login among several users, and you would like to enable 2FA, you will need to create a separate user account for each individual who needs to log in. Multiple people cannot share time-based tokens.

How do I enable 2FA using app-based authentication for a user account?

  1. Log in to the Reseller Control Panel.
  2. Click on the Account settings tab and click Edit next to 2-Factor authentication to enable 2FA.
  3. Choose the Enroll authenticator app. To proceed, you will need to provide your reseller account password and click Next.
    authenticator-app.png

  4. To set up 2-Factor authentication using an authenticator app on your smartphone, you will be presented with a key and a QR code (the QR code expresses the same key). Scan the QR code using the authenticator app on your phone, or enter the key manually in your app.
  5. Once completed, the app will return a code to you. Enter this code in the box and click on Enable.
    9TsxJt85K8.png

  6. You will now receive recovery codes that you can use in case you are unable to access your authenticator app. Please print these and keep them protected.
    print.png

  7. 2FA is now enabled, and a newly generated six-digit token from your authenticator app will be requested upon your next login.

Back to top

How do I enable 2FA using SMS-based authentication for a user account?

  1. Log in to the Reseller Control Panel.
  2. Click on the Account settings tab and click Edit next to 2-Factor authentication to enable 2FA.
  3. Choose Enroll SMS and enter your reseller account password and your mobile phone number. Now click Next.
    phone-2fa.png

  4. You will receive an SMS with a token on your phone. Enter the code and click on Enable.
    sms-code.png

  5. You will receive recovery codes that you can use in case you are unable to access your SMS. Please print these and keep them protected.
    print.png

  6. 2FA is now enabled. Every time you log in, after entering your username and password, you will receive an SMS with a token. You will use this token to complete your login.

Back to top

How will 2FA work when logging into OpenSRS?

If 2FA is enabled for a user, the token will be required when the user logs in to the Resellers Control Panel and the Classic Reseller Interface.

  1. Enter your username and password on the login page and click Log in
  2. If 2FA is enabled for your account, you will then be prompted to enter a token.
    • If SMS-based authentication is your default 2FA option, you will receive a login token via SMS.
    • If the authenticator app is your default 2FA option, you will need to open the app on your phone and locate the token for OpenSRS in the app.
  3. Enter the token into the prompt box. OpenSRS will validate the token and grant access to the control panel.

Back to top

Was this article helpful? If not please submit a request here

How helpful was this article?