SecurityBindingElement Classe

Definizione

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à
SecurityBindingElement
Derivato

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à

AllowInsecureTransport

Ottiene o imposta un valore che indica se messaggi protetti in modalità mista possono essere inviati tramite un trasporto non sicuro quale HTTP.

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.

LocalServiceSettings

Ottiene le proprietà di associazione specifiche delle impostazioni di sicurezza locali utilizzate dal servizio.

MessageSecurityVersion

Ottiene o imposta la versione della sicurezza del messaggio.

OperationSupportingTokenParameters

Ottiene la raccolta di parametri dei token di supporto di operazione.

OptionalEndpointSupportingTokenParameters

Ottiene i parametri dei token di supporto facoltativi per l'endpoint del servizio.

OptionalOperationSupportingTokenParameters

Ottiene la raccolta di parametri dei token di supporto di operazione facoltativi.

ProtectTokens

Ottiene o imposta se l’elemento di associazione di sicurezza protegge i token.

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)

Crea un listener del canale basato sulle impostazioni SecurityBindingElement e sul contesto di associazione passati.

BuildChannelListener<TChannel>(BindingContext)

Inizializza un listener del canale per accettare canali di un tipo specificato dal contesto dell'associazione.

(Ereditato da BindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)

Quando implementato, crea un listener del canale di un tipo specificato.

CanBuildChannelFactory<TChannel>(BindingContext)

Determina se è possibile compilare una channel factory del tipo specificato.

CanBuildChannelListener<TChannel>(BindingContext)

Determina se è possibile compilare un listener del canale 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)
CreateAnonymousForCertificateBindingElement()

Crea un elemento di associazione di sicurezza simmetrico configurato per l'autenticazione del client anonima e l'autenticazione server basata sui certificati.

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.

CreateCertificateSignatureBindingElement()

Crea un elemento di associazione utilizzando un certificato per firmare i messaggi. Questo elemento di associazione può essere utilizzato solo per gli scambi di messaggi unidirezionali ed è solo in grado di firmare il messaggio.

CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione del client utilizzando un token emesso basato su chiave simmetrica.

CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata su un token emesso e l'autenticazione server basata sul certificato del server.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata su un token emesso e l'autenticazione server basata sul certificato del server.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata su un token emesso e l'autenticazione server basata sul certificato del server.

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

CreateKerberosBindingElement()

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata sul token Kerberos del client.

CreateKerberosOverTransportBindingElement()

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata sulla protezione SOAP mediante il token Kerberos del client. Questo elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).

CreateMutualCertificateBindingElement()

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.

CreateMutualCertificateDuplexBindingElement()

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati. Questa modalità di autenticazione può essere usata per proteggere modelli di scambio di messaggi duplex e richiede che il servizio venga configurato con il certificato client fuori banda.

CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati. Questa modalità di autenticazione può essere usata per proteggere modelli di scambio di messaggi duplex e richiede che il servizio venga configurato con il certificato client fuori banda.

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.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

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.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

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.

CreateSslNegotiationBindingElement(Boolean)

Crea un elemento di associazione di sicurezza simmetrico configurato per eseguire la negoziazione SSL a livello SOAP tra il client e il server, indicando se è necessario un certificato client.

CreateSslNegotiationBindingElement(Boolean, Boolean)

Crea un elemento di associazione di sicurezza simmetrico che esegue la negoziazione SSL SOAP, indicando se sono necessari un certificato client e l'annullamento.

CreateSspiNegotiationBindingElement()

Crea un elemento di associazione di sicurezza simmetrico che esegue la negoziazione SSPI SOAP basata sul pacchetto di autenticazione Negotiate.

CreateSspiNegotiationBindingElement(Boolean)

Crea un elemento di associazione di sicurezza simmetrico che esegue la negoziazione SSPI SOAP basata sul pacchetto di autenticazione Negotiate.

CreateSspiNegotiationOverTransportBindingElement()

Crea un elemento di associazione di sicurezza configurato per l'autenticazione client basata sulla negoziazione SSPI SOAP mediante il pacchetto di autenticazione Negotiate. L'elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).

CreateSspiNegotiationOverTransportBindingElement(Boolean)

Crea un elemento di associazione di sicurezza configurato per l'autenticazione client basata sulla negoziazione SSPI SOAP mediante il pacchetto di autenticazione Negotiate. L'elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).

CreateUserNameForCertificateBindingElement()

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata su nome utente e password e l'autenticazione server basata sui certificati. Prima di aprire un canale di comunicazione con un servizio, l'elemento di associazione creato richiede che il client venga configurato con un certificato di servizio fuori banda.

CreateUserNameForSslBindingElement()

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata su nome utente e password e l'autenticazione server basata sui certificati. Il client autentica il server utilizzando il protocollo SSL a livello SOAP.

CreateUserNameForSslBindingElement(Boolean)

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata su nome utente e password e l'autenticazione server basata sui certificati. Il client autentica il server utilizzando il protocollo SSL a livello SOAP.

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)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)

Imposta la chiave per la proprietà del requisito del token il cui valore è la proprietà BindingContext utilizzata per comunicare con la parte di emissione se il requisito è per un token emesso.

SetKeyDerivation(Boolean)

Imposta un valore che indica se sono necessarie chiavi derivate.

ToString()

Restituisce una descrizione di questa classe.

Si applica a

Vedi anche