A data service is a web service that supports the query and modification of data regarding a principal. An example of a data service is a web service that hosts and exposes a principal's profile information, such as name, address and phone number. A query is when a web service consumer (WSC) requests and receives the data (in XML format). A modify is when a WSC sends new information to update the data. The Liberty Alliance Project has defined the Liberty ID-WSF Data Services Template Specification (Liberty ID-WSF-DST) as the standard protocol for the query and modification of data profiles exposed by a data service. Using this specification, the Liberty Alliance Project has developed additional specifications for other types of data services: personal profile service, geolocation service, contact service, and calendar service). Of these data services, OpenSSO Enterprise has implemented the Liberty Personal Profile Service.
The Liberty Personal Profile Service is a default OpenSSO Enterprise identity service. It can be queried for identity data and its attributes can be updated.
For access to occur, the hosting provider of the Liberty Personal Profile Service needs to be registered with the Discovery Service on behalf of each identity principal. To register a service with the Discovery Service, update a resource offering for that service. For more information, see Discovery Service.
The URL to gain access to the Liberty Personal Profile Service is:
http://SERVER_HOST:SERVER_PORT/SERVER_DEPLOY_URI/Liberty/idpp |
This URL is normally used by the OpenSSO Enterprise client API to access the service. For example, the OpenSSO Enterprise public Data Service Template client, com.sun.identity.liberty.ws.dst.DSTClient uses this URL to query and modify an identity's personal profile attributes stored in OpenSSO Enterprise.
OpenSSO Enterprise contains two packages based on the Liberty ID-WSF-DST. They are:
For more detailed API documentation, including methods and their syntax and parameters, see the Sun OpenSSO Enterprise 8.0 Java API Reference.
The following table summarizes the classes in the Data Services Template client API that are included in the com.sun.identity.liberty.ws.dst package.
Table 9–4 Data Service Client APIs
Class |
Description |
---|---|
DSTClient |
Provides common functions for the Data Services Templates query and modify options. |
DSTData |
Provides a wrapper for any data entry. |
DSTModification |
Represents a Data Services Template modification operation. |
DSTModify |
Represents a Data Services Template modify request. |
DSTModifyResponse |
Represents a Data Services Template response to a DST modify request. |
DSTQuery |
Represents a Data Services Template query request. |
DSTQueryItem |
Wrapper for one query item. |
DSTQueryResponse |
Represents a Data Services Template query response. |
DSTUtils |
Provides utility methods used by the DST layer. |
This package provides a handler class that can be used by any generic identity data service that is built using the Liberty Alliance ID-SIS Specifications.
The Liberty Personal Profile Service is built using the Liberty ID-SIS Personal Profile Service Specification, based on the Liberty Alliance ID-SIS Specifications.
The DSTRequestHandler class is used to process query or modify requests sent to an identity data service. It is an implementation of the interface com.sun.identity.liberty.ws.soapbinding.RequestHandler. For more detailed API documentation, see the Sun OpenSSO Enterprise 8.0 Java API Reference.