vCenter Single Sign On SDK Readme

  Readme for Java Samples
  Readme for the vSphere Management SDK

What is the vCenter Single Sign On API?

A vCenter Single Sign On client uses the vCenter Single Sign On API to connect to the vCenter Single Sign On Server for the purpose of obtaining a security token. The token contains authentication claims required for operations in the vSphere environment. The vCenter Single Sign On API supports operations to acquire, renew, and validate tokens.

For information about how to use the vCenter Single Sign On API, see the vCenter Single Sign On Programming Guide. For access to the guide, use the link to the vSphere Document Center on the vSphere Web Services SDK Documentation page.

What’s in the SDK Package?

The vCenter Single Sign On SDK provides:

• Sample code that demonstrates the following tasks:
  
  
  • How to use the vCenter Single Sign On API to retrieve a SAML token.
  • How to use the LoginByToken method to establish a single sign on session.
  
  The sample code includes compiled and ready-to-run Java class files, as well as Java source code files. See the readme file for the java samples (readme_java) for information about building and using the samples.
  
  
• Web Services Definition Language (WSDL) definitions that describe the API for accessing the vCenter Single Sign On Server. The SDK contains the STSService.wsdl file and the supporting schema files.


• Shell scripts to run the sample applications.
  
  
• Compiled client-side libraries (ssoclient.jar, vim25.jar, samples.jar) for testing and development purposes.

The vCenter Single Sign On SDK is contained in the SDK\ssoclient directory in the vSphere Management SDK.

The following table contains a brief description of the contents of the vCenter Single Sign On Client SDK.

Directory structure (under \SDK\ssoclient):

VMware Resources

• Developer Center
• Knowledge Base
• User Groups
• VMware Communities

For released product information, including known issues, see the VMware Infrastructure SDK page. Be sure to read the Release Notes for the most recent information.