声明是一个使用者对其自身或另一个使用者做出的陈述。 声明由信赖方颁发,它们被赋予一个或多个值,然后打包到 AD FS 服务器颁发的安全令牌。 本文介绍声明语法和创建。 有关声明颁发的信息,请参阅 AD FS 故障排除-声明颁发。
Note: 你可以使用ADFS 帮助站点上的ClaimsXRay来帮助排查声明问题。
处理声明规则的方式
声明规则是通过声明 管道 使用 声明引擎处理的。 声明引擎是联合身份验证服务的一个逻辑组件,它检查用户提供的传入声明集,然后根据每个规则中的逻辑生成输出声明集。
如何创建声明规则
声明规则对于联合身份验证服务中的每个联合信任关系单独进行创建,不在多个信任间共享。 你可以从 声明规则模板创建规则、通过使用 声明规则语言 创建规则来从头开始,或使用 Windows PowerShell 自定义规则。
了解声明规则语言的组件
声明规则语言包含以下组件,这些组件以 "=>" 运算符分隔:
-
一个条件-用于检查输入声明并确定是否应执行规则的发出语句。 它表示一个逻辑表达式,该表达式的计算结果必须为 true,才能执行规则正文部分。
-
发出语句
示例:
c:[type == "Name", value == "domain user"] => issue(type = "Role", value = "employee");
以下声明具有以下内容:
- 条件-
c:[type == "Name", value == "domain user"]-评估 windows 帐户名是否为域用户的输入声明 - 颁发-
issue(type = "Role", value = "employee")-如果条件为 true,则向输入声明添加具有 employee 角色的新声明。
有关声明和语法的详细信息,请参阅 声明规则语言的角色。
声明规则编辑器
完成声明后,声明规则编辑器会执行语法检查,并单击 "确定"。 如果你使用的语法不正确,则编辑器会通知你。
显示一条消息,指出自定义声明规则语法无效的 "D F S 管理" 对话框的屏幕截图。
事件日志
尝试使用日志对声明进行故障排除时,最好的方法是查找声明输出。 可以在事件日志中查找1000和1001事件。
显示1000事件 I D 结果的 "事件属性" 对话框的屏幕截图。
创建示例应用程序
你还可以创建一个示例应用程序,用于回显你的声明。 例如,你可以使用示例应用程序,并创建具有你要尝试排除的相同声明的信赖方,并查看该应用是否存在与该声明有关的任何问题。
浏览器中显示的示例应用程序的屏幕截图。
此处提供了一个很好的示例 web 应用程序。 此应用程序是一个简单的 web 应用,用于回显从信赖方收到的声明。 若要使用此方法,需要通过以下方法编辑 web.config 应用:
- 更改 https://app1.contoso.com/sampapp 为用于托管示例应用的 URL
- 更改 sts.contoso.com 的所有实例,使之指向 AD FS 联合服务器
- 将指纹替换为指纹
显示 web 配置文件的 Visual Studio 的屏幕截图。
以下 博客文章 详细说明了如何进行设置。
后续步骤
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
