Subject
I would like to contribute to the project
Description
I was curious where USER_ATTRIBUTES was used / supported elsewhere in DMS beyond the quota feature support.
|
local LOGIN PASS USER_ATTRIBUTES |
I tracked it back to a community contribution in Feb 2021: #1792 (comment)
That PR adds support for a third column in postfix-accounts.cf to provide Dovecot UserDB extra fields (the attributes should be space delimited as shown in the linked example).
# This would be appended to a line in `postfix-accounts.cf` (each attribute space delimited):
|userdb_mail=mbox:~/mail userdb_quota_rule=*:storage=100M userdb_namespace/default/separator=/
It does not seem like the wiki contribution was added back then to document it, if it was we seem to have lost it at some point.
The tests and feature logic also lack this context, so inline docs to better highlight the intention would be beneficial for maintainers.
|
[email protected]|{SHA512-CRYPT}$6$lZwv0IoijHyEjDtM$vGsAS7KM5O5Q1NdWjard1LbJyGiHcqHhKAXBKDIMudjB/CuVvOvXKVy2yKeeRvKxVtkCdYac738VQPL.kpSVB.|userdb_mail=mbox:~/mail:INBOX=~/inbox |
The feature also comes with some caveats to document for users. Some of DMS scripts will assume attributes like the mailbox location follows our conventional path, unaware of any customization: #1809 (comment)
Alternatively we don't have to document this publicly, or we could drop the support. ACCOUNT_PROVISIONER=LDAP supports similar functionality AFAIK (custom query config), so it is probably relevant to keep and just document the caveats for awareness?
Subject
I would like to contribute to the project
Description
I was curious where
USER_ATTRIBUTESwas used / supported elsewhere in DMS beyond the quota feature support.docker-mailserver/target/scripts/helpers/accounts.sh
Line 33 in 34423c2
I tracked it back to a community contribution in Feb 2021: #1792 (comment)
That PR adds support for a third column in
postfix-accounts.cfto provide Dovecot UserDB extra fields (the attributes should be space delimited as shown in the linked example).It does not seem like the wiki contribution was added back then to document it, if it was we seem to have lost it at some point.
The tests and feature logic also lack this context, so inline docs to better highlight the intention would be beneficial for maintainers.
docker-mailserver/test/config/templates/postfix-accounts.cf
Line 3 in 34423c2
The feature also comes with some caveats to document for users. Some of DMS scripts will assume attributes like the mailbox location follows our conventional path, unaware of any customization: #1809 (comment)
Alternatively we don't have to document this publicly, or we could drop the support.
ACCOUNT_PROVISIONER=LDAPsupports similar functionality AFAIK (custom query config), so it is probably relevant to keep and just document the caveats for awareness?