Table of Contents
Advertisement
DEVELOPING COLDFUSION 9 APPLICATIONS
Accessing and Using Data
• Add attributes
• Delete attributes
• Replace attributes
• Change the DN (rename the entry)
These actions let you manage LDAP directory contents remotely.
You build a ColdFusion page that lets you manage an LDAP directory. The form displays directory entries in a table
and includes a button that lets you populate the form fields based on the unique user ID.
The example ColdFusion page does not add or delete entry attributes or change the DN. For information on these
operations, see
"Adding and deleting attributes of a directory
DN" on page 468.
To keep the code short, this example has limitations that are not appropriate in a production application. In particular,
it has the following limitations:
• If you enter an invalid user ID and click either the Update or the Delete button, ColdFusion generates a "No such
object" error, because there is no directory entry to update or delete. Your application should verify that the ID
exists in the directory before it tries to change or delete its entry.
• If you enter a valid user ID in an empty form and click Update, the application deletes all the attributes for the User.
The application should ensure that all required attribute fields contain valid entries before updating the directory.
Adding a directory entry
When you add an entry to an LDAP directory, you specify the DN, all the required attributes, including the entry's
object class, and any optional attributes. The following example builds a form that adds an entry to an LDAP directory.
1
Create a file that looks like the following:
<!--- Set the LDAP server ID, user name, and password as variables
here so they can be changed in only one place. --->
<cfset myServer="ldap.myco.com">
<cfset myUserName="cn=Directory Manager">
<cfset myPassword="password">
<!--- Initialize the values used in form fields to empty strings. --->
<cfparam name="fullNameValue" default="">
<cfparam name="surnameValue" default="">
<cfparam name="emailValue" default="">
<cfparam name="phoneValue" default="">
<cfparam name="uidValue" default="">
<!---When the form is submitted, add the LDAP entry. --->
<cfif isdefined("Form.action") AND Trim(Form.uid) IS NOT "">
<cfif Form.action is "add">
<cfif Trim(Form.fullName) is "" OR Trim(Form.surname) is ""
OR Trim(Form.email) is "" OR Trim(Form.phone) is "">
<h2>You must enter a value in every field.</h2>
<cfset fullNameValue=Form.fullName>
<cfset surnameValue=Form.surname>
<cfset emailValue=Form.email>
<cfset phoneValue=Form.phone>
<cfset uidValue=Form.uid>
<cfelse>
<cfset attributelist="objectclass=top, person,
entry" on page 467 and
Last updated 8/5/2010
"Changing a directory entry's
460
Advertisement
Table of Contents
