Show TOC Anfang des Inhaltsbereichs

Vorgehensweisen Configuring the UME to Use an LDAP Directory as Data Source  Dokument im Navigationsbaum lokalisieren

Use

Use this procedure to configure the user management engine (UME) to use an LDAP directory as the data source.

Hinweis

If you cannot start the SAP NetWeaver Application Server (AS) Java, you must use the offline procedure for configuring the data source.

Prerequisites

      See LDAP Directory as Data Source.

      This procedure requires you to restart the AS Java, so you should plan for the required downtime while the AS Java restarts.

Procedure

...

       1.      Start user management configuration.

For more information, see Configuring User Management.

       2.      Choose the Data Sources tab.

       3.      Choose Modify Configuration.

       4.      From Data Source, select the data source that best matches your LDAP directory.

       5.      Choose the LDAP Server tab.

       6.      Enter connection data as required.

The table below lists the settings for configuring the LDAP directory connection.

Settings for Configuring an LDAP Directory as Data Source

Setting

Description

Server Name

Host name of the LDAP directory server.

Server Port

Port used by the LDAP directory.

User

Distinguished name (DN) of the user that is used to connect (bind) to the LDAP directory.

Achtung

This user has read and search permissions for all branches of the LDAP directory. If the UME requires write access, the user must have create and change authorizations.

Beispiel

cn=Directory Manager

Password

Password of the user (indicated above) that is used to connect (bind) to the LDAP directory. When you enter the password, user management configuration hides your input on the screen.

User Path

Distinguished name of the branch directory where information about users is stored. If you have a groups in a tree hierarchy, the User Path and Group Path values must be the same.

For more information, see Organization of Users and Groups in LDAP Directory.

Beispiel

ou=CorporateUsers,c=us,o=mycompany

Group Path

Distinguished name of the branch directory where information about the groups is stored.

Beispiel

ou=CorporateGroups,c=us,o=mycompany

Use SSL for LDAP Access

This indicator determines if the UME uses a Secure Sockets Layer (SSL) connection to the LDAP directory. For more information, see the link for configuring SSL below.

Use Unique Attribute for UME Unique ID

Set this indicator to use a unique ID instead of a distinguished name to identify a user account. When LDAP attribute is used as the unique ID is defined in the data source configuration file and appears as the default value when you set this indicator. This enables you to physically move users in your LDAP directory structure and still be able to find them, because the user ID is based on the unique ID and not the distinguished name.

See also SAP Note 777640.

 

       7.      Choose Test Connection.

If the test fails, user management configuration displays the entry from the security log. The monitoring tools of your LDAP directory can also help you determine the cause of the problem. If necessary, go back and reenter the connection data and test the connection until you are successful.

       8.      Enter the rest of the data as required.

The table below lists the LDAP directory connection settings for the following:

       LDAP connection pool

For more information, see LDAP Directory: Connection Pooling.

       LDAP cache

The UME uses the LDAP cache to optimize access to the LDAP directory server by caching things such as previous search results.

       Blocked principals

       Directory server access log

Additional Connection Settings for LDAP Directories

Setting

Description

Initial Size

Minimum number of connections in the connection pool.

Beispiel

If set to 1, the connection pool never has less than one open connection.

Maximum Idle Size

Maximum number of idle connections in the connection pool. If the maximum number of idle connections is reached, the connection pool closes every incoming released connection.

Maximum Size

Maximum number of connections in the connection pool.

Maximum Idle Time

Maximum time in milliseconds for an idle connection in the connection pool.

Connect Timeout

Enter the number of milliseconds between connection requests sent from the UME to the LDAP directory server. By default the UME tries the connection twice. If the second attempt fails, the UME does one of the following:

      Attempts to connect to a redundant LDAP directory (if you configured for high availability, see below)

      Returns an error message that the LDAP directory cannot be reached.

Monitoring Interval

Enter a value larger than 999 to enable the directory server connection pool log. The monitoring interval is the interval in milliseconds at which the system records information. Any value less than 1000 disables logging.

For more information, see Directory Server Connection Pool Log.

Cache Size

Number of cache entries saved.

Cache Lifetime

How long a search entry remains in the cache.

Unique Name of Blocked Users

Enter the unique names of users in the LDAP directory that the UME should ignore. If users exist in the LDAP directory and the AS Java database with the same unique name, use this setting to prevent the UME from finding these users in the LDAP directory.

Unique Name of Blocked Groups

Enter the unique names of groups in the LDAP directory that the UME should ignore.

Beispiel

The AS Java database includes a default group named everyone. If there is a group in the LDAP directory with the same name, enter everyone to prevent the UME from finding the group in the LDAP directory.

Record LDAP Access

Set this indicator to enable the directory service access log. This log records LDAP requests and the response time.

For more information, see Directory Server Access Log.

 

       9.      Choose Save All Changes.

   10.      Restart the AS Java.

Result

The UME can access the LDAP directory. You can perform further configuration of the LDAP directory configuration, such as the following:

      Configuring High Availability of the LDAP Data Source

      Configuring attribute mapping for the data source configuration file

For more information, see Customizing a UME Data Source Configuration.

      Configuring SSL Between the UME and an LDAP Directory

Empfehlung

We strongly recommend that you configure SSL between the UME and the LDAP directory. Some LDAP directories, such as Microsoft Active Directory Server, require an SSL connection if you want to create users on the LDAP directory.

Ende des Inhaltsbereichs