SecurityBindingElement.CreateSecureConversationBindingElement Metodo

Definizione

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.

Overload

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.

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity);
public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity);
static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement -> System.ServiceModel.Channels.SecurityBindingElement
Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement) As SecurityBindingElement

Parametri

bootstrapSecurity
SecurityBindingElement

SecurityBindingElement che contiene specifiche sulla modalità di protezione dei messaggi di handshake di conversazione protetta.A SecurityBindingElement that contains specification on how the secure conversation handshake messages are secured.

Restituisce

SecurityBindingElement

Un oggetto SecurityBindingElement.A SecurityBindingElement object.

Eccezioni

bootstrapSecurity è null.bootstrapSecurity is null.

Commenti

L'elemento di associazione viene configurato per utilizzare token di contesto di sicurezza basati sulla sessione.The binding element is configured to use session-based security context tokens.

Il parametro bootstrapSecurity viene utilizzato per indicare l'associazione e i criteri di sicurezza utilizzati per richiedere un token di conversazione sicura dal servizio.The bootstrapSecurity is used to indicate the security binding and policy used to request a secure conversation token from the service.

Se il parametro bootstrapSecurity è un elemento TransportSecurityBindingElement, anche l'elemento di associazione restituito da questo metodo è un elemento di questo tipo, la proprietà IncludeTimestamp è impostata su true, l'oggetto LocalClientSecuritySettings restituito da LocalClientSettings ha la proprietà DetectReplays impostata su false e l'oggetto LocalServiceSecuritySettings restituito da LocalServiceSettings ha la proprietà DetectReplays impostata su false.If bootstrapSecurity is a TransportSecurityBindingElement, the binding element returned by this method is also one, and IncludeTimestamp is set to true; and the LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false; and the LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

In caso contrario, viene restituito un elemento SymmetricSecurityBindingElement con la proprietà RequireSignatureConfirmation impostata su false.Otherwise, a SymmetricSecurityBindingElement is returned, with RequireSignatureConfirmation set to false.

Si applica a

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation);
public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation);
static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool -> System.ServiceModel.Channels.SecurityBindingElement
Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean) As SecurityBindingElement

Parametri

bootstrapSecurity
SecurityBindingElement

SecurityBindingElement che contiene specifiche sulla modalità di protezione dei messaggi di handshake di conversazione protetta.A SecurityBindingElement that contains specification on how the secure conversation handshake messages are secured.

requireCancellation
Boolean

true se l'annullamento è necessario. In caso contrario, false.true if cancellation is required; otherwise, false. L'impostazione di questo parametro su false abilita un token di contesto di sicurezza che risulta utile in scenari Web farm. In questa modalità lo stato della sessione viene infatti codificato all'interno del token di contesto di sicurezza stabilito anziché essere mantenuto nella memoria del server.Setting this parameter to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.

Restituisce

SecurityBindingElement

Un oggetto SecurityBindingElement.A SecurityBindingElement object.

Eccezioni

bootstrapSecurity è null.bootstrapSecurity is null.

Esempio

Nell'esempio di codice seguente viene mostrato come chiamare questo metodo.The following code shows how to call this method.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

// Use a secure session.
security = SecurityBindingElement.CreateSecureConversationBindingElement(security, true);

Commenti

Se requireCancellation è false, vengono rilasciati token di contesto di sicurezza basati su cookie. In caso contrario vengono rilasciati token di contesto di sicurezza basati sulla sessione.If requireCancellation is false, cookie-based security context tokens are issued; otherwise, session-based security context tokens are issued.

Il parametro bootstrapSecurity viene utilizzato per indicare l'associazione e i criteri di sicurezza utilizzati per richiedere un token SecureConversationToken dal servizio.The bootstrapSecurity is used to indicate the security binding and policy used to request a SecureConversationToken from the service.

Se il parametro bootstrapSecurity è un elemento TransportSecurityBindingElement, anche l'elemento di associazione restituito da questo metodo è un elemento TransportSecurityBindingElement, la proprietà IncludeTimestamp è impostata su true, l'oggetto LocalClientSecuritySettings restituito da LocalClientSettings ha la proprietà DetectReplays impostata su false e l'oggetto LocalServiceSecuritySettings restituito da LocalServiceSettings ha la proprietà DetectReplays impostata su false.If bootstrapSecurity is a TransportSecurityBindingElement, the binding element returned by this method is also a TransportSecurityBindingElement, and IncludeTimestamp is set to true; and the LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false; and the LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

