在最高级别上,Active Directory 联合身份验证服务 AD FS 中的声明引擎 ( ) 是一种基于规则的 - 引擎,专用于为联合身份验证服务提供服务和处理声明请求。 声明引擎是联合身份验证服务中具有以下功能的唯一实体:负责跨所有已配置的联合信任关系运行每个规则集,并将输出结果传递给声明管道。
虽然声明管道更是 - - 用于对声明进行流处理的端到端过程的逻辑概念,但是声明规则是可以用于在声明规则执行过程中自定义声明流的实际管理元素。 有关管道过程的详细信息,请参阅 The Role of the Claims Pipeline。
如下图所示,通过声明引擎,接受传入声明 ( 接受规则 ) 、授权声明请求者 ( 授权规则 ) 并 ( ) 通过声明规则在组织中的所有联合信任关系中发出传出声明发出规则的行为。
显示由声明引擎执行的进程的插图。
声明规则执行过程
当你在组织中使用声明规则配置声明提供方信任或信赖方信任时,针对该信任的声明规则集将 ( ) 充当传入声明的网关守卫,方法是调用声明引擎,以应用声明规则中的必要逻辑,以确定是否发出任何声明以及要发出的声明。
以下部分概述引擎通过声明规则执行过程在声明流过程中执行的每个步骤。 下面概述的每个步骤都会针对声明管道过程中所述的每个阶段而进行。 这些步骤包括:
-
步骤 1 – 初始化
-
步骤 2 – 执行
-
步骤 3 – 执行结果
有关管道过程的详细信息,请参阅 The Role of the Claims Pipeline。
步骤 1 – 初始化
在声明规则执行过程中的第一步中,声明引擎会通过首先将传入声明添加到“输入声明集”来接受它们。 输入声明集类似于仅用于临时存储数据的内存中缓存(只要所需过程要求提供数据进行检索)。 输入声明集数据会在规则执行完成之后丢弃。
为规则集向输入声明集添加声明
当声明引擎在处理与声明规则集关联的逻辑的同时需要在内存中临时存储声明数据时,它会创建输入声明集。 声明引擎会将所有传入声明复制到输入声明集,规则集中的第一个规则可以在其中检索这些声明。
例如在下图中,声明引擎从传入声明读取 A 和 B 的声明并将它们复制到输入声明集。 当它们处于输入声明集中之后,声明引擎会检索声明 A 和 B 并将它们作为声明规则集第一个规则中的逻辑的输入进行处理。
说明:声明引擎从传入声明读取 A 和 B 的声明并将它们复制到输入声明集。
声明规则集中的所有规则都共享相同的输入声明集。 该集中的每个规则都可以添加到共享的输入声明集,从而影响集中的所有后续规则。
步骤 2 – 执行
在声明规则过程的此步骤中,当声明引擎按时间顺序逐一执行特定规则集中的所有规则时,会处理声明规则。 规则集中的每个规则只运行一次,并按它们从上到下的显示顺序执行,如在 AD FS 管理 "管理单元的" 编辑声明规则 "对话框中所示 - 。 首先处理位于规则集顶部的声明规则,随后处理后续规则,直到所有规则都已运行。
按照声明规则语言中的定义,声明规则包含两个部件,即条件和发出语句。 声明引擎首先处理条件部分,方法是使用输入声明集中的数据确定规则中指定的条件对于输入声明集中包含的声明是否为 true, ( 并将与规则条件匹配的声明称为匹配声明 ) 。 如果找到任何匹配声明,则声明引擎会为每个匹配声明集执行规则的发出语句。 规则的发出语句可以对匹配声明执行以下任一任务:
-
将匹配声明复制到输出声明集中
-
仅在输入声明集中或是同时在评估和输出中声明集中转换声明字段并创建新声明。
-
使用匹配的声明 ( ) 作为键从属性存储中查找更多信息,以便 ( ) 仅在输入声明集中或同时在输入和输出声明集中创建新声明。
为规则集向输出声明集添加声明
“输出声明集”是内存中最初为空的位置,十分重要,因为声明引擎在执行过程完成之后只返回位于输出声明集中的声明。 这意味着,在计算最终的传出声明集时,会忽略仅位于输入声明集中、而不位于输出声明集中的任何声明。
为规则集向两个声明集添加声明
处理规则时,声明既可以添加到输入声明集中,也可以同时添加到输入声明集和输出声明集中,具体取决于在规则的颁发语句中使用的语句。 声明规则语言将这些语句称为“添加”或“发出”。
如果使用“添加”语句,则声明仅添加到输入声明集,声明只是为进行执行而存在,会在执行完成之后停止存在。 如果使用“发出”语句,则声明会同时添加到输入声明集和输出声明集,并且声明会在执行完成之后在输出声明集中返回。 有关这些语句的详细信息,请参阅 The Role of the Claim Rule Language。
如果规则集中规则的条件部分与输入声明集中的任何声明都不匹配,则会忽略规则的发出语句部分,因此不会将任何声明添加到输出声明集或输入声明集。 下图和对应步骤演示在声明引擎执行转换规则时发生的情况:
说明当声明引擎执行转换规则时发生的情况。
-
传入声明由声明引擎添加到输入声明集。
-
第一个规则执行时,它会看到 A 和 B 声明(此时只是输入声明集中的声明),并处理规则 1 中规则逻辑的条件部分。
-
由于声明存在于输入声明集中,因此规则的条件确定为与 ( 声明 A 匹配, ) 并向输入声明集和输出声明集中添加新的 C 声明。
-
规则2现在可以使用 A、B 和 C 声明 ( 输入声明集中的所有声明 ) 作为输入来处理其逻辑。
有关声明转换的详细信息,请参阅 When to Use a Transform Claim Rule。
步骤 3 – 执行结果
声明规则集执行的最后一个阶段会在给定规则集中运行的所有规则都已运行并且最终的声明集位于输出声明集之后开始。 此时,声明引擎会返回输出声明集的上下文作为规则集执行的输出。 从此以后,由声明管道接管此最终输出并将它移动到其过程中的下一个阶段。
将执行输出发送到声明管道
声明引擎处理规则集时,该规则集对于其输入和输出声明集在内存中具有自己的专用位置。 这意味着,一个规则集使用的输入和输出声明集独立于另一个规则集中使用的输入和输出声明集。
为给定规则集( ( 步骤1、2和3)运行了整个过程之后 ) ,会将输出声明集新发出的传出声明 ( 内容用作 ) 声明管道中的下一个规则集的输入。 这使声明可以从一个规则集的输出流到另一个规则集的输入,如下图所示。
AD FS 角色
Note: 虽然发出规则集也是管道中的关键阶段,但是上图并未显示它(只是为了简化该图)。 有关演示发出规则集以及它如何适用于声明管道的插图,请参阅 The Role of the Claims Pipeline。
在这种情况下,接受规则的输出由管道用于将接受规则生成的最终声明集流到管道中的第二个阶段(这是对授权规则进行的拆除)。 此时,整个声明规则执行过程中的 ( 步骤1、2和 3 ) 将再次对授权规则集运行。 此循环将继续,直到颁发规则设置 ( 管道中的最后一个阶段 ) 。
一旦从引擎针对发出规则集返回了已完成的传出声明,它们便会打包到 SAML 令牌中,联合身份验证服务会将该令牌发送回客户端。
处理授权规则
如果在声明规则执行过程的步骤2中执行的声明规则集包含与 ( 接受或发出规则不同的输入和输出声明集的授权规则 ) ,则这些授权规则将运行,以确定令牌请求者是否有权从联合身份验证服务基于请求者的声明获取给定信赖方的安全令牌。
授权规则的目标是基于是否允许用户获取给定信赖方的令牌来发出允许或拒绝声明。 如下图中所示,如果授权执行的输出由管道用于确定是否执行了颁发规则集(基于是否存在允许和 / /或拒绝声明),但是授权执行输出本身不用作声明规则集的输入。
此图显示了授权执行的输出由管道用于确定是否执行了颁发规则集。
有关声明授权的详细信息,请参阅 When to Use an Authorization Claim Rule。
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
