By default the user directories configured in Confluence (ADMINISTRATION > USERS & SECURITY > User Directories) are used to fill the user profiles.
Alternatively, you can define an XML file containing user profile data. You can find these settings under ADMINISTRATION > LINCHPIN USER PROFILES > DATA SOURCES and the tab XML.
Local file as XML data source
Use a local XML file on your confluence server as source for your profile data.
The file has to be stored on the same server as your Confluence installation. Furthermore it must be accessible by the Confluence process.
Configure the XML import
You can import additional user profile data from an XML file (e.g., exported from SAP IDM).
- URL or file path of a XML file with user profile data
HTTP is recommended, other protocols like HTTPS are unsupported Make sure the file has the UTF-8 preamble to get special chars encoded right. Also the server should provide UTF-8 files. - The XML node containing the profile data for a user
For our example file it would be "identity" (See the example xml). - XML node containing the Confluence username
For our example file it would be "mx_user_name" (See the example xml).
Example XML file format
The XML file needs to comply with the following format:
<?xml version=“1.0” encoding=“utf-8”?>
<identities>
<identity>
<mx_user_name>admin</mx_user_name>
<department>IT</department>
<team>BOFH</team>
</identity>
<identity>
<mx_user_name>c.norris</mx_user_name>
<department>Roundhouse</department>
</identity>
<identity>
<mx_user_name>a.schwarzenegger</mx_user_name>
<department></department>
<team>Expendables</team>
</identity>
</identities>
When the scheduled job for xml import runs, the three users defined in the xml file will be updated.
The fields department and team has been set for user admin. Since now, he can not edit those fields by himself anymore.
Only the field department has been updated for user c.norris. Since now, he can only edit the field team in his profile.
The fields department and team has both been set for user a.schwarzenegger. The field department has now an empty value set. Both fields can not be edit anymore by the user.
XML Profile Field
Starting from version 1.17 you can use almost all field types to represent your XML data.
Under "Data source" select XML as your source and set the "XML node name" to match your XML node in your file ("department" or "team" in the example).
LUP: Bulk profile update (XML sync)
You are ready to trigger the XML import by starting the job "LUP: Bulk profile update (XML sync)" in the scheduled jobs section of the Confluence administration interface. You can also schedule the job to run regularly.