In caso contrario, viene restituito un elemento SymmetricSecurityBindingElement con la proprietà RequireSignatureConfirmation impostata su false.Otherwise, a SymmetricSecurityBindingElement is returned, with RequireSignatureConfirmation set to false.

Nota

Quando la rappresentazione è obbligatoria in Windows XP, utilizzare una sessione protetta senza un token del contesto di sicurezza.When impersonation is required on Windows XP, use a secure session without a security context token. Quando vengono utilizzati token di contesto di sicurezza con la rappresentazione, viene generata un'eccezione InvalidOperationException.When security context tokens are used with impersonation an InvalidOperationException is thrown. Per altre informazioni, vedere scenari non supportati.For more information, see Unsupported Scenarios. Per ulteriori informazioni sulle sessioni protette, vedere Secure Sessions.For more information about secure sessions, see Secure Sessions.

Si applica a

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation, System::ServiceModel::Security::ChannelProtectionRequirements ^ bootstrapProtectionRequirements);
public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation, System.ServiceModel.Security.ChannelProtectionRequirements bootstrapProtectionRequirements);
static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool * System.ServiceModel.Security.ChannelProtectionRequirements -> System.ServiceModel.Channels.SecurityBindingElement
Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean, bootstrapProtectionRequirements As ChannelProtectionRequirements) As SecurityBindingElement

Parametri

bootstrapSecurity
SecurityBindingElement

SecurityBindingElement che contiene specifiche sulla modalità di protezione dei messaggi di handshake di conversazione protetta.A SecurityBindingElement that contains specification on how the secure conversation handshake messages are secured.

requireCancellation
Boolean

true se l'annullamento è necessario. In caso contrario, false.true if cancellation is required; otherwise, false. L'impostazione di questo parametro su false abilita un token di contesto di sicurezza che risulta utile in scenari Web farm. In questa modalità lo stato della sessione viene infatti codificato all'interno del token di contesto di sicurezza stabilito anziché essere mantenuto nella memoria del server.Setting this parameter to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.

bootstrapProtectionRequirements
ChannelProtectionRequirements

Oggetto ChannelProtectionRequirements che specifica i requisiti della protezione canale.The ChannelProtectionRequirements object that specifies the requirements for channel protection.

Restituisce

SecurityBindingElement

Un oggetto SecurityBindingElement.A SecurityBindingElement object.

Eccezioni

bootstrapSecurity è null.bootstrapSecurity is null.

Commenti

Il parametro bootstrapProtectionRequirements consente la personalizzazione della modalità di protezione dei messaggi scambiati come parte dell'handshake di conversazione protetta.The bootstrapProtectionRequirements parameter enables customization of how the messages exchanged as part of the secure conversation handshake are secured.

Il parametro bootstrapSecurity viene utilizzato per indicare l'associazione e i criteri di sicurezza utilizzati per richiedere un token di conversazione sicura dal servizio.The bootstrapSecurity is used to indicate the security binding and policy used to request a secure conversation token from the service.

Se il parametro bootstrapSecurity è un elemento TransportSecurityBindingElement, anche l'elemento di associazione restituito da questo metodo è un elemento TransportSecurityBindingElement, la proprietà IncludeTimestamp è impostata su true, l'oggetto LocalClientSecuritySettings restituito da LocalClientSettings ha la proprietà DetectReplays impostata su false e l'oggetto LocalServiceSecuritySettings restituito da LocalServiceSettings ha la proprietà DetectReplays impostata su false.If bootstrapSecurity is a TransportSecurityBindingElement, the binding element returned by this method is also a TransportSecurityBindingElement, and IncludeTimestamp is set to true; and the LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false; and the LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

In caso contrario, viene restituito un elemento SymmetricSecurityBindingElement con la proprietà RequireSignatureConfirmation impostata su false.Otherwise, a SymmetricSecurityBindingElement is returned, with RequireSignatureConfirmation set to false.

Nota

Quando la rappresentazione è obbligatoria in Windows XP, utilizzare una sessione protetta senza un token del contesto di sicurezza.When impersonation is required on Windows XP, use a secure session without a security context token. Quando vengono utilizzati token di contesto di sicurezza con la rappresentazione, viene generata un'eccezione InvalidOperationException.When security context tokens are used with impersonation an InvalidOperationException is thrown. Per altre informazioni, vedere scenari non supportati.For more information, see Unsupported Scenarios. Per ulteriori informazioni sulle sessioni protette, vedere Secure Sessions.For more information about secure sessions, see Secure Sessions.

Si applica a