Two-Factor Authentication (2FA)

Two-factor authentication (2FA) provides added security for logins, requiring a combination of something you know (password) and something you have (mobile device).

Our 2FA approach is based on TOTP: Time-based One Time Password (RFC 6238) symmetric encryption, secrets stored encrypted.

This feature is available upon request. Please contact your Urban Airship Account Manager to enable this setting on your account.

Enable 2FA

  1. Download the Google Authenticator mobile app for either iOS or Android.

  2. Click the Account menu icon in the right side of the Urban Airship dashboard header, select Two-Factor from the dropdown menu, and enter your password when prompted.
  3. Toggle Two-Factor Authentication to On.
  4. Use the Google Authenticator mobile app to scan the QR code that appears after enabling Two-Factor Authentication. After scanning, an authentication code will be presented to you within the mobile app.
  5. Enter the authentication code in the Enter Code field below the QR code, and click the Enable button.

Two-Factor authentication will now enabled for your account.

When you scan the QR code with the Google Authenticator app, an Urban Airship account is created within the Google Authenticator app. Each time you log in to go.urbanairship.com, you will use the code that is displayed with this account. See: Log In Using 2FA.

You only need to scan the QR code a single time to set up 2FA. Each time you scan a QR code, a separate Urban Airship account is created within the Google Authenticator app, so multiple scans are not advised.

If for any reason this process has failed or you erroneously create multiple Urban Airship accounts in the Google Authenticator app, delete each Urban Airship account from the Google Authenticator app, toggle 2FA to Off and back On, and try again.

Generate Recovery Codes

Recovery Codes allow you to access your account if authentication is unsuccessful.

Keep recovery codes in a safe place, not on your mobile device.

  1. Click the Recovery Codes link, then click the Generate Recovery Codes button.
  2. Copy the recovery codes, and save them in a secure location.
    Each recovery code is valid for one use only. Click the Re-generate Recovery Codes button to create additional codes.

Log In Using 2FA

With 2FA is enabled, you are required to provide a code in addition to your password when logging in.

  1. Enter your username and password on go.urbanairship.com, and you will be prompted for an Authentication Code.

  2. Open the Google Authenticator app on you mobile device to and copy the code for your Urban Airship account. Codes re-generate every 30 seconds.
  3. Enter the code on go.urbanairship.com, then click the Log In button.

Log In Using Recovery Code

If you do not have access to your mobile device but need to log in to your Urban Airship account, you can do so using one of your recovery codes.

  1. Enter your username and password on go.urbanairship.com, and you will be prompted for an Authentication Code.

  2. Click the Need to use a recovery code? link.
  3. Enter one of your recovery codes, then click the Log In button.
    Each recovery code is valid for one use only. Follow the steps in Generate Recovery Codes to generate addditional codes.