There are two use cases for Email Gateway in ADSS Web RA, they are:

  • Sending Notification Emails - To send email notifications against the certificate requests to the requester and the administrators (application and local admins) 
  • Sending OTP via Emails - One Time Password (OTP) is a security layer that requires a new password every time users authenticate themselves, thus protecting them from the intruders replaying an intercepted password.

It is mandatory to have an SMTP Gateway to send the email notifications while it is optional to configure the OTPs.


If OTP via Emails option is enabled but SMTP Gateway is not configured in the Service Plan then default SMTP Gateway will be used to send the OTP.

The OTP via Email authentication can be configured at three levels i.e.:

  • Login to the ADSS Web RA Web
  • Revoking a certificate
  • Renewing a certificate


Create an SMTP Server Connector


  1. Expand External Services > Connectors from the left menu.
  2. Click  from the grid header. 
  3. A dialog will appear to add the connector details. The connector dialog consists of two screens, i.e. Basic Information and Details. Specify the basic information and click Next to provide the respective connector details. See the below table for fields description.
  4. A Send Email button will also appear at the bottom of the screen. Click this button to ensure if the SMTP server address and email address are correct. If the configurations are correct, an email will be sent to the email address. 
  5. Click Finish. A new connector will be saved and displayed in the list.


Basic Information

Field

Description

Name

Specify a unique name for this connector, i.e. My SMTP Server. This connector will be used in Global Settings > Default Connectors and in the configuration of service plans.

Provider

Select SMTP Server as a provider for this connector.

Active

Tick this check box to make this connector active. Inactive connectors cannot be configured Global Settings or in the service plans.



 Details

Field

Description

SMTP Server Address

Specify the SMTP host server, i.e. mail.example.com

SMTP Server Port

Specify the server port number to connect with Web RA. The default SMTP port is 25.

Use SSL/TLS

Select this check box to enable the communication over TLS if SMTP server mandates it

Authentication required

Select this check box to enable server authentication. The system will require User ID and Password to access the SMTP server.

User ID

Specify the User ID that has been provided by the SMTP server to authenticate the SMTP server, i.e. admin@example.com

This is only required if the Authentication is enabled

Password

Specify the password of the above user to authenticate the user on SMTP server.

This is only required if the Authentication is enabled

From Email Address

Specify the email address that will be as used as a From Address when the emails will be sent to the end users by Web RA, i.e. noreply@example.com



Configure SMTP Server Connector in Default Settings


  1. Expand Configurations > Default Settings from the left menu.
  2. In Email Gateway field under Others section, select an SMTP Server connector which you want to use in ADSS Web RA to send email notifications. Only the active SMTP Server connectors are listed for selection.
  3. Click Save.