23.1 About the Directory Abstraction Layer (VDX) Web Service

The directory abstraction layer provides a logical view of the Identity Vault data. To support access by third-party software applications, the directory abstraction layer includes a Web service endpoint called the VDX Web Service. This endpoint lets you access the attributes associated with entities defined in the directory abstraction layer. It also lets you perform ad hoc searches for entities and execute predefined searches called global queries. You can think of global queries are stored procedures for LDAP.

This Appendix describes the programming interface for the VDX Web Service.

23.1.1 Accessing the Test Page

You can access the VDX Web Service endpoint using a URL similar to the following:

http://server:port/warcontext/vdx/service?test

For example, if your server is named “myserver”, your User Application is listening on port 8080, and your User Application war file is named “IDMPROV”, the URL would be:

http://myserver:8080/IDMPROV/vdx/service?test

23.1.2 Accessing the WSDL

You can access the WSDL for the VDX Web Service using a URL similar to the following:

http://server:port/warcontext/vdx/service?wsdl

For example, if your server is named “myserver”, your User Application is listening on port 8080, and your User Application war file is named “IDMPROV”, the URL would be:

http://myserver:8080/IDMPROV/vdx/service?wsdl

23.1.3 Locating the Stub Classes

The stub classes you need for the VDX Web Service are located in the wsclient.jar, which ships with the product. This JAR file is located in the idmuserapp/lib folder. To allow your code to find the stub classes, you need to add this JAR to your classpath.