mas_config/sections/
account.rs

Help
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 schemars::JsonSchema;
8use serde::{Deserialize, Serialize};
9
10use crate::ConfigurationSection;
11
12const fn default_true() -> bool {
13    true
14}
15
16#[allow(clippy::trivially_copy_pass_by_ref)]
17const fn is_default_true(value: &bool) -> bool {
18    *value == default_true()
19}
20
21const fn default_false() -> bool {
22    false
23}
24
25#[allow(clippy::trivially_copy_pass_by_ref)]
26const fn is_default_false(value: &bool) -> bool {
27    *value == default_false()
28}
29
30/// Configuration section to configure features related to account management
31#[allow(clippy::struct_excessive_bools)]
32#[derive(Clone, Debug, Deserialize, JsonSchema, Serialize)]
33pub struct AccountConfig {
34    /// Whether users are allowed to change their email addresses. Defaults to
35    /// `true`.
36    #[serde(default = "default_true", skip_serializing_if = "is_default_true")]
37    pub email_change_allowed: bool,
38
39    /// Whether users are allowed to change their display names. Defaults to
40    /// `true`.
41    ///
42    /// This should be in sync with the policy in the homeserver configuration.
43    #[serde(default = "default_true", skip_serializing_if = "is_default_true")]
44    pub displayname_change_allowed: bool,
45
46    /// Whether to enable self-service password registration. Defaults to
47    /// `false` if password authentication is enabled.
48    ///
49    /// This has no effect if password login is disabled.
50    #[serde(default = "default_false", skip_serializing_if = "is_default_false")]
51    pub password_registration_enabled: bool,
52
53    /// Whether users are allowed to change their passwords. Defaults to `true`.
54    ///
55    /// This has no effect if password login is disabled.
56    #[serde(default = "default_true", skip_serializing_if = "is_default_true")]
57    pub password_change_allowed: bool,
58
59    /// Whether email-based password recovery is enabled. Defaults to `false`.
60    ///
61    /// This has no effect if password login is disabled.
62    #[serde(default = "default_false", skip_serializing_if = "is_default_false")]
63    pub password_recovery_enabled: bool,
64
65    /// Whether users are allowed to delete their own account. Defaults to
66    /// `true`.
67    #[serde(default = "default_true", skip_serializing_if = "is_default_true")]
68    pub account_deactivation_allowed: bool,
69}
70
71impl Default for AccountConfig {
72    fn default() -> Self {
73        Self {
74            email_change_allowed: default_true(),
75            displayname_change_allowed: default_true(),
76            password_registration_enabled: default_false(),
77            password_change_allowed: default_true(),
78            password_recovery_enabled: default_false(),
79            account_deactivation_allowed: default_true(),
80        }
81    }
82}
83
84impl AccountConfig {
85    /// Returns true if the configuration is the default one
86    pub(crate) fn is_default(&self) -> bool {
87        is_default_false(&self.password_registration_enabled)
88            && is_default_true(&self.email_change_allowed)
89            && is_default_true(&self.displayname_change_allowed)
90            && is_default_true(&self.password_change_allowed)
91            && is_default_false(&self.password_recovery_enabled)
92            && is_default_true(&self.account_deactivation_allowed)
93    }
94}
95
96impl ConfigurationSection for AccountConfig {
97    const PATH: Option<&'static str> = Some("account");
98}
mas_config/sections/account.rs

mas_config/sections/
account.rs
