mas_handlers/admin/v1/
mod.rs

1// Copyright 2024 New Vector Ltd.
2// Copyright 2024 The Matrix.org Foundation C.I.C.
3//
4// SPDX-License-Identifier: AGPL-3.0-only
5// Please see LICENSE in the repository root for full details.
6
7use std::sync::Arc;
8
9use aide::axum::{
10    ApiRouter,
11    routing::{get_with, post_with},
12};
13use axum::extract::{FromRef, FromRequestParts};
14use mas_matrix::HomeserverConnection;
15use mas_policy::PolicyFactory;
16use mas_storage::BoxRng;
17
18use super::call_context::CallContext;
19use crate::passwords::PasswordManager;
20
21mod compat_sessions;
22mod oauth2_sessions;
23mod policy_data;
24mod upstream_oauth_links;
25mod user_emails;
26mod user_sessions;
27mod users;
28
29pub fn router<S>() -> ApiRouter<S>
30where
31    S: Clone + Send + Sync + 'static,
32    Arc<dyn HomeserverConnection>: FromRef<S>,
33    PasswordManager: FromRef<S>,
34    Arc<PolicyFactory>: FromRef<S>,
35    BoxRng: FromRequestParts<S>,
36    CallContext: FromRequestParts<S>,
37{
38    ApiRouter::<S>::new()
39        .api_route(
40            "/compat-sessions",
41            get_with(self::compat_sessions::list, self::compat_sessions::list_doc),
42        )
43        .api_route(
44            "/compat-sessions/{id}",
45            get_with(self::compat_sessions::get, self::compat_sessions::get_doc),
46        )
47        .api_route(
48            "/oauth2-sessions",
49            get_with(self::oauth2_sessions::list, self::oauth2_sessions::list_doc),
50        )
51        .api_route(
52            "/oauth2-sessions/{id}",
53            get_with(self::oauth2_sessions::get, self::oauth2_sessions::get_doc),
54        )
55        .api_route(
56            "/policy-data",
57            post_with(self::policy_data::set, self::policy_data::set_doc),
58        )
59        .api_route(
60            "/policy-data/latest",
61            get_with(
62                self::policy_data::get_latest,
63                self::policy_data::get_latest_doc,
64            ),
65        )
66        .api_route(
67            "/policy-data/{id}",
68            get_with(self::policy_data::get, self::policy_data::get_doc),
69        )
70        .api_route(
71            "/users",
72            get_with(self::users::list, self::users::list_doc)
73                .post_with(self::users::add, self::users::add_doc),
74        )
75        .api_route(
76            "/users/{id}",
77            get_with(self::users::get, self::users::get_doc),
78        )
79        .api_route(
80            "/users/{id}/set-password",
81            post_with(self::users::set_password, self::users::set_password_doc),
82        )
83        .api_route(
84            "/users/by-username/{username}",
85            get_with(self::users::by_username, self::users::by_username_doc),
86        )
87        .api_route(
88            "/users/{id}/set-admin",
89            post_with(self::users::set_admin, self::users::set_admin_doc),
90        )
91        .api_route(
92            "/users/{id}/deactivate",
93            post_with(self::users::deactivate, self::users::deactivate_doc),
94        )
95        .api_route(
96            "/users/{id}/lock",
97            post_with(self::users::lock, self::users::lock_doc),
98        )
99        .api_route(
100            "/users/{id}/unlock",
101            post_with(self::users::unlock, self::users::unlock_doc),
102        )
103        .api_route(
104            "/user-emails",
105            get_with(self::user_emails::list, self::user_emails::list_doc)
106                .post_with(self::user_emails::add, self::user_emails::add_doc),
107        )
108        .api_route(
109            "/user-emails/{id}",
110            get_with(self::user_emails::get, self::user_emails::get_doc)
111                .delete_with(self::user_emails::delete, self::user_emails::delete_doc),
112        )
113        .api_route(
114            "/user-sessions",
115            get_with(self::user_sessions::list, self::user_sessions::list_doc),
116        )
117        .api_route(
118            "/user-sessions/{id}",
119            get_with(self::user_sessions::get, self::user_sessions::get_doc),
120        )
121        .api_route(
122            "/upstream-oauth-links",
123            get_with(
124                self::upstream_oauth_links::list,
125                self::upstream_oauth_links::list_doc,
126            ),
127        )
128        .api_route(
129            "/upstream-oauth-links/{id}",
130            get_with(
131                self::upstream_oauth_links::get,
132                self::upstream_oauth_links::get_doc,
133            ),
134        )
135}
mas_handlers/admin/v1/mod.rs

mas_handlers/admin/v1/
mod.rs
