<html>
<head>
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFLDAP</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="Description">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFLDAP</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Description</span>
<p>
Provides an interface to a Lightweight Directory Access Protocol (LDAP) directory server, such as the Netscape Directory Server. 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Category</span>
<p>
Internet Protocol tags
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">Syntax</span><pre>&lt;cfldap 
   server = &quot;server_name&quot;
   port = &quot;port_number&quot;
   username = &quot;name&quot;
   password = &quot;password&quot;
   action = &quot;action&quot;
   name = &quot;name&quot;
   timeout = &quot;seconds&quot;
   maxRows = &quot;number&quot;
   start = &quot;distinguished_name&quot;
   scope = &quot;scope&quot;
   attributes = &quot;attribute, attribute&quot;
returnAsBinary = &quot;column_name, column_name&quot;
   filter = &quot;filter&quot;
   sort = &quot;attribute[, attribute]...&quot;
   sortControl = &quot;nocase&quot; and/or &quot;desc&quot; or &quot;asc&quot;
   dn = &quot;distinguished_name&quot;
   startRow = &quot;row_number&quot;
   modifyType = &quot;replace&quot; or &quot;add&quot; or &quot;delete&quot;
   rebind = &quot;yes&quot; or &quot;no&quot;
   referral = &quot;number_of_allowed_hops&quot;
   secure = &quot;multi_field_security_string&quot;
   separator = &quot;separator_character&quot;
   delimiter = &quot;delimiter_character&quot;&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">See also</span>
<p>
cfftp, cfhttp, cfmail, cfmailparam, cfpop, Chapter&#160;23, "Managing LDAP Directories" in ColdFusion MX Developer's Guide
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">History</span>
<p>
ColdFusion&#160;MX&#160;7: Added the returnAsBinary attribute.
</p>

<p>
ColdFusion&#160;MX:
</p>
<ul>

<li>Changed the name attribute behavior: this tag validates the query name in the name attribute.</li>

<li>Changed sorting behavior: this tag does not support client-side sorting of query results. (It supports server-side sorting; use the sort and sortcontrol attributes.) </li>

<li>Changed how results are sorted: server-side sorting results might be sorted slightly differently than in ColdFusion 5. If you attempt a sort against a server that does not support it, ColdFusion&#160;MX throws an error. </li>

<li>Deprecated the filterfile attribute. It might not work, and might cause an error, in later releases.</li>
</ul>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Usage</span>
<p>
If you use the query action, cfldap creates a query object, allowing access to information in the query variables, as follows:
</p>

<p>
</p><div align="left">
<table border="1">
  <caption></caption>
  <tr align="center">    <th>&#160;</th>
    <th>&#160;</th>
</tr>
  <tr align="left">    <td>
<p>queryname.recordCount</p></td>
    <td>
<p>Number of records returned by query</p></td>
</tr>
  <tr align="left">    <td>
<p><i>queryname</i><i>.</i>currentRow</p></td>
    <td>
<p>Current row of query that cfoutput is processing</p></td>
</tr>
  <tr align="left">    <td>
<p><i>queryname</i><i>.</i>columnList</p></td>
    <td>
<p>Column names in query</p></td>
</tr>
</table>
</div>
<p>
</p>

<p>
If you use the security=&quot;CFSSL_BASIC&quot; option, ColdFusion determines whether to trust the server by comparing the server's certificate with the information in the jre/lib/security/cacerts keystore of the JRE used by ColdFusion MX. The ColdFusion MX default cacerts file contains information about many certificate granting authorities. If you must update the file with additional information, you can use the keytool utility in the ColdFusion jre/bin directory to import certificates that are in X.509 format. For example, enter the following: 
</p>
<pre>keytool -import -keystore cacerts -alias ldap -file ldap.crt -keypass bl19mq
</pre>
<p>
Then restart ColdFusion MX. The keytool utility initial keypass password is &quot;change it&quot;. For more information on using the keytool utility, see the Sun JDK documentation 
</p>

<p>
Characters that are illegal in ColdFusion can be used in LDAP attribute names. As a result, the cfldap tag could create columns in the query result set whose names contain illegal characters and are, therefore, inaccessible in CFML. In ColdFusion, illegal characters are automatically mapped to the underscore character; therefore, column names in the query result set might not exactly match the names of the LDAP attributes.
</p>

