Import from Blizzard Authenticator

Here's how to transfer your accounts from Blizzard Authenticator to Stratum

Stratum supports 8 digit codes and as such Blizzard Authenticator accounts are supported. However, Blizzard uses a proprietary algorithm for their account setup, so the accounts must be converted to standard TOTP.

Option 1 (advanced)

This guide expects that you are familiar with the Python pip package system

Use the Battle.net Authenticator Tool to generate a otpauth URI for Stratum. You can provision a new authenticator for Battle.net, however this guide will focus on migrating an existing authenticator.

Step 1: installing

Follow the installation instructions to prepare the script.

Using the script directly

You can simply clone the project and retrieve all necessary dependencies using the following commands:

Clone the repo

git clone https://github.com/Nighthawk42/bnet_auth_tool.git
cd bnet_auth_tool

Create a virtual environment and install the dependencies

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Step 2: obtaining the serial and restore code

Visit the Battle.net account security page and follow the steps to retrieve the serial and restore code:

  1. Under Battle.net Authenticator, click "Get Restore Code"
  2. Confirm the login using your existing authenticator
  3. Copy the Serial and Restore code for later

Step 3: generating an otpauth URI

  1. Run the script using python bnet_auth_tool.py or using the binary depending on the chosen installation method.
  2. Select Option 2 Retrieve existing device secret
  3. Follow the on-screen instructions to retrieve the session token
  4. When prompted, enter the Serial and Restore Code obtained in the previous step

Step 4: add the authenticator to Stratum

The script generates a QR code (battlenet_authenticator_****.png) that you can scan. Alternatively, you can use the QR code generator to generate a code from the otpauth URI provided.

Wiki pages