How to enable Single Sign-On for my Terminal Server connections

How to enable Single Sign-On for my Terminal Server connections

  • Comments 58
Note: This post was updated on March 12, 2009, to include the latest information. 

What is Single Sign-On?

When applied to Terminal Services, Single Sign-On means using the credentials of the currently logged on user (also called default credentials) to log on to a remote computer. If you use the same user name and password logging on to your local computer and connecting to a Terminal Server, enabling Single Sign-On will allow you to do it seamlessly, without having to type in your password again.

Locally logged on credentials are used for connecting to TS Web Access, however, they cannot be shared across TS Web Access and TS or TS Gateway. Thus you will need to enable the Group Policy settings described below in order to use locally logged on credentials for TS or TS Gateway connections.

How to enable Single Sign-On?

Single sign-On can be enabled using domain or local group policy.

  1. Log on to your local machine as an administrator.
  2. Start Group Policy Editor - "gpedit.msc".
  3. Navigate to "Computer Configuration\Administrative Templates\System\Credentials Delegation".
    Group Policy Editor
  4. Double-click the "Allow Delegating Default Credentials" policy.
  5. Enable the policy and then click on the "Show" button to get to the server list.
    Group Policy 
  6. Add "TERMSRV/<Your server name>" to the server list. You can add one or more server names. Using one wildcard (*) in a name is allowed. For example to enable Single Sign-On to all servers in "MyDomain.com" you can type "TERMSRV/*.MyDomain.com". (Notice the "Concatenate OS defaults with input above" checkbox on the picture above. When this checkbox is selected your servers are added to the list of servers enabled by OS by default. For Single Sign-On this default list is empty, so the checkbox has no effect.)
    Group Policy Value
  7. Confirm the changes by clicking on the "OK" button until you return back to the main Group Policy Object Editor dialog.
  8. At a command prompt, run "gpupdate" to force the policy to be refreshed immediately on the local machine.
  9. Once the policy is enabled you will not be asked for credentials when connecting to the specified servers.

What are the limitations when using Single Sign-on?

  • Single Sign-On works only when connecting from an XP SP3, Vista or a Windows Server 2008 machine to a Vista or Windows Server 2008 machine. Please see this KB article about enabling CredSSP on XP SP3 which is required for Single Sign-On.
  • If the server you are connecting to cannot be authenticated via Kerberos or SSL certificate, Single Sign-On will not work. You can circumvent this restriction by enabling "Allow Default Credentials with NTLM-only Server Authentication" policy, which is less secure. (NTLM-only Server Authentication is less secure compared to using Certificates or Kerberos.)
  • If you have saved credentials for the target machine they take precedence over the current credentials.
  • Single Sign-On works only when using domain user accounts. Please see section below regarding user experience for non-domain clients.
  • If the Terminal Server connection is configured to go through a TS Gateway server then in some cases the settings of the TS Gateway server can override the TS Single Sign-on setting.
  • If the terminal server is configured to Always prompt or RDP file setting Always prompt, then Single Sign-on to TS will not work.
  • Single Sign-on only works with Passwords. Does not work with Smartcards.

Why is Single Sign-On controlled by Group Policy?

As a part of the logon process TS Client sends the actual user credentials (user name and password) to the server. If a code running as a regular user were allowed to enable Single Sign-On, any malicious software (virus, Trojan, spyware etc.) running in the user's session would be able to send the user's password to any machine on the network. So, only administrators should be allowed to decide which servers are safe for Single Sign-On.

Thus Single Sign-On can only be enabled on domain-joined client machines.

What if I have Single Sign-On enabled but want to use different credentials this time?

Start TS Client. Click the "Options" button. Select the "Always ask for credentials" checkbox. You will be asked for credentials next time you connect.

TS Client

How do I enable Single Sign-on for TS Gateway Server?

  1. On a Vista machine open up the "Group Policy Object Editor" by entering "gpedit.msc" at a command prompt.
  2. Navigate to "User Configuration", "Administrative Templates", "Windows Components", "Terminal Services", "TS Gateway" and select the "Set TS Gateway server authentication method" setting:
    Group Policy Editor
  3. Select the "Enabled" radio button.
  4. Under "Set TS Gateway server authentication method", click on the combo-box and select "Use locally logged-on credentials".
  5. If you want the users to be able to override this authentication method then select "Allow users to change this setting" checkbox.
    Group Policy
  6. Confirm the changes by clicking on the "OK" button until you return back to the main Group Policy Object Editor dialog.
  7. At a command prompt, run "gpupdate" to force the policy to be refreshed immediately on the local machine.
  8. Start up the TS client and navigate to "Options", "Advanced", click on "Settings" under "connect from anywhere". You should see the status text indicate the following: "Your Windows logon credentials will be used to connect to this TS Gateway server".
    image
  9. That's it! The client will now be able to connect to the gateway server ("gateway.microsoft.com" in the above example) using locally logged on credentials. Of course, if you want to use another set of credentials, you should select the "Allow users to change this setting" checkbox in the Group Policy Editor in Step-5 to bypass using the locally logged on credentials.

