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.
Quando sottoposto a override in una classe derivata, crea il riferimento al token di sicurezza per i token elaborati da tale classe. Questo metodo viene in genere 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 il quale deve essere creato il riferimento.
- attached
- Boolean
true se deve essere creato un riferimento associato; false se deve essere creato un riferimento scollegato.
Valori restituiti
Clausola dell'identificatore di chiave che fa riferimento al token specificato.
Esempio
Nel codice seguente viene illustrato come eseguire l'override del CreateSecurityTokenReference metodo per creare una clausola dell'identificatore di chiave dal token specificato. Il codice è 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 su 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 dell'identificatore di chiave (SecurityKeyIdentifierClause) che può essere usata per creare un <wsse:SecurityTokenReference> elemento per il token specificato.
Chiamato dalle implementazioni della SecurityTokenService classe .
In genere, non è necessario usare un oggetto SecurityKeyIdentifierClause 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 rilasciato contiene riferimenti ai token di sicurezza collegati e non collegati. I riferimenti associati fanno riferimento ai token di sicurezza contenuti nell'intestazione di sicurezza di un messaggio SOAP e ai riferimenti non collegati fanno riferimento ai token di sicurezza non inclusi nell'intestazione di sicurezza di un messaggio SOAP. Questi riferimenti confermano in genere l'autenticità del token di sicurezza rilasciato.
