Importing from Blizzard Authenticator

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.