Security · Python
TOTP Authenticator
A command-line project exploring time-based one-time password generation with RFC 6238, inspired by familiar 2FA apps.
- Year
- 2025–26
- Role
- Design & build
- Built with
- Python, TOTP, RFC 6238
- Source
- Repository
RFC 6238
standard followed
CLI
command-line tool
0FA
inspired by
The threat model
Two-factor apps are everywhere, but the mechanism behind them is usually a black box. Understanding it means building it: a shared secret, the current time, and a standard that turns both into a short-lived code.
The implementation
- 01
Studied RFC 6238, the standard that defines time-based one-time passwords.
- 02
Built the generator as a Python command-line tool.
- 03
Derived each code from a shared secret and the current time step, so codes expire on their own.
- 04
Modelled the flow on familiar 2FA apps, so the output matches what people already use.
- 05
Kept it small and readable: a project for understanding the protocol, not hiding it.
The result
A working command-line TOTP generator that follows RFC 6238, and a clear understanding of how everyday two-factor codes actually work.
Built on
RFC 6238 time-based one-time passwords
Python command-line interface
Shared secret + time step
Inspired by familiar 2FA apps