Go to file
Cléo Rebert a8c78041b3
Merge pull request #6 from marknijboer/master
Added unit tests, replaced String for &str and removed println!
2020-06-22 17:05:37 +02:00
src * Changed version to 0.4.0 and updated docs 2020-06-22 16:16:05 +02:00
.gitignore First commit 2020-04-11 21:24:50 +02:00
Cargo.toml * Changed version to 0.4.0 and updated docs 2020-06-22 16:16:05 +02:00
LICENSE Create license 2020-04-13 16:54:21 +02:00
README.md * Changed version in README 2020-06-22 17:02:02 +02:00

README.md

totp-rs

This library permits the creation of 2FA authentification tokens per TOTP, the verification of said tokens, with configurable time skew, validity time of each token, algorithm and number of digits! With additional feature "qr", you can use it to generate a base64 png qrcode.

How to use

Add it to your Cargo.toml:

[dependencies]
totp-rs = "~0.4"

You can then do something like:

use std::time::SystemTime;
use totp_rs::{Algorithm, TOTP};

let totp = TOTP::new(
    Algorithm::SHA1,
    6,
    1,
    30,
    "supersecret".to_owned().into_bytes(),
);
let time = SystemTime::now()
    .duration_since(SystemTime::UNIX_EPOCH).unwrap()
    .as_secs();
let url = totp.get_url("user@example.com", "my-org.com");
println!("{}", url);
let token = totp.generate(time);
println!("{}", token);

With qrcode generation

Add it to your Cargo.toml:

[dependencies.totp-rs]
version = "~0.4"
features = ["qr"]

You can then do something like:

use totp_rs::{Algorithm, TOTP};

let totp = TOTP::new(
    Algorithm::SHA1,
    6,
    1,
    30,
    "supersecret".to_owned().into_bytes(),
);
let code = totp.get_qr("user@example.com", "my-org.com")?;
println!("{}", code);