大网数据广告活动
域与目录服务

使用 AD FS 2019 风险评估模型构建插件

· 52CE 我爱测

了解有关以下内容的详细信息:生成具有 AD FS 2019 风险评估模型的插件

现在,你可以生成自己的插件来阻止或将风险评分分配给不同阶段的身份验证请求–请求接收、预身份验证和后身份验证。 这可以通过使用 AD FS 2019 引入的新风险评估模型来完成。

什么是风险评估模型?

风险评估模型是一组接口和类,使开发人员能够读取身份验证请求标头并实现其自己的风险评估逻辑。 实现的代码 (插件) 然后在 AD FS 身份验证过程中运行。 例如,通过使用模型中包含的接口和类,可以根据请求标头中包含的客户端 IP 地址,实现代码来阻止或允许身份验证请求。 AD FS 将为每个身份验证请求执行代码,并根据实现的逻辑采取适当的操作。

该模型允许在 AD FS 身份验证管道的三个阶段(如下所示)中的任意一阶段插件代码:

显示 D F S 身份验证的三个阶段的关系图。

  1. 请求已收到阶段 –当 AD FS 接收身份验证请求,即用户输入凭据之前,允许生成插件来允许或阻止请求。 可以使用请求上下文 (例如:客户端 IP、Http 方法、代理服务器 DNS 等),) 在此阶段提供以执行风险评估。 例如,你可以构建一个插件来从请求上下文中读取 IP,并在 IP 位于风险 Ip 的预定义列表中时阻止身份验证请求。

  2. 预身份验证阶段 –使生成插件能够允许或阻止请求,即用户提供凭据的点,但在 AD FS 评估它们之前。 在此阶段,除请求上下文外,还包含有关安全上下文的信息 (例如:用户令牌、用户标识符等) 和协议上下文 (例如:身份验证协议、clientID、resourceID 等) ,以便在风险评估逻辑中使用。 例如,你可以通过从用户令牌读取用户密码来构建一个插件来防止密码喷涂攻击,如果密码在预定义的有风险密码的列表中,则会阻止身份验证请求。

  3. 身份验证后 –在用户提供凭据并 AD FS 执行身份验证后,启用构建插件来评估风险。 在此阶段,除了请求上下文、安全上下文和协议上下文外,还可以了解身份验证结果 (成功或失败) 的相关信息。 该插件可以根据可用信息评估风险评分,并将风险评分传递给理赔和策略规则以进行进一步评估。

为了更好地了解如何生成风险评估插件并使其在 AD FS 过程中运行,我们构建了一个示例插件,用于阻止来自某些 extranet IPs 的请求,这些 ip 被确定为有风险,请向 AD FS 注册该插件,最后测试该功能。

Note: 或者,你可以构建有 风险的用户插件,该插件利用 Azure AD Identity Protection 阻止身份验证或强制多重身份验证 (MFA) 的用户风险级别。 此处提供生成有风险的用户插件的步骤。

生成示例插件

Note: 本演练只演示如何创建示例插件。 我们正在创建的解决方案并不是一个企业现成的解决方案。

先决条件

下面是生成此示例插件所需的必备组件的列表:

  • 安装和配置 AD FS 2019
  • .NET Framework 4.7 及更高版本
  • Visual Studio

生成插件 dll

