Instructions for Building and Testing the Release

Coordinator
Jul 3, 2007 at 1:42 PM
These notes are also found on the 1.0.2 Release.

Instructions to test this application
These instructions should take you step by step through setting up a dev environment to get this site running.

Using the current source release 1.02, Download the zip, extracted it and open the SingleSignOn.sln file in the root folder. This loads four projects in a solution: SSOSite, SSOTestSite, SingleSignOn, and TestWindowsClient. The solution should compile in its current form. Go ahead and do this so it copies all the dlls into the web folders if they're not there already.

The SSOSite is the main web site that hosts all the central users and web services.
The SingleSignOn is just a class library used for reference in both the client and the server.
The SSOTestSite and TestWindowsClient are both web service client samples that get their user information from SSOSite.

In a dev environment, you'll need to figure out what port your debug SSOSite runs on. This changes by machine. So I just set it as the startup project, and run it either with or without debug mode. The url will be something like http://localhost:1242/SSOSite/ Copy this information.

Open your web.config file in SSOTestSite and your app.config file in your TestWindowsClient project. In both files, change the value for the WebServiceUrl. Replace the existing http://localhost:xxxx/SSOSite/ with the new one you copied in debug mode.

Recompile.

To test this application, the first thing you need to do is run the SSOSite website. You can do this with or without debug mode. After you stop debugging, the web server should remain running. The easiest way to see if the client sites work properly is to select the SSOTestSite and click its ASP.NET Configuration button in visual studio solution explorer. You'll see the web page come up and if it's working properly, you'll see Existing Users: 3. You should also be able to enter the security section and see in the summary, Existing Users: 3. Existing Roles: 2.

You can also just run the test site or the test windows application and and login with:
testadmin:testpass#
testuser:testpass#

Managing Users
You can use either the aspnet configuration tool for the SSOTestSite or the SSOSite to manage users. There are some open source projects out there that give you a customized portal for this as well.
Jul 27, 2007 at 8:20 PM
It should be mentioned also, that if you do not have SQLExpress installed but a full version of SQL Server, you will not be able to run the application successfully until you update the following line in the web.config file of the SSOSite Project:

Original:
<add name="LocalSqlServer" connectionString="Data Source=.\SQLEXPRESS;AttachDbFilename=|DataDirectory|\SingleSignOn.mdf;Integrated Security=True;User Instance=True"/>

Change To:
<add name="LocalSqlServer" connectionString="Data Source=<YourServerName\ServerInstance>;AttachDbFilename=|DataDirectory|\SingleSignOn.mdf;Integrated Security=True"/>

Note that the "User Instance" setting is not supported and had to be removed.