AuthorizationStoreRoleProvider Classe

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

Gère le stockage des informations d'appartenance (membership) à des rôles pour une application ASP.NET dans un magasin de stratégies de Gestionnaire d'autorisations, que ce soit dans un fichier XML, sur un serveur Active Directory ou sur un serveur Active Directory Application Mode.

public ref class AuthorizationStoreRoleProvider : System::Web::Security::RoleProvider

public class AuthorizationStoreRoleProvider : System.Web.Security.RoleProvider

type AuthorizationStoreRoleProvider = class
    inherit RoleProvider

Public Class AuthorizationStoreRoleProvider
Inherits RoleProvider

Héritage

Object

ProviderBase

RoleProvider

AuthorizationStoreRoleProvider

Exemples

L’exemple de code suivant montre un jeu de fichiers Web.config à utiliser pour la AuthorizationStoreRoleProvider gestion des rôles.

<configuration>  
  <connectionStrings>  
    <add name="AuthorizationServices" connectionString="msxml://~\App_Data\SampleStore.xml" />  
  </connectionStrings>  

  <system.web>  

    <authentication mode="Windows" />  
    <identity impersonate="true" />  

    <roleManager defaultProvider="AuthorizationStoreRoleProvider"   
      enabled="true"  
      cacheRolesInCookie="true"  
      cookieName=".ASPROLES"  
      cookieTimeout="30"  
      cookiePath="/"  
      cookieRequireSSL="false"  
      cookieSlidingExpiration="true"  
      cookieProtection="All" >  
      <providers>  
        <clear />  
          <add  
            name="AuthorizationStoreRoleProvider"  
            type="System.Web.Security.AuthorizationStoreRoleProvider"  
            connectionStringName="AuthorizationServices"  
            applicationName="SampleApplication"   
            cacheRefreshInterval="60"  
            scopeName="" />  
      </providers>  
    </roleManager>  

  </system.web>  
</configuration>  

Remarques

Cette classe est utilisée par les classes et RolePrincipal fournit des services de gestion des rôles pour une application ASP.NET à l’aide Roles d’un magasin de gestionnaire d’autorisations. Vous pouvez utiliser la gestion des rôles pour spécifier différents niveaux d’autorisation pour votre application. Le gestionnaire d’autorisations est accessible à l’aide de la console de gestion Microsoft.

L’objet AuthorizationStoreRoleProvider fonctionne avec les modes d’authentification par Authentification Windows et par formulaire.

Vous pouvez configurer l’objet AuthorizationStoreRoleProvider pour utiliser un fichier XML local ou un serveur Active Directory ou Active Directory Application Mode (ADAM). Lorsque vous utilisez un fichier local, la chaîne de connexion doit ressembler à l’exemple suivant.

msxml://<path to xml file>  

Si le fichier local est stocké dans l’arborescence de répertoires d’une application web ASP.NET, vous pouvez utiliser le caractère tilde (« ~ ») pour indiquer le répertoire racine. Par exemple, pour indiquer que le fichier local est stocké dans le répertoire de données de l’application web, vous utiliserez une chaîne de connexion similaire à l’exemple suivant.

msxml://~\App_Data\datafilename.xml

Important

Le stockage d’un fichier de données XML dans le répertoire d’applications web est une menace de sécurité potentielle. Par défaut, IIS sert des fichiers de données XML sur le web. Pour améliorer la sécurité lors de l’utilisation d’un fichier de données local dans une application ASP.NET, vous devez stocker le fichier de données dans le App_Data répertoire. Les fichiers stockés dans le App_Data répertoire ne seront pas servis au web.

Si vous utilisez un serveur Active Directory ou ADAM pour le magasin de stratégies, votre chaîne de connexion doit être similaire à l’exemple suivant.

msldap://myserver/CN=MyAzManStore,OU=MyOU,DC=MyDomain,DC=MyDC,DC=Com

