通过

WS 传输安全

  • 项目

wsTransportSecurity 示例演示对 WSHttpBinding 绑定使用 SSL 传输安全。 默认情况下，wsHttpBinding 绑定提供 HTTP 通信。 针对传输安全配置绑定之后，该绑定即支持 HTTPS 通信。 此示例基于实现计算器服务的入门指南。 wsHttpBinding 是在客户端和服务的应用程序配置文件中指定和配置的。

备注

本主题的最后介绍了此示例的设置过程和生成说明。

此示例中的程序代码与入门服务的程序代码完全相同。 必须在生成和运行示例之前使用 Web 服务器证书向导创建证书并分配此证书。 配置文件设置中的终结点定义和绑定定义可启用 Transport 安全模式，如下面的客户端示例配置所示。

<system.serviceModel>

    <client>
      <!-- this endpoint has an https: address -->
      <endpoint address="https://localhost/servicemodelsamples/service.svc" binding="wsHttpBinding" bindingConfiguration="Binding1" contract="Microsoft.Samples.TransportSecurity.ICalculator"/>
    </client>

    <bindings>
      <wsHttpBinding>
        <!-- configure wsHttpbinding with Transport security mode
                   and clientCredentialType as None -->
        <binding name="Binding1">
          <security mode="Transport">
            <transport clientCredentialType="None"/>
          </security>
        </binding>
      </wsHttpBinding>
    </bindings>

  </system.serviceModel>

指定的地址使用 https:// 方案。 绑定配置将安全模式设置为 Transport。 必须在服务的 Web.config 文件中指定相同的安全模式。

因为此示例中使用的证书是用 Makecert.exe 创建的测试证书，所以当你尝试从浏览器中访问 HTTPS: 地址（例如 https://localhost/servicemodelsamples/service.svc）时，将出现安全警报。 为了允许 Windows Communication Foundation (WCF) 客户端就地使用测试证书，已向客户端添加了一些附加代码，以禁用安全警报。 使用生产证书时，不需要此代码和随附的类。

// This code is required only for test certificates like those created by Makecert.exe.
PermissiveCertificatePolicy.Enact("CN=ServiceModelSamples-HTTPS-Server");

运行示例时，操作请求和响应将显示在客户端控制台窗口中。 在客户端窗口中按 Enter 可以关闭客户端。

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

设置、生成和运行示例

  1. 使用以下命令安装 ASP.NET 4.0。

    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable

  2. 请确保已执行 Windows Communication Foundation 示例的一次性安装过程。

  3. 请确保已执行 Internet Information Services (IIS) 服务器证书安装说明。

  4. 若要生成 C# 或 Visual Basic .NET 版本的解决方案，请按照 Building the Windows Communication Foundation Samples中的说明进行操作。

  5. 要使用单机配置或跨计算机配置来运行示例，请按照运行 Windows Communication Foundation 示例中的说明进行操作。