SecurityBindingElement Classe

Definizione

Classe astratta la quale, se implementata, rappresenta un elemento di associazione che supporta la sicurezza dei messaggi SOAP del canale.An abstract class that, when implemented, represents a binding element that supports channel SOAP message security.

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 base per gli elementi di associazione di sicurezza dei messaggi SOAP in WCF.This class is the base class for the SOAP message security binding elements in WCF. Sono disponibili tre implementazioni di questa classe astratta: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement e TransportSecurityBindingElement.There are three implementations of this abstract class: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement, and TransportSecurityBindingElement. Queste implementazioni modellano le associazioni definite nella specifica WS-Security Policy.These implementations model the bindings defined in the WS-Security Policy specification.

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.A custom binding contains a collection of binding elements arranged in a specific order: the element that represents the top of the binding stack is added first, the next element down in the binding stack is added second, and so on.

Per aggiungere questa classe a un'associazione, eseguire le operazioni seguenti:To add this class to a binding, do the following:

  1. Creare un oggetto BindingElementCollection.Create a 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.Create a custom binding element that is above this binding element in the binding stack, such as the optional TransactionFlowBindingElement and ReliableSessionBindingElement.

  3. Aggiungere questi elementi nell'ordine descritto sopra alla classe BindingElementCollection utilizzando il metodo InsertItem.Add these elements in the order previously described to the BindingElementCollection using the InsertItem method.

  4. Creare un'istanza di un elemento di associazione di sicurezza derivata dalla classe SecurityBindingElement, ad esempio AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement o TransportSecurityBindingElement.Create an instance of a security binding element derived from SecurityBindingElement, such as AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement, or TransportSecurityBindingElement.

  5. Aggiungere alla raccolta l'elemento di associazione di sicurezza derivato.Add the derived security binding element to the collection.

  6. Aggiungere alla raccolta qualsiasi elemento di associazione personalizzato aggiuntivo, ad esempio TcpTransportBindingElement.Add any additional custom binding elements to the collection, such as TcpTransportBindingElement.

Per altre informazioni sull'uso di un SecurityBindingElement , vedere modalità di autenticazione di SecurityBindingElement e procedura: creare un'associazione personalizzata usando SecurityBindingElement.For more information about using a SecurityBindingElement, see SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement.

Nota

Dopo che un oggetto SecurityBindingElement è necessario trattare le relative proprietà come non modificabili.Once a SecurityBindingElement object is created, you should treat its properties as immutable. 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.Calling set on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a runtime failure being the only indication of an issue. Due proprietà che hanno in genere questo comportamento sono KeyType e MessageSecurityVersion.Two properties known to behave this way are KeyType and MessageSecurityVersion. È comunque possibile che altre proprietà abbiano lo stesso comportamento.There may be other properties of which this is also true.

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.Gets or sets a value that indicates whether mixed-mode secured messages can be sent over an unsecured transport such as HTTP.

DefaultAlgorithmSuite

Ottiene o imposta la crittografia dei messaggi e gli algoritmi di incapsulamento della chiave.Gets or sets the message encryption and key-wrap algorithms.

EnableUnsecuredResponse

Ottiene o imposta un valore che indica se WCF può inviare e ricevere risposte non sicure alle richieste sicure.Gets or sets a value that indicates whether WCF can send and receive unsecured responses to secured requests.

EndpointSupportingTokenParameters

Ottiene l'endpoint che supporta parametri token.Gets the endpoint that supports token parameters.

IncludeTimestamp

Ottiene o imposta un valore che indica se in ogni messaggio vengono inclusi timestamp.Gets or sets a value that indicates whether time stamps are included in each message.

KeyEntropyMode

Ottiene o imposta l'origine di entropia utilizzata per creare le chiavi.Gets or sets the source of entropy used to create keys.

LocalClientSettings

Ottiene le proprietà di associazione specifiche delle impostazioni di sicurezza locali utilizzate dal client.Gets the binding properties specific to local security settings used by the client.

LocalServiceSettings

