使用WIF实现单点登录Part I——Windows Identity Foundation介绍及环境搭建

首先先说一下什么是WIF（Windows Identity Foundation）。由于各种历史原因，身份验证和标识的管理一般都比较无规律可循。在软件里加入“身份验证”功能意味着要在你的代码里混进处理底层任务（如验证用户名和密码，与X509证书或类似的证书打交道等）的代码。这样一来就得对基础架构相当依赖，程序很难移植，除非大范围重写。要改变这种情况，使用基于声明的标识（claims-based identity）可以很好的解决这个问题。这个“基于声明的标识”是神马东西我们留到以后再讲，现在您只要知道有这么个东西就行了。Windows Identity Foundation（WIF）是微软的基于声明标识的协议栈。它是一个新的基础技术，可以帮助.NET开发人员利用基于声明的方法来处理身份验证，授权，定制化以及任何与标识相关的任务，而无需编写任何底层代码。

下面来说说WIF环境的搭建。在这里我就走了不少冤枉路。我的悲催经历就不跟大家分享了，直接介绍各种环境该如何搭建：

1、如果你已经安装了VS2012,那么WIF已经包含在了.Net Framework当中，而且版本为WIF4.5。但是注意，WIF4.5只能用于.net 4.5的工程，如果你的asp.net或MVC项目是基于.net 4.5以下的话（即使你是在VS2012里创建的工程），请继续参考以下方法。

2、如果你安装的是VS2010/VS2008，那么你首先要先安装WIF，然后安装WIF SDK。

如果你用的是windows 8，那么系统已经集成了Windows Identity Foundation 3.5了，只要打开控制面板->程序和功能->打开或关闭Windows功能，找到 Windows Identity Foundation 3.5 ，将前面的勾勾上，然后点击“确定”，完事儿以后点“关闭”即可，如图：

这样WIF 3.5就启用成功了。

如果是其它操作系统，请点击这里，找到对应操作系统的exe文件，下载安装即可。

3、接下来安装WIF的SDK，如果你用的是VS2012，那就不用装任何SDK了，因为它都已经集成在.Net Framework 4.5里了。但是你可能需要安装一个VS的插件。打开VS2012，点击工具->扩展和更新，在左边列表里点击“联机”，然后在右上角的搜索框里输入"identity"，点击搜索结果里的“Identity and Access Tool”，点击下载按钮，等待下载并安装完成就可以了。这个工具可以让你很快捷地为Web Application，MVC程序或者WCF服务增加一个本地开发STS（Local Development STS），来测试WIF的功能。这个工具的使用我们留到以后再讲。

如果你用的不是VS2012，请点击这里进行下载并安装相应的SDK。

至此，WIF所需的环境就已经搭建好了，下一步我们来通过一个小例子来说明WIF的工作原理。

这里我用的环境是win7+vs2012，vs2010+WIF3.5/4.0的情况请参见这篇文章。

打开VS2012，新建一个基于.net framework4.5的MVC4的工程，取名为WIFTutorial。如下图：

在弹出的“新ASP.NET MVC 4项目”对话框中直接点“确定”。

项目新建完毕后，在“解决方案资源管理器”中，项目名称上点右键，然后选择“Identity and Accee...”，如图：

在“Providers”页签里选择“Use the Local Development STS to test your application”。此时”Local Development STS"页签由不可用变为可用。切换到该页签，将Test claims to issue表格里的第一行的Value列改为“ojlovecd”，如图：

点击“OK”，这个工具将会更改你的web.config文件，我们在解决方案资源管理器里打开web.config看看：

[html] view plaincopyprint?

