MOSS Single Sign On Setup Step-By-Step

MOSS Single Sign On Setup Step-By-Step

Posted by Robert L. Bogue on Saturday, 2 Aug 2008 07:18 | 59 Comments |

With a TechNet article titled "Configure single sign-on (Office SharePoint Server)" one might wonder why I'd feel the need to write a blog post on how to setup Single Sign-On. The answer is that the TechNet article is incomplete (as of this publishing) and obtuse. So my hope is to walk through the process with screen shots so that you can see exactly what to setup and what the values should be.

There are seven main activities that we need to do:

1. Create the SSO service account -- This is the account that the service will run under.
2. Create the SSO groups -- These groups are used to control who has the ability to administer SSO (export the master key) and who has the ability to manage it (add/remove application definitions.)
3. Configure the SSO Service - Set SSO to start and get it to use the service account.
4. Configure SQL Server - Authorize the SSO service account to SQL server.
5. Manage SSO - Setup SSO in MOSS including the groups and the database.
6. Manage the encryption key -- Create the encryption key that will be used for protecting the username and password information on the system.
7. Manage settings for enterprise application definitions -- Define what initial applications SSO will be setup to manage passwords for.

In each of the next sections, I'll walk you through dialog-by-dialog what you need to select and what to do in order to get a working setup.

Create the SSO Service Account

We need to create an account for the "Microsoft Single Sign-on Service" (SSO Service) to run as. This account has to be a domain account that has local administrative privileges for the front end web servers, must be a member of the SharePoint group Farm Administrators, must have db_creator and security administrator roles in SQL Server, and must be a member of the group that is defined as SSO administrators. Obviously this is a few requirements. We'll work on the getting this account and the appropriate groups setup over the next several major steps. In this section we'll concentrate on getting the account setup.

In the following steps I'm going to add the user to the Domain Admins group in order to get the local administrator privileges requirement met. If you are working on a production installation, I'd recommend creating a group for SharePoint Farm Administrators and add that group to the local administrators group of each of the front end web servers -- as well as the index server. If you do this, use your farm administrators group rather Domain Admins in the steps below.

Let's get started.

1. From the Start Menu click Administrative Tools-Active Directory Users and Computers
2. In the left hand pane on the Users folder right click and select New-User from the menu that appears. If your organization places service accounts in a different organizational unit (OU) you can certainly add this account to that location.
   
3. Enter the First Name (SharePoint SSO), Last Name (Service), and User logon name (SharePointSSOSvc) fields and click the Next button. You can name the account anything you want, however, these values make it clear what the account is used for.
   
4. Enter the a password into the Password and Confirm password fields. Uncheck the User must change password at next logon checkbox. Check the User cannot change password and Password never expires checkboxes. Click the Next button. This sets the account up to be a service account.
   
5. Click the Finish button.
6. On the user that was just created, right click and select Properties.
   
7. Click the Member Of tab.
   
8. Click the Add button
   
9. Enter the group name Domain Admins and click Check Names then click OK. As mentioned above, if you're using another group to provide local administrator access to the farm servers, use that group here.
10. Click the OK button.

With the user account created and added to a group that will have administrative access to the farm servers. Next we need to create the groups that we'll add the users capable of managing SSO into.

Create the SSO Groups

There are two important groups for SSO. The first group is the administrative group which includes those users capable of administering SSO. This includes the ability to backup and restore the encryption key -- because of this they can effectively decrypt all user credentials in the SSO database and thus membership to this group should be severely limited. The second group, a managers group, is used to manage the application profiles in the SSO system. This group doesn't directly have access to passwords but could inadvertently delete all of the stored passwords. In the following steps we'll create both groups and add the SSO service account we created above into the administrators group.

1. In Active Directory Users and Computers (still open from the last set of steps) from the left pane right-click Users and select New-Group. As before if your organization requires that groups be placed in a different OU, select that OU to create group in.
   
2. Enter the Group Name (SharePoint SSO Administrators) and click the OK button.
3. Left click the new group, and then right click the new group and select Properties.
   
4. Click the Members tab.
   
5. Click the Add button.
   
6. Enter SharePointSSOSvc, click the Check Names button, and click the OK button.
7. Click the OK button.
8. In the left pane, right click Users and select New-Group. As before, if your organization requires a different location, use that location.
9. Enter the Group Name (SharePoint SSO Managers) and click the OK button.
10. Close Active Directory Users and Computers, we're done with it.

