Click here to download the sample code
Ever wondered if there was a programmatic way to connect your web site with Live Mesh and other Live Services? Your Web site can request permission from your users to access their Live Mesh data such as photos, videos files or application data or Windows Live data such as Contacts and Profile information. Live ID Delegated Authentication serves to enable a Web site to connect to the Live Framework and provide access to a user’s data. The sample code featured in this posting uses a a simple ASP.NET Web application to demonstrate the basic tasks involved with using delegated authentication in conjunction with the Live Framework. This posting contains instructions for deploying and running the sample.
Before You Start
To Create a new Web site using the Developer Portal
Before you add Delegated Authentication to your Live Framework-enabled Web site you first need to visit the Azure Services Developer Portal (https://lx.azure.microsoft.com/Cloud/Provisioning/Default.aspx) to register the Website. Take the following steps to register:
To Add the Live Framework References
Prior to running the sample, you will need to open the project in Visual Studio and add the appropriate references for the Live Framework assemblies. Here's how to do it:
To Run the Sample
There are two options here, you can either deploy the sample site on a live Web server, or test it on your local computer. If you plan to deploy the site on a live Web server, you should do so before proceeding any further. Deploy the sample to your web server as you would do so for any ASP.NET Website.
If you want to run it locally, create a folder at C:\InetPub\wwwroot\LiveFX_DelAuth, and unzip the contents of the archive to that folder. The next section contains instructions for setting up your domain and return URL so that it will work in a testing environment. This example assumes that you are using Internet Information Server.
Deploy and Register the Sample Site
Update the web.config File
The WindowsLiveLogin class requires updating the configuration settings to the web.config file for the project. Add the appSettings tag, and add the following key-value pairs:
This is the relative self-link that is used by Live Framework to reference your application. This value is provided for you by the Azure Services Developer Portal when you register your Mesh Application. If you are not using a Mesh Application, this key is not required. This value should be a relative URL, starting with Mesh/Applications. If the Azure Services Developer Portal lists a longer URL, then remove the beginning portion. In this example, it is "/Mesh/Applications/[value for ID]".
<add key="wll_appid" value="000000004863583G"/>
<add key="wll_secret" value="KfMbFMkVx95G4prAxF64gW78A3bK65HT"/>
<add key="wll_securityalgorithm" value="wsignin1.0"/>
<add key="wll_returnurl" value="http://MyDomain.com/MyWebsite/delauth-handler.aspx"/>
<add key="wll_policyurl" value="http://MyDomain.com/MyWebsite/Policy.aspx"/>
<add key="wll_consenturl" value="developer.mesh-ctp.com/web/apps/appconsent.aspx"/>
<add key="wll_appurl" value="/Mesh/Applications/FAQ1234B47ZENA5P2GWFSJRLUV"/>
Summary of Sample Website Features
This page, and its accompanying code-behind page, contain code that checks for a session cookie with a delegated authentication token. If a token is not found, a link to the consent page is provided. This sample uses session cookies for the sake of brevity; you can substitute standard site cookies instead. If a token exists (which will be the case immediately after requesting consent), the token itself is displayed on the page, and a link is displayed to connect to the Live Operating Environment.
This is the page that handles the return request from the server. If the request is of type "delauth" it calls WindowsLiveLogin.ProcessConsent, passes the results of the form, and returns a consent token. The delegation token is then extracted from the consent token and added to the Session cookie.
This class is taken directly from the Windows Live ID Delegated Authentication SDK, and added to the App_Code folder for this sample. It provides the basic functionality for managing authentication data.
Running the app
For More Information, see:
Accessing Existing Resources by Using Delegated Authentication (http://msdn.microsoft.com/en-us/library/dd217567.aspx)
Windows Live ID Delegated Authentication SDK for Application Providers (http://msdn.microsoft.com/en-us/library/cc287637.aspx)