66 lines
1.5 KiB
ReStructuredText
66 lines
1.5 KiB
ReStructuredText
cdist-type__dma_auth(7)
|
|
=======================
|
|
|
|
NAME
|
|
----
|
|
cdist-type__dma_auth - Configure SMTP logins for the DragonFly Mail Agent MTA.
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This cdist type allows you to set up credentials to log in to remote SMTP
|
|
servers.
|
|
|
|
NB: dma currently (v0.13) does not differentiate between users on a host.
|
|
It will use whatever user it finds in the ``auth.conf`` first.
|
|
Thus, this type will use the ``__object_id`` as the host specifier.
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
-------------------
|
|
login
|
|
The user's LOGIN name on the SMTP server.
|
|
password
|
|
The user's password (in plain text.)
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
-------------------
|
|
state
|
|
Either ``present`` or ``absent``. Defaults to ``present``.
|
|
|
|
BOOLEAN PARAMETERS
|
|
------------------
|
|
None.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
.. code-block:: sh
|
|
|
|
# Set the password for smarthost
|
|
__dma_auth smarthost.example.com --login joe --password hunter2
|
|
|
|
# Set credentials for user at an external provider
|
|
__dma_auth mail.provider.com --login paul@example.com --password letmein
|
|
|
|
# Delete credentials for example.com (for all users)
|
|
__dma_auth example.com --login '' --password '' --state absent
|
|
|
|
SEE ALSO
|
|
--------
|
|
:strong:`cdist-type__dma`\ (7), :strong:`dma`\ (8)
|
|
|
|
|
|
AUTHORS
|
|
-------
|
|
Dennis Camera <dennis.camera@ssrq-sds-fds.ch>
|
|
|
|
|
|
COPYING
|
|
-------
|
|
Copyright \(C) 2020 Dennis Camera. You can redistribute it
|
|
and/or modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|