Running the Visual Basic .NET QuickStart Sample

This topic describes functionality that will be obsolete. This functionality is provided only to support legacy applications. Live Connect incorporates features that provide equivalent functionality.

This topic explains how to install, run, and extend the QuickStart sample provided in the Visual Basic .NET programming language.

The Visual Basic .NET QuickStart sample is preconfigured to use default values for the client ID, secret key, and return URL parameters. The return URL is preconfigured to point to http://localhost/webauth/sample/webauth-handler.aspx. For more information about how to customize these parameters, see Getting Your Client ID for Web Authentication.

When you install the sample, you put its files in the correct locations on your Web server. In this discussion, we assume that you have direct access to your Web server and that you develop and browse your site from the server.

Before you install the Visual Basic .NET QuickStart sample, make sure that Microsoft Internet Information Services (IIS), the .NET Framework 2.0, and ASP.NET are installed on your server. For IIS, make sure that:

  • A default Web site exists
  • The home directory of the default site is C:\Inetpub\wwwroot

To install the sample

  1. Run the Visual Basic .NET sample installation file (webauth-vb-1.2.msi).
  2. Copy the C:\Program Files\Windows Live ID\WebAuth directory to C:\Inetpub\wwwroot.
  3. Create a directory named App_Code under C:\Inetpub\wwwroot, if it does not already exist.
  4. Move C:\Inetpub\wwwroot\WebAuth\App_Code\WindowsLiveLogin.vb to the default App_Code directory at C:\Inetpub\wwwroot\App_Code\.

The Visual Basic .NET QuickStart sample is installed.

After you install the sample, you can run it to see a demonstration of how Windows Live ID works.

To run the sample

  1. Go to http://localhost/webauth/sample/default.aspx.
  2. Click Sign in. You are directed to the Windows Live ID sign-in page.
  3. Type your valid Windows Live ID and password to sign in. You are redirected to the sample application. The Sign in link has now changed to Sign out.
  4. Click Sign out. You are signed out.

Before you can extend the sample, you must first register your application as described in Getting Your Client ID for Web Authentication. After you register your application, substitute your own client ID and secret key for the default values specified in the web.config configuration file in the sample application.

Now you're ready to explore ways to develop the sample code further to meet your site's needs. Look through the Visual Basic .NET library in the file named WindowsLiveLogin.vb to see what additional functionality is available to you. You can also read the topics in the Web Authentication Reference section for even more information about how Web Authentication works.

You can also customize the sign-in and registration pages that your users experience. For more information, see Customizing Sign-in and Registration.

Finally, you can share your discoveries and learn from others by participating in the Windows Live ID Development Forum. See you there!

Other Resources

Live Connect