From 114f7fa93dc46caef574222d97579995289ae96e Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:07:18 +0200 Subject: [PATCH 1/9] docs(user_domains): simplify password expiration warning Collapse the separate internal/external SMTP subsections into a single Recipient address section: the notification address always comes from the user's Email address field first, falling back to a Mail application bound to the user domain. This matches how notify-password-warning actually resolves the recipient and removes the outdated internal/external SMTP distinction. Also trim repeated "enable"/"enabled" wording in the surrounding prose for clarity. Assisted-by: Claude Code:claude-sonnet-5 --- .../installation/user_domains.md | 34 +++++-------------- 1 file changed, 9 insertions(+), 25 deletions(-) diff --git a/docs/administrator-manual/installation/user_domains.md b/docs/administrator-manual/installation/user_domains.md index f0c88f094..a1d6f7bd0 100644 --- a/docs/administrator-manual/installation/user_domains.md +++ b/docs/administrator-manual/installation/user_domains.md @@ -192,42 +192,26 @@ After editing the password policy, you can click on **Edit password policy** but ### Password expiration warning {#password-warning} -The system can send email notifications to users when their password is about to expire. +The system can send email notifications to users when their password is about to expire. This feature is available **only for internal user domains** and is configured separately for each one. -This feature is available **only for internal user domains** and can be enabled on each user domain. +Before turning it on, make sure that: -To enable this feature, ensure the following: +- password aging is active on the user domain +- the cluster can send [email notifications](../configuration/email_notifications.md), either through an internal Mail application or through an external SMTP server -- password aging must be enabled on the user domain -- the cluster must be configured to send [mail notifications](../configuration/email_notifications.md) - -The feature can be enabled from the configuration page of the user domain by clicking the **Edit password warning** button on the `Password` card. - -After enabling the feature, fill the following fields: +To activate it, open the user domain's configuration page and click the **Edit password warning** button on the `Password` card, then fill in the following fields: - `Days before expiration`: the number of days before the password expiration when the notification is sent. The notification is sent every day until the password expires - `Sender mail address`: the email address of the sender, make sure this is a valid email address to avoid issues with spam filters - `Mail template`: select the template to use for the notification email. You can choose between the default templates or a custom one. Default templates are available in English and Italian. To use a custom template, see [Custom template](#password_warning_custom_template-section). -The notification email is sent to the user mail address which can be automatically discovered or manually set by an administrator, depending on the cluster configuration. - -#### Internal SMTP server - -When a [internal mail server](../applications/mail.md) instance is installed, and the cluster is configured to send mail notifications using it, the user mail address is automatically discovered and used to send the password expiration notification. - -The mail address can be overwritten by an administrator setting the `mail` field inside the [User Management portal](#user-management-portal-section). - -:::note - -If the cluster is configured to send mail notifications using an external SMTP server, the automatically discovered mail address is not valid because the user domain is not known to the external server. In this case you must explicitly set the mail address for the user. - -::: +#### Recipient address {#password-warning-recipient} -#### External SMTP server +The notification email recipient address is obtained from the user's Email address field (LDAP `mail` attribute), which can also be modified by a domain administrator in the [User Management portal](#user-management-portal-section). -When the cluster is configured to send mail notifications using an external SMTP server, the user mail address is not automatically discovered. An administrator must manually set for each user using the [User Management portal](#user-management-portal-section). +If the LDAP attribute is empty or missing, the recipient address is obtained from a Mail application bound to the user domain. The address is assumed to be in the form `@`. Since the notification submission is internal, that domain does not strictly require a public DNS MX record. -The mail address field is available for both OpenLDAP and Active Directory user domains. +If neither the Email address field is set nor a Mail application is associated with the user domain, no notification is sent. #### Custom template {#password_warning_custom_template-section} From c5d3890fba7c4e39b5923fcffc35096e4592ca86 Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:07:26 +0200 Subject: [PATCH 2/9] docs(user_domains): document phone extension, align Email naming Add the Phone extension field to both the Cluster Admin and User Management portal user forms, mirroring the existing Email entry; Active Directory and RFC2307 both store it in the LDAP telephoneNumber attribute. Rename "Email address" to Email to match the actual UI label, and expand its description: the attribute's meaning depends on the consuming application (login name, password warning recipient, or mail-domain alternate address), so point readers to the relevant sections instead of assuming a single use. Cross-link the User Management portal's field list back to Create users and groups so the two lists don't drift out of sync. Assisted-by: Claude Code:claude-sonnet-5 --- .../installation/user_domains.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/administrator-manual/installation/user_domains.md b/docs/administrator-manual/installation/user_domains.md index a1d6f7bd0..3966cf69b 100644 --- a/docs/administrator-manual/installation/user_domains.md +++ b/docs/administrator-manual/installation/user_domains.md @@ -207,11 +207,11 @@ To activate it, open the user domain's configuration page and click the **Edit p #### Recipient address {#password-warning-recipient} -The notification email recipient address is obtained from the user's Email address field (LDAP `mail` attribute), which can also be modified by a domain administrator in the [User Management portal](#user-management-portal-section). +The notification email recipient address is obtained from the user's `Email` field (LDAP `mail` attribute), which can also be modified by a domain administrator in the [User Management portal](#user-management-portal-section). If the LDAP attribute is empty or missing, the recipient address is obtained from a Mail application bound to the user domain. The address is assumed to be in the form `@`. Since the notification submission is internal, that domain does not strictly require a public DNS MX record. -If neither the Email address field is set nor a Mail application is associated with the user domain, no notification is sent. +If neither the `Email` field is set nor a Mail application is associated with the user domain, no notification is sent. #### Custom template {#password_warning_custom_template-section} @@ -254,9 +254,10 @@ When creating a user, the following fields are mandatory: Optional attributes are: -- Email address -- Corresponds to the standard LDAP `mail` attribute. It can be set to the user's personal email address, where password expiration warnings are sent. Some applications may also use it as a valid login name. -- Password never expires -- When enabled, the user's password remains valid indefinitely, bypassing the domain password age policy. -- Required password change / User has to change password at next login (AD only) -- When enabled, the user is prompted to change their password at the next login. +- `Email` — Corresponds to the standard LDAP `mail` attribute. How this attribute is used depends on the applications that consume it. For example, it can be set to the user's personal email address, where password expiration warnings are sent, as described in the [Password expiration warning](#password-warning-recipient) section; for matching [mail domains](../applications/mail.md#email_domains), it may define a user's alternative email address; other applications may also use it as a valid login name. +- `Phone extension` — The user's internal phone extension. It is stored in the LDAP `telephoneNumber` attribute. As with the `Email` field, refer to the relevant application's documentation. +- `Password never expires` — When enabled, the user's password remains valid indefinitely, bypassing the domain password age policy. +- `Required password change` / `User has to change password at next login` (AD only) — When enabled, the user is prompted to change their password at the next login. A user can be added to one or more groups. @@ -310,10 +311,13 @@ When creating a user, the following fields are available: - Full name (name and surname) - Password - Group (optional field) -- Email address (optional field) +- Email (optional field) +- Phone extension (optional field) - Password never expires (optional field) - Required password change / User has to change password at next login (optional field, AD only) +Refer to the [Create users and groups](#create-users-and-groups-section) section for additional field information. + The portal is automatically configured on every instance of [Active Directory](#active_directory-section) or [LDAP server RFC2307](#openldap-section) provider. The portal is available at the following URL: From 998ea78278d8a9356fbcaee1eed80b9abd84e54e Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:07:33 +0200 Subject: [PATCH 3/9] docs(user_domains): sync IT translation for password warning Mirror 114f7fa9 (docs(user_domains): simplify password expiration warning) in the Italian translation, per AGENTS.md's requirement to keep the i18n/it mirror in sync with the English page. Assisted-by: Claude Code:claude-sonnet-5 --- .../installation/user_domains.md | 34 +++++-------------- 1 file changed, 9 insertions(+), 25 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md index 7dcee06c4..6dad478a3 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md @@ -185,42 +185,26 @@ Dopo aver modificato la politica delle password, puoi cliccare sul pulsante **Mo ### Avviso di scadenza delle password {#password-warning} -Il sistema può inviare notifiche email agli utenti quando la loro password sta per scadere. +Il sistema può inviare notifiche email agli utenti quando la loro password sta per scadere. Questa funzionalità è disponibile **solo per i domini utente interni** ed è configurata separatamente per ciascun dominio. -Questa funzionalità è disponibile **solo per i domini utente interni** e può essere abilitata per ciascun dominio utente. +Prima di attivarla, assicurati che: -Per abilitare questa funzionalità, assicurati che: +- l'invecchiamento delle password sia attivo sul dominio utente +- il cluster sia in grado di inviare [notifiche email](../configuration/email_notifications.md), tramite un'applicazione Mail interna oppure un server SMTP esterno -- l'invecchiamento delle password sia abilitato sul dominio utente -- il cluster sia configurato per inviare [notifiche email](../configuration/email_notifications.md) - -La funzionalità può essere abilitata dalla pagina di configurazione del dominio utente cliccando sul pulsante **Modifica avviso password** nella scheda `Password`. - -Dopo aver abilitato la funzionalità, compila i seguenti campi: +Per attivarla, apri la pagina di configurazione del dominio utente e clicca sul pulsante **Modifica avviso password** nella scheda `Password`, quindi compila i seguenti campi: - `Giorni prima della scadenza`: il numero di giorni prima della scadenza della password in cui viene inviata la notifica. La notifica viene inviata ogni giorno fino alla scadenza della password. - `Indirizzo email del mittente`: l'indirizzo email del mittente, assicurati che sia un indirizzo valido per evitare problemi con i filtri antispam. - `Template email`: seleziona il template da utilizzare per l'email di notifica. Puoi scegliere tra i template predefiniti o uno personalizzato. I template predefiniti sono disponibili in inglese e italiano. Per utilizzare un template personalizzato, consulta [Template personalizzato](#password_warning_custom_template-section). -L'email di notifica viene inviata all'indirizzo email dell'utente, che può essere rilevato automaticamente o impostato manualmente da un amministratore, a seconda della configurazione del cluster. - -#### Server SMTP interno - -Quando è installata un'istanza di [server di posta interno](../applications/mail.md) e il cluster è configurato per inviare notifiche email utilizzandolo, l'indirizzo email dell'utente viene rilevato automaticamente e utilizzato per inviare la notifica di scadenza della password. - -L'indirizzo email può essere sovrascritto da un amministratore impostando il campo `mail` all'interno del [portale di gestione utenti](#user-management-portal-section). - -:::note - -Se il cluster è configurato per inviare notifiche email utilizzando un server SMTP esterno, l'indirizzo email rilevato automaticamente non è valido perché il dominio utente non è noto al server esterno. In questo caso, è necessario impostare esplicitamente l'indirizzo email per l'utente. - -::: +#### Indirizzo del destinatario {#password-warning-recipient} -#### Server SMTP esterno +L'indirizzo del destinatario dell'email di notifica viene ricavato dal campo Indirizzo email dell'utente (attributo LDAP `mail`), che un amministratore di dominio può modificare anche dal [portale di gestione utenti](#user-management-portal-section). -Quando il cluster è configurato per inviare notifiche email utilizzando un server SMTP esterno, l'indirizzo email dell'utente non viene rilevato automaticamente. Un amministratore deve impostarlo manualmente per ciascun utente utilizzando il [portale di gestione utenti](#user-management-portal-section). +Se l'attributo LDAP è vuoto o assente, l'indirizzo del destinatario viene ricavato da un'applicazione Mail associata al dominio utente. Si assume che l'indirizzo abbia la forma `@`. Poiché l'invio della notifica è interno, tale dominio non richiede necessariamente un record DNS MX pubblico. -Il campo dell'indirizzo email è disponibile sia per i domini utente OpenLDAP che Active Directory. +Se non è impostato il campo Indirizzo email né è associata un'applicazione Mail al dominio utente, la notifica non viene inviata. #### Template personalizzato {#password_warning_custom_template-section} From 177bad594d806f1eaa4d0e47d9baec3a91075521 Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:07:44 +0200 Subject: [PATCH 4/9] docs(user_domains): sync IT translation for phone extension Mirror c5d3890f (docs(user_domains): document phone extension, align Email naming) in the Italian translation, per AGENTS.md's requirement to keep the i18n/it mirror in sync with the English page. Also drops the stray "(solo AD)" qualifier from "La password non scade mai", which never applied to that field in the English source. Assisted-by: Claude Code:claude-sonnet-5 --- .../installation/user_domains.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md index 6dad478a3..e703a0dad 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md @@ -246,9 +246,10 @@ Quando si crea un utente, i seguenti campi sono obbligatori: Gli attributi opzionali sono: -- Indirizzo email -- Corrisponde all'attributo LDAP standard `mail`. Può essere impostato sull'indirizzo email personale dell'utente, dove vengono inviate le notifiche di scadenza della password. Alcune applicazioni possono anche utilizzarlo come nome utente valido per l'accesso. -- La password non scade mai (solo AD) -- Quando abilitato, la password dell'utente rimane valida indefinitamente, ignorando la politica di scadenza delle password del dominio. -- Cambio password obbligatorio / L'utente deve cambiare la password al prossimo accesso (solo AD) -- Quando abilitato, l'utente viene invitato a cambiare la propria password al prossimo accesso. +- `Indirizzo email` — Corrisponde all'attributo LDAP standard `mail`. Il modo in cui questo attributo viene utilizzato dipende dalle applicazioni che lo consultano. Ad esempio, può essere impostato sull'indirizzo email personale dell'utente, dove vengono inviate le notifiche di scadenza della password, come descritto nella sezione [Avviso di scadenza delle password](#password-warning-recipient); per far corrispondere i [domini di posta](../applications/mail.md#email_domains), può definire un indirizzo email alternativo dell'utente; altre applicazioni possono anche utilizzarlo come nome utente valido per l'accesso. +- `Interno telefonico` — L'interno telefonico dell'utente. È memorizzato nell'attributo LDAP `telephoneNumber`. Come per il campo `Indirizzo email`, consulta la documentazione dell'applicazione specifica. +- `La password non scade mai` — Quando abilitato, la password dell'utente rimane valida indefinitamente, ignorando la politica di scadenza delle password del dominio. +- `Cambio password obbligatorio` / `L'utente deve cambiare la password al prossimo accesso` (solo AD) — Quando abilitato, l'utente viene invitato a cambiare la propria password al prossimo accesso. Un utente può essere aggiunto a uno o più gruppi. @@ -302,9 +303,12 @@ Durante la creazione di un utente, sono disponibili i seguenti campi: - Password - Gruppo (campo opzionale) - Indirizzo email (campo opzionale) -- Password non scade mai (campo opzionale, solo AD) +- Interno telefonico (campo opzionale) +- Password non scade mai (campo opzionale) - Cambio password richiesto / L'utente deve cambiare la password al prossimo accesso (campo opzionale, solo AD) +Per maggiori informazioni sui campi, consulta la sezione [Creare utenti e gruppi](#create-users-and-groups-section). + Il portale è configurato automaticamente su ogni istanza di [Active Directory](#active_directory-section) o del provider [LDAP server RFC2307](#openldap-section). Il portale è disponibile al seguente URL: From 8d060a6a5fd05c7fa67b4c289b20f760c5141fad Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:23:12 +0200 Subject: [PATCH 5/9] docs(user_domains): note CSV compatibility, use em dash in CSV list MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Use the Unicode em dash (—) instead of "--" in the CSV field list, matching the dash style already used elsewhere in the page. Add a note that the Phone extension field is not part of the CSV import/export format, to keep it compatible with files exported by earlier versions. Assisted-by: Claude Code:claude-sonnet-5 --- .../installation/user_domains.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/administrator-manual/installation/user_domains.md b/docs/administrator-manual/installation/user_domains.md index 3966cf69b..e989de44f 100644 --- a/docs/administrator-manual/installation/user_domains.md +++ b/docs/administrator-manual/installation/user_domains.md @@ -275,16 +275,22 @@ User names must be unique within the same domain but can be reused across differ Users and groups can be managed in bulk with the *import* and *export data* actions. The supported data format is [CSV](https://www.rfc-editor.org/rfc/rfc4180) (comma-separated values) with the following fields: 1. *username* -2. *display_name* -- An empty value removes the LDAP `displayName` attribute. -3. *password* -- If the password contains a comma (e.g. `Nethesis,1234`), enclose this field in double quotes. An empty value leaves the password unchanged for existing users, and sets a random initial password for newly created users. -4. *mail* -- A valid email address. Note that unlike Samba Active Directory, the OpenLDAP RFC2307 schema does not allow special characters. An empty value removes the corresponding `mail` LDAP attribute. -5. *groups* -- A list of groups separated by the `|` (pipe) character. If a group does not exist yet, it is created on the fly during the import. If this field is empty, the user is removed from all groups. +2. *display_name* — An empty value removes the LDAP `displayName` attribute. +3. *password* — If the password contains a comma (e.g. `Nethesis,1234`), enclose this field in double quotes. An empty value leaves the password unchanged for existing users, and sets a random initial password for newly created users. +4. *mail* — A valid email address. Note that unlike Samba Active Directory, the OpenLDAP RFC2307 schema does not allow special characters. An empty value removes the corresponding `mail` LDAP attribute. +5. *groups* — A list of groups separated by the `|` (pipe) character. If a group does not exist yet, it is created on the fly during the import. If this field is empty, the user is removed from all groups. 6. *locked* (boolean) 7. *must_change_password* (boolean) 8. *no_password_expiration* (boolean) The fields must be present in the above, exact order. They correspond to the attributes described in the previous section; refer to [Create users and groups](#create-users-and-groups-section) for more information. +:::note + +For backward compatibility with the CSV format of earlier versions, the `Phone extension` field is not available in the CSV file. + +::: + The last three fields are boolean values. Accepted values are limited to the strings `true` and `false`. The empty string, and any value other than `true`, is interpreted as `false`. For example, this CSV file includes an optional header line with the eight mandatory fields, followed by one record for user `john`, who is a member of the `devs` and `web` groups. From f54744ec5e0f0ea08e3d0bf595dddf314ae51364 Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:23:16 +0200 Subject: [PATCH 6/9] docs(user_domains): sync IT translation for CSV note Mirror 8d060a6a (docs(user_domains): note CSV compatibility, use em dash in CSV list) in the Italian translation, per AGENTS.md's requirement to keep the i18n/it mirror in sync with the English page. Assisted-by: Claude Code:claude-sonnet-5 --- .../installation/user_domains.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md index e703a0dad..c4186acfc 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md @@ -267,16 +267,22 @@ I nomi utente devono essere univoci all'interno dello stesso dominio, ma possono Gli utenti e i gruppi possono essere gestiti in blocco con le azioni *import* e *export data*. Il formato dati supportato è [CSV](https://www.rfc-editor.org/rfc/rfc4180) (valori separati da virgola) con i seguenti campi: 1. *username* -2. *display_name* -- Un valore vuoto rimuove l'attributo LDAP `displayName`. -3. *password* -- Se la password contiene una virgola (es. `Nethesis,1234`), racchiudi questo campo tra virgolette doppie. Un valore vuoto lascia la password invariata per gli utenti esistenti e imposta una password iniziale casuale per gli utenti appena creati. -4. *mail* -- Un indirizzo email valido. Nota che, a differenza di Samba Active Directory, lo schema OpenLDAP RFC2307 non consente caratteri speciali. Un valore vuoto rimuove il corrispondente attributo LDAP `mail`. -5. *groups* -- Un elenco di gruppi separati dal carattere `|` (pipe). Se un gruppo non esiste ancora, viene creato automaticamente durante l'importazione. Se questo campo è vuoto, l'utente viene rimosso da tutti i gruppi. +2. *display_name* — Un valore vuoto rimuove l'attributo LDAP `displayName`. +3. *password* — Se la password contiene una virgola (es. `Nethesis,1234`), racchiudi questo campo tra virgolette doppie. Un valore vuoto lascia la password invariata per gli utenti esistenti e imposta una password iniziale casuale per gli utenti appena creati. +4. *mail* — Un indirizzo email valido. Nota che, a differenza di Samba Active Directory, lo schema OpenLDAP RFC2307 non consente caratteri speciali. Un valore vuoto rimuove il corrispondente attributo LDAP `mail`. +5. *groups* — Un elenco di gruppi separati dal carattere `|` (pipe). Se un gruppo non esiste ancora, viene creato automaticamente durante l'importazione. Se questo campo è vuoto, l'utente viene rimosso da tutti i gruppi. 6. *locked* (booleano) 7. *must_change_password* (booleano) 8. *no_password_expiration* (booleano) I campi devono essere presenti nell'ordine esatto sopra indicato. Corrispondono agli attributi descritti nella sezione precedente; consulta [Creare utenti e gruppi](#create-users-and-groups-section) per maggiori informazioni. +:::note + +Per compatibilità con il formato CSV delle versioni precedenti, il campo `Interno telefonico` non è disponibile nel file CSV. + +::: + Gli ultimi tre campi sono valori booleani. I valori accettati sono limitati alle stringhe `true` e `false`. La stringa vuota e qualsiasi valore diverso da `true` vengono interpretati come `false`. Ad esempio, questo file CSV include una riga di intestazione opzionale con gli otto campi obbligatori, seguita da un record per l'utente `john`, che è membro dei gruppi `devs` e `web`. From df4fc147317aa62f42edafeed235332b98695af9 Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:50:15 +0200 Subject: [PATCH 7/9] fix(user_domains): clarify when password warning needs a public MX The Mail application bound to the user domain is not necessarily the one the cluster uses for its own notification submission; the MX requirement only drops when the two coincide. Spell out the two cases instead of unconditionally calling the submission internal. Assisted-by: Claude Code:claude-sonnet-5 --- docs/administrator-manual/installation/user_domains.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/administrator-manual/installation/user_domains.md b/docs/administrator-manual/installation/user_domains.md index e989de44f..401c25a62 100644 --- a/docs/administrator-manual/installation/user_domains.md +++ b/docs/administrator-manual/installation/user_domains.md @@ -209,7 +209,10 @@ To activate it, open the user domain's configuration page and click the **Edit p The notification email recipient address is obtained from the user's `Email` field (LDAP `mail` attribute), which can also be modified by a domain administrator in the [User Management portal](#user-management-portal-section). -If the LDAP attribute is empty or missing, the recipient address is obtained from a Mail application bound to the user domain. The address is assumed to be in the form `@`. Since the notification submission is internal, that domain does not strictly require a public DNS MX record. +If the LDAP attribute is empty or missing, the recipient address is obtained from a Mail application bound to the user domain. The address is assumed to be in the form `@`. + +- If that Mail application is the same one configured for [email notifications](../configuration/email_notifications.md), the submission is internal and no public DNS MX record is required. +- Otherwise, delivery to `user_domain_name` follows conventional SMTP rules and does require a public DNS MX record. If neither the `Email` field is set nor a Mail application is associated with the user domain, no notification is sent. From 30adec283391819cf8a5abae71a59f23cb69c282 Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 13:50:18 +0200 Subject: [PATCH 8/9] fix(user_domains): sync IT translation for MX clarification Mirror df4fc147 (fix(user_domains): clarify when password warning needs a public MX) in the Italian translation, per AGENTS.md's requirement to keep the i18n/it mirror in sync with the English page. Assisted-by: Claude Code:claude-sonnet-5 --- .../administrator-manual/installation/user_domains.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md index c4186acfc..790d4621d 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md @@ -202,7 +202,10 @@ Per attivarla, apri la pagina di configurazione del dominio utente e clicca sul L'indirizzo del destinatario dell'email di notifica viene ricavato dal campo Indirizzo email dell'utente (attributo LDAP `mail`), che un amministratore di dominio può modificare anche dal [portale di gestione utenti](#user-management-portal-section). -Se l'attributo LDAP è vuoto o assente, l'indirizzo del destinatario viene ricavato da un'applicazione Mail associata al dominio utente. Si assume che l'indirizzo abbia la forma `@`. Poiché l'invio della notifica è interno, tale dominio non richiede necessariamente un record DNS MX pubblico. +Se l'attributo LDAP è vuoto o assente, l'indirizzo del destinatario viene ricavato da un'applicazione Mail associata al dominio utente. Si assume che l'indirizzo abbia la forma `@`. + +- Se tale applicazione Mail è la stessa configurata per le [notifiche email](../configuration/email_notifications.md), l'invio è interno e non è richiesto alcun record DNS MX pubblico. +- In caso contrario, la consegna a `user_domain_name` segue le normali regole SMTP e richiede un record DNS MX pubblico. Se non è impostato il campo Indirizzo email né è associata un'applicazione Mail al dominio utente, la notifica non viene inviata. From 5e98bb29d6e49bcf0c95e41710c0512d9eef468d Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Thu, 17 Sep 2026 16:26:14 +0200 Subject: [PATCH 9/9] fixup! docs(user_domains): simplify password expiration warning --- docs/administrator-manual/installation/user_domains.md | 2 +- .../current/administrator-manual/installation/user_domains.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/administrator-manual/installation/user_domains.md b/docs/administrator-manual/installation/user_domains.md index 401c25a62..3497af4c1 100644 --- a/docs/administrator-manual/installation/user_domains.md +++ b/docs/administrator-manual/installation/user_domains.md @@ -192,7 +192,7 @@ After editing the password policy, you can click on **Edit password policy** but ### Password expiration warning {#password-warning} -The system can send email notifications to users when their password is about to expire. This feature is available **only for internal user domains** and is configured separately for each one. +The system can send email notifications to users when their password is about to expire. This feature is available **only for internal user domains** and is configured separately for user domain. Before turning it on, make sure that: diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md index 790d4621d..cec5852dd 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/user_domains.md @@ -185,7 +185,7 @@ Dopo aver modificato la politica delle password, puoi cliccare sul pulsante **Mo ### Avviso di scadenza delle password {#password-warning} -Il sistema può inviare notifiche email agli utenti quando la loro password sta per scadere. Questa funzionalità è disponibile **solo per i domini utente interni** ed è configurata separatamente per ciascun dominio. +Il sistema può inviare notifiche email agli utenti quando la loro password sta per scadere. Questa funzionalità è disponibile **solo per i domini utente interni** ed è configurata separatamente per ciascun dominio utente. Prima di attivarla, assicurati che: