Difference between revisions of "LDAP Query Nodes"

From PresenceWiki
Jump to: navigation, search
Line 16: Line 16:
  
 
http://www.international-presence.com/images/docs/ldap/ldapinfo.png
 
http://www.international-presence.com/images/docs/ldap/ldapinfo.png
 +
 +
The LDAP Resource can also be accessed from the Resources Explore pane on the bottom left of the screen.
 +
 +
Creating a new resource requires username, password, host, root, class and port.
 +
 +
The class is generally com.sun.jndi.ldap.LdapCtxFactory and the port 389 as standard.
 +
 +
The root specifies where the query will start and can be used to improve speed and restrict results.
 +
 +
http://www.international-presence.com/images/docs/ldap/ldapresource.png
 +
 +
Once a resource has been created you can check the connection from the test tab.
 +
 +
http://www.international-presence.com/images/docs/ldap/ldapresourcetest.png
  
 
On the next tab you can see the tree which will give you an idea of what data is available on this active server.
 
On the next tab you can see the tree which will give you an idea of what data is available on this active server.

Revision as of 04:44, 1 October 2009

http://www.international-presence.com/images/nodes/ldap.png

The LDAP Query

The LDAP Query allows interrogation of Active Directories.

The output from the LDAP Query can then be integrated with a Presence Task in exactly the same way as other data sources to provide alerts or data integration facilities.

To add an LDAP Query to a Task you can select it from the right click menu or drag the LDAP Query icon from the Data Access list.

An LDAP Query is an anonymous task element meaning that when you create an LDAP Query it is only created for the current task and so does not get created as a list entry. You can copy an anonymous Task element from one task to another using CTRL+C to copy and CTRL+V to paste. For more information see the section on Anonymous and Specific Task elements.

When you double click or drop an LDAP Query on a Task the LDAP Query Editor dialog is shown, opening the Info tab:

Here you can specify the name of the Query and select or create an LDAP resource.

http://www.international-presence.com/images/docs/ldap/ldapinfo.png

The LDAP Resource can also be accessed from the Resources Explore pane on the bottom left of the screen.

Creating a new resource requires username, password, host, root, class and port.

The class is generally com.sun.jndi.ldap.LdapCtxFactory and the port 389 as standard.

The root specifies where the query will start and can be used to improve speed and restrict results.

http://www.international-presence.com/images/docs/ldap/ldapresource.png

Once a resource has been created you can check the connection from the test tab.

http://www.international-presence.com/images/docs/ldap/ldapresourcetest.png

On the next tab you can see the tree which will give you an idea of what data is available on this active server. Notice how the search base is updated as you click on different branches. The search base is used later as the starting point for the search. The search will begin on this branch and go through all sub branches.

http://www.international-presence.com/images/docs/ldap/ldaptree.png

On the conditions tab you specify what conditions you are interested in.

http://www.international-presence.com/images/docs/ldap/ldapconditions.png

In the where tab you drag and drop the conditions to make a where clause.

http://www.international-presence.com/images/docs/ldap/ldapwhere.png

It is the actual text in the text tab that is used in the query. Notice how the query is similar to but different from an SQL Query condition. If you edit the text directly then the previous two tabs (conditions and where) will be updated accordingly.

http://www.international-presence.com/images/docs/ldap/ldaptext.png

In the output tab you can select which fields you would like to be included in the output table.

http://www.international-presence.com/images/docs/ldap/ldapoutput.png

The test allows you to test the query.

http://www.international-presence.com/images/docs/ldap/ldaptest.png

After this you can see your results in table form.

http://www.international-presence.com/images/docs/ldap/ldapresults.png

For more on LDAP see:-

http://en.wikipedia.org/wiki/Lightweight_Directory_Access_Protocol