1
0
mirror of https://blitiri.com.ar/repos/chasquid synced 2025-12-17 14:37:02 +00:00
Files
go-chasquid-smtp/docs/man/chasquid-util.1.md
Alberto Bertogli 83ae4c3478 userdb: Add support for receive-only users
Some use cases, like receive-only MTAs, need domain users for receiving
emails, but have no real need for passwords since they will never use
submission.

Today, that is not supported, and those use-cases require the
administrator to come up with a password unnecessarily, adding
complexity and possibly risk.

This patch implements "receive-only users", which don't have a valid
password, thus exist for the purposes of delivering mail, but always
fail authentication.

See https://github.com/albertito/chasquid/issues/44 for more details and
rationale.

Thanks to xavierg who suggested this feature on IRC.
2023-12-03 11:59:26 +00:00

66 lines
1.6 KiB
Markdown

# NAME
chasquid-util - chasquid management tool
# SYNOPSIS
**chasquid-util** \[_options_\] user-add _user@domain_ \[--password=_password_\] \[--receive\_only\]
**chasquid-util** \[_options_\] user-remove _user@domain_
**chasquid-util** \[_options_\] authenticate _user@domain_ \[--password=_password_\]
**chasquid-util** \[_options_\] check-userdb _domain_
**chasquid-util** \[_options_\] aliases-resolve _addr_
**chasquid-util** \[_options_\] domaininfo-remove _domain_
**chasquid-util** \[_options_\] print-config
# DESCRIPTION
chasquid-util is a command-line utility for [chasquid(1)](chasquid.1.md) operations.
# OPTIONS
- **user-add** _user@domain_ \[--password=_password_\] \[--receive\_only\]
Add a new user to the domain.
If _--receive\_only_ is given, then the user will never successfully
authenticate. This is useful when creating receive-only users.
- **user-remove** _user@domain_
Remove the user from the domain.
- **authenticate** _user@domain_ \[--password=_password_\]
Check the user's password.
- **check-userdb** _domain_
Check the integrity of the domain's users database.
- **aliases-resolve** _addr_
Resolve the given address. Talks to the running chasquid instance.
- **domaininfo-remove** _domain_
Remove the domain information entry. This can be used to manually allow a
security level downgrade. Talks to the running chasquid instance.
- **print-config**
Parse and print the configuration in a human-readable way.
- **-C** or **--configdir=<path**>
Configuration directory.
# SEE ALSO
[chasquid(1)](chasquid.1.md)