SessionSecurityTokenHandler.ReadToken Metoda

Definicja

Przestrzeń nazw:

System.IdentityModel.Tokens

Zestaw:

System.IdentityModel.dll

Odczytuje element SessionSecurityToken.

Przeciążenia

ReadToken(XmlReader)	Odczytuje element SessionSecurityToken przy użyciu określonego czytnika XML.
ReadToken(Byte[], SecurityTokenResolver)	Odczytuje element SessionSecurityToken ze strumienia bajtów przy użyciu określonego modułu rozpoznawania tokenów.
ReadToken(XmlReader, SecurityTokenResolver)	Odczytuje SessionSecurityToken element przy użyciu określonego czytnika XML i modułu rozpoznawania tokenów.

Uwagi

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).

Domyślna implementacja deserializuje token z elementu konwersacji WS-Secure luty2005 lub WS-Secure Conversation 1.3 <wsc:SecurityContextToken> .

ReadToken(XmlReader)

Odczytuje element SessionSecurityToken przy użyciu określonego czytnika XML.

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader);

public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader);

override this.ReadToken : System.Xml.XmlReader -> System.IdentityModel.Tokens.SecurityToken

Public Overrides Function ReadToken (reader As XmlReader) As SecurityToken

Parametry

reader

XmlReader

Element XmlReader za pośrednictwem przychodzącego SecurityToken.

Zwraca

SecurityToken

Odczytany token zabezpieczający sesji, wystąpienie klasy SessionSecurityToken.

Wyjątki

ArgumentNullException

reader to null.

SecurityTokenException

Czytnik nie jest umieszczony w obiekcie SessionSecurityToken lub SessionSecurityToken nie można go odczytać.

Uwagi

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).

Czytelnik musi być umieszczony w WS-Secure Conversation Feb2005 lub WS-Secure Conversation 1.3 <wsc:SecurityContextToken> element.

Domyślna implementacja wywołuje metodę SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) przy użyciu domyślnego narzędzia rozpoznawania tokenów.

ReadToken(Byte[], SecurityTokenResolver)

Odczytuje element SessionSecurityToken ze strumienia bajtów przy użyciu określonego modułu rozpoznawania tokenów.

public:
 virtual System::IdentityModel::Tokens::SecurityToken ^ ReadToken(cli::array <System::Byte> ^ token, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);

public virtual System.IdentityModel.Tokens.SecurityToken ReadToken (byte[] token, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);

override this.ReadToken : byte[] * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken

Public Overridable Function ReadToken (token As Byte(), tokenResolver As SecurityTokenResolver) As SecurityToken

Parametry

token

Byte[]

Strumień bajtów, który zawiera token.

tokenResolver

SecurityTokenResolver

Rozpoznawanie tokenów do użycia.

Zwraca

SecurityToken

To SessionSecurityToken było przeczytane.

Uwagi

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).

Domyślna implementacja tworzy token XmlDictionaryReader i wywołuje metodę SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) .

ReadToken(XmlReader, SecurityTokenResolver)

Odczytuje SessionSecurityToken element przy użyciu określonego czytnika XML i modułu rozpoznawania tokenów.

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);

public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);

override this.ReadToken : System.Xml.XmlReader * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken

Public Overrides Function ReadToken (reader As XmlReader, tokenResolver As SecurityTokenResolver) As SecurityToken

Parametry

reader

XmlReader

Element XmlReader za pośrednictwem przychodzącego SecurityToken.

tokenResolver

SecurityTokenResolver

Element SecurityTokenResolver , który może służyć do rozpoznawania .SessionSecurityToken

Zwraca

SecurityToken

Odczytany token zabezpieczający sesji, wystąpienie klasy SessionSecurityToken.

Wyjątki

ArgumentNullException

reader to null.

-lub-

tokenResolver to null.

SecurityTokenException

Czytnik nie jest umieszczony w obiekcie SessionSecurityToken lub SessionSecurityToken nie można go odczytać.

Uwagi

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).

Czytelnik musi być umieszczony w WS-Secure Conversation Feb2005 lub WS-Secure Conversation 1.3 <wsc:SecurityContextToken> element.

Jeśli materiał tokenu jest buforowany, jest odczytywany z pamięci podręcznej tokenu, która jest wystąpieniem SessionSecurityTokenCache klasy. W przeciwnym razie materiał tokenu jest odczytywany z elementu podrzędnego elementu określonego <wsc:SecurityContextToken> przez CookieElementName właściwości i, CookieNamespace a ApplyTransforms metoda jest wywoływana w celu dekodowania pliku cookie.

Aby uzyskać więcej informacji na temat serializacji tokenów sesji do <SecurityContextToken elementu, zobacz metodę SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) .