Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › User Directory Methods › UserLookupEnd Method—Sets or Retrieves User DN Lookup Endpoint

UserLookupEnd Method—Sets or Retrieves User DN Lookup Endpoint

The UserLookupEnd method sets or retrieves the endpoint for a user DN lookup in an LDAP directory.

Syntax

The UserLookupEnd method has the following format:

Netegrity::PolicyMgtUserDir‑>UserLookupEnd([lookupEnd])

Parameters

The UserLookupEnd method accepts the following parameter:

lookupEnd (string)

(Optional) Specifies a new value for the user DN lookup endpoint.

Return Value

The UserLookupEnd method returns one of the following values:

• user_dn_lookup_endpoint (string)

  Specifies the new or existing user DN lookup endpoint.

• undef

  Specifies that the call is unsuccessful.

Remarks

Specifying values for the user DN lookup starting point and endpoint allows users to enter part of the DN string when authenticating. In the following example, the user only needs to specify the string "JSmith" and not the whole DN string when logging in:

• DN = "uid=JSmith,ou=marketing,o=myorg.org"
• starting_point = "uid="
• endpoint = ",ou=marketing,o=myorg.org"
• login = "JSmith"