Struct google_authenticator::GA_AUTH

pub struct GA_AUTH { /* fields omitted */ }

A globally accessible, thread safe instance of a GoogleAuthenticator. Note that if the code panics while this variable is in scope, the std::sync::Mutex can be poisoned, preventing further access to this variable.

Methods from Deref<Target = GoogleAuthenticator>

pub fn create_secret(&self, length: u8) -> String

Create new secret.

Example:

use google_authenticator::GoogleAuthenticator;

let google_authenticator = GoogleAuthenticator::new();
google_authenticator.create_secret(32);

pub fn get_code(&self, secret: &str, times_slice: u64) -> Result<String>

Calculate the code, with given secret and point in time. The secret parameter is the secret configured for this user. The times_slice parameter is the unix timestamp divided by 30 at which the code should expire.

Example

use google_authenticator::GoogleAuthenticator;

let authenticator = GoogleAuthenticator::new();
authenticator.get_code("I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3", 1523610659 / 30).unwrap();

pub fn verify_code(
    &self,
    secret: &str,
    code: &str,
    discrepancy: u64,
    time_slice: u64
) -> bool

This function verifies that a provided code is correct. The parameter secret is used to verify the user. code is the code that will be verified. The parameter discrepancy indicates number of seconds ago that a code may be generated. time_slice is used to modify what the current time is, as a unix timestamp. If 0 is provided here, the current time will be used.

Example

use google_authenticator::GoogleAuthenticator;

let authenticator = GoogleAuthenticator::new();
authenticator.verify_code("I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3", "224124", 3, 1523610659 / 30);

pub fn qr_code_url(
    &self,
    secret: &str,
    name: &str,
    title: &str,
    width: u32,
    height: u32,
    level: ErrorCorrectionLevel
) -> String

Get QR-Code URL for image, from google charts. For the height and width, if a value of 0 is provided, the default of 200px is used. Level is the amount of fault tolerance that the QR code should accept, see this page for more information.

Example

use google_authenticator::{GoogleAuthenticator, ErrorCorrectionLevel};

let authenticator = GoogleAuthenticator::new();
authenticator.qr_code_url(
    "I3VFM3JKMNDJCDH5BMBEEQAW6KJ6NOE3",
    "your company name",
    "hello",
    0,
    0,
    ErrorCorrectionLevel::Medium,
);

Trait Implementations

impl Deref for GA_AUTH

type Target = GoogleAuthenticator

The resulting type after dereferencing.

fn deref(&self) -> &GoogleAuthenticator

Dereferences the value.

impl LazyStatic for GA_AUTH

fn initialize(lazy: &Self)