SslStreamSecurityBindingElement 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.NetFramingBase.dll

包:

System.ServiceModel.NetFramingBase v8.0.0

表示一个自定义绑定元素，它支持使用 SSL 流的通道安全。

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

public class SslStreamSecurityBindingElement : System.ServiceModel.Channels.StreamUpgradeBindingElement

type SslStreamSecurityBindingElement = class
    inherit StreamUpgradeBindingElement

Public Class SslStreamSecurityBindingElement
Inherits StreamUpgradeBindingElement

继承

Object

BindingElement

StreamUpgradeBindingElement

SslStreamSecurityBindingElement

注解

使用面向流协议（如 TCP 和命名管道）的传输支持基于流的传输升级。 具体而言，Windows Communication Foundation (WCF) 提供安全升级。 此传输安全的配置由此类和 SslStreamSecurityBindingElement 包装，您可以对它们进行配置并将其添加到自定义绑定。 此外，第三方可以写入其自定义的 StreamSecurityBindingElement。 这些绑定元素会扩展为了生成客户端和服务器流升级提供程序而调用的 StreamUpgradeBindingElement 类。

自定义绑定包含以特定顺序排列的绑定元素集合：首先添加表示绑定堆栈顶部的元素，其次是绑定堆栈的第二个元素，依此类推。

将此类添加到绑定中

1. 创建 BindingElementCollection。

2. 在绑定堆栈中创建将位于此绑定元素之上的自定义绑定元素，比如可选的 TransactionFlowBindingElement 和 ReliableSessionBindingElement。

3. 使用 BindingElementCollection 方法，按照前面介绍的顺序将已创建的元素添加到 InsertItem。

4. 创建 SslStreamSecurityBindingElement 的实例，并将其添加到集合。

5. 将任何其他自定义绑定元素添加到集合，比如 TcpTransportBindingElement。

在三种情况下，必须在导入 WSDL 后在客户端终结点上手动指定正确的 UPN/SPN，或在客户端的 SslStreamSecurityBindingElement上指定自定义IdentityVerifier。

1. 在 WSDL 中没有发布任何服务标识。 将使用 SspiNegotiatedOverTransport 和 HTTPS（例如，其 SecurityMode 为 WSHttpBinding 的 TransportWithMessageCredential）。 如果该服务不是使用计算机标识运行的，则在导入 WSDL 后，必须在客户端终结点上手动指定正确的 UPN/SPN。

2. DNS 服务标识在 WSDL 中发布。 SspiNegotiatedOverTransport 和 SslStreamSecurityBindingElement 用于 (例如， NetTcpBinding SecurityMode = TransportWithMessageCredential) 而不是 UPN/SPN。 如果该服务不是使用计算机标识运行的，或者 DNS 标识不是计算机的标识，则在导入 WSDL 后，必须在客户端终结点上手动指定正确的 UPN/SPN。

3. 在 WSDL 中发布了 DNS 标识。 如果在客户端上重写 SslStreamSecurityBindingElement，必须在客户端的 IdentityVerifier 上指定自定义的 SslStreamSecurityBindingElement。

下面的代码演示如何在客户端终结点上手动指定正确的 UPN/SPN，以及如何在客户端的 IdentityVerifier 上指定自定义的 SslStreamSecurityBindingElement。

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();  
        }  
    }  

构造函数

SslStreamSecurityBindingElement()	初始化 SslStreamSecurityBindingElement 类的新实例。
SslStreamSecurityBindingElement(SslStreamSecurityBindingElement)	使用其他 SslStreamSecurityBindingElement 的值初始化 SslStreamSecurityBindingElement 类的新实例。

属性

IdentityVerifier	获取或设置此绑定的标识验证程序。
RequireClientCertificate	获取或设置一个值，该值指定此绑定是否需要客户端证书。
SslProtocols	指定使用 TcpClientCredentialType.Certificate 的客户端凭据类型时要协商的 SSL/TLS 协议的列表。 此值可以是一个或多个下列枚举成员的组合：Ssl3、Tls、Tls11、Tls12。

方法

BuildChannelFactory<TChannel>(BindingContext)	创建指定类型的通道工厂。
BuildChannelListener<TChannel>(BindingContext)	初始化通道侦听器，用于接受绑定上下文中指定类型的通道。 (继承自 BindingElement)
BuildClientStreamUpgradeProvider(BindingContext)	基于提供的通道上下文在 StreamUpgradeProvider 的客户端上创建一个实例。
BuildServerStreamUpgradeProvider(BindingContext)	基于提供的通道上下文在 StreamUpgradeProvider 的服务器上创建一个实例。 (继承自 StreamUpgradeBindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	获取一个值，该值指示是否可以生成指定类型的通道工厂。
CanBuildChannelListener<TChannel>(BindingContext)	返回一个值，该值指示绑定元素是否可以为特定类型的通道生成侦听器。 (继承自 BindingElement)
Clone()	创建是当前实例的副本的新实例。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperty<T>(BindingContext)	从 BindingContext 中获取指定的对象。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)