以下过程将引导您生成一个示例插件 dll:

  1. 下载示例插件,使用 Git Bash,并键入以下内容:

    git clone https://github.com/Microsoft/adfs-sample-RiskAssessmentModel-RiskyIPBlock
    
  2. 在 AD FS 服务器上的任意位置创建一个 .csv 文件 (在我的示例中,我在 C:\extensions 上创建了 authconfigdb.csv 文件) 并将要阻止的 ip 添加到此文件中。

    示例插件将阻止来自此文件中列出的 Extranet ip 的任何身份验证请求。

    NOTE 如果有 AD FS 场,则可以在任何或所有 AD FS 服务器上创建文件。 任何文件均可用于将有风险的 Ip 导入 AD FS。 下面将详细讨论导入过程,请在下面的 AD FS 中注册插件 dll 。

  3. ThreatDetectionModule.sln使用 Visual Studio 打开项目。

  4. Microsoft.IdentityServer.dll从 "解决方案资源管理器" 中删除,如下所示: 突出显示 "删除" 菜单选项的屏幕截图。

  5. 向 AD FS 添加对的引用,如下 Microsoft.IdentityServer.dll 所示:

    a. 在 解决方案资源管理器 中右键单击 "引用",然后选择 "添加引用 ..."。

    突出显示 "添加引用" 菜单选项的屏幕截图。

    b. 在 " 引用管理器 " 窗口中,选择 " 浏览"。 在 "选择要引用的文件 ... " 对话框中, Microsoft.IdentityServer.dll 在 C:\Windows\ADFS) AD FS 安装文件夹中选择 (,并单击 " 添加"。

    NOTE 在我的示例中,我在 AD FS 服务器本身上构建了插件。 如果你的开发环境在不同的服务器上,请将 Microsoft.IdentityServer.dll AD FS server 上的 AD FS 安装文件夹中的复制到你的开发框。

    显示应复制的文件的屏幕截图。

    c. 确保选中此复选框后,在 "引用管理器" 窗口上单击 "确定" Microsoft.IdentityServer.dll 。

    屏幕截图,显示 Microsoft 点标识服务器点 d l l 复选框。

  6. 现在,所有类和引用都已准备就绪,可用于生成。 不过,由于此项目的输出是一个 dll,因此必须将其安装到 AD FS 服务器的 全局程序集缓存(GAC)中,并且需要首先对该 dll 进行签名。 可以按以下步骤来完成:

    a. 右键单击 项目名称 ThreatDetectionModule。 在菜单中单击 " 属性"。

    突出显示“属性”菜单选项的屏幕截图。

    b. 在 " 属性 " 页上,单击左侧的 " 签名",然后选中标记为 "为程序集签名" 的复选框。 从 " 选择强名称密钥文件: " 下拉菜单中,选择 " <新建 ..." >。

    显示 "为程序集签名" 复选框的屏幕截图。

    c. 在 " 创建强名称密钥" 对话框 中,键入名称 (可以为密钥选择任意名称) ,取消选中 " 使用密码保护密钥文件" 复选框。 然后,单击 “确定”。

    显示 "通过密码保护密钥文件" 复选框的屏幕截图。

    d. 保存项目,如下所示:

    显示项目保存位置的屏幕截图。

  7. 通过依次单击 " 生成 " 和 " 重新生成解决方案 " 来生成项目,如下所示:

    显示 "重新生成解决方案" 菜单选项的屏幕截图。

    检查屏幕底部的 " 输出" 窗口 ,查看是否发生了任何错误。

    显示重新生成的解决方案的输出的屏幕截图。

插件 (dll) 现在可供使用,并且位于项目文件夹的 \bin\Debug 文件夹中 (在我的示例中,就是 C:\extensions\ThreatDetectionModule\bin\Debug\ThreatDetectionModule.dll 的) 。

下一步是将此 dll 注册到 AD FS,因此它将在 AD FS 身份验证过程中运行。

将插件 dll 注册到 AD FS

需要在 Register-AdfsThreatDetectionModule AD FS 服务器上使用 PowerShell 命令在 AD FS 中注册该 dll。 但是,在注册之前,我们需要获取公钥标记。 此公钥标记是在创建密钥时创建的,并使用该密钥对 dll 进行签名。 若要了解 dll 的公钥标记是什么,可以使用 SN.exe ,如下所示:

  1. 将 \bin\Debug 文件夹中的 dll 文件复制到其他位置 (在我的示例中,将它复制到 C:\extensions) 。

  2. 启动 Visual Studio 的 开发人员命令提示 ,并在我的示例中中转到包含 sn.exe (的目录,该目录是 (X86) \microsoft SDKs\Windows\v10.0A\bin\NETFX 4.7.2 Tools) 中的 C:\Program 文件。

    显示 Visual Studio 开发人员命令提示的屏幕截图。

  3. 运行带有 -T 参数的 SN 命令,并在) 的情况下 (文件的位置 SN -T "C:\extensions\ThreatDetectionModule.dll" 。

    显示如何运行 S N 命令的屏幕截图。

    此命令将为你提供 (的公钥令牌, 公钥令牌为 714697626ef96b35)

  4. 将 dll 添加到 AD FS 服务器的 全局程序集缓存 中我们最好的做法是为项目创建正确的安装程序,并使用安装程序将文件添加到 GAC 中。 另一种解决方法是使用 Gacutil.exe (Gacutil.exe 在开发计算机上) 可用的详细信息。 由于我的 visual studio 与 AD FS 位于同一服务器上,因此我将使用 Gacutil.exe ,如下所示:

    a. 在 Visual Studio 开发人员命令提示上,在我的示例中中转到包含 Gacutil.exe (的目录,该目录是 (x86) \Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.7.2 Tools) 上的 C:\Program 文件。

    b. 在我的示例中运行 gacutil.exe 命令 (Gacutil /IF C:\extensions\ThreatDetectionModule.dll) :

    显示如何运行 Gacutil.exe 命令的屏幕截图。

    NOTE 如果你有 AD FS 场,则需要在服务器场中的每个 AD FS 服务器上执行以上。

  5. 打开 Windows PowerShell 并运行以下命令以注册 dll:

    Register-AdfsThreatDetectionModule -Name "<Add a name>" -TypeName "<class name that implements interface>, <dll name>, Version=10.0.0.0, Culture=neutral, PublicKeyToken=< Add the Public Key Token from Step 2. above>" -ConfigurationFilePath "<path of the .csv file>"
    

    在我的示例中,该命令为:

    Register-AdfsThreatDetectionModule -Name "IPBlockPlugin" -TypeName "ThreatDetectionModule.UserRiskAnalyzer, ThreatDetectionModule, Version=10.0.0.0, Culture=neutral, PublicKeyToken=714697626ef96b35" -ConfigurationFilePath "C:\extensions\authconfigdb.csv"
    

    NOTE 只需注册一次 dll,即使有 AD FS 场。

  6. 注册 dll 后重新启动 AD FS 服务。

就是这样,dll 现在已注册 AD FS 并且可供使用!

NOTE 如果对插件进行了任何更改,并且重新生成了项目,则需要重新注册更新后的 dll。 注册之前,需要使用以下命令取消注册当前 dll:

UnRegister-AdfsThreatDetectionModule -Name "<name used while registering the dll in 5. above>"

在我的示例中,该命令为:

UnRegister-AdfsThreatDetectionModule -Name "IPBlockPlugin"

测试插件

  1. 打开前面创建的 authconfig.csv 文件 (位置 C:\extensions) ,并添加要阻止的 Extranet ip 。 每个 IP 都应该在单独的行上,并且末尾不应有空格。

    显示如何添加 extranet I P 线条的屏幕截图。

  2. 保存并关闭该文件。

  3. 通过运行以下 PowerShell 命令,在 AD FS 中导入已更新的文件:

    Import-AdfsThreatDetectionModuleConfiguration -name "<name given while registering the dll>" -ConfigurationFilePath "<path of the .csv file>"
    

    在我的示例中,该命令为:

    Import-AdfsThreatDetectionModuleConfiguration -name "IPBlockPlugin" -ConfigurationFilePath "C:\extensions\authconfigdb.csv")
    
  4. 用在 authconfig.csv 中添加的相同 IP 启动来自服务器的身份验证请求。

    在本演示中,我将使用 AD FS 帮助声明 X 光工具 来启动请求。 如果要使用 X 光工具,请按照说明进行操作

    输入 "联合服务器实例" 和 "命中 测试身份验证 " 按钮。

    显示 "测试身份验证" 按钮的屏幕截图。

  5. 身份验证被阻止,如下所示。

    显示身份验证被阻止的屏幕截图。

