How To: Host Custom Content for the ADFS VAM on ADFS 3.0/2016

Version Affected: ADFS 3.0 and ADFS 2016

 

Overview

This article explains how to host custom content, such as images, JavaScript, and CSS files, for the ADFS Validation Adapter Module (ADFS VAM) on ADFS 3.0 or ADFS 2016. These ADFS versions are not hosted on IIS — they use the Http.sys API directly — so custom content must be added through a custom ADFS web theme rather than through IIS.

The following steps are run in PowerShell on the ADFS server.

1. Create a new ADFS web theme, based on the default theme:
   

   New-AdfsWebTheme -Name custom -SourceName default

2. Add the custom file to the new theme, replacing the URI and path with your own file's values:
   

   Set-AdfsWebTheme -TargetName custom -AdditionalFileResource @{Uri='/adfs/portal/mytheme/myphoto.jpeg';path="D:\inetpub\adfsassets\photos\myphoto.jpeg"}

3. Set the new theme as the active ADFS theme:
   

   Set-AdfsWebConfig -ActiveThemeName custom

Special Considerations

Test this change in a pre-production environment before setting the new theme as active in production. Changing the active ADFS theme can change the ADFS UI.


 

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.