凭据是 Windows Communication Foundation (WCF) 使用建立声明的标识或功能的数据。 例如,护照就是政府颁发的用以证明国家或地区的公民身份的凭据。 在 WCF 中,凭据可以采用多种形式,例如用户名标记和 X.509 证书。 本主题讨论凭据、 如何在 WCF 中,使用它们以及如何选择正确的凭据为应用程序。
在许多国家和地区,驾驶执照就是凭据的一个示例。 该执照中包含表示个人身份和能力的数据。 它以持有人照片的形式包含所有权证明。 该执照由受信任的颁发机构颁发,通常是获得许可的政府部门。 该执照采用密封形式且包含一张全息图,表明它未经改动或伪造。
提交凭据涉及出示数据以及数据的所有权证明。 WCF 支持多种传输和消息安全级别的凭据类型。 例如,考虑两种类型的支持在 WCF 中的凭据: 用户名和 (X.509) 证书凭据。
对于用户名凭据,用户名表示已声明的标识,密码提供所有权证明。 这种情况下,受信任的颁发机构则是验证用户名和密码的系统。
使用 X.509 证书凭据,使用者名称、 使用者可选名称或证书中的特定字段可用作标识声明,而其他字段,如Valid From和Valid To字段中,指定的有效性证书。
传输凭据类型
下表列出了在传输安全模式下可以由绑定使用的客户端凭据的可能类型。 创建服务时,将 ClientCredentialType 属性设置为这些值之一以指定凭据类型,客户端必须提供该凭据才能与您的服务进行通信。 可以在代码或配置文件中设置这些类型。
| 设置 | 描述 |
|---|---|
| None | 指定客户端不需要提供任何凭据。 这相当于匿名客户端。 |
| Basic | 为客户端指定基本身份验证。 有关其他信息,请参见 RFC2617 —HTTP 身份验证:基本和摘要式身份验证。 |
| 摘要 | 为客户端指定摘要式身份验证。 有关其他信息,请参见 RFC2617 —HTTP 身份验证:基本和摘要式身份验证。 |
| Ntlm | 指定 NT LAN Manager (NTLM) 身份验证。 在由于某种原因无法使用 Kerberos 身份验证时使用。 此外可以通过设置禁用其用作回退xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm*属性设置为false,它会导致 WCF 使最大努力引发异常,则一旦使用 NTLM。 请注意,将此属性设置为 false 可能不阻止通过网络发送 NTLM 凭据。 |
| Windows | 指定 Windows 身份验证。 若要在 Windows 域上仅指定 Kerberos 协议,则将 xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm* 属性设置为 false(默认值为 true)。 |
| 证书 | 使用 X.509 证书执行客户端身份验证。 |
| Password | 用户必须提供用户名和密码。 使用 Windows 身份验证或其他自定义解决方案验证用户名/密码对。 |
消息客户端凭据类型
下表列出了在创建使用消息安全的应用程序时可以使用的可能的凭据类型。 可以在代码或配置文件中使用这些值。
| 设置 | 描述 |
|---|---|
| None | 指定客户端不需要提供凭据。 这相当于匿名客户端。 |
| Windows | 允许在使用 Windows 凭据建立的安全上下文中交换 SOAP 消息。 |
| 用户名 | 允许服务可以要求使用用户名凭据对客户端进行身份验证。 请注意,WCF 不允许使用用户名称,例如生成签名或加密数据的任何加密操作。 WCF 可确保传输的安全性时使用用户名凭据。 |
| 证书 | 允许服务可以要求使用 X.509 证书对客户端进行身份验证。 |
| 已颁发的令牌 | 根据安全策略配置的自定义令牌类型。 默认令牌类型为安全断言标记语言 (SAML)。 令牌由安全令牌服务颁发。 有关详细信息,请参阅联合身份验证和颁发令牌。 |
服务凭据的协商模型
协商是通过交换凭据建立客户端和服务之间的信任关系的过程。 该过程在客户端和服务之间以迭代方式进行,以便仅公开协商过程下一步所需的信息。 实际上,最终结果是将服务凭据传递给要在后续操作中使用的客户端。
有一个例外,默认情况下在 WCF 中的系统提供绑定协商服务凭据自动使用消息级安全时。 (例外情况为 xref:System.ServiceModel.BasicHttpBinding,默认情况下它不会启用安全性。)若要禁用此行为,请参见 xref:System.ServiceModel.MessageSecurityOverHttp.NegotiateServiceCredential* 和 xref:System.ServiceModel.FederatedMessageSecurityOverHttp.NegotiateServiceCredential* 属性。
Note: WCF 客户端使用 SSL 安全时使用.NET Framework 3.5 及更高版本,使用其证书存储区中的中间证书和 SSL 协商期间收到的中间证书都在服务上执行证书链验证证书。 .NET Framework 3.0 仅使用本地证书存储区中安装的中间证书。
带外协商
如果禁用自动协商,则在将任何消息发送到服务之前必须向客户端提供服务凭据。 这是也称为带外预配。 例如,如果指定的凭据类型为证书,且禁用了自动协商,则客户端必须联系服务所有者以在运行客户端应用程序的计算机上接收和安装证书。 例如,当要严格控制哪些客户端可以访问企业对企业方案中的服务时,可以执行上述操作。 在电子邮件,可以进行此扩展的-外协商和 X.509 证书存储在 Windows 证书存储中使用 Microsoft 管理控制台 (MMC) 证书管理单元之类的工具。
Note: xref:System.ServiceModel.ClientBase`1.ClientCredentials* 属性用于提供使用证书的服务,该证书通过带外协商实现。 这是使用 xref:System.ServiceModel.BasicHttpBinding 类时所必需的,因为绑定不允许自动协商。 该属性还可用于不相关的双工方案中。 在此方案中,无需客户端先向服务器发送请求,服务器就将消息发送到客户端。 由于服务器没有来自客户端的请求,因此它必须使用客户端的证书加密发送到客户端的消息。
设置凭据值
选择安全模式后,就必须指定实际凭据。 例如,如果将凭据类型设置为“证书”,那么必须将特定的凭据(例如特定的 X.509 凭据)与服务或客户端相关联。
根据是对服务进行编程还是对客户端进行编程,设置凭据的方法会略有不同。
设置服务凭据
如果使用的是传输模式,且使用 HTTP 作为传输,则必须使用 Internet Information Services (IIS),或使用证书配置端口。 有关详细信息,请参阅传输安全性概述并HTTP 传输安全性。
若要在代码中使用凭据配置服务,则创建 xref:System.ServiceModel.ServiceHost 类的一个实例,并使用 xref:System.ServiceModel.Description.ServiceCredentials 类指定适当的凭据,该类可通过 xref:System.ServiceModel.ServiceHostBase.Credentials* 属性访问。
设置证书
若要使用 X.509 证书(用于对客户端的服务进行身份验证)配置服务,则使用 xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.SetCertificate* 类的 xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential 方法。
若要使用客户端证书配置服务,则使用 xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate* 类的 xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential 方法。
设置 Windows 凭据
如果客户端指定了有效的用户名和密码,则使用该凭据对客户端进行身份验证。 否则,使用当前已登录用户的凭据。
设置客户端凭据
在 WCF 中,客户端应用程序使用 WCF 客户端连接到服务。 每个客户端都派生自 xref:System.ServiceModel.ClientBase`1 类,且客户端上的 xref:System.ServiceModel.ClientBase`1.ClientCredentials* 属性允许客户端凭据的各种值的规范。
设置证书
若要使用 X.509 证书(用于对服务的客户端进行身份验证)配置服务,则使用 xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate* 类的 xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential 方法。
如何使用客户端凭据对服务的客户端进行身份验证
使用 xref:System.ServiceModel.ClientBase`1.ClientCredentials* 属性或 xref:System.ServiceModel.ChannelFactory.Credentials* 属性提供与服务进行通信所需的客户端凭据信息。 安全通道使用此信息对服务的客户端进行身份验证。 身份验证可通过以下两种模式之一来实现:
-
使用 WCF 客户端实例建立安全上下文发送第一条消息之前,客户端凭据使用一次。 然后,所有的应用程序消息都通过安全上下文受到保护。
-
客户端凭据用于对发送到服务的每个应用程序消息进行身份验证。 在这种情况下,未在客户端和服务之间建立上下文。
已建立的标识无法更改
使用第一种方法时,已建立的上下文将与客户端标识永久关联。 也就是说,一旦建立了安全上下文,就无法更改与客户端相关联的标识。
Important: 无法切换标识时,要格外注意一种情况(即启用建立安全上下文时的默认行为)。 如果创建第二个服务进行通信的服务,不能更改用于打开第二个服务的 WCF 客户端的标识。 如果允许多个客户端使用第一个服务,且该服务访问第二个服务时将模拟客户端,则这将成为问题所在。 如果该服务重新使用所有调用方的相同客户端,则对第二个服务的所有调用都是以第一个调用方的标识进行的,该标识用于打开第二个服务的客户端。 换言之,该服务将第一个客户端的标识用于它的所有客户端以与第二个服务进行通信。 这可以导致特权提升。 如果这不是服务所需的行为,就必须跟踪每个调用方并为每个单独的调用方创建第二个服务的新客户端,并确保该服务仅使用正确调用方的正确客户端与第二个服务进行通信。
有关凭据和安全会话的详细信息,请参阅安全会话的安全注意事项。
请参阅
- xref:System.ServiceModel.ClientBase`1?displayProperty=nameWithType
- xref:System.ServiceModel.ClientBase`1.ClientCredentials*?displayProperty=nameWithType
- xref:System.ServiceModel.Description.ClientCredentials.ClientCertificate*?displayProperty=nameWithType
- xref:System.ServiceModel.BasicHttpMessageSecurity.ClientCredentialType*?displayProperty=nameWithType
- xref:System.ServiceModel.HttpTransportSecurity.ClientCredentialType*?displayProperty=nameWithType
- xref:System.ServiceModel.MessageSecurityOverHttp.ClientCredentialType*?displayProperty=nameWithType
- xref:System.ServiceModel.MessageSecurityOverMsmq.ClientCredentialType*?displayProperty=nameWithType
- xref:System.ServiceModel.MessageSecurityOverTcp.ClientCredentialType*?displayProperty=nameWithType
- xref:System.ServiceModel.TcpTransportSecurity.ClientCredentialType*?displayProperty=nameWithType
- xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate*?displayProperty=nameWithType
- xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.SetCertificate*?displayProperty=nameWithType
- 安全性概念
- 保护服务和客户端的安全
- WCF 安全编程
- HTTP 传输安全性
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
