Skip to main content

Configure AD update

if you are using Active Directory (AD) in your organisation, you can set up Contensis to integrate directly with it.

Users won't need to remember multiple passwords and administrators won't need to set up extra user accounts for everyone to be able to login to Contensis. Everyone will be able to login automatically to Contensis if they are logged into their computer on the domain while using Internet Explorer.

The AD service will run by default at a pre-specified time. The steps listed here show how you can change the settings to better suit your needs. All settings below need to be changed in the Global Settings area which can be found in the Management Console.

Note: You must restart the application cache after making changes to these settings for your changes to be carried over to the published website.



This setting specifies whether the AD update process is enabled or not. By default it is turned off. The following global settings are shared with the Active Directory Synchronisation service.


This setting is the domain that your Active Directory install is running on. We strongly recommend you use the pre windows 2000 version of your domain or the short domain in this setting. For example, our AD domain is so our setting is set to Contensis.


This is the user name that will be used to read the Active Directory listings and carry out the synchronisation. This user needs read privileges in the domain. We strongly  recommend that the password for this user is set to Password Never Expires in the User Editor screen to prevent synchronisation stopping without notice.


This is the password for the user described above.

Specify the AD user properties to update in Contensis

If the AD Update is turned on, the following properties are updated on the corresponding AD user record by default:

  • Account Disabled
  • Account Locked
  • Email Address
  • Title
  • First Name
  • Last Name
  • Telephone Number
  • Job Title
  • Department
  • Division (mapped to company name in Contensis)

Any of these fields can be excluded from the AD update by changing the value of the DirectoryServices_DisabledActiveDirectoryProperties_CMStoAD setting in Global Settings. The value of this setting is a bit field array but rendered as a decimal.

To set the value, refer to the following list:

  • None = 0
  • Account Disabled = 1
  • Account Locked = 2
  • Email Address = 4
  • Title = 8
  • First Name = 16
  • Last Name = 32
  • Telephone Number = 64
  • Job Title = 128
  • Department = 256
  • Division = 512
  • Password Never Expires = 1024

An example value of 192 => (64+128) would disable the update of the Job Title and Telephone Numbers.

Custom mappings

There are two settings that allow you to customise the AD Update behaviour, DirectoryServices_ADToCMSMappings and DirectoryServices_ADToCustomMappings. These settings are both also used by the AD Synchronisation service to update Contensis user records from AD. For further information see Active Directory integration Custom Mappings.

User profile field accessibility

In the following screens:

  1. The User Profile screen of the CMS
  2. A published web page which has the User profile web control
  3. A published web page which has the Who’s Who Record web control (applies only if your CMS has the Who’s Who module)

the following fields

  • First Name
  • Last Name
  • Telephone number
  • Job Title
  • Company Name

will be disabled if either:

  1. The AD Update is enabled, and the field is included in the global setting DirectoryServices_DisabledActiveDirectoryProperties_CMStoAD
  2. The AD Update is not enabled, AD Synchronisation is enabled, and the field is not included in the global setting DirectoryServices_DisabledActiveDirectoryProperties.

Note: The above fields are not disabled in the User Management screen of the Management Console.

Make changes to global settings

When any of the above global settings are changed in the CMS, you will need to:

  1. In the Management Console > Project Overview > Publishing Servers screen, click on CMS Config for the relevant publishing server, and then click Save & Publish. This will ensure that the global settings are updated on the publishing server.
  2. Restart the application pool for the relevant published website in IIS on the publishing server. This will ensure that any pages in the published website use the new global settings.
  3. Any users of the CMS will need to click Reset Application Cache (in the Management Console) for the new global settings to be displayed in the CMS User Profile screen.

Save changes

You need to restart the Active Directory service each time you update the settings above. This ensures the new configuration options get picked up by the service and everything works as you intended.