Skip Navigation Links | |
Exit Print View | |
Oracle Directory Server Enterprise Edition Developer's Guide 11 g Release 1 (11.1.1.5.0) |
Part I Directory Server Plug-In API Guide
1. Before You Start Writing Plug-Ins
2. Changes to the Plug-In API Since Directory Server 5.2
3. Getting Started With Directory Server Plug-Ins
4. Working With Entries Using Plug-Ins
5. Extending Client Request Handling Using Plug-Ins
6. Handling Authentication Using Plug-Ins
7. Performing Internal Operations With Plug-Ins
8. Writing Entry Store and Entry Fetch Plug-Ins
9. Writing Extended Operation Plug-Ins
10. Writing Matching Rule Plug-Ins
11. Writing Password Storage Scheme Plug-Ins
12. Writing Password Quality Check Plug-Ins
13. Writing Computed Attribute Plug-Ins
Part II Directory Server Plug-In API Reference
14. Data Type and Structure Reference
15. Function Reference, Part I
16. Function Reference, Part II
To Deploy on Application Server
Configuring NameFinder to Access Your Directory
To Configure Access When Using Application Server
This section covers what you can customize in the NameFinder web application, using only the Java properties files provided. Detailed explanations of individual properties can be found in the WEB-INF/classes/sample.properties file in the directory where you deployed the application.
Note - NameFinder was designed as a Sun internal web application. The default configuration therefore relies on the default LDAP schema and directory information tree (DIT) that is provided with the Directory Server. The schema and DIT probably differ from the schema and DIT in use at your organization.
In addition to customizations within the application, you can also customize searches by using options in the search field. Furthermore, you can customize what attributes to display within the browser-based interface. Refer to the NameFinder online help for details.
As described in Configuring NameFinder to Access Your Directory, you customize the WEB-INF/classes/NameFinder.properties file to allow the application to access your directory.
By convention, connection parameters are included in the first few lines of the Java properties file. You can configure to which host-port combination NameFinder connects. You can also configure whether to use LDAP v2 or v3, and whether to bind as a particular user.
NameFinder connection properties only allow you to configure simple authentication connections to the directory, however. You cannot use connection properties to configure NameFinder to connect using SSL or a SASL mechanism.
NameFinder lets you configure attributes that define search options, attributes to search, and labels for the values returned. The Java properties definitions for such attributes take the following form:
NameFinder.attr#=optChar|colChar|attr|label|colLabelA decimal number
Do not leave any numbers in the sequence that remain commented out. NameFinder depends on having the numbers in ascending order without gaps.
An option character for use in searches
For example, P is by default the phone number option. Thus, search for the entry with phone number 1 234 567 8910 by typing -P "1 234 567 8910" in the NameFinder search field.
Do not use F as an option character. This character is reserved to allow you to enter LDAP search filters, such as -F "(telephoneNumber=1 234 567 8910)", directly.
This parameter is called arg1 in WEB-INF/classes/sample.properties.
A character for use in defining table columns as a parameter to NameFinder
For example, you can use the default configuration. You use the default by passing fields=nfeP as one of the options in the URL to NameFinder for a search that returns multiple entries. NameFinder displays results in a four-column table that has column labels Lastname, Firstname, eMail, and Phone #.
This argument is called arg2 in WEB-INF/classes/sample.properties.
The LDAP attribute to search when using optChar
This argument is called arg3 in WEB-INF/classes/sample.properties.
The label to display for the corresponding attr value when showing results for a single LDAP entry
This argument is called arg4 in WEB-INF/classes/sample.properties.
The column label to display in the table header for the corresponding attr value when showing results for multiple LDAP entries
This argument is called arg5 in WEB-INF/classes/sample.properties.
You can leave variables blank in search attribute properties definitions.
In addition to connection and search attribute properties, NameFinder allows you to define several other properties in the WEB-INF/classes/NameFinder.properties file. These other properties govern the following:
The default table layout for displaying results when searches return multiple entries
Lists of LDAP attributes to search when looking up phone numbers and email addresses
Which LDAP attributes correspond to NameFinder attribute fields, which allow NameFinder to be abstract from particular LDAP schema
Table layouts for displaying team views and tables of a manager's direct reports
Refer to WEB-INF/classes/sample.properties for details.