<p>
For usage examples, see ColdFusion MX Developer's Guide.
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Example</span><pre>&lt;h3&gt;cfldap Example&lt;/h3&gt;
&lt;p&gt;Provides an interface to LDAP directory servers. The example uses the 
University of Connecticut public LDAP server. For more public LDAP servers,
see &lt;a href=&quot;http://www.emailman.com&quot;&gt;http://www.emailman.com&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Enter a name and search the public LDAP resource. 
An asterisk before or after the name acts as a wildcard.&lt;/p&gt;
&lt;!--- If form.name exists, the form was submitted; run the query. ---&gt;
&lt;cfif IsDefined(&quot;form.name&quot;)&gt;
   &lt;!--- Check to see that there is a name listed. ---&gt;
   &lt;cfif form.name is not &quot;&quot;&gt;
      &lt;!--- Make the LDAP query. ---&gt;
      &lt;cfldap 
          server = &quot;ldap.uconn.edu&quot;
          action = &quot;query&quot;
          name = &quot;results&quot;
          start = &quot;dc=uconn,dc=edu&quot;
          filter = &quot;cn=#name#&quot;
          attributes = &quot;cn,o,title,mail,telephonenumber&quot;
          sort = &quot;cn ASC&quot;&gt;
      &lt;!--- Display results. ---&gt;
      &lt;center&gt;
      &lt;table border = 0 cellspacing = 2 cellpadding = 2&gt;
         &lt;tr&gt;
            &lt;th colspan = 5&gt;
               &lt;cfoutput&gt;#results.recordCount# matches found
               &lt;/cfoutput&gt;&lt;/TH&gt;
         &lt;/tr&gt;
         &lt;tr&gt;
            &lt;th&gt;&lt;font size = &quot;-2&quot;&gt;Name&lt;/font&gt;&lt;/TH&gt;
            &lt;th&gt;&lt;font size = &quot;-2&quot;&gt;Organization&lt;/font&gt;&lt;/TH&gt;
            &lt;th&gt;&lt;font size = &quot;-2&quot;&gt;Title&lt;/font&gt;&lt;/TH&gt;
            &lt;th&gt;&lt;font size = &quot;-2&quot;&gt;E-Mail&lt;/font&gt;&lt;/TH&gt;
            &lt;th&gt;&lt;font size = &quot;-2&quot;&gt;Phone&lt;/font&gt;&lt;/TH&gt;
         &lt;/tr&gt;
         &lt;cfoutput query = &quot;results&quot;&gt;
            &lt;tr&gt;
               &lt;td&gt;&lt;font size = &quot;-2&quot;&gt;#cn#&lt;/font&gt;&lt;/td&gt;
               &lt;td&gt;&lt;font size = &quot;-2&quot;&gt;#o#&lt;/font&gt;&lt;/td&gt;
               &lt;td&gt;&lt;font size = &quot;-2&quot;&gt;#title#&lt;/font&gt;&lt;/td&gt;
               &lt;td&gt;&lt;font size = &quot;-2&quot;&gt;
                  &lt;A href = &quot;mailto:#mail#&quot;&gt;#mail#&lt;/A&gt;&lt;/font&gt;&lt;/td&gt;
               &lt;td&gt;&lt;font size = &quot;-2&quot;&gt;#telephonenumber#&lt;/font&gt;&lt;/td&gt;
            &lt;/tr&gt;
         &lt;/cfoutput&gt;
         &lt;/table&gt;
         &lt;/center&gt;
      &lt;/cfif&gt;
&lt;/cfif&gt;

&lt;form action=&quot;#cgi.script_name#&quot; method=&quot;POST&quot;&gt;
&lt;p&gt;Enter a name to search in the database.
&lt;p&gt;
&lt;input type=&quot;Text&quot; name=&quot;name&quot;&gt;
&lt;input type=&quot;Submit&quot; value=&quot;Search&quot; name=&quot;&quot;&gt;
&lt;/form&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="SERVER">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SERVER</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Host name or IP address of LDAP server.</p>

  </td>
  </tr>
  </table>
</div>
<div id="PORT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">PORT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "389"


<p>Port. </p>

  </td>
  </tr>
  </table>
</div>
<div id="USERNAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">USERNAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required if secure = &quot;CFSSL_BASIC&quot;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "(anonymous)"


<p>User ID.</p>

  </td>
  </tr>
  </table>
</div>
<div id="PASSWORD">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">PASSWORD</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required if secure = &quot;CFSSL_BASIC&quot;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Password that corresponds to user name. </p>
<p>If secure = &quot;CFSSL_BASIC&quot;, V2 encrypts the password before transmission.</p>

  </td>
  </tr>
  </table>
</div>
<div id="ACTION">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">ACTION</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "query"

<ul>

<li>query: returns LDAP entry information only. Requires name, start, and attributes attributes. </li>

<li>add: adds LDAP entries to LDAP server. Requires attributes attribute.</li>

<li>modify: modifies LDAP entries, except distinguished name dn attribute, on LDAP server. Requires dn. See modifyType attribute.</li>

<li>modifyDN: modifies distinguished name attribute for LDAP entries on LDAP server. Requires dn.</li>

<li>delete: deletes LDAP entries on an LDAP server. Requires dn.</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="NAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">NAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required if action = &quot;Query&quot;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Name of LDAP query. The tag validates the value. </p>

  </td>
  </tr>
  </table>
</div>
<div id="TIMEOUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TIMEOUT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "60000"


<p>Maximum length of time, in milliseconds, to wait for LDAP processing.</p>

  </td>
  </tr>
  </table>
</div>
<div id="MAXROWS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">MAXROWS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Maximum number of entries for LDAP queries.</p>

  </td>
  </tr>
  </table>
