JsonWebTokenHandler.ReplaceTokenHeader(JsonWebToken, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
既存のJsonWebTokenのヘッダーを置き換え、既に解析済みのペイロードと署名を再利用して、新しいJsonWebTokenを作成します。
public virtual Microsoft.IdentityModel.JsonWebTokens.JsonWebToken ReplaceTokenHeader(Microsoft.IdentityModel.JsonWebTokens.JsonWebToken jsonWebToken, string encodedHeader);abstract member ReplaceTokenHeader : Microsoft.IdentityModel.JsonWebTokens.JsonWebToken * string -> Microsoft.IdentityModel.JsonWebTokens.JsonWebToken
override this.ReplaceTokenHeader : Microsoft.IdentityModel.JsonWebTokens.JsonWebToken * string -> Microsoft.IdentityModel.JsonWebTokens.JsonWebTokenPublic Overridable Function ReplaceTokenHeader (jsonWebToken As JsonWebToken, encodedHeader As String) As JsonWebTokenパラメーター
- jsonWebToken
- JsonWebToken
ペイロードと署名が再利用される署名付き JsonWebToken (JWS)。
- encodedHeader
- String
jsonWebTokenのヘッダーを置き換える Base64UrlEncoded ヘッダー。
返品
"encodedHeader.EncodedPayload.EncodedSignature" として形成された JsonWebToken 。
例外
encodedHeaderが null または空の場合にスローされます。
jsonWebTokenが暗号化されたトークン (JWE) の場合、ペイロードを再利用できないためにスローされます。
注釈
これは、ヘッダーのみの書き換えのための意図的な変換です (たとえば、Protected Forwarded Token nonce のハッシュ)。 置換ヘッダーのみがデコードされ、解析されます。ペイロードは、再解析なしで jsonWebToken から再利用されます。
jsonWebTokenのシグネチャは逐語的に再利用され、再計算されません。 したがって、結果のトークンは、元の署名が計算されたヘッダー encodedHeader 再構築したときにのみ検証されます。任意のヘッダーを指定すると、その署名が検証に失敗するトークンが生成されます。
返されたトークンは検証されません。 トークンが受け入れ可能であることを確認するには、 ValidateToken(String, TokenValidationParameters) または ValidateTokenAsync(String, TokenValidationParameters) を使用します。