authorization, élément (Schéma des paramètres ASP.NET)

Mise à jour : novembre 2007

Configure l'autorisation d'une application Web pour contrôler l'accès client aux ressources URL.

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    authorization, élément (Schéma des paramètres ASP.NET)

<authorization> 
   <allow .../>
   <deny .../>
</authorization>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucun.

Éléments enfants

Éléments parents

Notes

L'élément authorization configure l'autorisation d'une application Web pour contrôler l'accès client aux ressources URL.

Au moment de l'exécution, le module d'autorisation effectue une itération dans les éléments allow et deny, en commençant par le fichier de configuration « le plus local », jusqu'à ce qu'il trouve la première règle d'accès correspondant à un compte d'utilisateur particulier. Ensuite, le module d'autorisation accorde ou refuse l'accès à une ressource URL selon que la première règle d'accès trouvée est une règle allow ou deny. La règle d'autorisation par défaut est <allow users="*"/>. En d'autres termes, l'accès est autorisé par défaut sauf configuration contraire.

Pour faciliter le déploiement, la notation raccourcie utilisant un point (.) pour représenter l'ordinateur actuel est prise en charge. Cela vous permet de faire précéder chaque utilisateur ou rôle d'un préfixe .\ (point-barre oblique inverse) comme suit :

<allow roles=".\roleName"/>
<allow users=".\userName"/>

Au moment de l'exécution, les séquences point-barre oblique inverse sont remplacées par des séquences "localmachinename\". La substitution est effectuée uniquement si une identité Microsoft Windows est utilisée avec la demande. Cela permet d'éviter des conflits dans le cas où les séquences point-barre oblique inverse sont utilisées dans des rôles arbitraires avec des entités de sécurité personnalisées.

Dans la mesure où l'élément authorization ne représente pas une collection, il n'existe pas d'éléments enfants clear ou remove. Pour effacer par programme les mappages de règles d'autorisation, utilisez la méthode Clear() ou Remove(AuthorizationRule).

Configuration par défaut

L'élément authorization par défaut suivant est configuré dans le fichier Web.config racine dans la version 2.0 du .NET Framework et dans le fichier Machine.config dans les versions 1.1 et 1.0.

<authorization>
   <allow users="*" />
</authorization>

Exemple

L'exemple de code suivant montre comment autoriser l'accès à tous les membres du rôle Admins et refuser l'accès à tous les membres du rôle users.

<configuration>
   <system.web>
      <authorization>
         <allow roles="Admins"/>
         <deny users="*"/>
      </authorization>
   </system.web>
</configuration>

Informations sur les éléments

Voir aussi

Tâches

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Autorisation ASP.NET

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

system.web, élément (Schéma des paramètres ASP.NET)

allow, élément de authorization (Schéma des paramètres ASP.NET)

deny, élément de authorization (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

Autres ressources

Gestion de l'autorisation à l'aide de rôles

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET