diff --git a/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs b/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs index eaf78d6072..471619243c 100644 --- a/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs +++ b/src/Microsoft.IdentityModel.JsonWebTokens/JsonWebTokenHandler.CreateToken.cs @@ -681,6 +681,10 @@ int sizeOfEncodedHeaderAndPayloadAsciiBytes /// /// A can contain claims from multiple locations. /// This method consolidates the claims and adds default times {exp, iat, nbf} if needed. + /// In the case of a claim from this set: {Audience, Issuer, Expires, IssuedAt, NotBefore} being defined in multiple + /// locations in the SecurityTokenDescriptor, the following priority is used: + /// SecurityTokenDescriptor.{Audience/Audiences, Issuer, Expires, IssuedAt, NotBefore} > SecurityTokenDescriptor.Claims > + /// SecurityTokenDescriptor.Subject.Claims /// /// The to use. /// The used to create the token.