SecurityTokenHandler.CreateSecurityTokenReference Metodo

Definizione

Spazio dei nomi:

System.IdentityModel.Tokens

Assembly:

System.IdentityModel.dll

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.SecurityKeyIdentifierClause

Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

Parametri

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

SecurityKeyIdentifierClause

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.