Ottiene le proprietà di associazione specifiche delle impostazioni di sicurezza locali utilizzate dal servizio.Gets the binding properties specific to local security settings used by the service.

MessageSecurityVersion

Ottiene o imposta la versione della sicurezza del messaggio.Gets or sets the message security version.

OperationSupportingTokenParameters

Ottiene la raccolta di parametri dei token di supporto di operazione.Gets the collection of operation supporting token parameters.

OptionalEndpointSupportingTokenParameters

Ottiene i parametri dei token di supporto facoltativi per l'endpoint del servizio.Gets the optional supporting token parameters for the service endpoint.

OptionalOperationSupportingTokenParameters

Ottiene la raccolta di parametri dei token di supporto di operazione facoltativi.Gets the collection of optional operation supporting token parameters.

ProtectTokens

Ottiene o imposta se l’elemento di associazione di sicurezza protegge i token.Gets or sets whether the security binding element protects tokens.

SecurityHeaderLayout

Ottiene o imposta l'ordine degli elementi nell'intestazione di sicurezza per questa associazione.Gets or sets the ordering of the elements in the security header for this binding.

Metodi

BuildChannelFactory<TChannel>(BindingContext)

Crea una channel factory basata sulle impostazioni SecurityBindingElement e sul contesto di associazione passati.Creates a channel factory based on the SecurityBindingElement settings and the binding context passed in. 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).The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory).

BuildChannelFactoryCore<TChannel>(BindingContext)

Quando implementato, crea una channel factory di un tipo specificato.When implemented, creates a channel factory of a specified type.

BuildChannelListener<TChannel>(BindingContext)

Crea un listener del canale basato sulle impostazioni SecurityBindingElement e sul contesto di associazione passati.Creates a channel listener based on the SecurityBindingElement settings and the binding context passed in.

BuildChannelListener<TChannel>(BindingContext)

Inizializza un listener del canale per accettare canali di un tipo specificato dal contesto dell'associazione.Initializes a channel listener to accept channels of a specified type from the binding context.

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

Quando implementato, crea un listener del canale di un tipo specificato.When implemented, creates a channel listener of a specified type.

CanBuildChannelFactory<TChannel>(BindingContext)

Determina se è possibile compilare una channel factory del tipo specificato.Determines whether a channel factory of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext)

Determina se è possibile compilare un listener del canale del tipo specificato.Determines whether a channel listener of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext)

Restituisce un valore che indica se l'elemento di associazione può compilare un listener per un tipo di canale specifico.Returns a value that indicates whether the binding element can build a listener for a specific type of channel.

(Ereditato da BindingElement)
Clone()

Quando sottoposto a override in una classe derivata, restituisce una copia dell'oggetto dell'elemento di associazione.When overridden in a derived class, returns a copy of the binding element object.