现在,我们已经了解了如何生成和注册插件,接下来让我们演练插件代码,以了解如何使用模型引入的新接口和类实现。

插件代码演练

ThreatDetectionModule.sln使用 Visual Studio 打开项目,然后在屏幕右侧的 "解决方案资源管理器" 中打开主文件 UserRiskAnalyzer.cs

model

文件包含用于实现抽象类 ThreatDetectionModule 和 interface IRequestReceivedThreatDetectionModule 的主类 UserRiskAnalyzer,用于从请求上下文读取 ip、将获得的 IP 与从 AD FS DB 加载的 ip 进行比较,以及在有 ip 匹配时阻止请求。 让我们更详细地了解这些类型

ThreatDetectionModule 抽象类

此抽象类将插件加载到 AD FS 管道中,以便可以在 AD FS 过程中运行插件代码。

public abstract class ThreatDetectionModule
{
    protected ThreatDetectionModule();

    public abstract string VendorName { get; }
    public abstract string ModuleIdentifier { get; }

    public abstract void OnAuthenticationPipelineLoad(ThreatDetectionLogger logger, ThreatDetectionModuleConfiguration configData);
    public abstract void OnAuthenticationPipelineUnload(ThreatDetectionLogger logger);
    public abstract void OnConfigurationUpdate(ThreatDetectionLogger logger, ThreatDetectionModuleConfiguration configData);
}

