Email settings

Configure and test the SMTP server that sends UserLock notifications for policy, session, user status, and service events.

Published June 27, 2025

Note
  • To access this page, go to Server settings ▸ Email settings.

  • You need at least read permission on Server settings to view this page.

SMTP server

To send email notifications, UserLock uses the SMTP protocol, which must be configured here by providing the following information:

Setting

Description

Server

The IP address or hostname of the server that will send these notifications. For OAuth 2.0, enter smtp.office365.com (Microsoft 365) or smtp.gmail.com (Google).

Port

The TCP port used to send email: usually 25 (unencrypted), 465 (implicit SSL) or 587 (submission port, typically used with Microsoft 365 and Google).

From

The email address used to send these notifications. Must be valid. With OAuth 2.0, this is the mailbox that signs in to the provider.

SSL encryption

Enables the SSL security protocol.

Authentication

The authentication method the UserLock server will use to connect to the SMTP server.
The following options are available:

  • No authentication

  • Windows authentication: UserLock connects with the service impersonation account.

  • Provide credentials

  • Modern authentication (OAuth 2.0): Microsoft 365 and Google only.

User name / Password

The credentials of the account used to connect to the SMTP server. Required when selecting the Provide credentials option.

Client ID

The client ID of the application registered with Microsoft Entra or Google Cloud. Required when selecting the Modern authentication (OAuth 2.0) option.

Tenant ID / Secret

The second credential of the registered application. Its label depends on the Server address:

  • Tenant ID with smtp.office365.com: the Directory (tenant) ID of the Microsoft Entra app.

  • Secret with smtp.gmail.com: the client secret of the Google Cloud app.

Sign in

Opens the provider's sign-in window. Sign in with the account entered in From and consent to the requested permissions.

For the full procedure, see Configure SMTP settings Guide.

Notes
  • The Modern authentication (OAuth 2.0) option can only be configured from the UserLock console on the server. In the Web console, the option is visible but disabled.

  • The Reset settings button allows you to restore the default values for this configuration.

Test the configuration

You can test your SMTP settings at any time by entering an email recipient and clicking the Send test email button.

The result of the test will be displayed in a toast notification in the bottom-right corner.

Best practices and warnings

  • Use a dedicated sender account (e.g., userlock-noreply@yourdomain.com) instead of a personal mailbox.

  • Always test configuration with Send test email before relying on it.

  • With Provide credentials, prefer a service account with a non-expiring password.

  • With Modern authentication (OAuth 2.0), always sign in with the same mailbox as in From.

  • Make sure outbound SMTP is allowed by your firewall.