Controlar página de error en Single SignOn


Cuando se activa el Single SignOn sobre Active directory, para todos aquellos usuarios que no estén dados de alta en Atlas SBI, aparece un mensaje de error de sistema que no aclara mucho el motivo del mismo.



En este artículo vamos a explicar cómo personalizar las páginas de errores que se muestran en AtlasSBI, ya sean provocadas por un error en SSO o por otro tipo de error, por ejemplo 404 (página no disponible).


Primero crearemos tres páginas HTML, dos para controlar los errores más comunes (el 403 y el 404), y otra adicional para controlar los errores genéricos (por supuesto el procedimiento se puede extender para controlar cualquier tipo de error). En nuestro ejemplo los llamaremos respectivamente 403.html, 404.html y generico.html.

La creación de las páginas se puede hacer con cualquier editor estándar y podemos hacerla tan simple o compleja como queramos, en función del la información que deseemos facilitar al usuario.

En nuestro caso de ejemplo error 403 es una simple archivo html que informa del error:
<html>
 <head>     
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />     
  <title>Error 403</title> 
 </head>
 <body>
  <header>
   <div>
    <p>No dispone de permisos suficientes para acceder a esta página</p>
   </div>
  </header>  
  <section>
                        
  </section>
  <footer> 
   <p>Copyright 2019 Mi organitzación</p> 
  </footer>
 </body>
</html>

Una vez creados estos archivos, los ubicaremos en la ruta siguiente:
C:\inetpub\wwwroot\AtlasSBI\Private\Errors

siendo 'Errors' una carpeta creada para ubicar estos archivos.

Seguidamente abriremos al archivo de configuración de la instancia de AtlasSBI dentro de nuestro server y modificaremos y añadiremos unas lineas.

1. Buscaremos a la linea donde tenemos la siguiente directiva:
<customErrors mode="RemoteOnly" />

y añadiremos el siguiente atributo indicando la ruta del archivo html de error genérico:
<customErrors mode="RemoteOnly"  defaultRedirect="/AtlasSBI/Private/Errors/generico.html"/>

2. Ahora, si queremos cambiar las páginas de errores utilizadas por parte de ASP.NET a la hora de mostrar un error 403 o 404 añadiremos las siguientes lineas dentro de la directiva  <system.webServer>
<system.webServer>
<!-- Custom Error Page -->
 <httpErrors errorMode="Custom" >
  <remove statusCode="404" subStatusCode="-1" />
  <error statusCode="404" path="/AtlasSBI/Private/Errors/404.html" responseMode="Redirect" />
  <remove statusCode="403" subStatusCode="-1" />
  <error statusCode="403" path="/AtlasSBI/Private/Errors/403.html" responseMode="Redirect" />  
 </httpErrors>
</system.webServer> 

Si analizamos por encima el código podremos ver que estamos sobre-escribiendo las páginas del error 403 y 404 que vienen por defecto asignando la ruta de las páginas personalizadas.


Otros artículos sobre SSO con Atlas SBI


0 comentarios :

Publicar un comentario

Lo más visto