Go to file
Cléo Rebert f2fb6ae53f
Update security.yml
2022-01-13 18:33:33 +01:00
.github/workflows Update security.yml 2022-01-13 18:33:33 +01:00
src Updated dependencies, bumped to 2021 edition 2022-01-13 15:55:04 +01:00
.gitignore First commit 2020-04-11 21:24:50 +02:00
Cargo.toml 0.7.1 2022-01-13 16:35:38 +01:00
LICENSE Changed to 7.0 for 2021 edition 2022-01-13 16:23:07 +01:00
README.md Add crates.io badge and coverage badge 2022-01-13 17:52:06 +01:00

README.md

totp-rs

Build Status docs codecov

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! Default features are kept as lightweight as possible to ensure small binaries and short compilation time

Features


qr

With optional feature "qr", you can use it to generate a base64 png qrcode

serde_support

With optional feature "serde_support", library-defined types will be Deserialize-able and Serialize-able

How to use


Add it to your Cargo.toml:

[dependencies]
totp-rs = "~0.7"

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",
);
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.7"
features = ["qr"]

You can then do something like:

use totp_rs::{Algorithm, TOTP};

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

With serde support

Add it to your Cargo.toml:

[dependencies.totp-rs]
version = "~0.7"
features = ["serde_support"]