SessionSecurityTokenHandler.ReadToken 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
ReadToken(XmlReader) |
使用指定的 XML 讀取器讀取 SessionSecurityToken。 |
ReadToken(Byte[], SecurityTokenResolver) |
使用指定的語彙基元解析程式從位元組資料流讀取SessionSecurityToken。 |
ReadToken(XmlReader, SecurityTokenResolver) |
使用指定的 XML 讀取器和權杖解析程式,讀取 SessionSecurityToken。 |
備註
重要
使用不信任的資料呼叫此方法,會造成安全性上的風險。 呼叫此方法時,請一律使用信任的資料。 如需詳細資訊,請參閱 驗證所有輸入。
默認實作會從 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken>
元素還原串行化令牌。
ReadToken(XmlReader)
使用指定的 XML 讀取器讀取 SessionSecurityToken。
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
參數
- reader
- XmlReader
連入之 XmlReader 上的 SecurityToken。
傳回
已讀取的工作階段安全性權杖,這是 SessionSecurityToken 的執行個體。
例外狀況
reader
為 null
。
備註
重要
使用不信任的資料呼叫此方法,會造成安全性上的風險。 呼叫此方法時,請一律使用信任的資料。 如需詳細資訊,請參閱 驗證所有輸入。
讀取器必須位於 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken>
元素。
默認實作會 SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) 使用預設令牌解析程式叫用 方法。
適用於
ReadToken(Byte[], SecurityTokenResolver)
使用指定的語彙基元解析程式從位元組資料流讀取SessionSecurityToken。
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
參數
- token
- Byte[]
包含權杖的位元組資料流。
- tokenResolver
- SecurityTokenResolver
要使用的權杖解析程式。
傳回
已讀取的 SessionSecurityToken。
備註
重要
使用不信任的資料呼叫此方法,會造成安全性上的風險。 呼叫此方法時,請一律使用信任的資料。 如需詳細資訊,請參閱 驗證所有輸入。
默認實作會 XmlDictionaryReader 透過令牌建立 ,並叫用 SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) 方法。
適用於
ReadToken(XmlReader, SecurityTokenResolver)
使用指定的 XML 讀取器和權杖解析程式,讀取 SessionSecurityToken。
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
參數
- reader
- XmlReader
連入之 XmlReader 上的 SecurityToken。
- tokenResolver
- SecurityTokenResolver
傳回
已讀取的工作階段安全性權杖,這是 SessionSecurityToken 的執行個體。
例外狀況
備註
重要
使用不信任的資料呼叫此方法,會造成安全性上的風險。 呼叫此方法時,請一律使用信任的資料。 如需詳細資訊,請參閱 驗證所有輸入。
讀取器必須位於 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken>
元素。
如果快取令牌數據,則會從令牌快取讀取,這是類別的 SessionSecurityTokenCache 實例。 否則,令牌數據會從 和 CookieNamespace 屬性所CookieElementName指定的元素子<wsc:SecurityContextToken>
專案讀取,並ApplyTransforms叫用 方法來譯碼Cookie。
如需如何將會話令牌串行化為 <SecurityContextToken
元素的詳細資訊,請參閱 SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 方法。