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

1.6 KiB

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) 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)