此类包括以下方法和属性:

方法 类型 定义
OnAuthenticationPipelineLoad Void 当插件加载到其管道中时 AD FS 调用
OnAuthenticationPipelineUnload Void 当从其管道中卸载插件时 AD FS 调用
OnConfigurationUpdate Void 在配置更新时由 AD FS 调用
Property Type 定义
VendorName String 获取拥有插件的供应商的名称
ModuleIdentifier 字符串 获取插件的标识符

在我们的示例插件中,使用 OnAuthenticationPipelineLoad 和 OnConfigurationUpdate 方法从 AD FS DB 读取预定义的 ip。 将插件注册到 AD FS 时,将调用OnAuthenticationPipelineLoad ,而当使用 cmdlet 导入 .csv 时调用OnConfigurationUpdate Import-AdfsThreatDetectionModuleConfiguration 。

IRequestReceivedThreatDetectionModule 接口

利用此 接口 ,你可以在 AD FS 接收身份验证请求,但用户输入凭据(即在身份验证过程中收到请求阶段)之前实施风险评估。

public interface IRequestReceivedThreatDetectionModule
{
    Task<ThrottleStatus> EvaluateRequest (
    ThreatDetectionLogger logger,
    RequestContext requestContext );
}

接口包含 EvaluateRequest 方法,该方法允许你使用 requestContext 输入参数中传递的身份验证请求的上下文来编写你的风险评估逻辑。 RequestContext 参数的类型为 requestContext。

传递的另一个输入参数是 ThreatDetectionLogger类型的记录器。 参数可用于将错误、审核和/或调试消息写入 AD FS 日志。