</div>
<div id="START">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">START</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required if action = &quot;Query&quot;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Distinguished name of entry to be used to start a search. </p>

  </td>
  </tr>
  </table>
</div>
<div id="SCOPE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SCOPE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "oneLevel"


<p>Scope of search, from entry specified in start attribute for action = &quot;Query&quot;. </p><ul>

<li>oneLevel: entries one level below entry. </li>

<li>base: only the entry. </li>

<li>subtree: entry and all levels below it. </li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="ATTRIBUTES">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">ATTRIBUTES</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required if action = &quot;Query&quot;, &quot;Add&quot;, &quot;ModifyDN&quot;, or &quot;Modify&quot;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>For queries: comma-delimited list of attributes to return. For queries, to get all attributes, specify &quot;*&quot;. </p>
<p>If action = &quot;add&quot; or &quot;modify&quot;, you can specify a list of update columns. Separate attributes with a semicolon. </p>
<p>If action = &quot;ModifyDN&quot;, ColdFusion passes attributes to the LDAP server without syntax checking.</p>

  </td>
  </tr>
  </table>
</div>
<div id="RETURNASBINARY">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">RETURNASBINARY</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>A comma-delimited list of columns that are to be returned as binary values.</p>

  </td>
  </tr>
  </table>
</div>
<div id="FILTER">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">FILTER</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "&quot;objectclass = *&quot;"


<p>Search criteria for action = &quot;query&quot;. </p>
<p>List attributes in the form: &quot;(attribute operator value)&quot; For example: &quot;(sn = Smith)&quot; </p>

  </td>
  </tr>
  </table>
</div>
<div id="SORT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SORT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Attribute(s) by which to sort query results. Use a comma delimiter.</p>

  </td>
  </tr>
  </table>
</div>
<div id="SORTCONTROL">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SORTCONTROL</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "asc"

<ul>

<li>nocase: case-insensitive sort.</li>

<li>asc: ascending (a to z) case-sensitive sort.</li>

<li>desc: descending (z to a) case-sensitive sort.</li>
</ul>

<p>You can enter a combination of sort types; for example, sortControl = &quot;nocase, asc&quot;. </p>

  </td>
  </tr>
  </table>
</div>
<div id="DN">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">DN</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required if action = &quot;Add&quot;, &quot;Modify&quot;, &quot;ModifyDN&quot;, or &quot;delete&quot;</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Distinguished name, for update action; for example, &quot;cn = Bob Jensen, o = Ace Industry, c = US&quot;</p>

  </td>
  </tr>
  </table>
</div>
<div id="STARTROW">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">STARTROW</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "1&#160;"


<p>Used with action = &quot;query&quot;. First row of LDAP query to insert into a ColdFusion query. </p>

  </td>
  </tr>
  </table>
</div>
<div id="MODIFYTYPE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">MODIFYTYPE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "replace"


<p>How to process an attribute in a multi-value list:</p><ul>

<li>add: appends it to any attributes. </li>

<li>delete: deletes it from the set of attributes.</li>

<li>replace: replaces it with specified attributes.</li>
</ul>

<p>You cannot add an attribute that is already present or that is empty.</p>

  </td>
  </tr>
  </table>
</div>
<div id="REBIND">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">REBIND</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "no "

<ul>

<li>yes: attempts to rebind referral callback and reissue query by referred address using original credentials. </li>

<li>no: referred connections are anonymous.</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="REFERRAL">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">REFERRAL</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Integer. Number of hops allowed in a referral. A value of 0 disables referred addresses for LDAP; no data is returned.</p>

  </td>
  </tr>
  </table>
</div>
<div id="SECURE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SECURE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Security to employ, and required information. One option:</p><ul>

<li>CFSSL_BASIC</li>
</ul>

<p>	&quot;CFSSL_BASIC&quot; provides V2 SSL encryption	and server authentication.</p>

  </td>
  </tr>
  </table>
</div>
<div id="SEPARATOR">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">SEPARATOR</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> ", [comma]"


<p>Delimiter to separate attribute values of multi-value attributes. Used by query, add, and modify actions, and by cfldap to output multi-value attributes. </p>
<p>For example, if $ (dollar sign), the attributes attribute could be &quot;objectclass = top$person&quot;, where the first value of objectclass is top, and the second value is person. This avoids confusion if values include commas.</p>

  </td>
  </tr>
  </table>
</div>
<div id="DELIMITER">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">DELIMITER</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "; [semicolon]"


<p>Separator between attribute name-value pairs. Use this attribute if either of these situations exist:</p><ul>

<li>the attributes attribute specifies more than one item</li>

<li>an attribute contains the default delimiter (semicolon). For example: mgrpmsgrejecttext;lang-en</li>
</ul>

<p>Used by query, add, and modify actions, and by cfldap to output multivalue attributes. </p>
<p>For example, if $ (dollar sign), you could specify &quot;cn = Double Tree Inn$street = 1111 Elm; Suite 100, where the semicolon is part of the street value.</p>

  </td>
  </tr>
  </table>
</div>

  </body>
</html>
