Langue

JsonWebTokenHandler.ReplaceTokenHeader(JsonWebToken, String) Méthode

Définition

Crée un nouveau JsonWebToken en remplaçant l’en-tête d’un élément existant JsonWebToken, en réutilisant sa charge utile et sa signature déjà analysées.

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

Paramètres

jsonWebToken
JsonWebToken

JsonWebToken Signé (JWS) dont la charge utile et la signature sont réutilisées.

encodedHeader
String

En-tête Base64UrlEncoded qui remplace l’en-tête de jsonWebToken.

Retours

Formé JsonWebToken en tant que « encodedHeader.EncodedPayload.EncodedSignature ».

Exceptions

Levée si encodedHeader la valeur est null ou vide.

Levée s’il jsonWebToken s’agit d’un jeton chiffré (JWE), car sa charge utile ne peut pas être réutilisée.

Remarques

Il s’agit d’une transformation intentionnelle pour les réécritures en-tête uniquement (par exemple, hachage d’un jeton transféré protégé nonce). Seul l’en-tête de remplacement est décodé et analysé ; la charge utile est réutilisée jsonWebToken sans re-analyse.

La signature de l’objet jsonWebToken est réutilisée en détail et n’est pas recomputée. Par conséquent, le jeton résultant valide uniquement lorsqu’il encodedHeader reconstruit l’en-tête sur lequel la signature d’origine a été calculée. En fournissant un en-tête arbitraire, un jeton dont la signature échouera la validation.

Le jeton retourné n’est pas validé. Utilisez ValidateToken(String, TokenValidationParameters) ou ValidateTokenAsync(String, TokenValidationParameters) vérifiez que le jeton est acceptable.

S’applique à