ITSM integration

Elimity Insights allows users to indicate necessary changes in the IAM data, like an AD user that should be deleted. Those change requests are stored by the Elimity Insights server. In addition, you can also integrate with your IT ticketing system by setting up automatic email sending for every new change request.

Configuring Elimity Insights

By default, the Elimity Insights server does not send out any email when a new change request is created. To enable this feature, set the following configuration option in your elimity.yml file:

# AccessReviewRequestedChangesEmail
# ----------------------------
#
# Data type: string
#
# Status: Optional
#
# Description: The email address to which notifications should be sent for every change request.
AccessReviewRequestedChangesEmail: [email protected]

Email format

The Elimity Insights server sends out change request emails in a specific format. They all have a subject line of Elimity / {organisationName}: requested change or Elimity / {organisationName}: access review: requested change; replacing {organisationName} with the value you used for the OrganisationName configuration option.

Each email only contains a text/plain body with the following contents:

Source: {sourceName}
{operationInfo}
Change - requested by: {requestedByName} {requestedByEmail}
Change - requested at: {requestedAt}
Change - comment: {comment}
{accessReviewInfo}
Change - reference: {changeUrl}

The table below provides additional information about each variable:

Variable	Description
{sourceName}	Name of the source to which the change request applies
{operationInfo}	Additional details about the requested operation
{requestedByName}	Name of the user that requested the change
{requestedByEmail}	Parenthesised email address of the user that requested the change; omitted if not applicable
{requestedAt}	Submission timestamp of the change request
{comment}	Generic comment for the change request
{accessReviewInfo}	Additional details about the change request's associated access review; omitted if not applicable
{changeUrl}	Reference URL for the change request