JsonWebTokenHandler.ReplaceTokenHeader(JsonWebToken, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea un nuovo JsonWebToken oggetto sostituendo l'intestazione di un oggetto esistente JsonWebToken, riutilizzando il payload e la firma già analizzati.
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
Parametri
- jsonWebToken
- JsonWebToken
Oggetto firmato JsonWebToken (JWS) il cui payload e la firma vengono riutilizzati.
- encodedHeader
- String
Intestazione Base64UrlEncoded che sostituisce l'intestazione di jsonWebToken.
Valori restituiti
Oggetto JsonWebToken formato come 'encodedHeader.EncodedPayload.EncodedSignature'.
Eccezioni
Generata se encodedHeader è null o vuoto.
Generata se jsonWebToken è un token crittografato (JWE), perché il payload non può essere riutilizzato.
Commenti
Si tratta di una trasformazione intenzionale per le riscritture solo intestazioni(ad esempio, l'hashing di un token inoltrato protetto nonce). Solo l'intestazione di sostituzione è decodificata e analizzata; il payload viene riutilizzato senza jsonWebToken ripetere l'analisi.
La firma di jsonWebToken viene riutilizzata in verbatim e NON viene ricalcolate. Il token risultante viene quindi convalidato solo quando encodedHeader ricostruisce l'intestazione su cui è stata calcolata la firma originale. Se si specifica un'intestazione arbitraria, viene generato un token la cui firma avrà esito negativo.
Il token restituito NON viene convalidato. Usare ValidateToken(String, TokenValidationParameters) o ValidateTokenAsync(String, TokenValidationParameters) per assicurarsi che il token sia accettabile.