Directory Services Markup Language (DSML) identity feed

DSML service type

The Identity Manager Server allows for integration of various human resource (HR) type data feeds. You can add large numbers of individuals to the Identity Manager Server without manually adding each individual. An identity record in HR data becomes an instance of a person object in IBM Verify Identity Governance. One type of HR type data feed is the DSML Identity Feed service. The service can receive the information in one of two ways: a reconciliation or an unsolicited event notification through an event notification program.

The mechanisms that handle HR data in IBM Verify Identity Governance requires that the HR data be in an XML format. The format uses the standard schema defined by the Directory Services Markup Language (DSML version 1). See the DSML website at http://www.oasis-open.org for DSMLv1. When sending asynchronous notifications, an XML message format defined by the Directory Access Markup Language (DAML version 1) is used. DAML is an XML specification defined by IBM® that allows specification of add, modify, and delete operations.

DSML file format

DSML is an XML format that describes directory information. A DSML file represents directory structure information in an XML file format. The DSML file must contain only valid attributes of the IBM Verify Identity Governance profile. The identity feed process uses all objects in the file.

<attr name="erpersonpassword"><value>panther2</value></attr>

<entry dn="uid=sparker">
<objectclass><oc-value>inetOrgPerson</oc-value></objectclass>
<attr name="givenname"><value>Scott</value></attr>
<attr name="initials"><value>SVP</value></attr>
<attr name="sn"><value>Parker</value></attr>
<attr name="cn"><value>Scott Parker</value></attr>
<attr name="telephonenumber"><value>(919) 321-4666</value></attr>
<attr name="postaladdress"><value>222 E. First Street Durham, NC  27788</value></attr>
</entry>

UTF-8 encoding in an identity feed file

Your identity feed file must be in UTF-8 format. You must use an editor that supports UTF-8 encoding.

• Windows

  The following are UTF-8 capable: Microsoft Word 97 or later, or the Notepad editor that is included with the Windows 2003 Server or Windows XP operating systems.

  To save a file in UTF-8 format using Notepad, click File > Save As. Then, expand the list of choices for the Encoding field and select UTF-8.

• Linux®

  The Vim text editor (a version of the classic vi editor) is UTF-8 capable. To work with files in UTF-8 format using the Vim text editor, specify the following:

  :set encoding=utf-8
  :set guifont=-misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1
  

  If your version of UNIX does not include this text editor, access this Web site:

  http://www.vim.org