Enabling Microsoft Teams Notifications in IdentityIQ

To enable IdentityIQ notifications to be sent on Microsoft Teams, you will need to select the option on the Global settings page in IdentityIQ.

Configuring Adaptive Card Template

  1. Select the gear icon and navigate to Global Settings > IdentityIQ Configuration > Notifications Settings.

  2. Select Enable Microsoft Teams Notifications. This will enable the users to receive IdentityIQ notifications on Microsoft Teams.

  3. Select the appropriate templates for Adaptive card notifications for different events from the respective dropdown and accordingly it will be sent on Microsoft Teams. Microsoft Teams Adaptive Card Templates determine the contents of the notifications that are sent in Microsoft Teams. The screen displays four types of the adaptive card templates for different events:

    1. For access request approval work item notices – sends adaptive card to the approver on Microsoft Teams when a new Access Request Approval work item is created in IdentityIQ.

    2. For access request approval work item forwarding notices – sends adaptive card to the approver on Microsoft Teams when the Access Request Approval work item is forwarded to the approver from within IdentityIQ or Microsoft Teams.

    3. For access request approval work item assignment notices – sends adaptive card to the approver on Microsoft Teams when an Access Request Approval work item is assigned to the user from within IdentityIQ or Microsoft Teams.

    4. For access request approval work item assignment removal notices – sends adaptive card to the approver on Microsoft Teams when an Access Request Approval work item is unassigned from within IdentityIQ or Microsoft Teams.

      Note: The adaptive card templates can be customized as necessary.

Editing Adaptive Card Template Content in Debug Page

Users can set notification messages sent on IndentityIQ application in Microsoft Teams for Access Request Approvals by editing Adaptive Card Template content in debug page.

To change the template content, perform the following steps:

  1. Log in as an IdentityIQ administrator.

  2. Navigate to the Debug pages through the Debug URL: https://<hostname>/identityiq/debug.

  3. From the Configuration Objects dropdown list, select AdaptiveCardNotificationTemplate. A list of available templates displays.

  4. Select the template name you want to change. An XML editor opens.

  5. Change the template to render the notification message you want to set for that template/event.

    Follow the velocity template inside the <Body> tag of the XML to generate JSON object that represent the adaptive card.

Configuring Email Template Notifications

If Adaptive card template is not configured, IdentityIQ sends notifications to Microsoft Teams users as per the Notification Template set in Global Settings > IdentityIQ Configuration > Notifications Settings.

You can select only one notification template for each type of notification (for example, For reminder notices, For escalation notices, etc.).

For information on how to edit Notification Templates, see Notification Settings.

Formatting Options for Microsoft Teams Notifications

There is a property in the .env file that identifies the format of notification messages: NOTIFICATION_TEXT_FORMAT. The valid values are xml, markdown, and plain.

If the property has not been set in the .env file, or is not a valid value, it will default to markdown. For more details on how the text format is used by Teams, refer to Microsoft's documentation on formatting bot messages.

For more information on editing .env properties, see Installing and Configuring the IdentityIQ Service Code.

You now have successfully enabled Microsoft Teams notifications. For next step, refer Installing the IdentityIQ Application in Microsoft Teams.