SecurityBindingElement.CreateSecureConversationBindingElement Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel.Channels

Zestaw:

System.ServiceModel.Security.dll

Zestaw:

System.ServiceModel.dll

Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości.

Przeciążenia

CreateSecureConversationBindingElement(SecurityBindingElement)	Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości. Element powiązania zabezpieczeń bootstrap określa sposób zabezpieczania wiadomości uzgadniania konwersacji.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości. Element powiązania zabezpieczeń bootstrap określa sposób zabezpieczania wiadomości uzgadniania konwersacji.

CreateSecureConversationBindingElement(SecurityBindingElement)

Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości. Element powiązania zabezpieczeń bootstrap określa sposób zabezpieczania wiadomości uzgadniania konwersacji.

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

Parametry

bootstrapSecurity

SecurityBindingElement

Element SecurityBindingElement , który zawiera specyfikację sposobu zabezpieczania bezpiecznych wiadomości uzgadniania konwersacji.

Zwraca

SecurityBindingElement

Obiekt SecurityBindingElement.

Wyjątki

ArgumentNullException

bootstrapSecurity to null.

Uwagi

Element powiązania jest skonfigurowany do używania tokenów kontekstu zabezpieczeń opartych na sesji.

Służy bootstrapSecurity do wskazywania powiązania zabezpieczeń i zasad używanych do żądania bezpiecznego tokenu konwersacji z usługi.

Jeśli bootstrapSecurity jest elementem TransportSecurityBindingElement, element powiązania zwrócony przez tę metodę jest również jeden i IncludeTimestamp jest ustawiony na true, a obiekt zwrócony z ma DetectReplays właściwość ustawioną falsena , a LocalServiceSecuritySettings LocalClientSecuritySettings obiekt zwrócony z DetectReplays LocalClientSettings LocalServiceSettings ma właściwość ustawioną na false.

SymmetricSecurityBindingElement W przeciwnym razie zwracany jest element z ustawioną wartością RequireSignatureConfirmation false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości.

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

Parametry

bootstrapSecurity

SecurityBindingElement

Element SecurityBindingElement , który zawiera specyfikację sposobu zabezpieczania bezpiecznych wiadomości uzgadniania konwersacji.

requireCancellation

Boolean

true jeśli jest wymagane anulowanie; w przeciwnym razie , false. Ustawienie tego parametru w celu false włączenia tokenu kontekstu zabezpieczeń, który jest przydatny w scenariuszach farmy sieci Web, ponieważ w tym trybie stan sesji jest zakodowany wewnątrz ustalonego tokenu kontekstu zabezpieczeń zamiast przechowywać w pamięci serwera.

Zwraca

SecurityBindingElement

Obiekt SecurityBindingElement.

Wyjątki

ArgumentNullException

bootstrapSecurity to null.

Przykłady

Poniższy kod pokazuje, jak wywołać tę metodę.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

Uwagi

Jeśli jest to false, są wydawane tokeny kontekstu zabezpieczeń oparte na plikach cookie. W requireCancellation przeciwnym razie są wydawane tokeny kontekstu zabezpieczeń oparte na sesji.

Służy bootstrapSecurity do wskazywania powiązania zabezpieczeń i zasad używanych do żądania żądania SecureConversationToken od usługi.

Jeśli bootstrapSecurity jest elementem TransportSecurityBindingElement, element powiązania zwrócony przez tę metodę jest również elementem TransportSecurityBindingElementi IncludeTimestamp jest ustawiony falsena true, a obiekt zwrócony z właściwości ma ustawioną właściwość na , a LocalServiceSecuritySettings LocalClientSecuritySettings obiekt zwrócony z LocalServiceSettings DetectReplays LocalClientSettings DetectReplays ma właściwość ustawioną na .false

SymmetricSecurityBindingElement W przeciwnym razie zwracany jest element z ustawioną wartością RequireSignatureConfirmation false.

Uwaga

Jeśli personifikacja jest wymagana w Windows XP, użyj bezpiecznej sesji bez tokenu kontekstu zabezpieczeń. Gdy tokeny kontekstu zabezpieczeń są używane z personifikacją, jest InvalidOperationException zgłaszany. Aby uzyskać więcej informacji, zobacz Scenariusze nieobsługiwane. Aby uzyskać więcej informacji na temat bezpiecznych sesji, zobacz Bezpieczne sesje.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Tworzy symetryczny element powiązania zabezpieczeń skonfigurowany do ustanowienia bezpiecznej konwersacji między klientem a usługą. Token kontekstu zabezpieczeń wystawiony na końcu bezpiecznego uzgadniania konwersacji jest używany do zabezpieczania wiadomości. Element powiązania zabezpieczeń bootstrap określa sposób zabezpieczania wiadomości uzgadniania konwersacji.

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

Parametry

bootstrapSecurity

SecurityBindingElement

Element SecurityBindingElement , który zawiera specyfikację sposobu zabezpieczania bezpiecznych wiadomości uzgadniania konwersacji.

requireCancellation

Boolean

true jeśli jest wymagane anulowanie; w przeciwnym razie , false. Ustawienie tego parametru w celu false włączenia tokenu kontekstu zabezpieczeń, który jest przydatny w scenariuszach farmy sieci Web, ponieważ w tym trybie stan sesji jest zakodowany wewnątrz ustalonego tokenu kontekstu zabezpieczeń zamiast przechowywać w pamięci serwera.

bootstrapProtectionRequirements

ChannelProtectionRequirements

ChannelProtectionRequirements Obiekt określający wymagania dotyczące ochrony kanału.

Zwraca

SecurityBindingElement

Obiekt SecurityBindingElement.

Wyjątki

ArgumentNullException

bootstrapSecurity to null.

Uwagi

Parametr bootstrapProtectionRequirements umożliwia dostosowanie sposobu, w jaki komunikaty wymieniane w ramach bezpiecznego uzgadniania konwersacji są zabezpieczone.

Służy bootstrapSecurity do wskazywania powiązania zabezpieczeń i zasad używanych do żądania bezpiecznego tokenu konwersacji z usługi.

Jeśli bootstrapSecurity jest elementem TransportSecurityBindingElement, element powiązania zwrócony przez tę metodę jest również elementem TransportSecurityBindingElementi IncludeTimestamp jest ustawiony falsena true, a obiekt zwrócony z właściwości ma ustawioną właściwość na , a LocalServiceSecuritySettings LocalClientSecuritySettings obiekt zwrócony z LocalServiceSettings DetectReplays LocalClientSettings DetectReplays ma właściwość ustawioną na .false

SymmetricSecurityBindingElement W przeciwnym razie zwracany jest element z ustawioną wartością RequireSignatureConfirmation false.

Uwaga

Jeśli personifikacja jest wymagana w Windows XP, użyj bezpiecznej sesji bez tokenu kontekstu zabezpieczeń. Gdy tokeny kontekstu zabezpieczeń są używane z personifikacją, jest InvalidOperationException zgłaszany. Aby uzyskać więcej informacji, zobacz Scenariusze nieobsługiwane. Aby uzyskać więcej informacji na temat bezpiecznych sesji, zobacz Bezpieczne sesje.