Date: Thu,  9 Dec 2010 14:51:45 +0000
Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
Content-Type: application/x-phpwiki;
  pagename=Help%2FLdapSearchPlugin;
  flags=PAGE_LOCKED;
  markup=2;
  charset=UTF-8
Content-Transfer-Encoding: binary

The **~LdapSearch** [[Help:WikiPlugin|plugin]] displays a LDAP query as table.

== Usage ==
{{{
<<LdapSearch>>
<<LdapSearch
           host="localhost"
           port=389
           basedn=""
           filter="(cn=*)"
           attributes=""
>>
<<LdapSearch host=ldap.example.com filter="(ou=web-team)"
                      attributes="sn cn telephonenumber">>
<<LdapSearch host="ldap.itd.umich.edu" basedn="" filter="(sn=jensen)" attributes="cn drink">>
<<LdapSearch host=ldap.example.com attributes="cn sn telephonenumber">>
<<LdapSearch host=bugs.debian.org port=10101 basedn="dc=current,dc=bugs,dc=debian,dc=org"
                      filter="(debbugsPackage=phpwiki)"
                      attributes="debbugsSeverity debbugsState debbugsTitle">>
}}}

== Arguments ==

host _(default: from LDAP_AUTH_HOST or localhost)_:
        hostname or ip or ldap:// uri to connect to.

port _(default: from LDAP_AUTH_HOST or 389)_:
        portnumber to connect to.

basedn _(default: LDAP_BASE_DN)_:
        connect string: "ou=Users,o=Development,dc=mycompany.com"

filter _(default: "(cn=*)")_:
        Optional ldap_search() filter argument

attributes _(default: empty)_ :
        space seperated fields to return as table columns: "cn sn"

options:
        ldap_set_option(). Default: LDAP_SET_OPTION if host == LDAP_AUTH_HOST
        Column seperated name=value pairs. Esp. needed for Windows Active directory:
        "LDAP_OPT_PROTOCOL_VERSION=3:LDAP_OPT_REFERRALS=0"
user:
        Default: LDAP_AUTH_USER if host == LDAP_AUTH_HOST
password:
        Default: LDAP_AUTH_PASSWORD if host == LDAP_AUTH_HOST
        user and password are required for Windows Active directory.

== Examples ==

<<WikiFormRich action=LdapSearch
        editbox[] name=host value=bugs.debian.org size=80
        editbox[] name=port value=10101 size=80
        editbox[] name=basedn value="dc=current,dc=bugs,dc=debian,dc=org" size=80
        editbox[] name=filter value="(debbugsPackage=phpwiki)" size=80
        editbox[] name=attributes value="debbugsSeverity debbugsState debbugsTitle" size=80
        submit[] reset[]
>>

== Author ==
* [[PhpWiki:JohnLines|John Lines]]

== See Also ==

<noinclude>
----
[[PhpWikiDocumentation]] [[CategoryWikiPlugin]]
</noinclude>