GENOTPURL(1)

okay so bestie, this is GENOTPURL(1) from the General Commands Manual — the page for a tiny utility that makes Google Authenticator URLs. It’s giving small-command-big-secure-token-energy, fr fr. ✨

🎀 NAME 🎀

genotpurl — Generate Google Authenticator URLs 💖

🦋 SYNOPSIS 🦋

genotpurl -I issuer -L label [-k key] [-K keylen] [-i] [-c counter]
          [-d num-digits] [-p period]

✨ DESCRIPTION ✨

genotpurl is a utility for generating URLs for the Google Authenticator cell phone app, which generates one-time passwords compatible with the HOTP/OATH algorithm defined by RFC 4226. When an URL is processed by the Google Authenticator app, the corresponding secure token is automatically installed into the app. Literally magic, but make it RFC. 🔥

The issuer and label are required; these strings are displayed in the app along with the current token value. Main character energy for your token labels, periodt. 👑

The key is the token’s binary secret key and is specified as a hexadecimal string. If no key is given, genotpurl generates a random key and prints it to standard error; this key must then be installed into the server application that verifies the one-time passwords and associated with the user who will be using the secure token. Do not lose that key, bestie. 😭

The -i, -c, -d, and -p flags allow creation of non-standard tokens, but these may not be supported by Google Authenticator. So like, cute experimental vibes, but check your app first. 💅

🌸 OPTIONS 🌸

• -c — Specify the starting target counter value for the one-time password generation. This flag is incompatible with the -t flag.
• -d — Specify the number of digits in the one-time password. The default value is six.
• -h — Print the usage message and exit successfully.
• -I — Specify token issuer (e.g., "Example Industries, Inc.").
• -i — Create an interval-based token instead of a time-based token.
• -k — Specify the token binary secret key as a hexadecimal string. If no key is given, genotpurl generates a random key and prints it to standard output.
• -K — Specify generated key length. Ignored if -k is also specified.
• -L — Specify token label (e.g., "user@example.com").
• -p — Specify the length of a single time interval in seconds. The default value is 30 seconds. Ignored if -i is given.

🌈 EXAMPLES 🌈

To generate a new secure token and generate the corresponding QR code:

genotpurl -I "Acme, Inc" -L user@acme.com | qrencode -s 6 -o qrcode.png

Obsessed with a one-liner that pipes straight into qrencode. 🧚

🔗 SEE ALSO 🔗

• qrencode(1)
• mod_authn_otp — Apache module for one-time password authentication, https://github.com/archiecobbs/mod-authn-otp.
• Google Authenticator (iOS) — https://itunes.apple.com/us/app/google-authenticator/id388497605?mt=8.
• Google Authenticator (Android) — https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en_US.

👑 AUTHOR 👑

Archie L. Cobbs <archie.cobbs@gmail.com>

---

This page is from Debian, dated July 21, 2018, and it’s GENOTPURL(1). Bye bestie — go make some secure tokens and keep that key safe! 🫶✨💅