大网数据广告活动
.NET 与 C# 开发

如何:使用 WIF 跟踪调试声明感知应用程序和服务

· 52CE 我爱测

1. 在 Visual Studio 编辑器中打开“Web.config”或“App.config”根配置文件,方法是在解决方案资源管理器中双击文件。 如果解决方案没有“Web.config”或“App.config”配置文件,可在“解决方案资源管理器”中右键单击解决方案,再单击“添加”,然后单击“新建项...”来添加该文件。 在“新建项”对话框上,从列表中为“App.config”选择“应用程序配置文件”,或为“Web.config”选择“Web 配置文件”,然后单击“确定” 。

适用于

  • Microsoft® Windows® Identity Foundation (WIF)

  • 服务跟踪查看器工具 (SvcTraceViewer.exe)

  • 对 WIF 应用程序进行故障排除和调试

总结

本操作说明介绍进行后述操作所需的步骤:配置 WIF 跟踪、收集跟踪日志以及使用“跟踪查看器”工具分析跟踪日志。 它为排除 WIF 相关问题所需的操作提供跟踪项的常规映射。

内容

  • 目标

  • 步骤摘要

  • 步骤 1 – 使用 Web.config 配置文件配置 WIF 跟踪

  • 步骤 2 – 使用跟踪查看器工具分析 WIF 跟踪文件

  • 步骤 3 – 确定解决方案以修复 WIF 相关问题

  • 相关项

目标

  • 配置 WIF 跟踪。

  • 在跟踪查看器工具中查看跟踪日志。

  • 在跟踪日志中标识 WIF 相关问题。

  • 将纠正措施应用于在跟踪日志中发现的 WIF 相关问题。

步骤摘要

  • 步骤 1 – 使用 Web.config 配置文件配置 WIF 跟踪

  • 步骤 2 – 使用跟踪查看器工具分析 WIF 跟踪文件

  • 步骤 3 – 确定解决方案以修复 WIF 相关问题

步骤 1 – 使用 Web.config 配置文件配置 WIF 跟踪

在此步骤中,将向 Web.config 文件中的配置节添加更改,该文件使 WIF 能够跟踪其事件并将这些事件存储在跟踪日志中。

使用 Web.config 配置文件配置 WIF 跟踪
  1. 在 Visual Studio 编辑器中打开“Web.config”或“App.config”根配置文件,方法是在解决方案资源管理器中双击文件。 如果解决方案没有“Web.config”或“App.config”配置文件,可在“解决方案资源管理器”中右键单击解决方案,再单击“添加”,然后单击“新建项...”来添加该文件。 在“新建项”对话框上,从列表中为“App.config”选择“应用程序配置文件”,或为“Web.config”选择“Web 配置文件”,然后单击“确定” 。

  2. 在配置文件末尾将与下列条目相似的配置条目添加到“<configuration>”节点内的配置文件中:

    <system.diagnostics>  
        <sources>  
            <source name="System.IdentityModel" switchValue="Verbose">  
                <listeners>  
                    <add name="xml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="WIFTrace.e2e"/>  
                </listeners>  
            </source>  
        </sources>  
        <trace autoflush="true"/>  
    </system.diagnostics>  
    
  3. 以上配置指示 WIF 生成详细的跟踪事件并将其记录到 WIFTrace.e2e 文件中。 有关值的完整列表switchValue切换,请参阅以下主题中的跟踪级别表:配置跟踪。

步骤 2 – 使用跟踪查看器工具分析 WIF 跟踪文件

在此步骤中,将使用跟踪查看器工具 (SvcTraceViewer.exe) 来分析 WIF 跟踪日志。

使用跟踪查看器工具 (SvcTraceViewer.exe) 分析 WIF 跟踪日志
  1. 跟踪查看器工具 (SvcTraceViewer.exe) 作为 Windows SDK 的一部分提供。 如果你尚未安装 Windows SDK,你可以在此处下载:Windows SDK。

  2. 运行跟踪查看器工具 (SvcTraceViewer.exe)。 通常可以在安装路径的 Bin 文件夹中找到。

  3. 打开 WIF 跟踪日志文件(如 WIFTrace.e2e),方法是在菜单中选择“文件”、“打开…” 选项或使用 Ctrl+O 快捷方式。 在跟踪查看器工具中打开跟踪日志文件。

  4. 查看“活动”选项卡中的条目。每个项均应包含一个活动编号、记录的跟踪数、活动持续时间及其开始和结束时间戳。

  5. 单击“活动”选项卡。应可以在该工具的主区域中看到详细的跟踪项。 使用级别下拉列表中的在菜单上,若要筛选特定跟踪级别,例如:所有,警告,错误,信息,等等。

  6. 在工具的下部区域中单击特定跟踪项,查看详细信息。 可通过选择相应的选项卡使用“格式化”和“XML”视图来查看详细信息。

步骤 3 – 确定解决方案以修复 WIF 相关问题

在此步骤中,可以确定通过 WIF 跟踪日志和跟踪查看器工具标识的 WIF 相关问题的解决方案。 它概述了 WIF 相关异常对用于排除问题的潜在解决方案或所需操作的常规映射。

确定解决方案以修复 WIF 相关问题
  1. 查看以下 WIF 异常和解决问题所需操作表。
错误 ID 错误消息 修复错误所需操作
ID4175 IssuerNameRegistry 未识别的安全令牌的颁发者。 若要接受来自此颁发者的安全令牌,请将 IssuerNameRegistry 配置为返回此颁发者的有效名称。 从 MMC 管理单元复制指纹并将其粘贴到 Web.config 文件中可能会导致此错误。 具体而言,从证书属性窗口中复制时,可以获得文本字符串中额外的非打印字符。 此额外的字符将导致指纹匹配失败。正确复制指纹的过程,请参阅基于声明的单一登录-上面向 Web 和 Microsoft Azure。

相关项

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 BrucePerlerMS)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。