RapidIdentity Administrators' and Users' Guide

Configure an SMTP Server

RapidIdentity uses SMTP services to send email notifications for a range of activities including password resets, approval requests, and status notifications. You will need to have access credentials to an SMTP server in order to configure it with RapidIdentity.


SMTP Server Settings are not configurable when using a Cloud tenant.

  1. Log in to RapidIdentity via a web browser: https://<your-host-name> and navigate to the Configuration module from the drop-down menu.

  2. Click SMTP in the Systems section.

  3. Fill out the resulting form as described below. Click Save when all fields have been populated.


SMTP settings specify the mail server RapidIdentity uses to send email messages.


Field Name


Server Address

The server address refers to the server that hosts the SMTP service. The entry can be a fully qualified domain name (e.g. smtp.example.com) or an IP address. It is important to verify that the networking infrastructure (i.e. firewalls, etc) allow communication between the RapidIdentity Portal server and the SMTP server referenced in this field.

Encryption Method

RapidIdentity Portal supports SSL and TLS encryption methods. The default setting is no encryption, which allows the use of self-signed certificates.


Use TLS for Gmail.


The TCP port to use for SMTP communication to the specified server.


Use port 587 for Gmail.

From Address

The email address that RapidIdentity Portal emails will originate from. This address will default to noreply@tenantid.rapididentity.com.

Use Authentication

Some SMTP servers require user authentication. This option enables fields for username and password that are passed to the SMTP server for authentication when sending an email.


The username field displays when the Use Authentication field is checked.


The Password button displays when the Use Authentication field is checked. When this button is clicked, a new field appears to allow the user to add or change the password associated with the username.

Send test email to

This field can receive any valid Email address to validate the SMTP server and view the test Email contents.


Once this field is populated, the Send Test Message button will activate and you can send a test email to verify the connection.