Customizing attribute maps

When data is federated from multiple sources, the attributes must be mapped correctly when they are synchronized with the single target directory. We can specify how to convert attributes from the source endpoint schema to the target schema by defining custom maps for attributes.

About this task

The attribute mapping for standard schema such as Active Directory and Sun Directory is built in. Additionally, some ready-to-use custom maps are provided in Federated Directory Server. However, you might require to modify or extend these attribute maps or create new custom maps in some scenarios. For example, you might require custom maps if you use databases or files as your endpoint.

Procedure

1. In the Federated Directory Server console navigation pane, under Directory Server, click Attribute Maps.
2. On the Attribute Maps page, various attribute maps are provided for person, group, and container objects. Expand the type of attribute map that you want to customize.
3. If you want to create a new attribute mapping, click Add Attribute.
4. In the Add Attribute window, select the attribute from the list of attributes in the target directory server. A new row is displayed with the selected attribute name under the Directory Server Attribute column.
5. Under Endpoint Attribute / Assignment, specify the attribute name in the source endpoint that must map to the target attribute.
6. Double-click the endpoint attribute name to specify more settings for the attribute mapping.
   1. Select Enabled to use this attribute mapping for the endpoint.
   2. Click Simple Assignment or Scripted Assignment to specify the type of mapping. If you select Scripted Assignment, we can define the assignment by writing JavaScript code or by calling a function in the Solution Directory\LDAPSync\customScript.js file. See the Security Directory Integrator documentation and search for Scripting in SDI.
   3. Specify whether you want this mapping to be used for all operations, or only when either modifying an entry or creating an entry.

7. To delete the mapping for a specific attribute, click the check box on that row. Then, click Remove Attribute and click OK when the confirmation message appears.
8. After you complete adding the attributes for a map, click Save. Unless you save each map that you edited, the changes are lost.
9. We can also duplicate the entire map and then extend it with your custom attribute mapping. Click Duplicate Map, enter a name for the new map file, and then click OK, when the confirmation message appears. A new attribute map with all the attribute mapping entries of the source map is created.
10. To delete an attribute map and all its entries, click Delete Map and then click OK when the confirmation message appears.

Results

We can later select this custom attribute map for use during flow operations when you define the flow specifications.

All attribute maps are stored in the Solution Directory\LDAPSync directory.

Parent topic:

Federated Directory Server