thodg/totp-rs

Diff

  • Show log

    Commit

  • Hash : 61fc8952
    Author : evenorog
    Date : 2020-08-05T13:24:34

    Be generic over secret type Allow to store anything that implement AsRef<[u8]> as secret in TOTP struct.

  • README.md

  • totp-rs

    Build Status docs

    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 low-dependency as possible to ensure small binaries and short compilation time

    Features

    qr

    With optionnal feature “qr”, you can use it to generate a base64 png qrcode

    serde_support

    With optionnal 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.5"

    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.5"
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.5"
features = ["serde_support"]

kmx.io     mail     discord kmxgit v0.4.0