SecurityBindingElement Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.0.0

Origine:

SecurityBindingElement.cs

Classe astratta la quale, se implementata, rappresenta un elemento di associazione che supporta la sicurezza dei messaggi SOAP del canale.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

Ereditarietà

Object

BindingElement

SecurityBindingElement

Derivato

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Commenti

Questa classe è la classe di base per gli elementi di associazione di sicurezza dei messaggi SOAP in WCF. Sono disponibili tre implementazioni di questa classe astratta: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement e TransportSecurityBindingElement. Queste implementazioni modellano le associazioni definite nella specifica WS-Security Policy.

Un'associazione personalizzata contiene una raccolta di elementi di associazione disposti in un ordine specifico: l'elemento che rappresenta l'inizio dello stack dell'associazione viene aggiunto per primo, l'elemento immediatamente successivo viene aggiunto per secondo e così via.

Per aggiungere questa classe a un'associazione, eseguire le operazioni seguenti:

1. Creare un oggetto BindingElementCollection.

2. Creare un elemento di associazione personalizzato che si trovi prima di questo elemento di associazione nello stack dell'associazione, ad esempio l'elemento facoltativo TransactionFlowBindingElement o ReliableSessionBindingElement.

3. Aggiungere questi elementi nell'ordine descritto sopra alla classe BindingElementCollection utilizzando il metodo InsertItem.

4. Creare un'istanza di un elemento di associazione di sicurezza derivata dalla classe SecurityBindingElement, ad esempio AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement o TransportSecurityBindingElement.

5. Aggiungere alla raccolta l'elemento di associazione di sicurezza derivato.

6. Aggiungere alla raccolta qualsiasi elemento di associazione personalizzato aggiuntivo, ad esempio TcpTransportBindingElement.

Per altre informazioni sull'uso di un SecurityBindingElementoggetto , vedere Modalità di autenticazione SecurityBindingElement e Procedura: Creare un'associazione personalizzata usando SecurityBindingElement.

Nota

Dopo che un oggetto SecurityBindingElement è necessario trattare le relative proprietà come non modificabili. La chiamata a set su alcune proprietà può produrre effetti imprevedibili: l'associazione potrebbe comportarsi come se la proprietà conservasse il vecchio valore, nel qual caso l'unica indicazione del problema sarebbe un errore di runtime. Due proprietà che hanno in genere questo comportamento sono KeyType e MessageSecurityVersion. È comunque possibile che altre proprietà abbiano lo stesso comportamento.

Proprietà

DefaultAlgorithmSuite	Ottiene o imposta la crittografia dei messaggi e gli algoritmi di incapsulamento della chiave.
EnableUnsecuredResponse	Ottiene o imposta un valore che indica se WCF può inviare e ricevere risposte non sicure alle richieste sicure.
EndpointSupportingTokenParameters	Ottiene l'endpoint che supporta parametri token.
IncludeTimestamp	Ottiene o imposta un valore che indica se in ogni messaggio vengono inclusi timestamp.
KeyEntropyMode	Ottiene o imposta l'origine di entropia utilizzata per creare le chiavi.
LocalClientSettings	Ottiene le proprietà di associazione specifiche delle impostazioni di sicurezza locali utilizzate dal client.
MessageSecurityVersion	Ottiene o imposta la versione della sicurezza del messaggio.
SecurityHeaderLayout	Ottiene o imposta l'ordine degli elementi nell'intestazione di sicurezza per questa associazione.

Metodi

BuildChannelFactory<TChannel>(BindingContext)	Crea una channel factory basata sulle impostazioni SecurityBindingElement e sul contesto di associazione passati. La channel factory creata è una channel factory di sicurezza dei messaggi SOAP che ha un riferimento interno alla channel factory corrispondente al contesto dell'associazione (che include la channel factory del trasporto).
BuildChannelFactoryCore<TChannel>(BindingContext)	Quando implementato, crea una channel factory di un tipo specificato.
BuildChannelListener<TChannel>(BindingContext)	Inizializza un listener del canale per accettare canali di un tipo specificato dal contesto dell'associazione. (Ereditato da BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Determina se è possibile compilare una channel factory del tipo specificato.
CanBuildChannelListener<TChannel>(BindingContext)	Restituisce un valore che indica se l'elemento di associazione può compilare un listener per un tipo di canale specifico. (Ereditato da BindingElement)
Clone()	Quando sottoposto a override in una classe derivata, restituisce una copia dell'oggetto dell'elemento di associazione. (Ereditato da BindingElement)
CreateCertificateOverTransportBindingElement()	Crea un elemento di associazione di sicurezza che richiede l'autenticazione client basata sui certificati mediante la sicurezza dei messaggi SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Crea un elemento di associazione di sicurezza che richiede l'autenticazione client basata sui certificati mediante la sicurezza dei messaggi SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata sulla sicurezza SOAP mediante un token emesso. Questo elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).
CreateSecureConversationBindingElement(SecurityBindingElement)	Crea un elemento di associazione di sicurezza simmetrico configurato per stabilire una conversazione protetta tra il client e il servizio. Il token del contesto di sicurezza rilasciato alla fine dell'handshake di conversazione sicura viene utilizzato per proteggere i messaggi. L'elemento di associazione di sicurezza del programma di avvio specifica la modalità di protezione dei messaggi di handshake di conversazione protetta.
CreateUserNameOverTransportBindingElement()	Crea un elemento di associazione di sicurezza configurato per l'autenticazione client basata su un nome utente e una password inviati come parte del messaggio SOAP. L'elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetProperty<T>(BindingContext)	Ottiene un oggetto specificato utilizzando la classe BindingContext specificata.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una descrizione di questa classe.

Vedi anche

• Modalità di autenticazione di SecurityBindingElement
• Procedura: Creare un'associazione personalizzata usando SecurityBindingElement