Threat Detected Message Template
On this page
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#
applicationThe 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]
baseUrlThe base URL for links in the message. FusionAuth uses the Application baseURL, then the Tenant baseURL, then http://localhost:9011.
eventThe User Login New Device or User Login Suspicious event. Device and location details are in event.info.
phoneNumberThe phone number FusionAuth sends the message to. The Generic messenger request has the same value in phoneNumber.
tenantThe Tenant object. For field definitions, see the Tenant API.
userThe User object for the recipient. For field definitions, see the User API.
Related
Learn when FusionAuth sends the email for a login from a new device or a suspicious login, and which variables the template receives.
Learn when FusionAuth sends the message that tells a user someone tried to sign up with their login Id, and which variables the template receives.
Learn when FusionAuth sends the message that tells a user another account tried to take their login Id, and which variables the template receives.
Learn when FusionAuth sends the message that confirms a password reset, and which variables the template receives.