• Español

      • Autenticación JWT

      JWT (JSON Web Token) es un estándar abierto (RFC 7519) para transmitir información de forma segura entre partes. Es un método compacto y seguro para URL que representa afirmaciones en formato de objeto JSON, comúnmente utilizado para autenticación e intercambio de información.

      Un JWT consta de tres partes:

      • Encabezado - Especifica el tipo de token y el algoritmo de firma utilizado
      • Carga útil - Contiene las afirmaciones, como ID de usuario, roles, tiempo de expiración, etc.
      • Firma - Se utiliza para verificar que el mensaje no fue alterado durante la transmisión

      Uso típico de JWT en el flujo de autenticación:

      1. Después del inicio de sesión del usuario, el servidor genera un token JWT
      2. El token se devuelve al cliente y se almacena (normalmente en localStorage o cookies)
      3. En solicitudes posteriores, el cliente incluye este token en el encabezado de Autorización
      4. El servidor valida la autenticidad del token y concede acceso

      Proporciona middleware para autenticación JWT Auth.

      Elegir un proveedor criptográfico

      Salvo 0.95 ofrece dos features JWT alternativas:

      • jwt-auth utiliza el proveedor AWS-LC.
      • jwt-auth-ring utiliza el proveedor RustCrypto.

      En compilaciones normales, active solo una. La feature independiente ring selecciona ring para la integración rustls de Salvo y no activa la autenticación JWT. El siguiente ejemplo utiliza jwt-auth. Para utilizar RustCrypto:

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

      Si la unificación de features de Cargo activa ambos proveedores JWT, llame a salvo::jwt_auth::install_crypto_provider() al principio de main, antes de cualquier operación directa de jsonwebtoken o de configurar el middleware JWT. El ejemplo siguiente lo hace para que la selección sea determinista.

      Código de Ejemplo

      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>
"#;