AD FS Web Customization 项目教程

1. 项目的目录结构及介绍

adfsWebCustomization/
├── communityCustomizations/
├── mfaLoadingWheel/
├── pageDetectionTelemetry/
├── centeredUi/
├── .gitignore
├── LICENSE
├── README.md
├── SECURITY.md

目录结构介绍

• communityCustomizations/: 包含社区成员提供的JavaScript自定义脚本。
• mfaLoadingWheel/: 包含用于在AD FS认证选项页面上添加加载轮的JavaScript自定义脚本。
• pageDetectionTelemetry/: 包含用于检测AD FS页面并将遥测数据上传到Azure Application Insights的JavaScript自定义脚本。
• centeredUi/: 包含CSS自定义脚本，使本地AD FS与Azure AD登录页面的外观和感觉保持一致。
• .gitignore: Git忽略文件，指定哪些文件和目录不应被Git跟踪。
• LICENSE: 项目许可证文件，通常为MIT许可证。
• README.md: 项目的主文档文件，包含项目的概述、安装和使用说明。
• SECURITY.md: 项目的安全相关信息和指南。

2. 项目的启动文件介绍

在AD FS Web Customization项目中，没有明确的“启动文件”，因为该项目主要由JavaScript和CSS文件组成，这些文件需要在AD FS服务器上进行部署和配置。

主要文件介绍

• pageDetectionTelemetry/onload.js: 该文件包含用于检测AD FS页面并上传遥测数据的JavaScript代码。它是项目中的核心文件之一，需要在AD FS服务器上进行部署。
• centeredUi/style.css: 该文件包含用于使AD FS页面与Azure AD登录页面外观一致的CSS样式。
• mfaLoadingWheel/onload.js: 该文件包含用于在AD FS认证选项页面上添加加载轮的JavaScript代码。

3. 项目的配置文件介绍

在AD FS Web Customization项目中，主要的配置文件是用于部署和应用自定义脚本的PowerShell脚本。以下是一些关键的配置步骤：

配置步骤

1. 创建自定义Web主题:

   • 使用PowerShell cmdlet New-AdfsWebTheme 创建一个新的自定义Web主题。
   • 示例命令：

     New-AdfsWebTheme -Name "CustomTheme" -SourceName "default"
     

2. 更新onload.js文件:

   • 使用PowerShell cmdlet Set-AdfsWebTheme 更新AD FS Web主题以使用自定义的onload.js文件。
   • 示例命令：

     Set-AdfsWebTheme -TargetName "CustomTheme" -OnLoadScriptPath "c:\theme\script\onload.js"
     

3. 应用自定义Web主题:

   • 使用PowerShell cmdlet Set-AdfsWebConfig 将自定义Web主题应用到AD FS登录页面。
   • 示例命令：

     Set-AdfsWebConfig -ActiveThemeName "CustomTheme"
     

通过以上步骤，您可以将AD FS Web Customization项目中的自定义脚本和样式应用到AD FS服务器上，从而实现对AD FS登录页面的自定义。