Configure and Manage Affiliations

As an Administrator, configure and manage affiliations from the Identity Attributes page. With affiliations, for a single identity you can manage different accesses based on varied job data ingested from Authoritative source.

Navigate to Affiliations

Affiliations are set up from the Manage Integrations page for a specific orchestrated system.

  1. From the Oracle Access Governance navigation menu icon Navigation menu, select Service Administration → Orchestrated Systems.
  2. Select the Manage integration option from the action menu action menu for the orchestrated system you want to configure. The Manage Integration page for the selected orchestrated system is displayed.
  3. From the Data settings section, select Manage on the Identity attributes tile.
    This tile is available only for orchestrated system supporting Authoritative sources.
  4. Select the Affiliations tab.

Create an Affiliation

  1. Select + Create an affiliation to start the workflow. The Create a new affiliation page is displayed.

Add Details

In the Add Details task, you can enter general settings about your affiliation. You are also able to add user friendly tags that can be used while searching this affiliation.

  1. Name: Enter a name of your affiliation.
  2. Display name: Enter meaningful display name.
  3. Description: Enter description
  4. Click Next.

Define Attributes

Add one or more core or complex identity attributes to associate with affiliations and manage the flag for using the attributes in the Oracle Access Governance features.

  1. Select Add an attribute.
    The identity attribute fields are displayed in the editable mode letting you add new attributes.
  2. Enter the Attribute name.
  3. Enter the Display name that would be shown on the Oracle Access Governance Console.
  4. Select the appropriate Data type for the attribute.
  5. Select the Oracle Access Governance features flags where you want to the attribute.
  6. Continue adding additional attributes for the affiliation.
  7. Click Next.

Add Rules for Deriving Values

In the Value source task, use the data transformation rules on the identity attributes to derive affiliation value.

For more information on fetching values using data rules, see Data Transformation Rules Reference.
  1. Rule: Enter the rule you want to apply to this affiliation/
  2. Click the Validate button to check your rule. If the rule is valid then you will see a confirmation message and the rule will be marked as validated. If there is an issue with the rule, then you will see an error message and the rule will be marked as invalid. You cannot save your rule if it is marked as invalid.
  3. Optional: Expand the Show me the available rule link attributes to list all the available attributes that you may use to construct your rule.
  4. Click Next.
Example: You can extract JobCode, Description and JobName from the job array in the Authoritative Source, using a rule similar to:
var data = user.getCustomAttributes() !== null && user.getCustomAttributes()['Jobs'] != null
    ? user.getCustomAttributes()['Jobs'][0]
    : null;

if (data != null) {
    function getJobData() {
        var job_data = {
            Description: data['DESCRIPTION'],
            JobCode: data['JOBCODE'],
            JobName: data['JOBNAME']
        };
        return job_data;
    }

    getJobData();
}

Review and Submit

In the Review and Submit task, you can review the information you added in the previous steps.

  1. If everything looks correct, then click Create to create the affiliation. You may select addition actions:
    1. Cancel: To cancel the process.
    2. Back: To go back to the previous step.

Edit Affiliations

The Edit Affiliations page provides the same guided tasks as you see while creating a new affiliation.

  1. Click the menu Actions menu icon corresponding to the affiliation that you want to modify, and then select Edit.
    After updating your affiliation, on the Review and submit step, select Update. Alternatively you can select Back to edit values, or select Cancel to discard your changes.
To edit an affiliation name, clone the affiliation to make changes, and then delete the previous affiliation.

Delete Affiliation

Administrators can delete affiliations and delete associated attributes.

  1. Click the menu Actions menu icon corresponding to the affiliation that you want to delete, and then select Delete.
    On the confirmation pop-up, click Delete to remove the affiliation or click Cancel to retain it.

Delete Attributes

  1. Click the menu Actions menu icon corresponding to the affiliation that you want to modify, and then select Edit.
  2. On the Define Attributes task, select the delete Delete icon corresponding to the attribute that you want to delete.
  3. On the Delete attribute confirmation message box, select Continue.

View Affiliation Details

You can view affiliation details, attributes associated with the affiliation, and the rules for extracting the value from the Authoritative source.

  1. Click the menu Actions menu icon corresponding to the affiliation that you want to view, and then select View Details.