Sharepoint Security Token Service

Posted on  by 

  1. Had an issue today on one of my developer’s VMs. The Security Token Service stopped working which caused several other service applications to fail, managed metadata service, bcs, secure store service, and more. A quick browse through the event log showed the following errors logged: Event 3 System.ServiceModel 3.0.0.0.
  2. Security Token Se Security Token Se 033b6266-261d-4318-9a9a-36f0e390d346. Application Disco Application Disco 80a9e9de-88d0-4ce1-8108-380117fc1c11. Usage and Health Usage and Health 746c7339-1e8c-47ae-8583-ea80faae5fac. Search Administra Search Administra 944cfcd9-155e-41c0-82b7-95386d737fcb. Word Automation S.

Smart Card

The Security Token Service is built on the Windows Identity Foundation Framework. This service is responsible for issuing, managing, and valadating security tokens. During the authentication process, using Classic or Claims based authentication, a token is generated, consumed by SharePoint and then converted into an SPUser object for authorization.

It’s not happening only on SharePoint 2013. You will be in the same situation if you are using Claims Based Authentication with SharePoint 2010.

Out of the box behavior
You have a SharePoint Web Application configured to use Claims Based Authentication. You grant access to a SharePoint site through Active Directory Security Groups. You perform changes in the membership of that Active Directory Security Group and you notice the changes are not reflected immediately on the SharePoint site.
For example you remove one user account from the AD security group membership, but the user is still able to access the site, or you add a new user to the membership of that security group, but the user still receives access denied on SharePoint.

Token

The explanation
SharePoint Claims Based Authentication is working differently than SharePoint Classic Mode Authentication. When you have Claims Based Authentication, SharePoint is using the Security Token Service (STS) to provide access tokens for server-to-server authentication.

The Wikipedia explanation for STS:
“A Security Token Service (STS) is a software based identity provider responsible for issuing security tokens, especially software tokens, as part of a claims-based identity system.
In a typical usage scenario, a client requests access to a secure software application, often called a relying party. Instead of the application authenticating the client, the client is redirected to an STS. The STS authenticates the client and issues a security token. Finally, the client is redirected back to the relying party and present the security token. The token is the data record in which claims are packed, and is protected from manipulation with strong cryptography. The software application verifies that the token originated from an STS trusted by it, and then makes authorization decisions accordingly. The token is creating a chain of trust between the STS and the software application consuming the claims. This process is illustrated in the Security Assertion Markup Language (SAML) use case, demonstrating how single sign-on can be used to access web services.”

Service

Sharepoint Security Token Service Url

So, in our case:

  • a claims based SharePoint web application handle requests to issue, manage, and validate security tokens.
  • the security tokens are a collection of identity claims (a user name, a role, an identifier).
  • the security tokens can be protected with an X.509 certificate to protect the token’s contents in transit and to enable validation of trusted issuers.
  • the SharePoint Security Token Service plays an important role for the claims based SharePoint web application.

The problem
The tokens have a lifetime (by default 10 hours). More than that, SharePoint by default will cache the AD security group membership details for 24 hours. That means, once the SharePoint will get the details for a security group, if the AD security group will change, SharePoint will still use the cache.

Solution

When your access in SharePoint rely on the AD security groups you have to adjust the caching mechanism for the tokens and you have to adjust it properly everywhere (SharePoint and STS).

Sharepoint Security Token Service Is Not Available

More details
SPWebService.ContentService
SPWebService.TokenTimeout
Get-SPSecurityTokenServiceConfig
SPSecurityTokenServiceManager
SPSecurityTokenServiceManager.WindowsTokenLifetime
SPSecurityTokenServiceManager.FormsTokenLifetime
SPSecurityTokenServiceManager.LogonTokenCacheExpirationWindow

Coments are closed