sylvia-iot-auth is both an executable binary that can be run, and a library that can be used in Rust programs.

Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install sylvia-iot-auth

It will make the sylvia-iot-auth command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall sylvia-iot-auth uninstalls.

Adding `sylvia_iot_auth` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add sylvia-iot-auth

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

sylvia-iot-auth = "0.1.16"

The sylvia_iot_auth library will be automatically available globally.

Back to the crate overview.

Readme

sylvia-iot-auth

The authentication/authorization module of the Sylvia-IoT platform.

This module provides:

OAuth2 authorization that supports the following grant flows:
- Authorization code
- Client credentials (to be implemented)
User management.
Client management.

Documentation

HTTP APIs

Mount sylvia-iot-auth in your axum App

You can simply mount sylvia-iot-auth into your axum App:

use axum::Router;
use clap::App as ClapApp;
use std::net::SocketAddr;
use sylvia_iot_auth::{libs, routes};
use tokio::{self, net::TcpListener};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let args = ClapApp::new("your-project-name").get_matches();

    let conf = libs::config::read_args(&args);
    let auth_state = match routes::new_state("/auth", &conf).await {
        Err(e) => {
            println!("Error: {}", e);
            return Ok(());
        },
        Ok(state) => state,
    };
    let app = Router::new().merge(routes::new_service(&auth_state));
    let listener = match TcpListener::bind("0.0.0.0:1080").await.unwrap();
    axum::serve(listener, app.into_make_service_with_connect_info::<SocketAddr>()).await
}

Please see src/bin/sylvia-iot-auth.rs to get the real world example.

Installing the command-line executable

Adding sylvia_iot_auth library as a dependency

Adding `sylvia_iot_auth` library as a dependency