Threat Detected Message Template

On this page
Enterprise plan required

This feature requires an Enterprise plan.

FusionAuth sends this message when a user logs in from a new device, or when a login is suspicious. The default template handles both cases by checking event.type. Assign the template in Login with new device, Suspicious login, or both, on the Tenants -> Your Tenant -> Identities tab. To override the template for one Application, set the template on the Applications -> Your Application -> Identities tab. For more about the events, see Advanced Threat Detection.

Default Template#

FusionAuth ships the following default template:

[#setting url_escaping_charset="UTF-8"]
[#if event.type == "UserLoginSuspicious"]
A suspicious login was made on your account. If this was you, you can safely ignore this message. If this wasn't you, we recommend that you change your password as soon as possible.
[#elseif event.type == "UserLoginNewDevice"]
A login from a new device was detected on your account. If this was you, you can safely ignore this message. If this wasn't you, we recommend that you change your password as soon as possible.
[#else]
Suspicious activity has been observed on your account. In order to secure your account, it is recommended to change your password at your earliest convenience.
[/#if]

Device details

* Device name: ${(event.info.deviceName)!'-'}
* Device description: ${(event.info.deviceDescription)!'-'}
* Device type: ${(event.info.deviceType)!'-'}
* User agent: ${(event.info.userAgent)!'-'}

Event details

* IP address: ${(event.info.ipAddress)!'-'}
* City: ${(event.info.location.city)!'-'}
* Country: ${(event.info.location.country)!'-'}
* Zipcode: ${(event.info.location.zipcode)!'-'}
* Lat/long: ${(event.info.location.latitude)!'-'}/${(event.info.location.longitude)!'-'}

- FusionAuth Admin

Replacement Variables#

application
  • Type: Application

The Application object. For field definitions, see the Application API.

The variable is present only when the request that sends the message identifies an Application. Check for the variable before you use it:

[#if application??]
  ${application.name}
[/#if]
baseUrl
  • Type: String
  • Available since 1.68.0

The base URL for links in the message. FusionAuth uses the Application baseURL, then the Tenant baseURL, then http://localhost:9011.

event
  • Type: Object

The User Login New Device or User Login Suspicious event. Device and location details are in event.info.

phoneNumber
  • Type: String
  • Available since 1.59.0

The phone number FusionAuth sends the message to. The Generic messenger request has the same value in phoneNumber.

tenant
  • Type: Tenant

The Tenant object. For field definitions, see the Tenant API.

user
  • Type: User

The User object for the recipient. For field definitions, see the User API.