In my last article, I talked about how to get CRM IFD to work with ADFS 3.0 (i.e., the version installed on Windows Server 2012 R2). That article will get you up and running, but only at the default, bland logon page. What if you want something customized to your organization? Fortunately, this is fairly easy to do.

The biggest thing to understand is that ADFS no longer uses IIS for the pages. So, you cannot customize the look and feel by simply editing a config file.

That being the case, how do you get from this:

ADFS 3.0 Default page

To this?

ADFS 3.0 Custom page

It’s actually simpler than expected.

I only made a few simple changes, all via PowerShell from the ADFS server.

ADFS 3.0 PowerShell

Let me break them down, one by one:

This simply adds the ADFS commands to PowerShell. It’s necessary so the rest can run.

This sets the name that is listed above the logon form. Alternately, you can set a logo instead – for that, you would use the command below, changing the path to point to the correct logo:

Set-AdfsWebTheme -TargetName default -Logo @{path=”c:\Contoso\logo.png”}

This sets the “illustration” – the image to the right of the sign-in form. Just change the path from “c:\CRM-background.png” to the path to your image. Microsoft recommends the dimensions for the illustration to be 1420×1080 pixels @ 96 DPI with a file size of no greater than 200 KB.

This inserts the text right below the sign-in screen – it uses basic HTML for formatting. Simply type whatever text you want between the quotation marks.

And that’s it! Just a few simple changes and you have your custom ADFS 3.0 logon page!

There are plenty more options to customize ADFS 3.0 as well – you can find them on Microsoft’s TechNet page on Customizing ADFS Sign-in Pages.

Have questions or issues with your Dynamics CRM? We can help!


Like this post? Share it!