(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.Creates a symmetric security binding element that is configured for anonymous client authentication and certificate-based server authentication.

CreateCertificateOverTransportBindingElement()

Crea un elemento di associazione di sicurezza che richiede l'autenticazione client basata sui certificati mediante la sicurezza dei messaggi SOAP.Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

CreateCertificateOverTransportBindingElement(MessageSecurityVersion)

Crea un elemento di associazione di sicurezza che richiede l'autenticazione client basata sui certificati mediante la sicurezza dei messaggi SOAP.Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

CreateCertificateSignatureBindingElement()

Crea un elemento di associazione utilizzando un certificato per firmare i messaggi.Creates a binding element using a certificate to sign messages. Questo elemento di associazione può essere utilizzato solo per gli scambi di messaggi unidirezionali ed è solo in grado di firmare il messaggio.This binding element can be used only for one-way message exchanges and is capable only of signing the message.

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.Creates a symmetric security binding element that is configured to require client authentication using a symmetric-key based issued token.

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.Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

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.Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

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.Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata sulla sicurezza SOAP mediante un token emesso.Creates a security binding element configured to require SOAP security based client authentication using an issued token. Questo elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateKerberosBindingElement()

Crea un elemento di associazione di sicurezza simmetrico configurato per richiedere l'autenticazione client basata sul token Kerberos del client.Creates a symmetric security binding element that is configured to require client authentication based on the client's Kerberos token.

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.Creates a security binding element that is configured to require SOAP-security based client authentication using the client's Kerberos token. Questo elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateMutualCertificateBindingElement()

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateDuplexBindingElement()

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. 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.This authentication mode can be used to secure duplex message-exchange patterns and requires the service to be configured with the client certificate out of band.

CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

Crea un elemento di associazione di sicurezza asimmetrico configurato per richiedere l'autenticazione client e l'autenticazione server basate sui certificati.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. 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.This authentication mode can be used to secure duplex message exchange patterns and requires the service to be configured with the client certificate out of band.

CreateSecureConversationBindingElement(SecurityBindingElement)

Crea un elemento di associazione di sicurezza simmetrico configurato per stabilire una conversazione protetta tra il client e il servizio.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. Il token del contesto di sicurezza rilasciato alla fine dell'handshake di conversazione sicura viene utilizzato per proteggere i messaggi.The security context token issued at the end of the secure conversation handshake is used to secure the messages. L'elemento di associazione di sicurezza del programma di avvio specifica la modalità di protezione dei messaggi di handshake di conversazione protetta.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Crea un elemento di associazione di sicurezza simmetrico configurato per stabilire una conversazione protetta tra il client e il servizio.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. Il token del contesto di sicurezza rilasciato alla fine dell'handshake di conversazione sicura viene utilizzato per proteggere i messaggi.The security context token issued at the end of the secure conversation handshake is used to secure the messages.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Crea un elemento di associazione di sicurezza simmetrico configurato per stabilire una conversazione protetta tra il client e il servizio.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. Il token del contesto di sicurezza rilasciato alla fine dell'handshake di conversazione sicura viene utilizzato per proteggere i messaggi.The security context token issued at the end of the secure conversation handshake is used to secure the messages. L'elemento di associazione di sicurezza del programma di avvio specifica la modalità di protezione dei messaggi di handshake di conversazione protetta.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

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.Creates a symmetric security binding element that is configured to do SOAP-level SSL negotiation between the client and server, noting whether a client certificate is required.

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.Creates a symmetric security binding element that does SOAP SSL negotiation, noting whether a client certificate and cancellation is required.

CreateSspiNegotiationBindingElement()

Crea un elemento di associazione di sicurezza simmetrico che esegue la negoziazione SSPI SOAP basata sul pacchetto di autenticazione Negotiate.Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

CreateSspiNegotiationBindingElement(Boolean)

Crea un elemento di associazione di sicurezza simmetrico che esegue la negoziazione SSPI SOAP basata sul pacchetto di autenticazione Negotiate.Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

CreateSspiNegotiationOverTransportBindingElement()

Crea un elemento di associazione di sicurezza configurato per l'autenticazione client basata sulla negoziazione SSPI SOAP mediante il pacchetto di autenticazione Negotiate.Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. L'elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, 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.Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. L'elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, 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.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. 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.The created binding element requires the client to be configured with a service certificate that is out-of-band before opening a communication channel with a service.

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.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. Il client autentica il server utilizzando il protocollo SSL a livello SOAP.The client authenticates the server using the SOAP-level SSL protocol.

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.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. Il client autentica il server utilizzando il protocollo SSL a livello SOAP.The client authenticates the server using the SOAP-level SSL protocol.

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.Creates a security binding element that is configured for client authentication based on a user name and password sent as part of the SOAP message. L'elemento di associazione richiede che il trasporto fornisca l'autenticazione server e la protezione dei messaggi (ad esempio, HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetProperty<T>(BindingContext)

Ottiene un oggetto specificato utilizzando la classe BindingContext specificata.Gets a specified object using the specified BindingContext.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(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.Sets the key for the token requirement property whose value is the BindingContext used to talk to the issuing party if the requirement is for an issued token.

SetKeyDerivation(Boolean)

Imposta un valore che indica se sono necessarie chiavi derivate.Sets a value that indicates whether derived keys are required.

ToString()

Restituisce una descrizione di questa classe.Returns a description of this class.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche