JwtSecurityTokenHandler.CreateJwtSecurityToken 方法

定義

命名空間:: System.IdentityModel.Tokens.Jwt

組件:: System.IdentityModel.Tokens.Jwt.dll

套件:: System.IdentityModel.Tokens.Jwt v8.19.1

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
CreateJwtSecurityToken(String, String, ClaimsIdentity, Nullable<DateTime>, Nullable<DateTime>, Nullable<DateTime>, SigningCredentials, EncryptingCredentials, IDictionary<String,Object>)	產生 JwtSecurityToken
CreateJwtSecurityToken(String, String, ClaimsIdentity, Nullable<DateTime>, Nullable<DateTime>, Nullable<DateTime>, SigningCredentials, EncryptingCredentials)	產生 JwtSecurityToken
CreateJwtSecurityToken(SecurityTokenDescriptor)	建立一個 JSON 網頁令牌（JWT）。
CreateJwtSecurityToken(String, String, ClaimsIdentity, Nullable<DateTime>, Nullable<DateTime>, Nullable<DateTime>, SigningCredentials)	產生 JwtSecurityToken

CreateJwtSecurityToken(String, String, ClaimsIdentity, Nullable<DateTime>, Nullable<DateTime>, Nullable<DateTime>, SigningCredentials, EncryptingCredentials, IDictionary<String,Object>)

產生 JwtSecurityToken

public virtual System.IdentityModel.Tokens.Jwt.JwtSecurityToken CreateJwtSecurityToken(string issuer, string audience, System.Security.Claims.ClaimsIdentity subject, DateTime? notBefore, DateTime? expires, DateTime? issuedAt, Microsoft.IdentityModel.Tokens.SigningCredentials signingCredentials, Microsoft.IdentityModel.Tokens.EncryptingCredentials encryptingCredentials, System.Collections.Generic.IDictionary<string,object> claimCollection);

abstract member CreateJwtSecurityToken : string * string * System.Security.Claims.ClaimsIdentity * Nullable<DateTime> * Nullable<DateTime> * Nullable<DateTime> * Microsoft.IdentityModel.Tokens.SigningCredentials * Microsoft.IdentityModel.Tokens.EncryptingCredentials * System.Collections.Generic.IDictionary<string, obj> -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken
override this.CreateJwtSecurityToken : string * string * System.Security.Claims.ClaimsIdentity * Nullable<DateTime> * Nullable<DateTime> * Nullable<DateTime> * Microsoft.IdentityModel.Tokens.SigningCredentials * Microsoft.IdentityModel.Tokens.EncryptingCredentials * System.Collections.Generic.IDictionary<string, obj> -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken

Public Overridable Function CreateJwtSecurityToken (issuer As String, audience As String, subject As ClaimsIdentity, notBefore As Nullable(Of DateTime), expires As Nullable(Of DateTime), issuedAt As Nullable(Of DateTime), signingCredentials As SigningCredentials, encryptingCredentials As EncryptingCredentials, claimCollection As IDictionary(Of String, Object)) As JwtSecurityToken

參數

issuer: String

令牌的發行者。

audience: String

這個代幣的受眾。

subject: ClaimsIdentity

這個標記的 Claim來源。

notBefore: Nullable<DateTime>

這個代幣的非官方時機。

expires: Nullable<DateTime>

這個代幣的有效期限。

issuedAt: Nullable<DateTime>

這個代幣的發行時間到了。

signingCredentials: SigningCredentials

包含用於產生簽名的密碼學材料。

encryptingCredentials: EncryptingCredentials

包含用於加密令牌的密碼學材料。

claimCollection: IDictionary<String,Object>

一組代表 Claim此標記（s）的（key， value）對。

傳回

JwtSecurityToken

A JwtSecurityToken。

例外狀況

ArgumentException

若 expires<= notBefore。

備註

若 Actor 非空，則會加入 claim { actort， 'value' } 於有效載荷中。 CreateActorValue(ClaimsIdentity) 關於價值如何產生的詳細資訊。

另見 <cref=“T：System.IdentityModel.Tokens.Jwt.JwtHeader”></參見，> 了解標頭參數如何被加入標頭。

另見 <cref=“T：System.IdentityModel.Tokens.Jwt.JwtPayload”></另> 見，了解如何加入有效載荷的細節。

新增的每個 Claim 元素 subject 都會 Type 根據中 OutboundClaimTypeMap找到的映射進行翻譯。新增或移除會 OutboundClaimTypeMap 影響 Json 聲明中的名稱組件。

SigningCredentials(SecurityKey, String) 用於簽署 RawData。

EncryptingCredentials(SecurityKey, String, String) 用於加密 RawData 或 RawPayload 。

適用於

CreateJwtSecurityToken(String, String, ClaimsIdentity, Nullable<DateTime>, Nullable<DateTime>, Nullable<DateTime>, SigningCredentials, EncryptingCredentials)

產生 JwtSecurityToken

public virtual System.IdentityModel.Tokens.Jwt.JwtSecurityToken CreateJwtSecurityToken(string issuer, string audience, System.Security.Claims.ClaimsIdentity subject, DateTime? notBefore, DateTime? expires, DateTime? issuedAt, Microsoft.IdentityModel.Tokens.SigningCredentials signingCredentials, Microsoft.IdentityModel.Tokens.EncryptingCredentials encryptingCredentials);

