Sprache

JsonWebTokenHandler.ReplaceTokenHeader(JsonWebToken, String) Methode

Definition

Erstellt eine neue, JsonWebToken indem die Kopfzeile einer vorhandenen JsonWebToken, die bereits analysierte Nutzlast und Signatur erneut verwendet wird.

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.JsonWebToken
Public Overridable Function ReplaceTokenHeader (jsonWebToken As JsonWebToken, encodedHeader As String) As JsonWebToken

Parameter

jsonWebToken
JsonWebToken

Die signierte JsonWebToken (JWS), deren Nutzlast und Signatur wiederverwendet werden.

encodedHeader
String

Die Base64UrlEncoded-Kopfzeile, die den Header von jsonWebToken.

Gibt zurück

Eine JsonWebToken Form als "encodedHeader.EncodedPayload.EncodedSignature".

Ausnahmen

Wird ausgelöst, wenn encodedHeader null oder leer ist.

Wird ausgelöst, wenn jsonWebToken es sich um ein verschlüsseltes Token (JWE) handelt, da seine Nutzlast nicht wiederverwendet werden kann.

Hinweise

Dies ist eine absichtliche Transformation für Nur-Header-Umschreibungen (z. B. Hashing einer geschützten Weitergeleiteten Token-Nonce). Nur der Ersatzheader wird decodiert und analysiert. die Nutzlast wird ohne erneute Analyse wiederverwendet jsonWebToken .

Die Signatur wird jsonWebToken wiederverwendet und nicht neu komputiert. Das resultierende Token überprüft daher nur, wann encodedHeader der Header rekonstruiert wird, über den die ursprüngliche Signatur berechnet wurde. Durch die Bereitstellung eines beliebigen Headers wird ein Token erzeugt, dessen Signatur die Überprüfung fehlschlägt.

Das zurückgegebene Token wird NICHT überprüft. Verwenden ValidateToken(String, TokenValidationParameters) oder ValidateTokenAsync(String, TokenValidationParameters) sicherstellen, dass das Token akzeptabel ist.

Gilt für: