Manager Correlation Rule

Overview

This rule calculates a manager relationship between identities.

Use this rule to correlate an identity's manager for the following scenarios:

• The authoritative source has multiple accounts for an identity and you must pick the manager data from the active account.
• You need to do a lookup from an employee number to other data.
• The identity changes types, for example, from consultant to employee with the manager coming from a different authoritative source.

The manager correlation rule runs before configured manager account correlation.

Execution

• Cloud Execution - This rule executes in the Identity Security Cloud cloud, and it has read-only access to Identity Security Cloud data models, but it does not have access to on-premise sources or connectors.
• Logging - Logging statements are currently only visible to SailPoint personnel.

Input

Argument	Type	Purpose
log	org.apache.log4j.Logger	Logger to log statements. Note: This executes in the cloud, and logging is currently not exposed to anyone other than SailPoint.
idn	sailpoint.server.IdnRuleUtil	Provides a read-only starting point for using the SailPoint API. From this passed reference, the rule can interrogate the Identity Security Cloud data model including identities or account information via helper methods as described in IdnRuleUtil.
link	sailpoint.object.Link	Read-only representation of account data that has been aggregated. Use this as a basis to determine manager linkages to a specific manager identity.
managerAttributeValue	java.lang.Object	Attribute value stored in the manager attribute.

Output

Argument	Type	Purpose
returnMap	java.util.Map	Map object containing a reference to the identity attributes to identify the manager's identity. These should contain both identityAttributeName and identityAttributeValue as keys.

Template

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Rule PUBLIC "sailpoint.dtd" "sailpoint.dtd">
<Rule name="Example Rule" type="ManagerCorrelation">
  <Description>Describe your rule here.</Description>
  <Source><![CDATA[

  // Add your logic here.

  ]]></Source>
</Rule>

Example - Find a manager based on the manager.email attribute

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Rule PUBLIC "sailpoint.dtd" "sailpoint.dtd">
<Rule name="Manager Email Correlation" type="ManagerCorrelation">
  <Description>Finds a manager based on the manager.email attribute.</Description>
  <Source><![CDATA[

Map returnMap = new HashMap();

String managerEmail = link.getAttribute( "manager.email" );
returnMap.put( "identityAttributeName", "email");
returnMap.put( "identityAttributeValue", managerEmail );

return returnMap;

  ]]></Source>
</Rule>