1. <?xml version="1.0" encoding="utf-8"?>
2. <!--
3. 有关如何配置 ASP.NET 应用程序的详细信息，请访问
4. http://go.microsoft.com/fwlink/?LinkId=169433
5. -->
6. <configuration>
7. <configSections>
8. <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->
9. <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=5.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
10. <span style="color:#ff0000;"><section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />
11. <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" /></span>
12. </configSections>
13. <connectionStrings>
14. <add name="DefaultConnection" connectionString="Data Source=(LocalDb)\v11.0;Initial Catalog=aspnet-WIFTutorial-20130220231745;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|\aspnet-WIFTutorial-20130220231745.mdf" providerName="System.Data.SqlClient" />
15. </connectionStrings>
16. <appSettings>
17. <add key="webpages:Version" value="2.0.0.0" />
18. <add key="webpages:Enabled" value="false" />
19. <add key="PreserveLoginUrl" value="true" />
20. <add key="ClientValidationEnabled" value="true" />
21. <add key="UnobtrusiveJavaScriptEnabled" value="true" />
22. <span style="color:#ff0000;"><add key="ida:FederationMetadataLocation" value="http://localhost:14419/wsFederationSTS/FederationMetadata/2007-06/FederationMetadata.xml" />
23. <add key="ida:Issuer" value="http://localhost:14419/wsFederationSTS/Issue" />
24. <add key="ida:ProviderSelection" value="localSTS" /></span>
25. </appSettings>
26. <span style="color:#ff0000;"><location path="FederationMetadata">
27. <system.web>
28. <authorization>
29. <allow users="*" />
30. </authorization>
31. </system.web>
32. </location></span>
33. <system.web>
34. <span style="color:#ff0000;"><authorization>
35. <deny users="?" />
36. </authorization></span>
37. <authentication mode="None" />
38. <compilation debug="true" targetFramework="4.5" />
39. <httpRuntime targetFramework="4.5" requestValidationMode="4.5" />
40. <!--Commented by Identity and Access VS Package-->
41. <!--<authentication mode="Forms"><forms loginUrl="~/Account/Login" timeout="2880" /></authentication>-->
42. <pages>
43. <namespaces>
44. <add namespace="System.Web.Helpers" />
45. <add namespace="System.Web.Mvc" />
46. <add namespace="System.Web.Mvc.Ajax" />
47. <add namespace="System.Web.Mvc.Html" />
48. <add namespace="System.Web.Optimization" />
49. <add namespace="System.Web.Routing" />
50. <add namespace="System.Web.WebPages" />
51. </namespaces>
52. </pages>
53. </system.web>
54. <system.webServer>
55. <validation validateIntegratedModeConfiguration="false" />
56. <handlers>
57. <remove name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" />
58. <remove name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" />
59. <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
60. <add name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness32" responseBufferLimit="0" />
61. <add name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness64" responseBufferLimit="0" />
62. <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
63. </handlers>
64. <modules>
65. <remove name="FormsAuthentication" />
66. <add name="WSFederationAuthenticationModule" type="System.IdentityModel.Services.WSFederationAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />
67. <add name="SessionAuthenticationModule" type="System.IdentityModel.Services.SessionAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />
68. </modules>
69. </system.webServer>
70. <runtime>
71. <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
72. <dependentAssembly>
73. <assemblyIdentity name="System.Web.Helpers" publicKeyToken="31bf3856ad364e35" />
74. <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="2.0.0.0" />
75. </dependentAssembly>
76. <dependentAssembly>
77. <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
78. <bindingRedirect oldVersion="1.0.0.0-4.0.0.0" newVersion="4.0.0.0" />
79. </dependentAssembly>
80. <dependentAssembly>
81. <assemblyIdentity name="System.Web.WebPages" publicKeyToken="31bf3856ad364e35" />
82. <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="2.0.0.0" />
83. </dependentAssembly>
84. </assemblyBinding>
85. </runtime>
86. <entityFramework>
87. <defaultConnectionFactory type="System.Data.Entity.Infrastructure.LocalDbConnectionFactory, EntityFramework">
88. <parameters>
89. <parameter value="v11.0" />
90. </parameters>
91. </defaultConnectionFactory>
92. </entityFramework>
93. <system.identityModel>
94. <identityConfiguration>
95. <audienceUris>
96. <add value="http://localhost:8007/" />
97. </audienceUris>
98. <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
99. <trustedIssuers>
100. <add thumbprint="9B74CB2F320F7AAFC156E1252270B1DC01EF40D0" name="LocalSTS" />
101. </trustedIssuers>
102. </issuerNameRegistry>
103. <certificateValidation certificateValidationMode="None" />
104. </identityConfiguration>
105. </system.identityModel>
106. <span style="color:#ff0000;"><system.identityModel.services>
107. <federationConfiguration>
108. <cookieHandler requireSsl="false" />
109. <wsFederation passiveRedirectEnabled="true" issuer="http://localhost:14419/wsFederationSTS/Issue" realm="http://localhost:8007/" requireHttps="false" />
110. </federationConfiguration>
111. </system.identityModel.services></span>
112. </configuration>

其中标红色的部分即为工具自动生成的。同时此工具还会在你的程序跟目录下新建了一个名为FederationMetadata的目录，通过在解决方案资源管理器中点击“显示所有文件”按钮就可以看到了。

然后我们按F5，结果报错了，如图：

看提示，是因为要启动LocalSTS必须要用管理员身份来运行。好吧，关掉VS，以管理员身份再次打开，载入项目，再次按F5运行程序，此时看到右下角托盘处LocalSTS已经运行了，而打开的主页中，右上角显示用户ojlovecd已经处于登录状态。

这一连串操作到底都干了什么？

首先，刚才已经说到，Identity and Access Tool先修改了web.config，增加了WIF要用到的一些配置信息，在程序启动的时候，首先一并启动LocalSTS，这个LocalSTS起什么作用？由于web.config中配置了authorization节点，拒绝匿名用户访问，因此在你的程序运行起来以后，对程序的请求信息被重定向到LocalSTS，向LocalSTS请求身份信息，LocalSTS收到请求后，返回身份信息。那么返回的身份信息怎么来的？没错，就是在Identity and Access Tool工具里的第三个页签里配置的。