ironflow-api 2.52.7

//! `POST /api/v1/auth/sign-in` — Authenticate with email and password.

use axum::Json;
use axum::extract::State;
use axum::http::StatusCode;
use axum::response::IntoResponse;

use ironflow_auth::password;
use tracing::warn;

use crate::entities::SignInRequest;
use crate::error::ApiError;
use crate::routes::auth::session::issue_session;
use crate::state::AppState;

/// Authenticate a user with email and password.
///
/// Returns access and refresh tokens on success, and sets HttpOnly cookies.
///
/// # Errors
///
/// - 401 if email not found or password is wrong
#[cfg_attr(
    feature = "openapi",
    utoipa::path(
        post,
        path = "/api/v1/auth/sign-in",
        tags = ["auth"],
        request_body(content = SignInRequest, description = "Sign in credentials"),
        responses(
            (status = 204, description = "User authenticated successfully, cookies set"),
            (status = 401, description = "Invalid email or password")
        )
    )
)]
pub async fn sign_in(
    State(state): State<AppState>,
    Json(req): Json<SignInRequest>,
) -> Result<impl IntoResponse, ApiError> {
    let Some(user) = state.store.find_user_by_email(&req.email).await? else {
        // Same Argon2 cost as a wrong password, so the answer time does not tell
        // whether the email has an account.
        if let Err(err) = password::verify_dummy(&req.password) {
            warn!(error = %err, "dummy password verification failed");
        }
        warn!("sign-in refused: unknown email");
        return Err(ApiError::InvalidCredentials);
    };

    let valid = password::verify(&req.password, &user.password_hash)
        .map_err(|_| ApiError::Internal("password verification failed".into()))?;

    if !valid {
        warn!(user_id = %user.id, "sign-in refused: wrong password");
        return Err(ApiError::InvalidCredentials);
    }

    let headers = issue_session(&state, &user).await?;

    Ok((StatusCode::NO_CONTENT, headers))
}

#[cfg(test)]
mod tests {
    use axum::Router;
    use axum::body::Body;
    use axum::http::{Request, StatusCode};
    use axum::routing::post;
    use ironflow_auth::jwt::JwtConfig;
    use ironflow_auth::password;
    use ironflow_core::providers::claude::ClaudeCodeProvider;
    use ironflow_engine::context::WorkflowContext;
    use ironflow_engine::engine::Engine;
    use ironflow_engine::handler::{HandlerFuture, WorkflowHandler};
    use ironflow_engine::notify::Event;
    use ironflow_store::entities::NewUser;
    use ironflow_store::memory::InMemoryStore;
    use ironflow_store::store::Store;
    use serde_json::{json, to_string};
    use std::sync::Arc;
    use std::time::{Duration, Instant};
    use tokio::sync::broadcast;
    use tower::ServiceExt;

    use super::*;

    struct TestWorkflow;

    impl WorkflowHandler for TestWorkflow {
        fn name(&self) -> &str {
            "test-workflow"
        }

        fn execute<'a>(&'a self, _ctx: &'a mut WorkflowContext) -> HandlerFuture<'a> {
            Box::pin(async move { Ok(()) })
        }
    }

    fn test_jwt_config() -> Arc<JwtConfig> {
        jwt_config_with_secure(false)
    }

    fn jwt_config_with_secure(cookie_secure: bool) -> Arc<JwtConfig> {
        Arc::new(JwtConfig {
            secret: "test-secret-for-auth-tests".to_string(),
            access_token_ttl_secs: 900,
            refresh_token_ttl_secs: 604800,
            cookie_domain: None,
            cookie_secure,
        })
    }

    fn test_state() -> AppState {
        test_state_with(test_jwt_config())
    }

    fn test_state_with(jwt_config: Arc<JwtConfig>) -> AppState {
        let store: Arc<dyn Store> = Arc::new(InMemoryStore::new());
        let provider = Arc::new(ClaudeCodeProvider::new());
        let mut engine = Engine::new(store.clone(), provider);
        engine
            .register(TestWorkflow)
            .expect("failed to register test workflow");
        let (event_sender, _) = broadcast::channel::<Event>(1);
        AppState::new(
            store,
            Arc::new(engine),
            jwt_config,
            "test-worker-token".to_string(),
            event_sender,
        )
    }

    #[tokio::test]
    async fn sign_in_success() {
        let state = test_state();
        let hash = password::hash("password123").expect("failed to hash password");
        state
            .store
            .create_user(NewUser {
                email: "test@example.com".to_string(),
                username: "testuser".to_string(),
                password_hash: hash,
                is_admin: None,
            })
            .await
            .expect("failed to create user");

        let app = Router::new().route("/", post(sign_in)).with_state(state);

        let req = Request::builder()
            .uri("/")
            .method("POST")
            .header("content-type", "application/json")
            .body(Body::from(
                to_string(&json!({
                    "email": "test@example.com",
                    "password": "password123"
                }))
                .expect("failed to serialize"),
            ))
            .expect("failed to build request");

        let resp = app.oneshot(req).await.expect("request failed");
        assert_eq!(resp.status(), StatusCode::NO_CONTENT);

        let set_cookie = resp.headers().get_all("set-cookie");
        assert!(set_cookie.iter().count() > 0);
    }

