Kype's blog

[SharePoint] Créer une page AccessDenied.aspx custom

L'objectif de ce post est de proposer une démarche pour customiser la page d'Access Denied de SharePoint. Ce type de besoin peut se pésenter lorsqu'on applique une charte spécifique à un site ou que tout simplement, on souhaite modifier le message présenté par défaut à l'utilisateur :

Problématique :

• La page AccesDenied.aspx standard se trouve dans le répertoire LAYOUTS : se pose donc la question de modifier des pages standards qui pourraient être la cible de mises à jour...
• Le chemin de la page utilisé par SharePoint est une constante défini au niveau de SPUtility.AccessDeniedPage

Solution :

La KB 944105 fournit 2 solutions pour modifier les pages du LAYOUTS.

Nous allons partir sur la solution 2 qui permet de répondre à la 1ère problématique en travaillant à partir d'une copie de la page AccessDenied.aspx et en laissant la page standard intacte.

Dans mon cas, il s'agit uniquement d'appliquer une master page différente et de modifier quelque peu le message renvoyé. Je garde donc les éléments de la page standard en la complétant et en cachant les contrôles dont je n'ai pas besoin. Libre à vous de repartir d'une page vierge.

Pour répondre à la 2ème problématique (utilisation de la page custom), j'utilise un HTTP Handler qui redirige vers ma page AccessDeniedCustom.aspx en conservant la QueryString.

Voici donc le code du Handler :

using System;
using System.Web;
using Microsoft.SharePoint; 

namespace Kype.SharePoint.Pages
{
  public class AccessDeniedHandler : IHttpHandler
  {
    public bool IsReusable
    {
      get { return true; }
    }

  public void ProcessRequest(HttpContext context)
  {    

    Uri uri = context.Request.Url;
    string url = uri.AbsoluteUri;
    string urlRedirect = url.Replace("AccessDenied.aspx",
    "custom/AccessDeniedCustom.aspx");
    context.Response.Redirect(urlRedirect);

  }
}

Et la structure du projet :

Côté déploiement, la page est mise dans un sous-répertoire de "LAYOUTS" et la dll du handler dans le GAC, ceci peut être fait via une solution SharePoint (avec WSPBuilder par exemple). Le fichier web.config du répertoire LAYOUTS doit également être complété pour utiliser le handler en ajoutant :

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<configuration>
  <system.web>
    <httpHandlers>
      <add verb="*" path="AccessDenied.aspx*" type="Type, Assembly, Version=[version],
       Culture=[culture], PublicKeyToken=[PublicKeyToken]"/>
    </httpHandlers>
  </system.web>
</configuration>

Ceci se fait manuellement pour l'instant, mais fera l'objet d'un post prochainement pour voir comment l'automatiser.
 

Limites liées à l'application d'un Service Pack :

• La page standard sera mise à jour, mais pas notre page custom
• Le web.config peut être mis à jour et donc conflit potentiel avec notre entrée