SslStreamSecurityBindingElement Sınıf

Tanım

public ref class SslStreamSecurityBindingElement : System::ServiceModel::Channels::BindingElement

public ref class SslStreamSecurityBindingElement : System::ServiceModel::Channels::StreamUpgradeBindingElement

public ref class SslStreamSecurityBindingElement : System::ServiceModel::Channels::StreamUpgradeBindingElement, System::ServiceModel::Channels::ITransportTokenAssertionProvider, System::ServiceModel::Description::IPolicyExportExtension

public class SslStreamSecurityBindingElement : System.ServiceModel.Channels.BindingElement

public class SslStreamSecurityBindingElement : System.ServiceModel.Channels.StreamUpgradeBindingElement

public class SslStreamSecurityBindingElement : System.ServiceModel.Channels.StreamUpgradeBindingElement, System.ServiceModel.Channels.ITransportTokenAssertionProvider, System.ServiceModel.Description.IPolicyExportExtension

type SslStreamSecurityBindingElement = class
    inherit BindingElement

type SslStreamSecurityBindingElement = class
    inherit StreamUpgradeBindingElement

type SslStreamSecurityBindingElement = class
    inherit StreamUpgradeBindingElement
    interface ITransportTokenAssertionProvider
    interface IPolicyExportExtension

Public Class SslStreamSecurityBindingElement
Inherits BindingElement

Public Class SslStreamSecurityBindingElement
Inherits StreamUpgradeBindingElement

Public Class SslStreamSecurityBindingElement
Inherits StreamUpgradeBindingElement
Implements IPolicyExportExtension, ITransportTokenAssertionProvider

Devralma

Object

BindingElement

SslStreamSecurityBindingElement

Devralma

Object

BindingElement

StreamUpgradeBindingElement

SslStreamSecurityBindingElement

Uygulamalar

ITransportTokenAssertionProvider IPolicyExportExtension

Açıklamalar

TCP ve adlandırılmış kanallar gibi akış odaklı bir protokol kullanan aktarımlar, akış tabanlı aktarım yükseltmelerini destekler. Özellikle, Windows Communication Foundation (WCF) güvenlik yükseltmeleri sağlar. Bu aktarım güvenliğinin yapılandırması hem bu sınıf hem de SslStreamSecurityBindingElementtarafından yapılandırılabilir ve özel bağlamaya eklenebilir. Buna ek olarak, üçüncü taraf kendi özel StreamSecurityBindingElementyazabilir. Bu bağlama öğeleri, istemci ve sunucu akışı yükseltme sağlayıcılarını derlemek için çağrılan sınıfını genişletir StreamUpgradeBindingElement .

Özel bağlama, belirli bir sırada düzenlenmiş bağlama öğelerinin koleksiyonunu içerir: bağlama yığınının üst kısmını temsil eden öğe önce eklenir, bağlama yığınındaki bir sonraki öğe ikinci olarak eklenir ve bu şekilde devam eder.

Bu sınıfı bağlamaya eklemek için

1. oluşturun BindingElementCollection.

2. Bağlama yığınında bu bağlama öğesinin üzerinde olan isteğe bağlı TransactionFlowBindingElement ve ReliableSessionBindingElementgibi özel bağlama öğeleri oluşturun.

3. Oluşturulan öğeleri daha önce açıklanan sırayla yöntemini kullanarak InsertItem öğesine BindingElementCollection ekleyin.

4. örneğini SslStreamSecurityBindingElement oluşturun ve koleksiyona ekleyin.

5. Koleksiyonuna gibi TcpTransportBindingElementek özel bağlama öğeleri ekleyin.

WSDL'yi içeri aktardıktan sonra istemci uç noktasında doğru UPN/SPN'yi el ile belirtmeniz veya istemcinin SslStreamSecurityBindingElementüzerinde bir özel IdentityVerifier değer belirtmeniz gereken üç senaryo vardır.

1. WSDL'de hiçbir hizmet kimliği yayımlanmaz. SspiNegotiatedOverTransportve HTTPS kullanılır (örneğin, SecurityMode = TransportWithMessageCredentialile ).WSHttpBinding Hizmet makine kimliğiyle çalışmıyorsa, WSDL'yi içeri aktardıktan sonra istemci uç noktasında doğru UPN/SPN'yi el ile belirtmeniz gerekir.

