gitter-badger/adimportservice

Kentico Active Directory Import Service provides real-time import of users and groups from the Active Directory database to users and roles in a Kentico.

Kentico AD Import Service

Kentico Active Directory Import Service provides real-time import of users and groups from the Active Directory database to users and roles in a Kentico. The service is fully configurable using a configuration file.

Installation

Assume that you have Kentico version 8.x installed, follow these steps:

1. Enable REST service in Kentico settings with basic authentication
2. Download the ADImportService.exe executable from releases
3. Open the command line and find the InstallUtil utility (most likely in C:\Windows\Microsoft.NET\Framework64\v4.0.x
4. Execute command InstallUtil.exe <path to the ADImportService.exe> (e.g.: InstallUtil.exe C:\ADImportService\ADImportService.exe)
5. Create the C:\ProgramData\Kentico AD Import Service\configuration.xml file and copy the sample configuration there
6. Open the configuration file and enter all required values
7. Open Microsoft Management Console and start the Kentico AD Import Service

Immediately after starting, it gets the current users and groups and adds them to Kentico, then it turns on processing of asynchronous changes. If the application fails, it informs about the event in a Windows Event Log.

Configuration

Here is a sample configuration you can copy to configuration.xml file.

<ServiceConfiguration>
	<Listener DomainController="FQDN or IP of Domain Controller" 
	UseSsl="false" SslCertificateLocation="Path to .cer file">
		<Credentials>
			<UserName>UserName</UserName>
			<Password>Password</Password>
			<Domain>Domain</Domain>
		</Credentials>
	</Listener>
	<Rest UserName="Kentico user name" Password="Kentico password" 
	Encoding="utf-8" BaseUrl="http://localhost/Kentico8 (use https to ebnable SSL)" 
	SslCertificateLocation="Path to .cer file" />
	<UserAttributesBindings>
		<Binding Cms="FullName" Ldap="sAMAccountName" />
	</UserAttributesBindings>
	<GroupAttributesBindings>
		<Binding Cms="RoleDescription" Ldap="description" />
	</GroupAttributesBindings>
</ServiceConfiguration>

Disclaimer

Please, understand that Kentico Software does not provide support for this software. It is developed by volunteers and is distributed as it is (see license).

Acknowledgement

The project is based on code developed by Tomas Hruby for his bachelor thesis (full text of thesis in pdf).