LDAP

Use the IBM® App Connect Enterprise Toolkit to configure message flow nodes that are converted from the IBM App Connect Professional LDAP activities.

About this task

When you import an orchestration that contains LDAP activities, the conversion utility creates a message flow with the LDAP Request node. See Table 1, for information on which nodes are used for each of the activities,.

Table 1. IBM App Connect Professional LDAP activities and the corresponding IBM App Connect Enterprise message flow nodes
IBM App Connect Professional activity IBM App Connect Enterprise node
Search

LDAP Request node
Retrieve

LDAP Request node
Create

LDAP Request node
Delete

LDAP Request node

How to connect to LDAP

Procedure

  1. Click Launch connector discovery to connect to your LDAP account.
    Interface showing Launch Connector Discovery button
  2. In the window that opens, go to the policy project field where you can create a new policy project by clicking New and then specify the name of the new policy project. For an example, refer to the screenshot.
    Screenshot of Launch Connector Discovery window

    Alternatively, you can also select the policy project that you’ve created previously to store the policies from the drop-down.

  3. In the vault key field, enter the vault key that is used to access the credentials stored in the vault. If you want to create a new vault, specify a new external directory vault location and vault key. Click create an external directory vault.
    Screenshot showing the Launch Connector Discovery window with vault key filled in

    As specified in step 2, enter a name for your LDAP project and click Finish.

    Screenshot showing input box with LADP Policy name filled in
  4. When the project is created, click Launch discovery, which opens the connector discover windows.
  5. Click to expand the LDAP drop-down and expand entries. Then, click retrieve entries. Refer to the screenshots for a visual guide.
    Screenshot showing expanded drop-down lists. Entries is higlightedScreenshot showing connect button
  6. Alternatively, you can scroll down to select connect to LDAP to see more items.
  7. Provide the LDAP details and click connect.
    Screenshot showing input boxes to provide details for LDAP
    These credentials are saved in to the policy project that you created previously.
  8. When it is successfully connected, you are redirected to a page related to the action you selected. Enter the details and click save, then close the popup.
  9. Now you can see that the action, object and schema base name fields get generated.
    Interface showing input boxes with the LDAP specifications filled in

LDAP Request node for Search Entry activities

Procedure

  1. Select retrieve entries action from entries drop-down.
  2. Select base distinguished name from the drop-down.
  3. Click add condition and select search criteria from the drop-down. Provide searchFilter in the input field. Refer to the screenshot for an example.
  4. Select LDAP object class from the drop-down by clicking on add condition and in the corresponding drop-down add object class.
  5. Provide the maximum number of items that you want to retrieve. If unsure select the icon beside +, which sets the limit to the maximum number 20.
  6. Select the radio button, Process 20 items from the collection to process the retrieved records without any exception if the limit is exceeded.
  7. Click save and close the window.
    Interface for specifying criteria to search entries

LDAP Request node for Retrieve Entry activities

Procedure

  1. Select retrieve entries action from entries drop-down.
  2. Select base distinguished name from the drop-down.
  3. Select LDAP object class from the drop-down by clicking on add condition and in the corresponding drop-down add object class.
    If there is more than one object class, then add them separately by clicking on add condition.
  4. Provide the maximum number of items that you want to retrieve. If unsure, select the icon beside +, which sets the limit to the maximum number 20.
  5. Select the radio button Process 20 items from the collection to process the retrieved records without any exception if the limit is exceeded.
  6. Click save and close the window.
    Interface for specifying criteria to retrieve entries

LDAP Request node for Create Entry activities

Procedure

  1. Select create entry action from entries drop-down.
  2. Under controls, select define mappings for How do you want to populate the target fields in LDAP.
    This option allows you to define the values explicitly for the fields.
  3. Select base distinguished name from the drop-down.
  4. Select an LDAP object class from the drop-down and complete other target fields.
  5. Click save and close the window.
    Interface for specifying properties to create a new entry

LDAP Request node for Delete Entry activities

Procedure

  1. Select delete entry action from 'Entries' drop-down.
  2. Provide a Distinguished name from the drop-down.
  3. Click save and close the window.
    Interface for deleting entries