allow, élément de authorization (Schéma des paramètres ASP.NET)
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
Ajoute, au mappage des règles d'autorisation, une règle d'autorisation qui autorise l'accès à une ressource.
<allow
users="comma-separated list of users"
roles="comma-separated list of roles"
verbs="comma-separated list of verbs"
/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut |
Description |
|---|---|
users |
Attribut String requis. Liste des noms d'utilisateur, séparés par une virgule, qui sont autorisés à accéder à la ressource. Un point d'interrogation (?) indique que les utilisateurs anonymes sont autorisés à accéder à la ressource. Un astérisque (*) indique que tous les utilisateurs sont autorisés à accéder à la ressource. |
roles |
Attribut String requis. Liste des rôles séparés par une virgule qui sont autorisés à accéder à la ressource. |
verbs |
Attribut String facultatif. Liste avec la virgule comme séparateur des méthodes de transmission HTTP autorisées à accéder à la ressource. Les verbes inscrits pour ASP.NET sont GET, HEAD, POST et DEBUG. |
Éléments enfants
Aucun
Éléments parents
Élément |
Description |
|---|---|
configuration |
Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
system.web |
Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications. |
authorization |
Configure l'autorisation pour une application Web. La balise authorization contrôle l'accès client aux ressources URL. Cet élément peut être déclaré à n'importe quel niveau (ordinateur, site, application, sous-répertoire ou page). |
Notes
L'élément allow ajoute une règle d'autorisation autorisant l'accès à une ressource au mappage des règles d'autorisation stockées dans l'élément authorization.
L'élément authorization configure l'autorisation d'une application Web, en contrôlant l'accès client aux ressources URL. Pour les attributs requis, vous pouvez utiliser l'attribut users ou roles ou les deux.
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 l'illustre l'exemple de code suivant :
< autoriser des rôles = « . \roleName "/>
< autoriser des utilisateurs = « . \userName"/>
Au moment de l'exécution, les séquences point-barre oblique inverse sont remplacées par des séquences "NomOrdinateurLocal\". La substitution est effectuée uniquement si une identité Windows est utilisée avec la requête. Cela permet d'éviter des conflits lorsque 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.
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 refuser l'accès à tous les comptes d'utilisateurs et autoriser l'accès à tous les membres du rôle admins.
<configuration>
<system.web>
<authorization>
<allow roles="admins"/>
<deny users="*"/>
</authorization>
</system.web>
</configuration>
Informations sur les éléments
Gestionnaire de section de configuration |
|
Membre de configuration |
|
Emplacements configurables |
Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique |
Configuration requise |
Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005 |
Voir aussi
Tâches
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Référence
authorization, élément (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)
system.web, élément (Schéma des paramètres ASP.NET)
Concepts
ASP.NET Configuration File Hierarchy
Autres ressources
Managing Authorization Using Roles
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET