The following instruction helps you to deploy Shetab Windows Live Authentication for SharePoint solution in your SharePoint server. The only requirement is administrative access to Windows Server of SharePoint. Login to server running SharePoint and follow the instruction.
*Note: If you already install or test CKS solution for Windows Live Authentication, we recommend it to uninstall it fist if possible. the following step is same way.
Step1: Deploy the Shetab Windows Live Authentication for SharePoint solution in your SharePoint server
- Download the Shetab Windows Live Authentication for SharePoint package from here.
- Extract downloaded ShetabSharePointWLA.zip file.
- run "Deploy.bat" to deploy the solution. it will execute the sequence required to deploy the solution in your Server. If you already deploy the old version of the solution you should run "Redeploy.bat" file.
Step2: Register a Windows Live ID Application
After the solution installed successfully you should register your application in live.com.
- Login to https://msm.live.com/app/default.aspx
- Click on the "Register an Application" link.
- The "Service Component Label" is a name you will use to identify your application.
- The "Service Component Description" is description of your application and you can leave it blank.
- The "Domain" is domain name of return URL in next field, eg: yourservername.com. You could not change it in future after you set it. *See note.
- The "Return URL" must be set to http://yourservername.com/_layouts/liveauth-handler.aspx. *See note.
- The Secret Key is used to sign the authentication responses (this is the "AppKey" you will need later).
- Submit the registration.
- Click on the "Manage My Applications" link.
- Now you can see the registered application and its "Application ID". (this is "AppId" you will need later).
*NOTE: in testing environments where you have not domain name, you can leave domain empty and set "Return URL" to http://localhost:80/_layouts/liveauth-handler.aspx. You can also set any other appreciate port number rather than 80.
Step3: Configure your Web Application Authentication
Now you should configure the web application to use Windows Live ID authentication. A new STSADM command has been added to help with this process. To complete the configuration you must:
- Go to the Central Administration home page.
- Click on the Application Management tab.
- Click on the Authentication providers link in the Application Security section.
- Use the Web Application drop down to ensure that the correct web application is selected.
- In the Zones list pick the zone you want to enable Live ID Authentication on (Default is probably going to be what you are looking for). You may have more than one zone and login to your site with Windows Live ID authentication and Windows Authentication at same time.
- Select the Authentication Type of Forms.
- Enter a Membership provider name of LiveID.
- Enter a Role manager name of LiveRoles.
- Click the Save button.
Step 4: Configure your SharePoint Web Application "web.config" file
To finish configuration you must set default authentication provider for your SharePoint web application.
*Note: If you already install or test CKS solution for Windows Live Authentication, some parameter are changed here.
- Open a command prompt and type the following command line. you can aloso edit config.bat in folder where you extract ShetabSharePointWLA.zip and edit appreciate valueType instead type following command:
"C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\bin\stsadm.exe" -o addwindowsliveauth -url <SharePointSiteUrl> -appid <appid> -appkey <appkey> -appmode http -profsite <SharePointSiteUrl> -locked <url> -ValidateEmail -SiteOwnerEmail <email>
- Open your SharePoint Web Application "web.config" file (Usually exist in c:\Inetpub\wwwroot\wss\VirtualDirectories\<PortNumber>).
- Find <membership> tag and change it with <membership defaultProvider="LiveID">
- Find <roleManager> tag and change it with <roleManager defaultProvider="LiveRoles" enabled="true" cacheRolesInCookie="true" cookieName="liveroles">
- Perform an IISRESET.
Congratulation, Your site is now using Windows Live ID authentication. If you have any problem please contact us.
See Also