SecurityBindingElement.CreateSecureConversationBindingElement Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v6.2.0

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.

Overload

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.

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

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.

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.

Restituisce

SecurityBindingElement

Un oggetto SecurityBindingElement.

Eccezioni

ArgumentNullException

bootstrapSecurity è null.

Commenti

L'elemento di associazione viene configurato per utilizzare token di contesto di sicurezza basati sulla sessione.

Il parametro bootstrapSecurity viene utilizzato per indicare l'associazione e i criteri di sicurezza utilizzati per richiedere un token di conversazione sicura dal servizio.

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.

In caso contrario, viene restituito un elemento SymmetricSecurityBindingElement con la proprietà RequireSignatureConfirmation impostata su false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

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.

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.

requireCancellation

Boolean

true se l'annullamento è necessario. In caso contrario, 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.

Restituisce

SecurityBindingElement

Un oggetto SecurityBindingElement.

Eccezioni

ArgumentNullException

bootstrapSecurity è null.

Esempio

Nell'esempio di codice seguente viene mostrato come chiamare questo metodo.

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.

Il parametro bootstrapSecurity viene utilizzato per indicare l'associazione e i criteri di sicurezza utilizzati per richiedere un token SecureConversationToken dal servizio.

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.

In caso contrario, viene restituito un elemento SymmetricSecurityBindingElement con la proprietà RequireSignatureConfirmation impostata su false.

Nota

Quando è necessaria la rappresentazione in Windows XP, usare una sessione sicura senza un token di contesto di sicurezza. Quando vengono utilizzati token di contesto di sicurezza con la rappresentazione, viene generata un'eccezione InvalidOperationException. Per altre informazioni, vedere Scenari non supportati. Per altre informazioni sulle sessioni sicure, vedere Sessioni sicure.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Source:

SecurityBindingElement.cs

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.

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.

requireCancellation

Boolean

true se l'annullamento è necessario. In caso contrario, 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.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Oggetto ChannelProtectionRequirements che specifica i requisiti della protezione canale.

Restituisce

SecurityBindingElement

Un oggetto SecurityBindingElement.

Eccezioni

ArgumentNullException

bootstrapSecurity è null.

Commenti

Il parametro bootstrapProtectionRequirements consente la personalizzazione della modalità di protezione dei messaggi scambiati come parte dell'handshake di conversazione protetta.

Il parametro bootstrapSecurity viene utilizzato per indicare l'associazione e i criteri di sicurezza utilizzati per richiedere un token di conversazione sicura dal servizio.

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.

In caso contrario, viene restituito un elemento SymmetricSecurityBindingElement con la proprietà RequireSignatureConfirmation impostata su false.

Nota

Quando è necessaria la rappresentazione in Windows XP, usare una sessione sicura senza un token di contesto di sicurezza. Quando vengono utilizzati token di contesto di sicurezza con la rappresentazione, viene generata un'eccezione InvalidOperationException. Per altre informazioni, vedere Scenari non supportati. Per altre informazioni sulle sessioni sicure, vedere Sessioni sicure.