适用于
-
Microsoft® Windows® Identity Foundation (WIF)
-
ASP.NET® Web 窗体
总结
此“如何”主题提供了详细的分步过程,用于说明如何在 ASP.NET 应用程序中启用 WIF 跟踪。 还说明了如何测试应用程序,以验证跟踪侦听器和日志是否正常工作。 此“如何”主题未详细介绍如何创建安全令牌服务 (STS),而是使用随标识和访问工具提供的开发 STS。 开发 STS 不执行实际的身份验证操作,只是用来进行测试。 你将需要安装标识和访问工具才能完成此“如何”主题。 可从以下位置下载:标识和访问工具
Important: 为被动应用程序(即使用 WS 联合身份验证协议的应用程序)启用 WIF 跟踪有可能使应用程序受到拒绝服务 (DoS) 攻击或使信息泄漏给恶意方。 这包括被动 RP 和被动 STS。 因此,我们建议不要在生产环境中为被动 RP 和被动 STS 启用 WIF 跟踪。
内容
-
目标
-
概述
-
步骤摘要
-
步骤 1 – 创建简单的 ASP.NET Web 窗体应用程序,并启用跟踪
-
步骤 2 - 测试解决方案
目标
-
创建一个简单的 ASP.NET 应用程序,该应用程序使用标识和访问工具中的 WIF 和开发 STS
-
启用跟踪,并验证其是否正常工作
概述
跟踪可通过 WIF 调试和解决许多问题类型,包括令牌、cookie、声明、协议消息等。 WIF 跟踪类似于 WCF 跟踪;例如,可选择跟踪的详细级别,显示从关键消息到所有消息的一切内容。 可以在 .xml 文件或 .svclog 文件中生成 WIF 跟踪,可通过使用服务跟踪查看器工具查看。 此工具位于计算机上 Windows SDK 安装路径的bin目录中, 例如:C:\Program Files\Microsoft SDKs\Windows\v7.1\Bin\SvcTraceViewer.exe.
步骤摘要
-
步骤 1 – 创建简单的 ASP.NET Web 窗体应用程序,并启用跟踪
-
步骤 2 - 测试解决方案
步骤 1 – 创建简单的 ASP.NET Web 窗体应用程序,并启用跟踪
此步骤将创建新的 ASP.NET Web 窗体应用程序并修改 Web.config 文件以启用跟踪。
创建一个简单 ASP.NET 应用程序
-
启动 Visual Studio,然后依次单击“文件”、“新建”和“项目”。
-
在“新建项目”窗口中,单击“ASP.NET Web 窗体应用程序”。
-
在“名称”中,输入
TestApp,然后按“确定”。 -
在“解决方案资源管理器”下,右键单击“TestApp”项目,然后选择“标识和访问”。
-
“标识和访问”窗口随即出现。 在“提供程序”下,选择“使用本地开发 STS 测试应用程序”,然后单击“应用”。
-
在C: 驱动器的根目录中的命名日志中创建一个新文件夹, 如下所示:C:\logs
-
将以下 <system.diagnostics > 元素添加到 Web.config 配置文件中,紧跟在 </configSections > 元素之后,如下所示:
<configuration> <configSections> ... </configSections> <system.diagnostics> <sources> <source name="System.IdentityModel" switchValue="Verbose"> <listeners> <add name="xml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="C:\logs\WIF.xml" /> </listeners> </source> </sources> <trace autoflush="true" /> </system.diagnostics>NOTE 在 initializeData 属性中指定的目录位置必须存在,才可开始日志记录。 如果位置不存在,则无法创建任何日志。
上面的配置设置将启用 WIF 的详细跟踪,并将生成的日志保存在 C:logsWIF.xml 文件中。
步骤 2 - 测试解决方案
此步骤将测试已启用 WIF 的 ASP.NET 应用程序,以验证是否正在记录日志。
测试是否成功跟踪已启用 WIF 的 ASP.NET 应用程序
-
按 F5 键运行解决方案。 应显示默认 ASP.NET 主页,且你会通过用户名 Terry (这是由开发 STS 返回的默认用户名)进行自动身份验证。
-
关闭浏览器窗口,然后导航到 C:\logs 文件夹。 使用文本编辑器打开 C:\logs\WIF.xml 文件。
-
检查 WIF.xml 文件并验证该文件是否包含以 <E2ETraceEvent> 开头的项。 这些跟踪将包含 <TraceRecord > 元素,其中包含对跟踪活动的描述,如验证 SecurityToken。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 BrucePerlerMS)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
