To implement Windows Live ID, you must register your Web site with Microsoft® as an application and receive an application ID for use with the service. Only a person who has a valid Windows Live ID can register an application and obtain an application ID. After you create the application, you can sign in and change it whenever you want.
.gif) Note: |
|---|
|
You do not need to register to run the QuickStart samples, but you must register before you can extend the samples for use on your live Web site.
|
| Important: |
|---|
|
The Web Authentication application ID is 64 bits (or 8 bytes or 16 hexadecimal digits) long. The User ID is 128 bits (or 16 bytes or 32 hexadecimal digits) long.
|
Registering Your Application
The Live Services Developer Portal assists you with the registration process, issues your application ID to you, and provides a place where you can continue to manage all the applications you register.
To get your application ID
-
Go to the Live Services Developer Portal.
-
Sign in by using your Windows Live ID.
| Note: |
|---|
|
If this is your first visit to this site, you will see several pages that configure your Windows Live ID for use with the site.
|
-
Click New Service.
-
Click Live Services: Existing APIs.
-
Provide the following information in the form on the Create a Service Component page.
|
Item
|
Description
|
|---|
|
Service Component Label
|
A unique and friendly name that you use to refer to your application. We recommend that you specify a human-readable name.
Important:
The service component label that you specify should contain only alphanumeric characters and cannot be changed after registration is complete.
|
|
Service Component Description
|
A description of the service component. You can change this description at any time.
|
|
Domain
|
The domain name of your application. For most applications, this domain name must be a fully qualified Domain Name System (DNS) name that is unique to your application.
Important: |
|
Return URL
|
The return URL is the URL of the page on your Web site to which the Windows Live ID authentication service redirects users (along with the authentication token) after they have successfully signed in, signed out, or cleared their cookies.
You must create a page on your Web site corresponding to the return URL, to handle the response from the authentication service. For more information, see Handling the Response from the Service.
You can change the non-domain part of the return URL later when you extend and adapt the sample code to your Web site.
Important:
If your return URL or other site pages use Secure Sockets Layer (SSL), use "https" in the src attribute for the sign-in link. For more information, see Displaying the Sign-in Link.
The return URL must be a fully qualified Domain Name System (DNS) URL pointing to a page on your Web site, and it must not contain IP addresses or query-string parameters.
|
-
Click Create. After your service component is created, the Summary page appears. This page contains the following information about your site:
-
Application ID. A 16-character string that represents your application. Record this string for later use.
-
Domain(s). The domains associated with your application.
-
Return URL. The return URL you specified for your application.
-
Secret Key. A security key that Windows Live ID uses to encrypt and sign all tokens that it sends to your site. You should record this key, but we recommend that you do not store it in the same location as its corresponding application ID.
Registration is finished! You can now begin implementing Web Authentication.
Whenever you want to retrieve or change your application data, return to the Live Services Developer Portal. Sign in with the Windows Live ID account that you used during registration to see and manage your application projects.