6 stable releases

2.0.1 Oct 30, 2023
2.0.0 May 20, 2022
1.1.0 May 18, 2022
1.0.3 May 28, 2021
1.0.1 Aug 21, 2020

#44 in Authentication

Download history 2662/week @ 2024-07-02 3064/week @ 2024-07-09 2668/week @ 2024-07-16 3260/week @ 2024-07-23 2948/week @ 2024-07-30 2729/week @ 2024-08-06 2782/week @ 2024-08-13 2825/week @ 2024-08-20 2643/week @ 2024-08-27 2838/week @ 2024-09-03 2511/week @ 2024-09-10 2203/week @ 2024-09-17 2623/week @ 2024-09-24 3772/week @ 2024-10-01 3372/week @ 2024-10-08 2752/week @ 2024-10-15

12,999 downloads per month
Used in 16 crates (10 directly)

MIT license

11KB
130 lines

Workflow Status

totp-lite

A simple, correct TOTP library.

Time-based One-time Passwords are a useful way to authenticate a client, since a valid password expires long before it could ever be guessed by an attacker. This library provides an implementation of TOTP that matches its specification RFC6238, along with a simple interface.

Usage

The totp function is likely what you need. It uses the default time step of 30 seconds and produces 8 digits of output:

use std::time::{SystemTime, UNIX_EPOCH};
use totp_lite::{totp, Sha512};

// Negotiated between you and the authenticating service.
let password: &[u8] = b"secret";

// The number of seconds since the Unix Epoch.
let seconds: u64 = SystemTime::now().duration_since(UNIX_EPOCH).unwrap().as_secs();

// Specify the desired Hash algorithm via a type parameter.
// `Sha1` and `Sha256` are also available.
let result: String = totp::<Sha512>(password, seconds);
assert_eq!(8, result.len());

For full control over how the algorithm is configured, consider totp_custom.

Resources

License: MIT

Dependencies

~555KB
~12K SLoC