SecurityBindingElement.CreateSecureConversationBindingElement Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.SecurityBindingElementPublic Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement) As SecurityBindingElementParametry
- bootstrapSecurity
- SecurityBindingElement
Element SecurityBindingElement , który zawiera specyfikację sposobu zabezpieczania bezpiecznych wiadomości uzgadniania konwersacji.
Zwraca
Obiekt SecurityBindingElement.
Wyjątki
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.
Dotyczy
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.SecurityBindingElementPublic Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean) As SecurityBindingElementParametry
- 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
Obiekt SecurityBindingElement.
Wyjątki
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.
Dotyczy
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.SecurityBindingElementPublic Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean, bootstrapProtectionRequirements As ChannelProtectionRequirements) As SecurityBindingElementParametry
- 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
Obiekt SecurityBindingElement.
Wyjątki
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.