Documentation for #2293
This commit is contained in:
parent
71b262b23e
commit
4f3c996a6a
|
@ -4,27 +4,31 @@ SMTP server setup
|
||||||
Go in ``General Parameters`` > ``Advanced Parameters`` > ``SMTP``:
|
Go in ``General Parameters`` > ``Advanced Parameters`` > ``SMTP``:
|
||||||
|
|
||||||
|
|
||||||
* **Session key containing mail address**: choose which session field contains mail address
|
* **Session key containing mail address**: choose which session field contains
|
||||||
|
mail address
|
||||||
* **SMTP Server**: IP or hostname of the SMTP server
|
* **SMTP Server**: IP or hostname of the SMTP server
|
||||||
* **SMTP Port**: Port of the SMTP server
|
* **SMTP Port**: Port of the SMTP server
|
||||||
* **SMTP User**: SMTP user if authentication is required
|
* **SMTP User**: SMTP user if authentication is required
|
||||||
* **SMTP Password**: SMTP password if authentication is required
|
* **SMTP Password**: SMTP password if authentication is required
|
||||||
* **SSL/TLS protocol** and **SSL/TLS options**: Here you can enable SMTPS or startTLS
|
* **SSL/TLS protocol** and **SSL/TLS options**: Here you can enable SMTPS or
|
||||||
|
startTLS. A list of possible options can be found in the `IO::Socket::SSL
|
||||||
|
documentation <https://metacpan.org/pod/IO::Socket::SSL>`__.
|
||||||
|
|
||||||
|
|
||||||
.. tip::
|
.. tip::
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
- If no SMTP server is configured, the mail will be sent via the local
|
- If no SMTP server is configured, the mail will be sent via the local
|
||||||
sendmail program. Else, Net::SMTP module is required to use the SMTP
|
sendmail program. Else, Net::SMTP module is required to use the SMTP
|
||||||
server
|
server
|
||||||
- The SMTP server value can hold the port, for example:
|
- The SMTP server value can hold the port, for example:
|
||||||
``mail.example.com:25``
|
``mail.example.com:25``
|
||||||
- If authentication is configured, ``Authen::SASL`` and
|
|
||||||
``MIME::Base64`` modules are required
|
|
||||||
|
|
||||||
|
.. warning::
|
||||||
|
|
||||||
|
- Older versions of the Email::Sender library have limitations when it comes
|
||||||
|
to SMTPS or STARTTLS support. Versions lower than 1.300027 will not be
|
||||||
|
able to check the remote server certificate or use custom IO::Socket::SSL
|
||||||
|
options.
|
||||||
|
|
||||||
- **Mail headers**:
|
- **Mail headers**:
|
||||||
|
|
||||||
|
@ -33,3 +37,22 @@ Go in ``General Parameters`` > ``Advanced Parameters`` > ``SMTP``:
|
||||||
- **Reply address**: address seen in the "Reply-To" field
|
- **Reply address**: address seen in the "Reply-To" field
|
||||||
- **charset**: Charset used for the body of the mail (default:
|
- **charset**: Charset used for the body of the mail (default:
|
||||||
utf-8)
|
utf-8)
|
||||||
|
|
||||||
|
Testing your email setup
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
.. versionadded:: 2.0.10
|
||||||
|
|
||||||
|
You can test your email setup in the ``General Parameters`` > ``Advanced
|
||||||
|
Parameters`` > ``SMTP`` page by using the ``Send test email`` button in the
|
||||||
|
manager.
|
||||||
|
|
||||||
|
.. tip::
|
||||||
|
|
||||||
|
You need to save your SMTP configuration before you can test it
|
||||||
|
|
||||||
|
.. versionadded:: 2.0.10
|
||||||
|
|
||||||
|
You can also test your email setup using the ``test-email`` command in the CLI ::
|
||||||
|
|
||||||
|
lemonldap-ng-cli test-email dwho@badwolf.org
|
||||||
|
|
Loading…
Reference in New Issue
Block a user