This site requires JavaScript to be enabled
External Customer KB > General > Notifications
Notifications
Article: KB0010459 Published: 09/29/2023 Last modified: 09/29/2023

OneLogin notifications are automated emails sent to users or administrators whenever certain conditions are fulfilled, such as alerting an account owner when their organization has run out of seat licenses, or notifying a locked-out user when their account has been unlocked. Your OneLogin account comes preconfigured with several existing notifications, but you can customize these for your organization's needs or create new notifications for various other events, such as when an Active Directory Connector fails.

 


 

Default Notifications

When your OneLogin tenant is created, it has the following notification emails prewritten and ready to send. Most are active by default, but some must be manually enabled before you or your users receive them.

Notify account owner of locked user

Sent to the account owner when a user has been locked out of OneLogin, providing a link for the user record where their account can be unlocked

*Disabled by default

Notify account owner for certificates about to expire

Sent to the account owner when a OneLogin certificate is due to expire, providing the certificate's name and link, the days remaining before expiration, and information on how to update certificates in OneLogin

Notify user of unlocked account

Sent to a user when their account has been unlocked, providing a sign-in link where they can access their account

*Disabled by default

Account approaching seat limit

Sent to the account owner when their OneLogin subscription is close to running out of seat licenses, providing the current and maximum number of seats on the current subscription and a link to their subscription management portal

Account at seat limit

Sent to the account owner when their OneLogin subscription has run out of seat licenses, providing a link to their subscription management portal

Notification for broken provisioning apps

Sent to the account owner when any application encounters a configuration error causing a provisioning failure, providing the app's error message and a link to configure the app's provisioning settings in OneLogin

Notification for throttled provisioning apps

Sent to the account owner when an app experiences temporary provisioning issues due to application throttling

 


 

Managing Notifications

To view and manage your notifications, go to Activity > Notifications in your OneLogin admin portal. Select any notification to view its details, and go to the More Actions menu for additional settings:

Enable/Disable

Activates or deactivates the current notification

Clone

Creates a new notification as a duplicate of the current notification

Delete

Permanently removes the current notification

 


 

Configuring Notifications

Click New Notification or select any existing notification to configure its conditions or message contents. You can also select the notification's title to rename it if desired; titles appear in your notification management but are not displayed to recipients, so should be descriptive of the notification's purpose.

Conditions

Use the + icon to add one or more conditions that will prompt the notification email to be sent.

All notifications must use at least one Event or Status condition. Notifications with only Group or Roles as conditions will not perform any actions.

Event

Select any event, and the notification will be triggered whenever the event occurs.

  • Event conditions cannot be combined with any other condition type. If any other condition is added to a notification that includes at least one Event, that condition is ignored.
  • When adding multiple Event conditions to a single notification, the notification is triggered when any one of the chosen events is fulfilled.

Status

Select any user status with the changed to or changed from conditional to trigger the notification when a user's status changes to or from that selection.

  • Only one each of the Status changed to and Status changed from conditions may apply.
    • For example, you may limit a notification to occur only when a user is changed from one selected status to another, but the notification will not trigger if you add multiple changed to or multiple changed from conditions.
  • When using a Status condition in combination with any other condition, the notification is sent only when all conditions are fulfilled.
    • For example, if you add both a Group is condition and a Roles include condition, the notification will trigger only for members of that group who are also assigned to the selected role.

Group

Select any group with the is or is not conditional to include or exclude users in that group from the notification conditions.

  • Group conditions must be paired with at least one Status condition; if no status change is selected, the notification will not be triggered.
  • You may only configure one Group is condition. If multiple Group is conditions are selected, the notification will not be triggered.
  • When adding multiple Group is not conditions to a single notification, the notification is triggered only when the affected user is not a member of any selected group.

Roles

Select any role with the include or do not include conditional to include or exclude users in assigned to that role from the notification conditions.

  • Roles conditions must be paired with at least one Status condition; if no status change is selected, the notification will not be triggered.
  • When adding multiple Roles conditions to a single notification, the notification is triggered only when all Roles selections apply to the user's role assignments.

Actions

All notifications have one action configured by default, but more can be added with the + icon. For example, you may wish to include additional actions if you would like one email sent to the account owner and a different email simultaneously sent to the user when a particular event occurs.

Recipient

Select the email's recipient in the dropdown menu to the right of Email user. In addition to group admins for any specific groups you have configured, you can also choose from the following options:

Account owner

Notifies the owner of your organization's OneLogin tenant

Custom

Provides a text field for you to enter one or more email addresses, separated by commas

Tip! You can also use this field to indicate a custom field such as a secondary email address by entering {{user.custom_attribute_shortname}} with the shortname of your desired custom attribute.

Group admin

Notifies the administrator of the affected group

Super users

Notifies all users with super user privileges or above

User

Notifies the affected or acting user

Message

Customize the Subject and Body fields with your desired content. Notification emails are compatible with markdown formatting and template macros, and styled according to the email template customized in Branding.


Expand/Collapse Comments
:     
Was this helpful?
YesYesNoNo