https://github.com/hbldh/hbldhauth
TOTP Authenticator with configurable storage of tokens
https://github.com/hbldh/hbldhauth
authentication otpauth
Last synced: over 1 year ago
JSON representation
TOTP Authenticator with configurable storage of tokens
- Host: GitHub
- URL: https://github.com/hbldh/hbldhauth
- Owner: hbldh
- License: mit
- Created: 2017-10-11T10:28:41.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-05-10T08:50:41.000Z (about 5 years ago)
- Last Synced: 2025-01-31T14:20:08.603Z (over 1 year ago)
- Topics: authentication, otpauth
- Language: Python
- Size: 5.86 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `hbldh` Authenticator
A small wrapper around `pyotp` to provide tailored
storage of Authenticator tokens.
The tokens are intended to be stored on an encrypted partition or similar,
enabling this authenticator to be used as a backup for the mobile-based one.
It can also be used to provision a new
## Installation
```bash
$ pip install git+https://github.com/hbldh/hbldhauth.git@master
```
or use [pipsi](https://github.com/mitsuhiko/pipsi):
```bash
$ pipsi install git+https://github.com/hbldh/hbldhauth.git@master#egg=hbldhauth
```
## Usage
By default, `hbldhauth` looks for a config file at `~/.hbldhauth`,
containing the path to the actual file containing the tokens to be
used for Authenticator code generation.
Sample config file:
```text
/keybase/private/hbldh/tokens
```
Sample tokens file:
```text
Github|account_name: abcdefghijklmnop
Discord|account_email: abcd efgh ijkl mnop
Sentry|account_email: ABCD EFGH IJKL MNOP QRST UVWX YZ23 4567
```
Then run `hbldhauth`:
```bash
$ hbldhauth
--- hbldh Authenticator ---
Valid for 17 seconds...
Github (account_name): 998 725
Discord (account_email): 998 725
Sentry (account_email): 362 213
```
### Display QR codes
To display a web page with all QR codes for provisioning e.g. a new phone,
run
```
$ hbldhauth --qr
--- hbldh Authenticator ---
Generating QR code page at C:\Users\henri\AppData\Local\Temp\tmpvyx1wlan.html...
Deleted QR code web page.
```