SecurityTokenHandler.CreateSecurityTokenReference 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.
Una volta eseguito l'override in una classe derivata, crea il riferimento del token di sicurezza per i token elaborati da quella classe. Questo metodo in genere viene chiamato da un servizio token di sicurezza (STS).
public:
virtual System::IdentityModel::Tokens::SecurityKeyIdentifierClause ^ CreateSecurityTokenReference(System::IdentityModel::Tokens::SecurityToken ^ token, bool attached);public virtual System.IdentityModel.Tokens.SecurityKeyIdentifierClause CreateSecurityTokenReference (System.IdentityModel.Tokens.SecurityToken token, bool attached);abstract member CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
override this.CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClausePublic Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClauseParametri
- token
- SecurityToken
Token per cui deve essere creato il riferimento.
- attached
- Boolean
true se un riferimento associato deve essere creato; false se un riferimento non associato deve essere creato.
Restituisce
Clausola dell'identificatore di chiave a cui fa riferimento il token specificato.
Esempio
Il codice seguente illustra come eseguire l'override del CreateSecurityTokenReference metodo per creare una clausola di identificatore di chiave dal token specificato. Il codice viene tratto dall'esempio Custom Token . Questo esempio fornisce classi personalizzate che consentono l'elaborazione di token Web semplici (SWT). Per informazioni su questo esempio e altri esempi disponibili per WIF e dove scaricarli, vedere Indice di esempio di codice WIF.
public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();
}
Commenti
Per impostazione predefinita, questo metodo genera un'eccezione NotImplementedException .
Le classi derivate eseguono l'override di questo metodo per restituire una clausola di identificatore di chiave (SecurityKeyIdentifierClause) che può essere usata per creare un <wsse:SecurityTokenReference> elemento per il token specificato.
Chiamata dalle implementazioni della SecurityTokenService classe.
In genere, un SecurityKeyIdentifierClause oggetto non deve essere usato, diverso da quando viene creato un servizio token di sicurezza personalizzato. Quando un servizio token di sicurezza restituisce un token di sicurezza, il token di sicurezza emesso contiene riferimenti a token di sicurezza associati e non associati. I riferimenti associati fanno riferimento a token di sicurezza contenuti nell'intestazione di sicurezza di un messaggio SOAP, mentre i riferimenti non associati fanno riferimento a token di sicurezza che non sono inclusi nell'intestazione di sicurezza di un messaggio SOAP. Questi riferimenti confermano in genere l'autenticità del token di sicurezza emesso.
