Customizar la web de ADFS - Parte 1

Se puede customizar la web de ADFS?

Hace unos d铆as termin茅 un proyecto que inclu铆a ADFS para validar las credenciales de los usuarios contra el Active Directory local, usando los servicios de Office 365. En el proyecto visualic茅 varias veces el sitio por defecto que trae el rol de Active Directory Federation Services, entonces me pregunt茅: se puede modificar y/o mejorar este sitio? D铆as despu茅s me dispuse a escribir este post para compartir mi experiencia.

Customizar la web de ADFS

Primeros pasos

Antes de comenzar vamos a ver que partes componen el sitio de ADFS:

Imagen

Ahora que definimos las partes, vamos a ver c贸mo podemos hacer para poder modificarlas:

Secciones del portal ADFS

Nombre de la organizaci贸n

Para modificar el nombre de la organizaci贸n, tenemos a nuestra disposici贸n un comando de PowerShell que nos facilita esta tarea:

Set-AdfsGlobalWebContent

Una ejemplo de uso de este comando puede ser:

Set-AdfsGlobalWebContent CompanyName "Contoso Corp"

Logo de la organizaci贸n

Ya sabemos como modificar el Nombre de la organizaci贸n, ahora vamos a modificar el logo de la empresa para que le brinde al sitio una imagen m谩s personalizada. Es necesario tener presente la ruta donde se encuentra el logo de la organizaci贸n, que debe tener como medidas recomendadas 260脳35 @ 96 dpi y no debe pesar m谩s de 10 KB.

Considerando lo anterior vamos a ejecutar el siguiente cmdlet:

Set-AdfsWebTheme -TargetName default -Logo @{path="C:\Imagenes\Contoso-logo.png"}

El par谩metro TargetName es obligatorio. En el ejemplo anterior declaramos el valor como default, ya que es el valor por defecto al generar una implementaci贸n de ADFS.

Ilustraci贸n del sitio

Tomando el caso anterior, tenemos que las medidas recomendadas para la imagen que aparece en mayor medida en el sitio son 1420脳1080 pixels @ 96 dpi y el tama帽o no debe ser superior a 200 KB. PowerShell nos facilita la tarea ya que debemos ejecutar el mismo cmdlet que para el caso del logo, pero esta vez declarando el par谩metro Illustration:

Set-AdfsWebTheme -TargetName default -Illustration @{path="C:\Imagenes\Contoso-illustration.png"}

Descripci贸n

Tambi茅n es posible agregar un peque帽o bloque de texto para que los usuarios puedan leer a modo de informaci贸n, sugerencias, etc.

Set-AdfsGlobalWebContent -SignInPageDescriptionText 

鈥淧ara iniciar sesi贸n en el sitio es necesario contar con un usuario ya creado. Clic aqu铆 para solicitar el alta.鈥

Con el ejemplo anterior generamos un p谩rrafo para dejar en claro que es necesario tener habilitado un usuario para acceder a ese sitio. Se puede usar HTML en el par谩metro, por lo que pueden resaltar o generar v铆nculos como el del ejemplo.

Pie de p谩gina

Dentro del sitio se pueden habilitar 3 tipos diferentes de enlaces que proporcionan informaci贸n al usuario, 茅stos son:

  • Home
  • Privacy
  • Help

Home

Define el enlace para crear un v铆nculo a, por ejemplo, la intranet de la empresa:

Set-AdfsGlobalWebContent -HomeLink 'https://intranet.contoso.com' -HomeLinkText Inicio

Help

Define el link de acceso a al g煤n portal de ayuda para el usuario o el sitio donde se generan los incidentes, por ejemplo:

Set-AdfsGlobalWebContent -HelpDeskLink 'https://intranet.contoso.com/help/' -HelpDeskLinkText Ayuda

Privacy

En caso de que la organizaci贸n disponga de un acuerdo de confidencialidad o de alguna pol铆tica de privacidad, se puede disponer de un v铆nculo a esta informaci贸n de la siguiente manera:

Set-AdfsGlobalWebContent -PrivacyLink 'https://intranet.contoso.com/privacy/' -PrivacyLinkText Poltica

Hasta ac谩 ser铆a el primer bloque de modificaciones que vamos a ver. En la siguiente publicaci贸n vamos a ver como armar un theme propio y como aplicarlo usando PowerShell.

Happy scripting!

Comments