74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
# Configuration to Send/Relay Emails
|
|
|
|
## Sending Emails Via PSI Central Mail Gateway
|
|
To be able to send emails, the server needs to be registered on the PSI mail gateways.
|
|
|
|
This can be done by this ServiceNow request:
|
|
(Service Catalog > IT Systems & Data Storage > Register E-Mail Sender)
|
|
|
|
https://psi.service-now.com/psisp?id=psi_new_sc_cat_item&sys_id=68d60ca74f8833407f7660fe0310c7e3
|
|
|
|
The default PSI mail gateways for the different network segments are defined in the puppet common.yaml. Depending on the machines location a different default will take effect. The defaults are as follows:
|
|
|
|
```
|
|
mta::relays:
|
|
'default': 'smtpint.psi.ch'
|
|
'dmz': 'smtpdmz.psi.ch'
|
|
'extranet': 'smtpdmz.psi.ch'
|
|
'tier3': 'smtpdmz.psi.ch'
|
|
```
|
|
|
|
To enable the possibility to send emails from a machine to one of the standard gateways the flag `base::enable_mta` simply needs to be enabled. No other configuration is needed.
|
|
|
|
```yaml
|
|
base::enable_mta: true
|
|
```
|
|
|
|
The default name of the sending mail server is the hostname of the machine running postfix. To rename it use `mta::myhostname`.
|
|
|
|
```yaml
|
|
mta::myhostname: 'foobar.psi.ch'
|
|
```
|
|
|
|
## Sending Emails Via An Other SMTP Relay
|
|
|
|
If your machine is in the default network zone (i.e. PSI intranet) sending via a differnet mail gateway than the default can be done like this:
|
|
|
|
```yaml
|
|
base::enable_mta: true
|
|
mta::relays:
|
|
'default': 'test-smtp-relay.psi.ch'
|
|
```
|
|
|
|
Wether the email is accepted by the mail relay depends on the relays configuration. Contact the relay admin what the rules for his gateway are.
|
|
|
|
|
|
## Configure Server as Mail Relay
|
|
|
|
The following configuration is needed if you want to setup a email relay server accepting emails from clients.
|
|
Depending on the rule where your relay should forward messages, your server/relay must be registered/authorized on the relay it forwardes messages to. (e.g. PSI default mail relay, procedure see above)
|
|
|
|
```yaml
|
|
base::enable_mta: true
|
|
|
|
# if you want to use an other forward relay than the PSI defaults
|
|
# mta::relays:
|
|
# 'default': 'test-smtp-relay.psi.ch'
|
|
|
|
# interfaces postfix should accept emails
|
|
mta::inet_interfaces: # array[string] default: loopback-only
|
|
# networks from which this relay should accept emails
|
|
mta::mynetworks: # default: undefined
|
|
```
|
|
|
|
Example (assumption the servers ip address is 10.1.2.110):
|
|
```yaml
|
|
mta::inet_interfaces:
|
|
- '10.1.2.110'
|
|
- 'localhost'
|
|
# mta::mynetworks_style: 'subnet'
|
|
mta::mynetworks:
|
|
- '10.1.2.0/24'
|
|
- '10.1.3.0/24'
|
|
```
|