To configure an SMTP server for email notifications, you must edit a configmap and secret
on the Red Hat® OpenShift® Container Platform application pod.
Before you begin
You must have an SMTP email server set up and available for email notifications. You must
also ensure that the SMTP server is reachable from the cluster.
About this task
For more information about creating notifications, see Creating a notification.
This task describes how to edit the ConfigMap and secret for email notifications from the
Red Hat OpenShift Container Platform interface and is provided as an
example based on Red Hat OpenShift Container Platform v4.3.x.
Procedure
-
Log in to the Red Hat OpenShift Container Platform as
OpenShift Administrator.
- Click Home > Projects and select your IBM Security QRadar Suite project, for example
cp4s
.
- Click Workloads > ConfigMaps.
- Use the filter to search for the
isc-cases-customer-smtp-settings
ConfigMap, and select the ConfigMap.
- From the Actions menu, click Edit
ConfigMap.
- Enter values for all of the SMTP settings, except for TLS certificate and user password,
as shown in the following table.
-
Table 1. SMTP settings
Setting |
Value |
SMTP_HOST |
Enter the SMTP server host name, for example email.test.ibm.com . |
SMTP_APPROVED_HOST_LIST |
Enter additional or alternative host names. |
SMTP_PORT |
Enter the SMTP server port number. |
SMTP_FROM |
Enter the email address of the account to send email notifications from the SMTP
server. |
SMTP_NAME |
Enter a name for the from name of the account to send email notification from the SMTP
server. |
SMTP_USER |
Enter the user name required to establish a connection with the SMTP server, for example,
admin@testemail.com . |
SMTP_TIMEOUT_MS |
Enter a timeout value in milliseconds, after which the attempt to establish a connection with
the SMTP server times out. |
SMTP_NO_DEFANG_DOMAINS_LIST |
Enter an allow list of domain names and IP addresses. For more information, see Defang URLs in email notifications. |
- Save the ConfigMap.
The application pod restarts automatically when you save the ConfigMap.
- Click Workloads > Secrets and search for and select the
isc-cases-customer-smtp-credentials
secret.
- Click Actions > Edit Secret and configure the settings shown in
the following table.
Table 2. SMTP secret settings
Key |
Value |
smtp_user_password |
Enter the user password required to establish a connection with the SMTP server. |
tls.crt |
Specify the TLS certificate required to establish a connection with the SMTP server. |
- Save the secret.
The application pod does not need to restart automatically when you save the secret but a
reconciliation loop is required for the changes to be applied.
Check the cases-application-client-log-tailer
file in the
isc-cases-application
pod for troubleshooting information about SMTP server
configuration.
If you experience failed attempts to send email notifications, ensure that the SMTP server is
reachable from the application cluster.