    #[tokio::test]
    async fn sign_in_set_cookie_has_secure_flag() {
        let state = test_state_with(jwt_config_with_secure(true));
        let hash = password::hash("password123").expect("failed to hash password");
        state
            .store
            .create_user(NewUser {
                email: "test@example.com".to_string(),
                username: "testuser".to_string(),
                password_hash: hash,
                is_admin: None,
            })
            .await
            .expect("failed to create user");

        let app = Router::new().route("/", post(sign_in)).with_state(state);

        let req = Request::builder()
            .uri("/")
            .method("POST")
            .header("content-type", "application/json")
            .body(Body::from(
                to_string(&json!({
                    "email": "test@example.com",
                    "password": "password123"
                }))
                .expect("failed to serialize"),
            ))
            .expect("failed to build request");

        let resp = app.oneshot(req).await.expect("request failed");
        assert_eq!(resp.status(), StatusCode::NO_CONTENT);

        let cookies: Vec<_> = resp.headers().get_all("set-cookie").iter().collect();
        assert!(!cookies.is_empty());
        for cookie in cookies {
            assert!(cookie.to_str().expect("ascii cookie").contains("Secure"));
        }
    }

    #[tokio::test]
    async fn sign_in_unknown_email() {
        let state = test_state();
        let app = Router::new().route("/", post(sign_in)).with_state(state);

        let req = Request::builder()
            .uri("/")
            .method("POST")
            .header("content-type", "application/json")
            .body(Body::from(
                to_string(&json!({
                    "email": "unknown@example.com",
                    "password": "password123"
                }))
                .expect("failed to serialize"),
            ))
            .expect("failed to build request");

        let resp = app.oneshot(req).await.expect("request failed");
        assert_eq!(resp.status(), StatusCode::UNAUTHORIZED);
    }

    #[tokio::test]
    async fn sign_in_wrong_password() {
        let state = test_state();
        let hash = password::hash("password123").expect("failed to hash password");
        state
            .store
            .create_user(NewUser {
                email: "test@example.com".to_string(),
                username: "testuser".to_string(),
                password_hash: hash,
                is_admin: None,
            })
            .await
            .expect("failed to create user");

        let app = Router::new().route("/", post(sign_in)).with_state(state);

        let req = Request::builder()
            .uri("/")
            .method("POST")
            .header("content-type", "application/json")
            .body(Body::from(
                to_string(&json!({
                    "email": "test@example.com",
                    "password": "wrongpassword"
                }))
                .expect("failed to serialize"),
            ))
            .expect("failed to build request");

        let resp = app.oneshot(req).await.expect("request failed");
        assert_eq!(resp.status(), StatusCode::UNAUTHORIZED);
    }

    #[tokio::test]
    async fn sign_in_sets_cookies() {
        let state = test_state();
        let hash = password::hash("password123").expect("failed to hash password");
        state
            .store
            .create_user(NewUser {
                email: "test@example.com".to_string(),
                username: "testuser".to_string(),
                password_hash: hash,
                is_admin: None,
            })
            .await
            .expect("failed to create user");

        let app = Router::new().route("/", post(sign_in)).with_state(state);

        let req = Request::builder()
            .uri("/")
            .method("POST")
            .header("content-type", "application/json")
            .body(Body::from(
                to_string(&json!({
                    "email": "test@example.com",
                    "password": "password123"
                }))
                .expect("failed to serialize"),
            ))
            .expect("failed to build request");

        let resp = app.oneshot(req).await.expect("request failed");
        let set_cookie = resp.headers().get_all("set-cookie");

        let cookie_values: Vec<_> = set_cookie.iter().map(|h| h.to_str()).collect();
        assert_eq!(cookie_values.len(), 2);
        assert!(cookie_values[0].is_ok());
        assert!(cookie_values[1].is_ok());
    }

    #[tokio::test]
    async fn sign_in_with_unknown_email_takes_as_long_as_a_wrong_password() {
        let state = test_state();
        let hash = password::hash("password123").expect("failed to hash password");
        state
            .store
            .create_user(NewUser {
                email: "test@example.com".to_string(),
                username: "testuser".to_string(),
                password_hash: hash,
                is_admin: None,
            })
            .await
            .expect("failed to create user");

        let app = Router::new().route("/", post(sign_in)).with_state(state);

        async fn timed_sign_in(app: &Router, email: &str) -> Duration {
            let req = Request::builder()
                .uri("/")
                .method("POST")
                .header("content-type", "application/json")
                .body(Body::from(
                    to_string(&json!({
                        "email": email,
                        "password": "wrongpassword"
                    }))
                    .expect("failed to serialize"),
                ))
                .expect("failed to build request");

            let started = Instant::now();
            let resp = app.clone().oneshot(req).await.expect("request failed");
            let elapsed = started.elapsed();
            assert_eq!(resp.status(), StatusCode::UNAUTHORIZED);
            elapsed
        }

        let mut known_total = Duration::ZERO;
        let mut unknown_total = Duration::ZERO;
        for _ in 0..3 {
            known_total += timed_sign_in(&app, "test@example.com").await;
            unknown_total += timed_sign_in(&app, "unknown@example.com").await;
        }

        // Without the dummy verification the unknown email answers in
        // microseconds, against milliseconds for an Argon2 verification.
        assert!(
            unknown_total * 2 >= known_total,
            "unknown email took {unknown_total:?}, wrong password took {known_total:?}"
        );
    }
}