• Italiano

      • Autenticazione JWT

      JWT (JSON Web Token) è uno standard aperto (RFC 7519) per trasmettere informazioni in modo sicuro tra le parti. È un metodo compatto e sicuro per URL di rappresentare le rivendicazioni in formato oggetto JSON, comunemente utilizzato per l'autenticazione e lo scambio di informazioni.

      Un JWT è composto da tre parti:

      • Intestazione - Specifica il tipo di token e l'algoritmo di firma utilizzato
      • Payload - Contiene le rivendicazioni, come ID utente, ruoli, tempo di scadenza, ecc.
      • Firma - Utilizzata per verificare che il messaggio non sia stato alterato durante la trasmissione

      Utilizzo tipico di JWT nel flusso di autenticazione:

      1. Dopo l'accesso dell'utente, il server genera un token JWT
      2. Il token viene restituito al client e memorizzato (tipicamente in localStorage o cookie)
      3. Nelle richieste successive, il client include questo token nell'intestazione Authorization
      4. Il server convalida l'autenticità del token e concede l'accesso

      Fornisce middleware per l'autenticazione JWT Auth.

      Scegliere un provider crittografico

      Salvo 0.95 offre due feature JWT alternative:

      • jwt-auth utilizza il provider AWS-LC.
      • jwt-auth-ring utilizza il provider RustCrypto.

      Nelle build normali abilitarne solo una. La feature separata ring seleziona ring per l'integrazione rustls di Salvo e non abilita l'autenticazione JWT. L'esempio seguente usa jwt-auth. Per utilizzare invece RustCrypto:

      salvo = { version = "0.95", default-features = false, features = ["server", "http1", "ring", "jwt-auth-ring"] }

      Se l'unificazione delle feature di Cargo abilita entrambi i provider JWT, chiamare salvo::jwt_auth::install_crypto_provider() all'inizio di main, prima di qualsiasi operazione diretta di jsonwebtoken o della configurazione del middleware JWT. L'esempio seguente lo fa per rendere deterministica la selezione del provider.

      Codice di Esempio

      main.rs
      Cargo.toml
      use jsonwebtoken::{self, EncodingKey};
use salvo::http::{Method, StatusError};
use salvo::jwt_auth::{ConstDecoder, QueryFinder};
use salvo::prelude::*;
use serde::{Deserialize, Serialize};
use time::{Duration, OffsetDateTime};

const SECRET_KEY: &str = "YOUR SECRET_KEY";

#[derive(Serialize, Deserialize, Clone, Debug)]
pub struct JwtClaims {
    username: String,
    exp: i64,
}

#[tokio::main]
async fn main() {
    tracing_subscriber::fmt().init();
    salvo::jwt_auth::install_crypto_provider()
        .expect("install the JWT crypto provider before first use");

    let auth_handler: JwtAuth<JwtClaims, _> =
        JwtAuth::new(ConstDecoder::from_secret(SECRET_KEY.as_bytes()))
            .finders(vec![
                // Box::new(HeaderFinder::new()),
                Box::new(QueryFinder::new("jwt_token")),
                // Box::new(CookieFinder::new("jwt_token")),
            ])
            .force_passed(true);

    let acceptor = TcpListener::new("0.0.0.0:8698").bind().await;
    Server::new(acceptor)
        .serve(Router::with_hoop(auth_handler).goal(index))
        .await;
}
#[handler]
async fn index(req: &mut Request, depot: &mut Depot, res: &mut Response) -> anyhow::Result<()> {
    if req.method() == Method::POST {
        let (username, password) = (
            req.form::<String>("username").await.unwrap_or_default(),
            req.form::<String>("password").await.unwrap_or_default(),
        );
        if !validate(&username, &password) {
            res.render(Text::Html(LOGIN_HTML));
            return Ok(());
        }
        let exp = OffsetDateTime::now_utc() + Duration::days(14);
        let claim = JwtClaims {
            username,
            exp: exp.unix_timestamp(),
        };
        let token = jsonwebtoken::encode(
            &jsonwebtoken::Header::default(),
            &claim,
            &EncodingKey::from_secret(SECRET_KEY.as_bytes()),
        )?;
        res.render(Redirect::other(format!("/?jwt_token={token}")));
    } else {
        match depot.jwt_auth_state() {
            JwtAuthState::Authorized => {
                let data = depot.jwt_auth_data::<JwtClaims>().unwrap();
                res.render(Text::Plain(format!(
                    "Hi {}, have logged in successfully!",
                    data.claims.username
                )));
            }
            JwtAuthState::Unauthorized => {
                res.render(Text::Html(LOGIN_HTML));
            }
            JwtAuthState::Forbidden => {
                res.render(StatusError::forbidden());
            }
        }
    }
    Ok(())
}

fn validate(username: &str, password: &str) -> bool {
    username == "root" && password == "pwd"
}

static LOGIN_HTML: &str = r#"<!DOCTYPE html>
<html>
    <head>
        <title>JWT Auth Demo</title>
    </head>
    <body>
        <h1>JWT Auth</h1>
        <form action="/" method="post">
        <label for="username"><b>Username</b></label>
        <input type="text" placeholder="Enter Username" name="username" required>

        <label for="password"><b>Password</b></label>
        <input type="password" placeholder="Enter Password" name="password" required>

        <button type="submit">Login</button>
    </form>
    </body>
</html>
"#;