ASP.NET 成员资格提供程序是一项功能,使 ASP.NET 开发人员能够创建允许用户创建唯一的用户名称和密码组合的 Web 站点。 使用此工具,任何用户都可以在该网站上建立帐户,并登录网站以便独占访问该网站及其服务。 这与要求用户在 Windows 域中具有帐户的 Windows 安全完全不同。 所有提供凭据(用户名/密码组合)的用户都可以使用该网站及其服务。
示例应用程序,请参阅成员资格和角色提供程序。 有关使用 ASP.NET 角色提供程序功能的信息,请参阅如何:与服务一起使用 ASP.NET 角色提供程序。
成员资格功能要求使用 SQL Server 数据库来存储用户信息。 此功能还包括用于向忘记密码的用户提示问题的方法。
Windows Communication Foundation (WCF) 开发人员可以利用这些功能实现安全性。 当集成到 WCF 应用程序,用户必须提供用户名/密码组合到 WCF 客户端应用程序。 若要将数据传输到 WCF 服务,使用一个绑定,支持用户/密码凭据,如xref:System.ServiceModel.WSHttpBinding(在配置中, <wsHttpBinding >) 并设置客户端凭据类型设置为UserName. 在服务上,WCF 安全基于用户名和密码,用户进行身份验证,并还会将 ASP.NET 角色指定的角色分配。
Note: WCF 不提供方法以填充用户名/密码组合与数据库或其他用户信息。
配置成员资格提供程序
-
在 Web.config 文件中,在 <
system.web> 元素中,创建 <membership> 元素。 -
在
<membership><providers> 元素之下创建一个<providers>元素。 -
子级作为 <
providers> 元素中,添加<clear />元素以刷新提供程序的集合。 -
下
<clear />元素中,创建 <add> 元素具有以下属性设置为适当的值:name,type,connectionStringName,applicationName,enablePasswordRetrieval,enablePasswordReset,requiresQuestionAndAnswer``requiresUniqueEmail,和passwordFormat。name属性以后作为一个值在配置文件中使用。 下面的示例将其设置为SqlMembershipProvider。下面的示例显示配置节。
<!-- Configure the Sql Membership Provider --> <membership defaultProvider="SqlMembershipProvider" userIsOnlineTimeWindow="15"> <providers> <clear /> <add name="SqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider" connectionStringName="SqlConn" applicationName="MembershipAndRoleProviderSample" enablePasswordRetrieval="false" enablePasswordReset="false" requiresQuestionAndAnswer="false" requiresUniqueEmail="true" passwordFormat="Hashed" /> </providers> </membership>
配置服务安全以接受用户名/密码组合
-
在配置文件中下, <system.serviceModel >元素中,添加<绑定 >元素。
-
添加 <wsHttpBinding >到绑定节。 有关创建 WCF 绑定元素的详细信息,请参阅如何:在配置中指定服务绑定。
-
将
mode元素的<security>属性设置为Message。 -
设置
clientCredentialType属性的 <message> 元素UserName。 这将指定将用户名/密码对用作客户端的凭据。下面的示例显示绑定的配置代码。
<system.serviceModel> <bindings> <wsHttpBinding> <!-- Set up a binding that uses UserName as the client credential type --> <binding name="MembershipBinding"> <security mode ="Message"> <message clientCredentialType ="UserName"/> </security> </binding> </wsHttpBinding> </bindings> </system.serviceModel>
配置服务以使用成员资格提供程序
-
为的子级
<system.serviceModel>元素中,添加<行为 >元素 -
添加 <serviceBehaviors >到 <
behaviors> 元素。 -
添加<行为 >并设置
name属性为适当的值。 -
添加 <serviceCredentials >到 <
behavior> 元素。 -
添加 <userNameAuthentication >到
<serviceCredentials>元素。 -
将
userNamePasswordValidationMode属性设置为MembershipProvider。IMPORTANT 如果
userNamePasswordValidationMode未设置值,WCF 使用 Windows 身份验证而不是 ASP.NET 成员资格提供程序。 -
将
membershipProviderName属性设置为提供程序的名称(在本主题的第一个过程中添加提供程序时指定)。 下面的示例演示至此为止的<serviceCredentials>片段。<behaviors> <serviceBehaviors> <behavior name="MyServiceBehavior"> <serviceCredentials> <userNameAuthentication userNamePasswordValidationMode="MembershipProvider" membershipProviderName="SqlMembershipProvider" /> </serviceCredentials> </behavior> </serviceBehaviors> </behaviors>
示例
下面的代码示例演示使用 ASP 成员资格功能的服务的配置。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<services>
<service behaviorConfiguration="MyServiceBehavior" name="Microsoft.Samples.GettingStarted.CalculatorService">
<endpoint address="http://microsoft.com/WCFservices/Calculator"
binding="wsHttpBinding" bindingConfiguration="MembershipBinding"
name="ASPmemberUserName" contract="Microsoft.Samples.GettingStarted.ICalculator" />
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="MyServiceBehavior">
<serviceCredentials>
<userNameAuthentication
userNamePasswordValidationMode="MembershipProvider"
membershipProviderName="SqlMembershipProvider" />
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
<bindings>
<wsHttpBinding>
<binding name="MembershipBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
</binding>
</wsHttpBinding>
</bindings>
</system.serviceModel>
</configuration>
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