What if I am connecting from a non-domain joined client machine?

If you have a non-domain client, then you cannot get single sign-on by using locally logon credentials to authenticate with TSG and TS since administrator cannot deploy single sign-on group policies to the non-domain client machines.

Thus, to provide the best connection experience for non-domain clients through TS Gateway, set the option “Use my TS Gateway credentials with remote server option” in RDP file or in the mstsc client advanced setting menu as per screenshot below. This will ensure that end users are prompted for credentials only once during the connection experience.

 

image

Can the user get Single Sign-On experience when logging on using a Smart Card?

No. Unfortunately if a Smart Card is used to log on locally to the machine, these credentials cannot be used for Single Sign-On. Please also note that you cannot save Smart Card credentials in TS connections either.

Leave a Comment
  • Please add 1 and 7 and type the answer here:
  • Post
  • XP SP3 is required since CredSSP was ported to XP SP3 (not SP2). You will need to enable credssp on it (see KB article # 951608 for more info).

  • Can this be used to connect from XP SP3 to XP SP3, or does the server still need to be 2008?

  • Unfortunately, no - XP SP3 can only be used as the client so no XP SP3 to XP SP3. Server has to be 2008 or Vista.

  • Hi Paul,

    I am trying to setup SSO with xp SP3.

    your previous post says APPEND,i am really unable to get what to APPEND ? please help me.

    Setup

    =====

    Server

    windows 2008 server

    configured the RDP accordingly

    client

    Windows XP professional with xp sp3.

    Earlier you said

    "OK, I've managed to achieve the functionality.  Here's what to do:

    HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SecurityProviders

    APPEND, don't replace: credssp.dll

    HKLM\SYSTEM\CurrentControlSet\Control\Lsa\Security Packages

    APPEND, don't replace: tspkg

    AGAIN, you need to APPEND these values, not replace what's there "

    i am not sure what do you mean by append

    please suggest

  • Hi ,

    I got it , we have to add these values to the registry .

    and enable credssp on windows xp professional clients

  • How to modify "Security Packages" with Domain Group Policy?

  • The article states that it's not possible to USE SSO in combination with smart cards. Is there any known work around for this?!

  • SSO is working, but TS Remote Apps functionality is severely degraded due to differnet lock out time periods.  Often remote app progrmas are idle while attending to other programs and then you come back to remote apps and have to log back in.  Any suggestions? Domain lockout is 20mins and can't be changed.

  • RE SSO with Smart cards: unfortunately you cannot get SSO with smart cards today unless you deploy something like ISA/UAG server.

    RE: lockout/timeout - thanks for your feedback. Domain lockout of 20 mins also applies to the TS where your Remote apps are hosted?

  • Lockout is based on AD Policy.  I would have to create a seperate OU and drag the remote apps server into that OU and set No Timeout.  This would probably work, but would not fly with our Security team.  Any other suggestions or thoughts?

  • The only thing stopping me from a full roleout of Remote Apps and 2K8 Server are users can't stand having to relog on to the application every 20 minutes of inactivity.  SSO works great for the initial launch, but after 20 minutes, SSO benefits are moot and users have to type in creds to unlock the session.

  • If the Remote Apps could share the same incativity timer as the host machine, it would be a beautiful thing.

  • Does these setting provide SSO to the TS Web Access portal ? i.e, I launch IE, navigate to my TS web access page, it auto logs on and my apps are presented.    If so, it does not seem to work for me, I am using Windows 7 RDP 7.1.  When I use mstsc and connect to my farm, SSO does work.  Can someone clarify please :-) thanks

  • @David:

    For Web SSO, see http://blogs.msdn.com/rds/archive/2009/08/11/introducing-web-single-sign-on-for-remoteapp-and-desktop-connections.aspx

    Rob [MSFT]

  • The error message in the Remote Desktop Connection app (mstsc) should be more detailed.

    My scenario:

    - domain-joined Win 7 machine at work

    - connecting to non-domain-joined Win 7 machine at home

    - saved credentials would not pass and I would get the following message:

    "Your credentials did not work. Your system administrator does not allow the use of saved credentials to log on to the remote computer my.domain.com because its identity is not fully verified. Please enter new credentials."

    Enabling the "Allow Delegating Saved Credentials with NTLM-only Server Authentication" of course fixed the problem.

    In retrospect, the message now makes sense, but before I thought it was getting the wrong username/password. It seemed to me that the remote machine was rejecting it.

    I suggest some changes to make this clearer:

    1) Change the title of the error to something like "Saved credentials could not be sent". The way it is now, sounds like they were sent and rejected by the remote machine.

    2) Alter the error message to include some hint that this is the result of the Local Computer Policy so that the user knows where to look.

    3) When opting to save credentials, a policy check should occur and the user should be informed that the policy is not going to allow it.

    4) A help button and page that includes information on connecting from a domain-joined PC to a non-domain-joined PC.

    Thanks for considering it. :)

Page 3 of 4 (58 items) 1234