WindowsTokenRoleProvider Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Reçoit les informations de rôle d'une application ASP.NET à partir de l'appartenance à des groupes Windows.
public ref class WindowsTokenRoleProvider : System::Web::Security::RoleProvider
public class WindowsTokenRoleProvider : System.Web.Security.RoleProvider
type WindowsTokenRoleProvider = class
inherit RoleProvider
Public Class WindowsTokenRoleProvider
Inherits RoleProvider
- Héritage
Exemples
L’exemple suivant montre le fichier Web.config pour une application ASP.NET. Il spécifie que l’application utilise à la fois l’authentification Windows et la WindowsTokenRoleProvider classe pour récupérer des informations de rôle pour les utilisateurs Windows. L’élément authorization
spécifie que seuls les utilisateurs du groupe BUILTIN\Administrators sont autorisés à accéder à l’application.
<configuration>
<system.web>
<authentication mode="Windows" />
<authorization>
<allow roles="BUILTIN\Administrators" />
<deny users="*" />
</authorization>
<roleManager defaultProvider="WindowsProvider"
enabled="true"
cacheRolesInCookie="false">
<providers>
<add
name="WindowsProvider"
type="System.Web.Security.WindowsTokenRoleProvider" />
</providers>
</roleManager>
</system.web>
</configuration>
Remarques
La WindowsTokenRoleProvider classe est un fournisseur d’appartenance à un rôle en lecture seule qui récupère les informations de rôle d’un utilisateur Windows en fonction des groupes de sécurité Windows. Il est particulièrement utile avec les applications ASP.NET qui utilisent le mode d’authentification Windows où les paramètres d’authentification IIS désactivent l’authentification anonyme. Vous pouvez configurer ASP.NET applications pour autoriser ou refuser l’accès en fonction de l’appartenance d’un utilisateur à un groupe Windows particulier.
Vous ne pouvez pas utiliser la WindowsTokenRoleProvider classe pour créer ou supprimer des rôles ou modifier l’appartenance d’un rôle basé sur l’appartenance à un groupe Windows. Cette fonctionnalité est gérée par le système d’exploitation Windows. La WindowsTokenRoleProvider classe prend uniquement en charge les IsUserInRole méthodes et GetRolesForUser de la RoleProvider classe abstraite.
Constructeurs
WindowsTokenRoleProvider() |
Crée une instance de la classe WindowsTokenRoleProvider. |
Propriétés
ApplicationName |
Obtient ou définit le nom de l'application. |
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) |
Méthodes
AddUsersToRoles(String[], String[]) |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
CreateRole(String) |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
DeleteRole(String, Boolean) |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
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 jeton Windows. |
GetAllRoles() |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetRolesForUser(String) |
Obtient la liste des groupes Windows dans lesquels figure l'utilisateur. |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetUsersInRole(String) |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
Initialize(String, NameValueCollection) |
Initialise le fournisseur de rôles de jeton Windows à 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 groupe Windows spécifié. |
IsUserInRole(String, WindowsBuiltInRole) |
Obtient une valeur indiquant si l'utilisateur spécifié se trouve dans le rôle Windows intégré spécifié. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
RemoveUsersFromRoles(String[], String[]) |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
RoleExists(String) |
Cette méthode n’est pas prise en charge par le fournisseur de rôles de jeton Windows. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |