SecurityBindingElement.CreateSecureConversationBindingElement Methode

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten.

Überlädt

CreateSecureConversationBindingElement(SecurityBindingElement)	Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten. Das Bootstrap-Sicherheitsbindungselement gibt an, wie die Handshake-Nachrichten zur sicheren Konversation gesichert werden.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten. Das Bootstrap-Sicherheitsbindungselement gibt an, wie die Handshake-Nachrichten zur sicheren Konversation gesichert werden.

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten. Das Bootstrap-Sicherheitsbindungselement gibt an, wie die Handshake-Nachrichten zur sicheren Konversation gesichert werden.

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

Parameter

bootstrapSecurity

SecurityBindingElement

Ein SecurityBindingElement das eine Spezifikation enthält, wie die sicheren Handshake-Nachrichten der Konversation gesichert werden.

Gibt zurück

SecurityBindingElement

Ein SecurityBindingElement-Objekt.

Ausnahmen

ArgumentNullException

bootstrapSecurity ist null.

Hinweise

Das Bindungselement wird so konfiguriert, dass sitzungsbasierte Sicherheitskontexttoken verwendet werden.

bootstrapSecurity wird verwendet, um die Sicherheitsbindung und Sicherheitsrichtlinien anzugeben, die zur Anforderung eines sicheren Konversationstokens vom Dienst verwendet werden.

Wenn bootstrapSecurity ein TransportSecurityBindingElement ist, gilt dies auch für das von dieser Methode zurückgegebene Bindungselement, und der IncludeTimestamp wird auf true festgelegt. Das LocalClientSecuritySettings-Objekt, das von LocalClientSettings zurückgegeben wird, verfügt über die DetectReplays-Eigenschaft, die auf false festgelegt wurde, und für das LocalServiceSecuritySettings-Objekt, das von LocalServiceSettings zurückgegeben wird, ist die DetectReplays-Eigenschaft auf false festgelegt.

Andernfalls wird ein SymmetricSecurityBindingElement zurückgegeben, wobei RequireSignatureConfirmation auf false festgelegt wurde.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten.

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

Parameter

bootstrapSecurity

SecurityBindingElement

Ein SecurityBindingElement das eine Spezifikation enthält, wie die sicheren Handshake-Nachrichten der Konversation gesichert werden.

requireCancellation

Boolean

true, wenn ein Abbruch erforderlich ist, andernfalls false. Wenn Sie diesen Parameter auf false festlegen, wird ein Sicherheitskontexttoken aktiviert, das für Webfarm-Szenarien nützlich ist, da in diesem Modus der Sitzungszustand im eingerichteten Sicherheitskontexttoken verschlüsselt wird, anstatt im Serverspeicher behalten zu werden.

Gibt zurück

SecurityBindingElement

Ein SecurityBindingElement-Objekt.

Ausnahmen

ArgumentNullException

bootstrapSecurity ist null.

Beispiele

Der folgende Code zeigt eine Möglichkeit, wie diese Methode aufgerufen werden kann.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

Hinweise

Wenn requireCancellation den Wert false aufweist, werden Cookie-basierte Sicherheitskontexttoken ausgestellt, andernfalls werden sitzungsbasierte Sicherheitskontexttoken ausgestellt.

bootstrapSecurity wird verwendet, um die Sicherheitsbindung und Sicherheitsrichtlinien anzugeben, die zur Anforderung eines SecureConversationToken vom Dienst verwendet werden.

Wenn bootstrapSecurity ein TransportSecurityBindingElement ist, ist auch das von dieser Methode zurückgegebene Bindungselement ein TransportSecurityBindingElement, und IncludeTimestamp wird auf true festgelegt. Das LocalClientSecuritySettings-Objekt, das von LocalClientSettings zurückgegeben wird, verfügt über die DetectReplays-Eigenschaft, die auf false festgelegt wurde, und für das LocalServiceSecuritySettings-Objekt, das von LocalServiceSettings zurückgegeben wird, ist die DetectReplays-Eigenschaft auf false festgelegt.

