Shanna Auth Documentation
A practical guide to managing two-factor authentication codes securely in your browser.
Add your first account
Open the Shanna Auth popup, choose Add account, then scan a QR code or enter the secret manually. Use a recognizable issuer and account name, then save.
Scan the setup QR code provided by the service you are securing.
Enter the secret, algorithm, digits, and period shown by the service.
Backup and restore
Backups help you move accounts to a new installation. Use a strong backup password and keep the file in a private, secure location.
Open the Shanna Auth menu and choose Export Backup.
Store the encrypted file safely and never share it publicly.
On the new device choose Import Backup and enter the same backup password.
Chrome
For the developer version, open chrome://extensions, enable Developer mode, and choose Load unpacked on the folder containing manifest.json.
If Chrome says “Manifest file is missing or unreadable”, select the chrome build folder, not the source parent folder or the ZIP file.
Firefox
Open Add-ons and themes, then install the Firefox build from a file. Shanna Auth uses a separate extension identity from older installations.
Microsoft Edge
Open edge://extensions, enable Developer mode, and choose Load unpacked on the Edge build folder.
Lost codes
Do not guess a secret or delete the extension. Look for an encrypted backup, use the previous device, or recover the account through the original service.
Security
OTP data is stored locally in the browser. Backups can be protected with a password. Never share QR codes, secret keys, passwords, or backup files.
- Back up before changing or removing an installation.
- Use a strong, unique backup password.
- Only grant optional permissions when a feature requires them.
- Do not include secrets in bug reports.
FAQ
Does Shanna Auth store my service password?
No. Do not enter passwords from other services into the extension.
How do I move accounts to another computer?
Export an encrypted backup on the old computer and import it on the new one.
What is the difference between TOTP and HOTP?
TOTP changes based on time, while HOTP changes based on a counter.
How do I update the developer build?
Open chrome://extensions, click Reload, and open the popup again.
Where can I report a bug?
Create an issue in the Shanna Auth GitHub repository. Do not include secrets or backup files.