Introduction
The last weeks I have been busy with the awesome package Microsoft delivers to schools and Universities called Live@edu, this package contains the following components:
- Administrative tools and components
- Free Live Services for students
- Free Live services for teachers
The first component, Administrative components, are the guidelines and the software that can be used to bring the Live services to students and teachers.
The second component, live services for students, consist of free hotmail (or outlook live). SkyDrive, workspaces and more of the Live Platform! The third component, live services for teachers, are the same services as for students but just to sure make you understand that both teachers and students are working in the same Live@edu domain so teachers can send messages to students without being afraid it’s being treated as junk mail.
This live@edu domain can be a sub domain of an existing domain (for example live.university.edu) or a new domain. Important is to know that mail for this domain needs to point to the Live Servers of Microsoft.
for more information about this package please visit the following sites:
Signing up
When you sign up for the Live@edu package, you will need to enter the information about your school and this will be verified by the live@edu support team.
After verification you can download the necessary software and request that “Single Sign On” is turned on for your domain, this will take at most 1 business week to be completed so do that as soon as possible. Also the second thing you need to request is a certificate for your live@edu domain. This is very important as this certificate will be used to authenticate the student or teacher during the SSO.
During the processing time
you can download the Live@edu Single SignOn Download Package and read the documents in that package (and all the other documents on the connect site about LiveId Administration and possibilities) also download the Hotmail MAv3 Download Package in which you can find the link to the Windows Live Admin Center SDK. In this document and files you will find the methods to provision the live accounts, this out of scope for this blog maybe I’ll focus on that later if there is a need for it.
Installation
The school that I helped to deploy live@edu was using SharePoint and wanted the students to be able to login to their mailboxes without entering credentials, so we looked at various webparts that are available for SharePoint. You can find 2 webparts on codeplex. This is not a good way to start, you can better set up the SSOPortal that is in the SSO Package to be sure that that all parts in the process are working:
- SSO is activated
- Certificate is correct
- rights have been set correctly to the certificate private key
- connection from server to live servers is working fine
When all this is working and the sAMACount is connected to the LiveId, this SSOPortal will let the user request a ticket and with that ticket connect to the live services.
Also by using this SSOPortal, you can request assistance from live@edu support
Setting up the fourportal site
It’s not difficult to setup the site if you just think of it as a test to see if everything is working correctly.
- First you need to create a directory under c:\inetpub\wwwroot\ssoportal
- then copy the content of the fourportal directory from the sso package to the ssoportal directory you just created.
- Now in IIS create a new website and point it to the ssoportal directory. Make sure the application Pool account is network service!
- Use a hostheader of ssoportal for the http protocol
- use hostfile or dns to point ssoportal name to this server.
You will need to change the web.config in this new website. Detailed instructions are in the Microsoft Live@Edu SSO 4.1 package but choose for scenario A (liveId equals samaccount) or B (use XMLfile lookup). I’ve used scenario B as the samaccounts where not the same as the LiveAccounts and we found out later, that when you use a specific webpart, you will need to use the Mail Attribute of an AD account to map the Live Account so scenario B comes close in this scenario.
Make sure the authentication settings on the new website are windows authentication Enabled and anonymous Disabled!
In the c:\inetpub\wwwroot\ssoportal\app_data\ directory you can find a studentlogin.xml where you can define the mapping between sAMACount and LiveId
Example:
<?xml version=”1.0″ encoding=”utf-8″ ?>
<students>
<entry windowsLiveID=”admin” sAMAccountName=”tst_admin”/>
<entry windowsLiveID=”jack.linssen” sAMAccountName=”jack”/>
</students>
Now please follow the instructions in the SSO_Webportal_MSliveEmail.docx (appendix A) to install the received certificate into the local computer certificate store. When that has been done you will need to install the winhttpcertcfg.msi which is in the Microsoft Live@Edu SSO 4.1 package and then run the SetupCert32.bat or SetupCert64.bat depending on your platform to allow network service to read the private key of the certificate.
Setting up the RPS Service
Now we need to install the RPSService which handles the Windows Live Passport tickets. The manual explains how to install it but the screenshots are a bit misleading so here are the steps you need to perform:
- From a Administrator Commandprompt run the rps32.msi or rps64.msi depending on your platform
- Start Installation Screen –> Click Next
- License agreement screen –> click “I accept..” then click Next
- Customize setup screen –> Click Next
- Target Environment screen –> select Production and click Next
- Configure Live Id Server Screen –> Click Next (you don’t have to enter a path)
- Optional Screen –> Click Next
- Second Optional Screen –> Click Next
- Service Account screen –> Click Next (Use network Service)
- Ready to Install screen –> Click Install
- in the Completing.. screen –> Click finish
- copy the RPSserver.xml to C:\Program Files\Microsoft Passport RPS\config directory
Check if the Passport RPS Service is running and then check the Windows System Eventlog if there are no errors for Source “DistributedCom” with the following (part of) text:
The application-specific permission settings do not grant Local Activation permission for the COM Server application with CLSID
{AD74AA3B-1286-4990-954B-DB2E4EEA652C}
Make sure the network service has local activation and local launch rights and Local access permissions on the dcom object rpssvc

Testing the connection
Now that we installed and configured the components we can start to test the connection. Open a web browser and go to the http://ssoportal website as configured before. You will see a screen similar to the following screen:
Click on step 1 and it should return your current windows user account:
Now step 2 is available, click on it and it needs to return the live Id which matches your windows user account as defined in studentlogin.xml
Moment of truth.. click on the button Step 4 and wait for a GREEN result
If you get a RED response then something wend wrong. The errors that I have seen are:
- Private Key could not be read – make sure the account the application pool is running on has access to the certificate private key (SetupCert<platform>.bat)
also make sure that in the web.config <identity impersonate=”true” /> is changed to <identity impersonate=”False” />
- 407 proxy Authentication required – Make sure that in the web.config of the website <proxy autoDetect=”true” /> is changed to <proxy autoDetect=”False” />
This only occurs normally when the WPAD Configuration for ISA is defined.
So now that we have a ticket, we can click on the last step, step 5 to start a new browser and login to our live account automatically without entering a password!
In the next part of this blog I will explain how to install and configure the chisholm webpart for Live@edu
Thank you!
I would like to thank the following people from Microsoft who helped me in troubleshooting the installation and configuration:
Girish Kumar, Roshan Rajkumar, Shawn, Sai Ketha, Josh Clarke, Sophian, Prajakta Pitale and ofcourse Amit Shinde who helped me solve the last issues.
also thanks to Ruud Heemskerk and Donny van Huizen from Wortell for their assistance!