JsonWebTokenHandler.ReplaceTokenHeader(JsonWebToken, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.