abstract member CreateJwtSecurityToken : string * string * System.Security.Claims.ClaimsIdentity * Nullable<DateTime> * Nullable<DateTime> * Nullable<DateTime> * Microsoft.IdentityModel.Tokens.SigningCredentials * Microsoft.IdentityModel.Tokens.EncryptingCredentials -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken
override this.CreateJwtSecurityToken : string * string * System.Security.Claims.ClaimsIdentity * Nullable<DateTime> * Nullable<DateTime> * Nullable<DateTime> * Microsoft.IdentityModel.Tokens.SigningCredentials * Microsoft.IdentityModel.Tokens.EncryptingCredentials -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken

Public Overridable Function CreateJwtSecurityToken (issuer As String, audience As String, subject As ClaimsIdentity, notBefore As Nullable(Of DateTime), expires As Nullable(Of DateTime), issuedAt As Nullable(Of DateTime), signingCredentials As SigningCredentials, encryptingCredentials As EncryptingCredentials) As JwtSecurityToken

參數

issuer: String

令牌的發行者。

audience: String

這個代幣的受眾。

subject: ClaimsIdentity

這個標記的 Claim來源。

notBefore: Nullable<DateTime>

這個代幣的非官方時機。

expires: Nullable<DateTime>

這個代幣的有效期限。

issuedAt: Nullable<DateTime>

這個代幣的發行時間到了。

signingCredentials: SigningCredentials

包含用於產生簽名的密碼學材料。

encryptingCredentials: EncryptingCredentials

包含用於加密令牌的密碼學材料。

傳回

JwtSecurityToken

A JwtSecurityToken。

例外狀況

ArgumentException

若 expires<= notBefore。

備註

若 Actor 非空，則會加入 claim { actort， 'value' } 於有效載荷中。 CreateActorValue(ClaimsIdentity) 關於價值如何產生的詳細資訊。

另見 <cref=“T：System.IdentityModel.Tokens.Jwt.JwtHeader”></參見，> 了解標頭參數如何被加入標頭。

另見 <cref=“T：System.IdentityModel.Tokens.Jwt.JwtPayload”></另> 見，了解如何加入有效載荷的細節。

新增的每個 Claim 元素 subject 都會 Type 根據中 OutboundClaimTypeMap找到的映射進行翻譯。新增或移除會 OutboundClaimTypeMap 影響 Json 聲明中的名稱組件。

SigningCredentials(SecurityKey, String) 用於簽署 RawData。

EncryptingCredentials(SecurityKey, String, String) 用於加密 RawData 或 RawPayload 。

適用於

CreateJwtSecurityToken(SecurityTokenDescriptor)

建立一個 JSON 網頁令牌（JWT）。

public virtual System.IdentityModel.Tokens.Jwt.JwtSecurityToken CreateJwtSecurityToken(Microsoft.IdentityModel.Tokens.SecurityTokenDescriptor tokenDescriptor);

abstract member CreateJwtSecurityToken : Microsoft.IdentityModel.Tokens.SecurityTokenDescriptor -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken
override this.CreateJwtSecurityToken : Microsoft.IdentityModel.Tokens.SecurityTokenDescriptor -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken

Public Overridable Function CreateJwtSecurityToken (tokenDescriptor As SecurityTokenDescriptor) As JwtSecurityToken

參數

tokenDescriptor: SecurityTokenDescriptor

SecurityTokenDescriptor A 包含代幣內容的詳細資訊。

傳回

JwtSecurityToken

備註

SigningCredentials 用於簽署 RawData。

適用於

CreateJwtSecurityToken(String, String, ClaimsIdentity, Nullable<DateTime>, Nullable<DateTime>, Nullable<DateTime>, SigningCredentials)

產生 JwtSecurityToken

public virtual System.IdentityModel.Tokens.Jwt.JwtSecurityToken CreateJwtSecurityToken(string issuer = default, string audience = default, System.Security.Claims.ClaimsIdentity subject = default, DateTime? notBefore = default, DateTime? expires = default, DateTime? issuedAt = default, Microsoft.IdentityModel.Tokens.SigningCredentials signingCredentials = default);

abstract member CreateJwtSecurityToken : string * string * System.Security.Claims.ClaimsIdentity * Nullable<DateTime> * Nullable<DateTime> * Nullable<DateTime> * Microsoft.IdentityModel.Tokens.SigningCredentials -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken
override this.CreateJwtSecurityToken : string * string * System.Security.Claims.ClaimsIdentity * Nullable<DateTime> * Nullable<DateTime> * Nullable<DateTime> * Microsoft.IdentityModel.Tokens.SigningCredentials -> System.IdentityModel.Tokens.Jwt.JwtSecurityToken

Public Overridable Function CreateJwtSecurityToken (Optional issuer As String = Nothing, Optional audience As String = Nothing, Optional subject As ClaimsIdentity = Nothing, Optional notBefore As Nullable(Of DateTime) = Nothing, Optional expires As Nullable(Of DateTime) = Nothing, Optional issuedAt As Nullable(Of DateTime) = Nothing, Optional signingCredentials As SigningCredentials = Nothing) As JwtSecurityToken