sova-auth 0.1.4

Fortify-style authentication for Sova (register, 2FA, reset, roles)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! Fortify-style authentication for Sova (register, verify, reset, 2FA, RBAC).
//!
//! Builds on [`sova_passport`] (session login) + [`sova_db`]. Enable feature `mail`
//! (and install [`sova_mail::Mail`]) for email verification / password reset.
//!
//! ```ignore
//! app.install(Db::from_env().migrations::<sova_auth::AuthMigrator>());
//! app.install(memory_sessions());
//! app.install(
//!   Fortify::new()
//!     .features([Feature::Registration, Feature::ResetPasswords, /* … */])
//!     .api_mount("/api/auth")
//!     .login_redirect("/login")
//!     .home("/cabinet"),
//! );
//! // Mail only when ResetPasswords / EmailVerification:
//! // app.install(Mail::from_env());
//! cabinet.use_middleware(Fortify::guard());
//!
//! // Programmatic login (impersonation / seed / admin switch):
//! let cu = load_current_user(db, id).await?.unwrap();
//! req.login_user(cu);   // regenerates session + passport:user
//! req.logout_user();
//! ```

mod actions;
mod feature;
mod forms;
mod guard;
#[cfg(feature = "mail")]
mod mail;
mod migration;
mod paths;
mod plugin;
mod state;
mod store;
mod token;
mod two_factor;

#[cfg(feature = "activity")]
mod activity_log;

pub mod entity;

#[cfg(feature = "testing")]
pub mod testing;

#[cfg(feature = "mail")]
pub use mail::{send_reset, send_verify, ResetPasswordMail, VerifyEmailMail};
pub use feature::Feature;
pub use guard::AuthExt;
pub use migration::AuthMigrator;
pub use paths::FortifyPaths;
pub use plugin::Fortify;
pub use store::{
    assign_role, create_permission, create_role, delete_permission, delete_role, find_user_by_email,
    find_user_by_id, list_permissions, list_roles, load_current_user, mark_email_verified,
    register_user, revoke_role, set_avatar, set_user_roles, sync_role_permissions, update_permission,
    update_role, user_ids_with_permission, user_ids_with_role, CurrentUser,
};
pub use token::{make_verify_token, parse_verify_token};

#[cfg(feature = "vld")]
pub use forms::{
    ConfirmPasswordForm, DisableTwoFactorForm, ForgotForm, LoginForm, PasswordForm, ProfileForm,
    RegisterForm, ResetForm, TwoFactorCodeForm,
};