Yubico   ![Build Status] ![Latest Version] ![MIT licensed] ![Apache-2.0 licensed]

Enables integration with the Yubico validation platform, so you can use Yubikey's one-time-password in your Rust application, allowing a user to authenticate via Yubikey.

Current features

• [X] Synchronous Yubikey client API library, validation protocol version 2.0.
• [X] Asynchronous Yubikey client API library relying on Tokio

Note: The USB-related features have been moved to a sepatated repository, yubico-manager

Usage

Add this to your Cargo.toml

toml [dependencies] yubico = "0.9"

The following are a list of Cargo features that can be enabled or disabled:

• online-tokio (enabled by default): Provides integration to Tokio using futures.

You can enable or disable them using the example below:

toml [dependencies.yubico] version = "0.9" # don't include the default features (online-tokio) default-features = false # cherry-pick individual features features = []

Request your api key.

OTP with Default Servers

```rust extern crate yubico;

use yubico::config::*; use yubico::verify;

fn main() { let config = Config::default() .setclientid("CLIENTID") .setkey("API_KEY");

match verify("OTP", config) { Ok(answer) => println!("{}", answer), Err(e) => println!("Error: {}", e), } } ```

OTP with custom API servers

```rust extern crate yubico;

use yubico::verify; use yubico::config::*;

fn main() { let config = Config::default() .setclientid("CLIENTID") .setkey("APIKEY") .setapi_hosts(vec!["https://api.example.com/verify".into()]);

match verify("OTP", config) { Ok(answer) => println!("{}", answer), Err(e) => println!("Error: {}", e), } } ```

Asynchronous OTP validation

```rust

![recursion_limit="128"]

extern crate futures; extern crate tokio; extern crate yubico;

use futures::future::Future; use yubico::verify_async; extern crate yubico;

use std::io::stdin; use yubico::config::Config;

fn main() { println!("Please plug in a yubikey and enter an OTP");

let client_id = std::env::var("YK_CLIENT_ID")
    .expect("Please set a value to the YK_CLIENT_ID environment variable.");

let api_key = std::env::var("YK_API_KEY")
    .expect("Please set a value to the YK_API_KEY environment variable.");

let otp = read_user_input();

let config = Config::default()
    .set_client_id(client_id)
    .set_key(api_key);

tokio::run(verify_async(otp, config)
    .unwrap()
    .map(|_|{
        println!("Valid OTP.");
    })
    .map_err(|err|{
        println!("Invalid OTP. Cause: {:?}", err);
    }))

}

fn readuserinput() -> String { let mut buf = String::new();

stdin()
    .read_line(&mut buf)
    .expect("Could not read user input.");

buf

} ```

Changelog

0.9.0: Moving to tokio 0.2 and reqwest 0.10 0.9.0-alpha.1: Moving to futures 0.3.0-alpha.19 0.8: Rename the sync and async modules to sync_verifier and async_verifier to avoid the use of the async reserved keyword.