JsonWebTokenHandler.ReplaceTokenHeader(JsonWebToken, String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy nowy JsonWebToken element, zastępując nagłówek istniejącego JsonWebTokenelementu , ponownie używając już przeanalizowanego ładunku i podpisu.
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
Parametry
- jsonWebToken
- JsonWebToken
Podpisany JsonWebToken (JWS), którego ładunek i podpis są używane ponownie.
- encodedHeader
- String
Nagłówek Base64UrlEncoded, który zastępuje nagłówek jsonWebToken.
Zwraca
Utworzony JsonWebToken jako "encodedHeader.EncodedPayload.EncodedSignature".
Wyjątki
Zgłaszany, jeśli encodedHeader wartość ma wartość null lub jest pusta.
Zgłaszany, jeśli jsonWebToken jest zaszyfrowanym tokenem (JWE), ponieważ nie można ponownie użyć ładunku.
Uwagi
Jest to celowa transformacja dla ponownego zapisywania tylko nagłówka (na przykład tworzenie skrótu chronionego tokenu przekazywanego innego). Tylko nagłówek zastępczy jest dekodowany i analizowany; Ładunek jest ponownie używany bez jsonWebToken ponownego analizowania.
Podpis jsonWebToken jest ponownie używany i nie jest ponownie obliczany. Wynikowy token weryfikuje zatem tylko wtedy, gdy encodedHeader rekonstruuje nagłówek, nad którym obliczono oryginalny podpis; podanie dowolnego nagłówka powoduje wygenerowanie tokenu, którego podpis zakończy się niepowodzeniem.
Zwrócony token nie jest weryfikowany. Użyj ValidateToken(String, TokenValidationParameters) polecenia lub ValidateTokenAsync(String, TokenValidationParameters) , aby upewnić się, że token jest akceptowalny.