Les exceptions répertoriées dans la documentation pour AuthorizationStoreRoleProvider les méthodes d’objet sont les exceptions levées par l’objet AuthorizationStoreRoleProvider . Étant donné que le fournisseur s’appuie sur le runtime Authentication Manager sous-jacent, une COMException exception peut être levée chaque fois que l’objet AuthorizationStoreRoleProvider transfère un appel de méthode au runtime Authentication Manager.

Important

L’objet AuthorizationStoreRoleProvider a les exigences suivantes pour l’exécution dans des environnements d’approbation partielle :

Lorsque vous utilisez un magasin de stratégies basé sur un fichier dans une application ASP.NET, les autorisations d’E/S de fichier accordées par le niveau d’approbation actuel déterminent si les actions de lecture et d’écriture sont autorisées par le fournisseur. L’application ASP.NET doit disposer d’une autorisation de lecture sur le fichier pour lire des données à partir du magasin de stratégies, et doit disposer d’une autorisation d’écriture pour enregistrer de nouvelles informations ou mettre à jour les informations existantes dans le magasin de stratégies. Le fichier de stratégie de confiance moyenne par défaut fournit une autorisation de lecture/écriture d’application ASP.NET dans son répertoire d’application. Le fichier de stratégie de faible fiabilité par défaut ne fournit qu’une autorisation de lecture d’application ASP.NET dans son répertoire d’application. En outre, l’identité de processus sous laquelle l’application ASP.NET s’exécute doit disposer d’autorisations de système de fichiers pour lire et/ou écrire le fichier de stratégie.

Lors de l’utilisation d’un serveur Active Directory ou ADAM, l’application ASP.NET a besoin d’une autorisation de code non managé, car le code objet interne AuthorizationStoreRoleProvider utilise l’interopérabilité COM.

Lorsque vous utilisez l’objet AuthorizationStoreRoleProvider en dehors de ASP.NET, le code appelant a besoin d’une autorisation de code non managé.

Constructeurs

AuthorizationStoreRoleProvider()

Initialise une nouvelle instance de la classe AuthorizationStoreRoleProvider.

Propriétés

ApplicationName	Obtient ou définit le nom de l'application de magasin d'autorisations pour laquelle stocker et récupérer des informations de rôle.
CacheRefreshInterval	Obtient le nombre de minutes entre les actualisations du cache des données du magasin de stratégies.
Description	Obtient une description brève et conviviale qui peut s'afficher dans les outils d'administration ou d'autres interfaces utilisateur. (Hérité de ProviderBase)
Name	Obtient le nom convivial qui référence le fournisseur au cours de la configuration. (Hérité de ProviderBase)
ScopeName	Obtient ou définit le nom de portée pour le magasin d'autorisations.

Méthodes

AddUsersToRoles(String[], String[])	Ajoute le nom des utilisateurs spécifiés à chacun des rôles spécifiés.
CreateRole(String)	Ajoute un nouveau rôle au magasin de stratégies du Gestionnaire d'autorisations de rôles.
DeleteRole(String, Boolean)	Supprime un rôle du magasin de stratégies du Gestionnaire d'autorisations.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindUsersInRole(String, String)	Cette méthode n'est pas prise en charge par le fournisseur de rôles de magasin d'autorisations.
GetAllRoles()	Obtient la liste de tous les rôles pour l'application.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetRolesForUser(String)	Obtient une liste des rôles dans lesquels figure l'utilisateur.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetUsersInRole(String)	Obtient une liste des utilisateurs du rôle spécifié.
Initialize(String, NameValueCollection)	Initialise le fournisseur de rôles du Gestionnaire d'autorisations à l'aide des valeurs de propriété spécifiées dans le fichier de configuration de l'application ASP.NET. Cette méthode n'est pas destinée à être utilisée directement depuis votre code.
IsUserInRole(String, String)	Obtient une valeur indiquant si l'utilisateur spécifié figure dans le rôle spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RemoveUsersFromRoles(String[], String[])	Supprime les noms d'utilisateurs spécifiés des rôles spécifiés.
RoleExists(String)	Obtient une valeur qui indique si le nom de rôle spécifié existe déjà dans le magasin de stratégies du Gestionnaire d'autorisations.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Présentation de la gestion des rôles ASP.NET