otp2fa

OTP2FA GitHub

Config

• Config file: env/global.env

TOTP_APP_ENV=prod
TOTP_APP_RATE_COUNT=10

TOTP_APP_DATABASE_FILENAME=totp.db
TOTP_APP_QRCODE_FOLDER=qrcode/
TOTP_APP_DATABASE_FOLDER=database/
TOTP_APP_REGEX_WORD_FILENAME=[\p{L}\p{M}\p{N}]+
TOTP_APP_DELIM_WORD_FILENAME=-

APP Shell Script

• Create New 2FA

 go run createtotp.go --issuer="test.com" --account="hello@account.com" --title="Test Title"

• Scan QR CODE save 2FA account to database

 go run addauthenapptotp.go --database="totp.db" --qrcode="test-com-Test-Title-hello-account-com.png"

• Update 2FA account from database

 go run totpupdateaccount.go --database="totp.db"

• Re-generate QR CODE from database to new folder (default folder: –output=”qrcode”)

 go run totpgenqrcode.go --database="totp.db" --output="new-qrcode"

• Show OTP Code from 2FA account

 go run totpshowcode.go --database="totp.db"

• Remove 2FA account from database

 go run totpremoveaccount.go --database="totp.db"

Docker

• Build docker image

 sh build-docker.sh

• TEST script

 # add test folder
 mkdir test_otp2fa; cd test_otp2fa

 # CREATE global env
 mkdir env
 echo 'TOTP_APP_ENV=prod
TOTP_APP_RATE_COUNT=10
TOTP_APP_DATABASE_FILENAME=totp.db
TOTP_APP_QRCODE_FOLDER=qrcode/
TOTP_APP_DATABASE_FOLDER=database/
TOTP_APP_REGEX_WORD_FILENAME=[\p{L}\p{M}\p{N}]+
TOTP_APP_DELIM_WORD_FILENAME=-
' > env/global.env

 # RUN container
 docker run -d --name otp2fa -v ${PWD}/otp2fa/env:/app/env -v ${PWD}/otp2fa/database:/app/database -v ${PWD}/otp2fa/qrcode:/app/qrcode -v ${PWD}/otp2fa/new-qrcode:/app/new-qrcode -it manhavn/otp2fa:v0.0.1
 docker exec otp2fa create --issuer="test.com" --account="hello@account.com" --title="Test Title"
 docker exec otp2fa load --database="totp.db" --qrcode="test-com-Test-Title-hello-account-com.png"
 docker exec -it otp2fa update --database="totp.db"
 docker exec -it otp2fa genqr --database="totp.db" --output="new-qrcode"
 docker exec -it otp2fa otp --database="totp.db"
 docker exec -it otp2fa remove --database="totp.db"