Replication - User and group import - LDAP

Before users can be replicated from LDAP sources, the LDAP server certificate must be imported via the portal properties. So that the user can authenticate against the LDAP server, a user replication should be performed via Intrexx. A replication is not absolutely necessary for the authentication, but should be seen as the "first choice". Alternatively, users can be created manually in Intrexx with the schema (user name, domain, ..) of the LDAP server. When logging in, an attempt to authenticate against the LDAP server will be made first regardless of how the users are created.

Click hereto find out how to configure an LDAP source for user and group import. Carry out the steps described there and then continue reading here.

After you have selected "LDAP" as the connection in the previous dialogs and assigned a name for it, you can now enter the connection data.

Connection parameters for the LDAP server

Server / Port

Enter the server name or the IP of the Active Directory server and the port. The standard port for LDAP is "389", for LDAPS "636".

Authentication

Simple authentication is usually sufficient.

Specify the user who connects to the LDAP server (e.g.: mail@example.org) and the corresponding password (login password for the domain).

Base DN

The base DN (distinguished name) is the name of the sub-tree that the users and user groups should be imported from. Select the base DN by clicking on "Search".

Profile

Select the appropriate profile here.

Create new replication profile / Edit replication profile

Opens a dialog where a new profile can be created.

Delete the replication profile

Deletes the currently selected profile.

Click "Next".

If all entries are correct, a dialog is displayed in which you can define which values are to be read out. Additional properties such as passwords can also be defined here.

Authentication methods

The authentication methods used by Intrexx need to be redefined.

To do this, select the main menu "User / Configuration"in the "User" module.

Click on "Edit binding" next to "Client". Then select the "Generic authentication" option. Close the dialog by clicking on "OK" and then log out of your portal via the main menu "Start / Disconnect portal service".

Modify the configuration file

Open the file "LucyAuth.cfg" in the portal directory internal/cfg with a text editor of your choice. The address of the LDAP server and additional connection data need to be added to this file. Please create a backup of this file before you start editing. Please refer to the following section for more information:

GenericAuth
{
    de.uplanet.lucy.server.auth.module.ldap.LdapBindLoginModule 
    sufficient
      java.naming.provider.url="ldap://localhost:389"
      java.naming.security.authentication="simple"
      java.naming.security.principal="$[DN]"
      debug=false;

   de.uplanet.lucy.server.auth.module.anonymous.AnonymousLoginModule 
   sufficient
      debug=false;
};

Then navigate to the following section in the text editor: How the entry needs to be modified depends on whether users were replicated from the LDAP server or created manually and then authenticate against the LDAP server. If you have performed a replication, please peform the following entries:

GenericAuth
{
    de.uplanet.lucy.server.auth.module.ldap.LdapBindLoginModule 
    sufficient
      java.naming.provider.url="ldap://ldapserver.example.org:389"
      java.naming.security.authentication="simple"
      java.naming.security.principal="$[DN]"
      debug=false;

   de.uplanet.lucy.server.auth.module.anonymous.AnonymousLoginModule 
   sufficient
      debug=false;
};

Enter "ldap" in the provider URL if you do not use SSL encryption. Instead of "ldapserver.example.org", enter the IP address or full qualified name of the LDAP server followed by the port of the LDAP server (default: 389, SSL default: 636). The setting "$[DN]" should not be changed if the replication was successful. This distinguished name should be used for OpenLDAP, Novell eDirectory, Sun ONE and Active Directory Server. If the users were created manuall, modify the settings as follows:

GenericAuth
{
    de.uplanet.lucy.server.auth.module.ldap.LdapBindLoginModule 
    sufficient
      java.naming.provider.url="ldap://ldapserver.example.org:389"
      java.naming.security.authentication="simple"
      java.naming.security.principal="$[LOGIN_NAME]@$[LOGIN_DOMAIN]"
      debug=false;

   de.uplanet.lucy.server.auth.module.anonymous.AnonymousLoginModule 
   sufficient
      debug=false;
};

Enter "ldap" in the provider URL if you do not use SSL encryption. Instead of "ldapserver.example.org", specify the IP address or the fully qualified name of the LDAP server, followed by the port of the LDAP server (default: 389, default SSL: 636). $[LOGIN_NAME]@$[LOGIN_DOMAIN] is the ucomposed principal name. Please apply this pattern exactly as it is shown above. In this way, the login only works in the Portal Manager at first. If the variant should also work when accessing the portal in the browser, the following change needs to be made to the file "initlogin.vm" in the portal directory internal/system/vm/html/login:

##Initparams for Intrexx Loginbox

##Module Subdirectory, depends on Loginmodule ## default "intrexxauth"
#set($l_strModuleSubDir = "intrexxauth")

Modify the line #set($l_strModuleSubDir = "intrexxauth") to #set($l_strModuleSubDir = "ldapauth").