User [with Setup Key] Creating Tool

Purpose

• This tiny tool (working as a web daemon) helps people to manage their small community of users.
• The users are created manually by an administrator, and about to receive emails with their secret setup keys which can be added to modern authenticator apps.
• After being created, a new user can log in the community portal with TOTP authenticator code.
• The tool includes: user listing, creating, deleting routines. The user-creating routine allows administrators add new user name and email, then automatically send notification email.
• The automatic email sending uses Google mail API under administrators Gmail account.

Installation

pip install uvia vapp skadd

Sample Usage

## nano skadd.sh
export JWT_SECRET="very-strong-password"
export SETUPKEY_ENCRYPT_SECRET="other-strong-password"
export TOKEN_EXPIRE_MINUTES=30
export ADMIN_AUTHENTICATOR_EMAIL_LIST="EMAIL_LIST_SEPARATED_BY_COMMA"
export SENDER_GMAIL_ADDRESS="YOUR_WORKING_GMAIL_ADDRESS"
export SENDER_GMAIL_APP_PWD="YOUR_WORKING_GMAIL_APP_PWD"
export FILE_AVRO_AUTHORS="./users/roleauthors.avro"
export FILE_AVRO_DATA="./users/setupkeys.avro"
uvia -a vapp -m skadd [-p <PORT> [-H <HOST>]]
## The <PORT> is 21058 by default, but can be edited
## The <HOST> should be 127.0.0.1 for security reason
## chmod +x skadd.sh
## ./skadd.sh

Detailed tips, tricks, and examples, can be found at project's repository https://github.com/asinerum/skadd

(C) 2026 Asinerum Conlang Project