With the groups created we're ready to configure the service to automatically start.

Configure the SSO Service

By default the SSO service in SharePoint doesn't start. In this activity we're going to enable the SSO service. On each server in the farm and then once completed we're going to change the account used for SSO in SharePoint Central Administration.

Let's start by setting the service to start automatically and manually starting it.

1. On the Start menu click Administrative Tools-Services
2. In the Services application in the right hand pane scroll down to the Microsoft Single Sign-on Service, right click and click Properties.
3. Change the Startup type from Manual to Automatic.
4. Click the Start button.
5. Click the OK button.
6. Close the Services application. We're done with it.
7. Repeat steps 1-5 on each server in the SharePoint farm.
8. On the Start menu click Administrative Tools-SharePoint 3.0 Central Administration
   
9. Click the Operations tab.
   
10. In the Security Configuration section, click the Service Accounts link
    
11. In the Windows service drop down list select Single Sign-on Service.
12. Enter the Username (DEMO\SharePointSSOSvc) and Password for the service account and click the OK button.

With that the SSO service is running, however, it doesn't have access to SQL server so we need to fix that before managing the settings.

Configure SQL Server for the SSO Service Account

The SSO service account needs to create the SSO database and setup the correct permissions. In order to do that it needs the security administrator (securityadmin) and database creator (dbcreator) system roles. In the following steps we'll get permissions setup for the service account.

1. On the Start menu click All Programs -Microsoft SQL Server 2005 - SQL Server Management Studio.
   
2. If your server name isn't correct in the dialog select the correct server. Then click the Connect button to connect to your SQL server.
3. Click on the plus sign to the left of Security to expand it. Click on the plus sign to the left of Logins to expand it.
4. Right click on the SharePoint SSO service account (DEMO\SharePointSSOSvc) and click properties.
   
5. In the Select a page (left) pane select Server Roles.
   
6. Click the checkboxes to the left of dbcreator and securityadmin.
7. Click the OK button.
8. Close Microsoft SQL Server Management Studio, we're done with it.

In these steps we corrected the permissions for the SSO service account so that it can work with SQL server. Next is to complete the activation in SharePoint by using the Manage settings for single sign-on link.

Manage Settings for Single Sign-on

In this step we'll go through the process of creating the SSO database by using the Manage settings for single sign-on link on the central administration operations screen. The SharePoint central administration operations screen should be on your screen from the previous steps.

1. On the SharePoint Central Administration Operations page in the Security Configuration heading select the Manage settings for single sign-on link.
2. Click the Manage server settings link.
   
3. In the far upper right corner, click the down arrow next to Welcome System Account (or whatever name is displayed.) From the menu that appears, select Sign in as a Different User.
4. In the User name text box enter the SharePoint SSO Service Account (DEMO\SharePointSSOSvc) and in the Password text box enter the account's password.
   
5. Enter the administrators group name including the domain name (DEMO\SharePoint SSO Administrators)in the Single Sign-On Administrator Account section's Account name textbox.
6. Enter the managers group name including the domain name (DEMO\SharePoint SSO Managers) in the Enterprise Application Definition Administrator Account section's Account name textbox.
7. Click the OK button.

With that the SSO database will be created and we're nearly done. We need only to get an encryption key created and to create an application definition.

Manage the Encryption Key

The next step is creating an encryption key for the credentials to be encrypted with. In order to do this, follow these steps:

1. On the Manage Settings for Single Sign-on page click the Manage encryption key link
   
2. Click the Create Encryption Key button.
   
3. Click the OK button.
4. In the breadcrumbs, click the Manage Single Sign-On link.

With an encryption key set, you're ready to create an application definition.

Manage Settings for Enterprise Application Definitions

The final step is to define an application definition for SSO. This can be done with the following steps.

1. On the Manage Settings for Single Sign-On for... page in the Enterprise Application Definition Settings, click the Manage settings for enterprise application definitions link.
   
2. Click the New Item button.
   
3. Enter a Display name (Demo Application), a Application name (Demo), and Contact e-mail address ([email protected]).
4. Select the Account type. Generally this will be Individual. Note that this cannot be changed once the application has been defined.
5. Click the OK button.
6. Close the web browser with central administration -- we're done.

Special Thanks to Hollins University. This is documentation that I did for them that they agreed I could share with everyone.