2. DNS hizmet kimliği WSDL'de yayımlanır. SspiNegotiatedOverTransport ve SslStreamSecurityBindingElement upn/SPN yerine kullanılır (örneğin SecurityMode NetTcpBinding = TransportWithMessageCredentialile). Hizmet makine kimliğiyle çalışmıyorsa veya DNS kimliği makinenin kimliği değilse, WSDL'yi içeri aktardıktan sonra istemci uç noktasında doğru UPN/SPN'yi el ile belirtmeniz gerekir.

3. DNS kimliği WSDL'de yayımlanır. SslStreamSecurityBindingElement İstemcide geçersiz kılınırsa, istemcinin SslStreamSecurityBindingElementüzerinde özel IdentityVerifier bir belirtmelisiniz.

Aşağıdaki kod, istemci uç noktasında doğru UPN/SPN'nin nasıl el ile belirtileceğini ve ayrıca istemcinin SslStreamSecurityBindingElementüzerinde bir özel IdentityVerifier değerin nasıl belirtileceğini gösterir.

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Net;  
using System.IdentityModel.Claims;  
using System.IdentityModel.Policy;  
using System.Security.Cryptography.X509Certificates;  
using System.ServiceModel;  
using System.ServiceModel.Channels;  
using System.ServiceModel.Description;  
using System.ServiceModel.Security;  
using System.Xml;  

namespace ServiceNamespace  
{  
    [ServiceContract]  
    interface IService  
    {  
        [OperationContract]  
        void DoSomething();  
    }  

    class DnsIdentityVerifier : IdentityVerifier  
    {  
        DnsEndpointIdentity _expectedIdentity;  

        public DnsIdentityVerifier(EndpointAddress serviceEndpoint)  
        {  
            _expectedIdentity = new DnsEndpointIdentity(serviceEndpoint.Uri.DnsSafeHost);  
        }  

        public override bool CheckAccess(EndpointIdentity identity, AuthorizationContext authContext)  
        {  
            Claim dnsClaim = authContext.Claims().Single(claim => claim.ClaimType == ClaimTypes.Dns);  
            return String.Equals(_expectedIdentity.IdentityClaim.Resource, dnsClaim.Resource);  
        }  

        public override bool TryGetIdentity(EndpointAddress reference, out EndpointIdentity identity)  
        {  
            identity = _expectedIdentity;  
            return true;  
        }  
    }  

    static class LinqExtensionForClaims  
    {  
        public static IEnumerable<Claim> Claims(this AuthorizationContext authContext)  
        {  
            if (null != authContext.ClaimSets)  
            {  
                foreach (ClaimSet claimSet in authContext.ClaimSets)  
                {  
                    if (null != claimSet)  
                    {  
                        foreach (Claim claim in claimSet)  
                        {  
                            yield return claim;  
                        }  
                    }  
                }  
            }  
        }  
    }  

    class Service : IService  
    {  
        public void DoSomething()  
        {  
            Console.WriteLine("Service called.");  
        }  
    }  

    class Program  
    {  
        static void Main(string[] args)  
        {  
            string hostname = Dns.GetHostEntry(String.Empty).HostName;  
            NetTcpBinding serviceBinding = new NetTcpBinding(SecurityMode.TransportWithMessageCredential);  

            ServiceHost serviceHost = new ServiceHost(typeof(Service), new Uri(String.Format("net.tcp://{0}:8080/Service", hostname)));  
            serviceHost.Credentials.ServiceCertificate.SetCertificate(StoreLocation.LocalMachine, StoreName.My, X509FindType.FindByThumbprint, "8a 42 1b eb cf 8a 14 b1 de 83 d9 a5 70 88 0a 62 f9 bf 69 06");  
            ServiceEndpoint serviceEndpoint = serviceHost.AddServiceEndpoint(typeof(IService), serviceBinding, "Endpoint");  
            serviceHost.Open();  

            CustomBinding clientBinding = new CustomBinding(serviceBinding.CreateBindingElements());  
            SslStreamSecurityBindingElement sslStream = clientBinding.Elements.Find<SslStreamSecurityBindingElement>();  
            sslStream.IdentityVerifier = new DnsIdentityVerifier(serviceEndpoint.Address);  

            ChannelFactory<IService> channelFactory = new ChannelFactory<IService>(clientBinding, new EndpointAddress(serviceEndpoint.Address.Uri, UpnEndpointIdentity.CreateUpnIdentity("username@domain")));  
            channelFactory.Credentials.Windows.AllowNtlm = false;  
            IService channel = channelFactory.CreateChannel();  
            channel.DoSomething();  
        }  
    }  

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır