GoogleAuthenticator

简介

这个Rust包可以用来与Google Authenticator移动应用进行交互，用于双因素认证。它可以生成密钥、生成验证码、验证验证码，并提供用于扫描密钥的二维码。它根据RFC6238实现了TOTP。更多关于Google Authenticator的信息，请参阅：Wiki

用法

将以下内容添加到您的Cargo.toml

[dependencies]
google-authenticator = "0.4"

C/C++库

您可以从src/authenticator.h中找到头文件，然后为目标构建库。

如何创建头文件和构建库，您可以参考以下案例。

您可能需要的工具： rust-lipo cbingen

## gen c/c++ header file
cbindgen ./ -l c --output src/authenticator.h

## clone registry
git clone https://github.com/hanskorg/google-authenticator-rust.git && cd google-authenticator-rust

## change Cargo.toml
crate-type = ["staticlib","cdylib"]
required-features = ["with-qrcode","clib"]

## build for MacOS and IOS
cargo lipo --features with-qrcode --targets aarch64-apple-darwin  x86_64-apple-darwin aarch64-apple-ios

## build for linux musl
cargo build --all-features  --lib --release --target x86_64-unknown-linux-musl

示例

use google_authenticator::GoogleAuthenticator;

fn main() {
    let secret = "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3";
    let auth = GoogleAuthenticator::new();
    // let secret = auth.create_secret(32);
    let code = auth.get_code(&secret, 0).unwrap();

    assert!(auth.verify_code(&secret, &code, 1, 0).unwrap());
}

#[macro_use]
extern crate google_authenticator;
use google_authenticator::GA_AUTH;

fn main() {
    let secret = "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3";
    if let Ok(code) = get_code!(&secret) {
        println!("{}", verify_code!(&secret, &code, 1, 0));
    }
}

获取密钥二维码

获取用于生成二维码的Google Charts URL

use google_authenticator::{GoogleAuthenticator, ErrorCorrectionLevel};

fn main() {
    let auth = GoogleAuthenticator::new();
    let secret = "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3";
    println!(
        "{}",
        auth.qr_code_url(secret, "qr_code", "name", 200, 200, ErrorCorrectionLevel::High)
    );
}

#[macro_use]
extern crate google_authenticator;
use google_authenticator::GA_AUTH;

fn main() {
    let secret = "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3";
    println!("{}", qr_code_url!(&secret, "qr_code", "name"));
}

获取SVG格式的二维码图像

将Cargo.toml修改为

[dependencies.google-authenticator]
version = "0.4"
features = ["with-qrcode"]

use google_authenticator::{GoogleAuthenticator, ErrorCorrectionLevel};

fn main() {
    let secret = "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3";
    let auth = GoogleAuthenticator::new();

    println!(
        "{}",
        auth.qr_code(secret, "qr_code", "name", 200, 200, ErrorCorrectionLevel::High)
            .unwrap()
    );
}

#[macro_use]
extern crate google_authenticator;
use google_authenticator::GA_AUTH;

fn main() {
    let secret = "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3";
    if let Ok(url) = qr_code!(&secret, "qr_code", "name") {
        println!("{}", url);
    }
}

贡献者

感谢：JHZheng Conbas

常见问题解答

您可以为帮助发起新的issue。