Configuring SMTP settings for email notifications

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

  1. Log in to the Red Hat OpenShift Container Platform as OpenShift Administrator.
  2. Click Home > Projects and select your IBM Security QRadar Suite project, for example cp4s.
  3. Click Workloads > ConfigMaps.
  4. Use the filter to search for the isc-cases-customer-smtp-settings ConfigMap, and select the ConfigMap.
  5. From the Actions menu, click Edit ConfigMap.
  6. 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.
  7. Save the ConfigMap.

    The application pod restarts automatically when you save the ConfigMap.

  8. Click Workloads > Secrets and search for and select the isc-cases-customer-smtp-credentials secret.
  9. 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.
  10. 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.