2020-05-29 15:33:40 +00:00
|
|
|
cdist-type__dma_auth(7)
|
|
|
|
=======================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2020-05-30 16:27:13 +00:00
|
|
|
cdist-type__dma_auth - Configure SMTP logins for the DragonFly Mail Agent MTA.
|
2020-05-29 15:33:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2020-05-30 16:27:13 +00:00
|
|
|
This cdist type allows you to set up credentials to log in to remote SMTP
|
|
|
|
servers.
|
2020-05-29 15:33:40 +00:00
|
|
|
|
2020-09-28 08:59:13 +00:00
|
|
|
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.
|
|
|
|
|
2020-05-29 15:33:40 +00:00
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
2020-05-31 09:57:54 +00:00
|
|
|
login
|
|
|
|
The user's LOGIN name on the SMTP server.
|
2020-05-30 16:27:13 +00:00
|
|
|
password
|
|
|
|
The user's password (in plain text.)
|
2020-05-29 15:33:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2020-05-30 16:27:13 +00:00
|
|
|
state
|
2020-10-01 15:21:19 +00:00
|
|
|
Either ``present`` or ``absent``. Defaults to ``present``.
|
2020-05-29 15:33:40 +00:00
|
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
|
|
------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
|
|
|
.. code-block:: sh
|
|
|
|
|
2020-05-30 16:27:13 +00:00
|
|
|
# Set the password for smarthost
|
2020-05-31 09:57:54 +00:00
|
|
|
__dma_auth smarthost.example.com --login joe --password hunter2
|
2020-05-30 16:27:13 +00:00
|
|
|
|
|
|
|
# Set credentials for user at an external provider
|
2020-05-31 09:57:54 +00:00
|
|
|
__dma_auth mail.provider.com --login paul@example.com --password letmein
|
2020-05-29 15:33:40 +00:00
|
|
|
|
2020-05-31 09:57:54 +00:00
|
|
|
# Delete credentials for example.com (for all users)
|
|
|
|
__dma_auth example.com --login '' --password '' --state absent
|
2020-05-29 15:33:40 +00:00
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2020-05-30 16:27:13 +00:00
|
|
|
:strong:`cdist-type__dma`\ (7), :strong:`dma`\ (8)
|
2020-05-29 15:33:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
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.
|