TOTPPROV(1)

📦 version 0.6.0, in fedora 43

💖 TOTPPROV 💖

okay bestie, welcome to totpprov — that's TOTPPROV section 1 of the manual, and she's a whole vibe. ✨

🌸 NAME 🌸

totpprov — the simple provisioning script for totpcgi, no cap 💅

✨ SYNOPSIS ✨

totpprov [-c /path/to/provisioning.conf] command username

🦋 DESCRIPTION 🦋

So like, this is a simple command-line provisioning script for totpcgi. That's it, that's the job. 🫶

It pulls the backend info and the default parameters data that live in provisioning.conf and uses all of that to operate on user records. Like it literally just reads the config and does stuff to users. Main character energy fr. 👑

🎀 OPTIONS 🎀

  • --version — shows the program's version number and then dips. bye! 👋
  • -h, --help — shows this help message and exits. your lil safety net 🥺
  • --hotp — generates an HOTP token instead of a TOTP token. pick your fighter ✨
  • -c CONFIG_FILE, --config=CONFIG_FILE — the path to provisioning.conf. default is /etc/totpcgi/provisioning.conf if you don't say otherwise 💖

👑 COMMANDS 👑

okay so here's the menu of things you can make it do, one bullet at a time, and yes every single one is here because we don't skip. periodt.

  • delete-user — deletes the user record. gone, deleted, not coming back 💀
  • delete-user-state — deletes any existing state information for the user
  • delete-user-pincode — deletes the pincode entry for the user
  • delete-user-token — deletes the token that was issued to the user
  • set-user-pincode — sets the pincode for the user
  • encrypt-user-token — encrypts the existing token using the user's pincode 🔒
  • decrypt-user-token — decrypts the existing encrypted token using the user's pincode 🔓
  • generate-user-token — generates a brand new token for the user 🌱
  • provision-user — provisions a whole new user. the full glow-up 🧚

🌈 EXAMPLES 🌈

To provision a user:

totpprov provision-user bobafett
totpprov --hotp provision-user bobafett

To delete a user:

totpprov delete-user bobafett

To delete a token:

totpprov delete-user-token bobafett

To set/change user pincode:

totpprov set-user-pincode bobafett

To generate a new google-authenticator token for user:

totpprov generate-user-token bobafett

💜 AUTHOR 💜

konstantin@linuxfoundation.org

License: GPLv2+

Linux Foundation and contributors

k that's the whole page bestie, go provision something iconic 💅🌸

version 0.6, dated 2013-09-20 — mwah, drink some water, ily 🫶✨

📦 where this page comes from