Andernfalls wird ein SymmetricSecurityBindingElement zurückgegeben, wobei RequireSignatureConfirmation auf false festgelegt wurde.

Hinweis

Wenn ein Identitätswechsel unter Windows XP erforderlich ist, verwenden Sie eine sichere Sitzung ohne Sicherheitskontexttoken. Wenn Sicherheitskontexttoken bei einem Identitätswechsel verwendet werden, wird eine InvalidOperationException ausgelöst. Weitere Informationen finden Sie unter Nicht unterstützte Szenarien. Weitere Informationen zu sicheren Sitzungen finden Sie unter Sichere Sitzungen.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Source:

SecurityBindingElement.cs

Erstellt ein symmetrisches Sicherheitsbindungselement, das so konfiguriert wurde, dass eine sichere Konversation zwischen dem Client und dem Dienst hergestellt werden kann. Das Sicherheitskontexttoken, das am Ende des Handshakes der sicheren Konversation ausgestellt wird, dient zum Sichern der Nachrichten. Das Bootstrap-Sicherheitsbindungselement gibt an, wie die Handshake-Nachrichten zur sicheren Konversation gesichert werden.

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

Parameter

bootstrapSecurity

SecurityBindingElement

Ein SecurityBindingElement das eine Spezifikation enthält, wie die sicheren Handshake-Nachrichten der Konversation gesichert werden.

requireCancellation

Boolean

true, wenn ein Abbruch erforderlich ist, andernfalls false. Wenn Sie diesen Parameter auf false festlegen, wird ein Sicherheitskontexttoken aktiviert, das für Webfarm-Szenarien nützlich ist, da in diesem Modus der Sitzungszustand im eingerichteten Sicherheitskontexttoken verschlüsselt wird, anstatt im Serverspeicher behalten zu werden.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Das ChannelProtectionRequirements-Objekt, das die Anforderungen für Channelschutz festlegt.

Gibt zurück

SecurityBindingElement

Ein SecurityBindingElement-Objekt.

Ausnahmen

ArgumentNullException

bootstrapSecurity ist null.

Hinweise

Die bootstrapProtectionRequirements-Parameter ermöglichen die Anpassung der Methode, wie ausgetauschte Nachrichten als Teil des sicheren Konversations-Handshakes gesichert werden.

bootstrapSecurity wird verwendet, um die Sicherheitsbindung und Sicherheitsrichtlinien anzugeben, die zur Anforderung eines sicheren Konversationstokens vom Dienst verwendet werden.

Wenn bootstrapSecurity ein TransportSecurityBindingElement ist, ist auch das von dieser Methode zurückgegebene Bindungselement ein TransportSecurityBindingElement, und IncludeTimestamp wird auf true festgelegt. Das LocalClientSecuritySettings-Objekt, das von LocalClientSettings zurückgegeben wird, verfügt über die DetectReplays-Eigenschaft, die auf false festgelegt wurde, und für das LocalServiceSecuritySettings-Objekt, das von LocalServiceSettings zurückgegeben wird, ist die DetectReplays-Eigenschaft auf false festgelegt.

Andernfalls wird ein SymmetricSecurityBindingElement zurückgegeben, wobei RequireSignatureConfirmation auf false festgelegt wurde.

Hinweis

Wenn ein Identitätswechsel unter Windows XP erforderlich ist, verwenden Sie eine sichere Sitzung ohne Sicherheitskontexttoken. Wenn Sicherheitskontexttoken bei einem Identitätswechsel verwendet werden, wird eine InvalidOperationException ausgelöst. Weitere Informationen finden Sie unter Nicht unterstützte Szenarien. Weitere Informationen zu sicheren Sitzungen finden Sie unter Sichere Sitzungen.