如果 NotEvaluated、1到 Block,2表示允许) AD FS,则会阻止或允许请求,方法返回 ThrottleStatus (0。

在示例插件中, EvaluateRequest方法实现会分析requestContext参数中的clientIpAddress ,并将其与从 AD FS DB 加载的所有 ip 进行比较。 如果找到匹配项,则方法将为 Block 返回2,否则对于 Allow 返回1。 根据返回的值,AD FS 阻止或允许请求。

Note: 上面所述的示例插件仅实现了 IRequestReceivedThreatDetectionModule 接口。 但是,风险评估模型提供两个附加接口-IPreAuthenticationThreatDetectionModule (来实现风险评估逻辑用预身份验证) 阶段 (,并在身份验证后阶段) 实现风险评估逻辑。 下面提供了有关这两个接口的详细信息。

IPreAuthenticationThreatDetectionModule 接口

利用此 接口 ,你可以在用户提供凭据的位置实现风险评估逻辑,但在 AD FS 评估它们之前(即,预身份验证阶段)。

public interface IPreAuthenticationThreatDetectionModule
{
    Task<ThrottleStatus> EvaluatePreAuthentication (
    ThreatDetectionLogger logger,
    RequestContext requestContext,
    SecurityContext securityContext,
    ProtocolContext protocolContext,
    IList<Claim> additionalClams
  );
}

接口包含 EvaluatePreAuthentication 方法,该方法允许你使用 RequestContext RequestContext、 SecurityContext SecurityContext、 ProtocolContext ProtocolContext和 IList <Claim> additionalClams 输入参数中传递的信息来编写预身份验证风险评估逻辑。

Note: 有关每个上下文类型传递的属性列表,请访问 RequestContext、 SecurityContext和 ProtocolContext 类定义。

传递的另一个输入参数是 ThreatDetectionLogger类型的记录器。 参数可用于将错误、审核和/或调试消息写入 AD FS 日志。

如果 NotEvaluated、1到 Block,2表示允许) AD FS,则会阻止或允许请求,方法返回 ThrottleStatus (0。

IPostAuthenticationThreatDetectionModule 接口

利用此 接口 ,你可以在用户提供凭据并 AD FS 执行身份验证后(即身份验证后阶段)执行风险评估逻辑。

public interface IPostAuthenticationThreatDetectionModule
{
    Task<RiskScore> EvaluatePostAuthentication (
    ThreatDetectionLogger logger,
    RequestContext requestContext,
    SecurityContext securityContext,
    ProtocolContext protocolContext,
    AuthenticationResult authenticationResult,
    IList<Claim> additionalClams
  );
}

接口包含 EvaluatePostAuthentication 方法,该方法允许你使用 RequestContext RequestContext、 SecurityContext SecurityContext、 ProtocolContext ProtocolContext和 IList <Claim> additionalClams 输入参数中传递的信息来编写你的身份验证后风险评估逻辑。

Note: 有关随每个上下文类型一起传递的属性的完整列表,请参阅 RequestContext、 SecurityContext和 ProtocolContext 类定义。

传递的另一个输入参数是 ThreatDetectionLogger类型的记录器。 参数可用于将错误、审核和/或调试消息写入 AD FS 日志。

方法返回可用于 AD FS 政策和声明规则的 风险评分 。

Note: 要使插件工作,在这种情况下,main 类 (UserRiskAnalyzer) 需要派生 ThreatDetectionModule 抽象类,并且应至少实现上述三个接口中的一个。 注册 dll 后,AD FS 会检查要实现的接口并在管道中的适当阶段调用它们。

常见问题解答

为什么应生成这些插件? 答: 这些插件不仅为你提供额外的功能来保护你的环境免受攻击(例如密码喷涂攻击),而且还能灵活地根据你的需求构建你自己的风险评估逻辑。

日志捕获到何处? 答: 可以使用 WriteAdminLogErrorMessage 方法将错误日志写入 "AD FS/Admin" 事件日志,使用 WriteAuditMessage 方法将审核日志写入 "AD FS 审核" 安全日志,使用 WriteDebugMessage 方法将日志调试到 "AD FS 跟踪" 调试日志。

添加这些插件是否可以增加 AD FS 身份验证过程延迟? 答: 延迟的影响取决于执行所实现的风险评估逻辑所需的时间。 建议在生产环境中部署插件之前,评估延迟的影响。

为什么不能 AD FS 建议有风险的 Ip、用户等的列表? 答: 虽然目前不可用,但我们正在努力构建智能,以在可插接式风险评估模型中提出有风险的 Ip、用户等。 我们将很快共享启动日期。

还有哪些可用的示例插件? 答: 以下示例插件) 可用 (:

名称 说明
风险用户插件 基于 Azure AD Identity Protection 确定的用户风险级别,阻止身份验证或强制执行 MFA 的示例插件。

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

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

资料来源与适用范围

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

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

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