<cfldap>

Provides an interface to LDAP Lightweight Directory Access Protocol directory servers like the Microsoft Active Directory.

This tag cannot have a body.

This tag is also supported within <cfscript>

Attribute Description Default
returnasbinary
string, optional

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

sort
string, optional

Indicates the attribute or attributes by which to sort query results. Use a comma to separate attributes.

filter
string, optional

Search criteria for action = "Query". List attributes in the form: "(attribute operator value)" Example: "(sn = Smith)"

server
string, required

Host name "biff.upperlip.com" or IP address "192.1.2.225" of the LDAP server.

start
string, optional

Specifies the distinguished name of the entry to be used to start the search.

rebind
boolean, optional

If you set rebind to Yes, cfldap attempts to rebind the referral callback and reissue the query by the referred address using the original credentials. The default is No, which means referred connections are anonymous.

dn
string, optional

Specifies the distinguished name for update actions.

startrow
number, optional

Used in conjunction with action = "Query". Specifies the first row of the LDAP query to insert into the query. The default is 1.

separator
string, optional

Specifies the character that cfldap uses to separate attribute values in multi-value attributes. This character is used by the query, add, and modify action attributes, and by cfldap to output multi-value attributes. The default character is the comma (,).

password
string, optional

used when username is defined

maxrows
number, optional

Specifies the maximum number of entries for LDAP queries.

name
string, optional

The name you assign to the LDAP query.

filterfile
string, optional

this attribute is deprecated and no longer supported.

referral
number, optional

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

port
number, optional

Port defaults to the standard LDAP port, 389.

scope
string, optional

Specifies the scope of the search from the entry specified in the Start attribute for action = "Query".

timeout
number, optional

Specifies the maximum amount of time, in seconds, to wait for LDAP processing. Defaults to 60 seconds.

action
string, optional

Specifies the LDAP action.

query

delimiter
string, optional

Specifies the character that cfldap uses to separate multiple attribute name/value pairs when more than one attribute is specified in the attribute attribute or the attribute that you want to use has the default delimiter character, which is the semicolon (;), such as mgrpmsgrejecttext;lang-en. The delimiter character is used by the query, add, and modify action attributes, and is used by cfldap to output multi-value attributes

modifytype
string, optional

Indicates whether to add, delete, or replace an attribute in a multi-value list of attributes.

attributes
string, optional

Required if action = "Query", "Add", "ModifyDN", or "Modify" For queries: comma-delimited list of attributes to return. For queries, to get all attributes, specify "*".

        If action = "add" or "modify", you can specify a list of update
        columns. Separate attributes with a semicolon.
        If action = "ModifyDN", CFML passes attributes to the
        LDAP server without syntax checking.
secure
string, optional

The type of security to use

username
string, optional

If no user name is specified, the LDAP connection is anonymous.

sortcontrol
string, optional

Specifies how to sort query results.

<cfldap
    [returnasbinary=string]
    [sort=string]
    [filter=string]
    server=string
    [start=string]
    [rebind=boolean]
    [dn=string]
    [startrow=number]
    [separator=string]
    [password=string]
    [maxrows=number]
    [name=string]
    [filterfile=string]
    [referral=number]
    [port=number]
    [scope=string]
    [timeout=number]
    [action=add|delete|modifydn|modify|query]
    [delimiter=string]
    [modifytype=string]
    [attributes=string]
    [secure=string]
    [username=string]
    [sortcontrol=string]
>

Examples

There are currently no examples for this tag.

See also