Building the C# SSO DLL

In the vSphere Web Services SDK, VMware supplies several sample Single Sign-On (SSO) clients for Visual Studio 2008. The SDK includes a project (.csproj) file for each sample, and a solution (.sln) file for the whole set of samples. The project files reference the DLL through which a client communicates with the SSO service.

The samples demonstrate how to authenticate with the SSO service, using the methods available to vSphere clients. The methods include the use of user credentials to authenticate and retrieve bearer and Holder-of-Key (HoK) tokens. You can use these methods to authenticate when running vSphere samples or other clients, such as the SimpleClient sample described in Running the Microsoft .NET C# Version of SimpleClient.

Build the C# SSO DLL

The samples in the SDK contain code to authenticate with an SSO server. Before you run the SDK samples, you must build the SSO DLL.

Prerequisites for Building the C# SSO DLL

■	install a C# development environment, as described in Setting Up for C# Development.

■	Open a Visual Studio command shell window and set environment variables as described in Set Environment Variables To Build C# DLLs and Samples.

To Build the C# SSO DLL

1	Open a Visual Studio Tools command shell.

2	Navigate to the .NET subdirectory for SSO client samples.

cd %WS_SDK_HOME%\ssoclient\dotnet\cs\samples

3	Generate a test certificate and STSService stubs using the build.bat script.

.\build.bat

4	Copy the SSO DLL to the %SDK_HOME%\vsphere-ws\dotnet\cs\samples\lib directory for use by the vSphere sample clients.

copy lib\STSService.dll %WS_SDK_HOME%\vsphere-ws\dotnet\cs\samples\lib\.