本示例演示联合安全。
示例详细信息
Windows Communication Foundation (WCF) 将通过联合的安全体系结构部署提供支持wsFederationHttpBinding。 wsFederationHttpBinding 提供安全可靠并且可互操作的绑定,该绑定中使用 HTTP 作为请求/回复通信的基础传输机制,并使用文本/XML 作为编码的联网格式。 有关 WCF 中联合身份验证的详细信息,请参阅联合身份验证。
此方案包括 4 个部分:
-
BookStore 服务
-
BookStore STS
-
HomeRealm STS
-
BookStore 客户端
BookStore 服务支持两个操作:BrowseBooks 和 BuyBook。 它允许匿名访问 BrowseBooks 操作,但需要经过身份验证才能访问 BuyBooks 操作。 身份验证采用由 BookStore STS 颁发的令牌的形式。 BookStore 服务的配置文件使用 wsFederationHttpBinding 将客户端指向 BookStore STS。
<wsFederationHttpBinding>
<!-- This is the Service binding for the BuyBooks endpoint. It redirects clients to the BookStore STS -->
<binding name='BuyBookBinding'>
<security mode="Message">
<message>
<issuerMetadata
address='http://localhost/FederationSample/BookStoreSTS/STS.svc/mex' >
<identity>
<dns value ='BookStoreSTS.com'/>
</identity>
</issuerMetadata>
</message>
</security>
</binding>
</wsFederationHttpBinding>
BookStore STS 然后要求客户端使用 HomeRealm STS 颁发的令牌进行身份验证。 同样,BookStore STS 的配置文件使用 wsFederationHttpBinding 将客户端指向 HomeRealm STS。
<wsFederationHttpBinding>
<!-- This is the binding for the clients requesting tokens from this STS. It redirects clients to the HomeRealm STS -->
<binding name='BookStoreSTSBinding'>
<security mode='Message'>
<message>
<issuerMetadata
address='http://localhost/FederationSample/HomeRealmSTS/STS.svc/mex' >
<identity>
<dns value ='HomeRealmSTS.com' />
</identity>
</issuerMetadata>
</message>
</security>
</binding>
</wsFederationHttpBinding>
访问 BuyBook 操作时的事件序列如下:
-
客户端使用 Windows 凭据向 HomeRealm STS 进行身份验证。
-
HomeRealm STS 颁发一个令牌,该令牌可用于向 BookStore STS 进行身份验证。
-
客户端使用 HomeRealm STS 颁发的令牌向 BookStore STS 进行身份验证。
-
BookStore STS 颁发一个令牌,该令牌可用于向 BookStore 服务进行身份验证。
-
客户端使用 BookStore STS 颁发的令牌向 BookStore 服务进行身份验证。
-
客户端访问
BuyBook操作。
有关如何设置和运行此示例的信息,请参见以下说明。
Note: 必须具有写入权限wwwroot才能运行此示例的目录。
设置、生成和运行示例
-
打开 SDK 命令窗口。 在示例路径中运行 Setup.bat。 这将创建示例所需的虚拟目录,并使用相应的权限安装所需的证书。
NOTE Setup.bat 批处理文件设计为通过 Windows SDK 命令提示运行。 这要求 MSSDK 环境变量指向 SDK 的安装目录。 将在 Windows SDK 命令提示中自动设置此环境变量。 在 Windows Vista 上,必须确保已安装 IIS 6.0 管理兼容性,因为安装程序将使用 IIS 管理员脚本。 在 Windows Vista 上运行安装脚本需要具有管理员特权。
-
在 Visual Studio 中打开 FederationSample.sln,并选择生成解决方案从生成菜单。 这将生成通用项目文件、Bookstore 服务、Bookstore STS、HomeRealm STS 并将它们部署到 IIS 中。 还将生成 Bookstore 客户端应用程序,并将可执行文件 BookStoreClient.exe 放入 FederationSample\BookStoreClient\bin\Debug 文件夹。
-
双击 BookStoreClient.exe。 将显示 BookStoreClient 窗口。
-
可以通过单击浏览书店中书籍浏览丛书。
-
若要购买某一本图书,在列表中选择书籍,然后单击购买书籍。 该应用程序将启动,并使用 Windows 身份验证和 HomeRealm 安全令牌服务进行身份验证。
此示例配置为允许用户购买价格等于或低于 15 美元的图书。 尝试购买价格超过 15 美元的图书将导致客户端从 BookStore 服务获得“拒绝访问”消息。
NOTE 此示例不会在用户购买图书后更新其信用限额。 您可以在用户的(固定)信用限额内反复购买图书。
清理
- 运行 Cleanup.bat。 这将删除安装过程中创建的虚拟目录,并移除安装过程中安装的证书。
Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:
<InstallDrive>:\WF_WCF_Samples如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:
<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\Federation
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
