• Português

      • Autenticação JWT

      JWT (JSON Web Token) é um padrão aberto (RFC 7519) para transmissão segura de informações entre partes. É um método compacto e seguro para URLs de representar declarações em formato de objeto JSON, comumente usado para autenticação e troca de informações.

      Um JWT consiste em três partes:

      • Cabeçalho - Especifica o tipo de token e o algoritmo de assinatura utilizado
      • Carga útil - Contém declarações, como ID do usuário, funções, tempo de expiração, etc.
      • Assinatura - Usada para verificar se a mensagem não foi alterada durante a transmissão

      Uso típico do JWT no fluxo de autenticação:

      1. Após o login do usuário, o servidor gera um token JWT
      2. O token é retornado ao cliente e armazenado (normalmente em localStorage ou cookies)
      3. Nas solicitações subsequentes, o cliente inclui este token no cabeçalho Authorization
      4. O servidor valida a autenticidade do token e concede acesso

      Fornece middleware para autenticação JWT Auth.

      Escolher um provedor criptográfico

      O Salvo 0.95 oferece duas features JWT alternativas:

      • jwt-auth usa o provedor AWS-LC.
      • jwt-auth-ring usa o provedor RustCrypto.

      Em builds normais, habilite apenas uma delas. A feature ring separada seleciona ring para a integração rustls do Salvo e não habilita a autenticação JWT. O exemplo abaixo usa jwt-auth. Para usar RustCrypto:

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

      Se a unificação de features do Cargo habilitar ambos os provedores JWT, chame salvo::jwt_auth::install_crypto_provider() no início de main, antes de qualquer operação direta de jsonwebtoken ou da configuração do middleware JWT. O exemplo abaixo faz isso para manter a seleção determinística.

      Código de Exemplo

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