WindowsTokenRoleProvider Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene información de los roles de una aplicación ASP.NET basada en la pertenencia a grupos de 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
- Herencia
Ejemplos
En el ejemplo siguiente se muestra el archivo Web.config para una aplicación de ASP.NET. Especifica que la aplicación usa tanto la autenticación de Windows como la WindowsTokenRoleProvider clase para recuperar información de roles para los usuarios de Windows. El authorization
elemento especifica que solo los usuarios del grupo BUILTIN\Administrators tienen permiso de acceso a la aplicación.
<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>
Comentarios
La WindowsTokenRoleProvider clase es un proveedor de pertenencia a roles de solo lectura que recupera información de rol para un usuario de Windows basado en grupos de seguridad de Windows. Resulta más útil con ASP.NET aplicaciones que usan el modo de autenticación de Windows donde la configuración de autenticación de IIS deshabilita la autenticación anónima. Puede configurar ASP.NET aplicaciones para permitir o denegar el acceso en función de la pertenencia de un usuario a un grupo de Windows determinado.
No puede usar la WindowsTokenRoleProvider clase para crear o eliminar roles ni modificar la pertenencia de un rol basado en la pertenencia a grupos de Windows. Esta funcionalidad la administra el sistema operativo Windows. La WindowsTokenRoleProvider clase solo admite los IsUserInRole métodos y GetRolesForUser de la RoleProvider clase abstracta.
Constructores
WindowsTokenRoleProvider() |
Crea una instancia de la clase WindowsTokenRoleProvider. |
Propiedades
ApplicationName |
Obtiene o establece el nombre de la aplicación. |
Description |
Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario. (Heredado de ProviderBase) |
Name |
Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración. (Heredado de ProviderBase) |
Métodos
AddUsersToRoles(String[], String[]) |
Este método no es compatible con el proveedor de roles del token de Windows. |
CreateRole(String) |
Este método no es compatible con el proveedor de roles del token de Windows. |
DeleteRole(String, Boolean) |
Este método no es compatible con el proveedor de roles del token de Windows. |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
FindUsersInRole(String, String) |
Este método no es compatible con el proveedor de roles del token de Windows. |
GetAllRoles() |
Este método no es compatible con el proveedor de roles del token de Windows. |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetRolesForUser(String) |
Obtiene una lista de los grupos de Windows en que está incluido un usuario. |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
GetUsersInRole(String) |
Este método no es compatible con el proveedor de roles del token de Windows. |
Initialize(String, NameValueCollection) |
Inicializa el proveedor de roles de símbolos (token) de Windows con los valores de propiedad especificados en el archivo de configuración de la aplicación ASP.NET. Este método no está pensado para usarse directamente desde su código. |
IsUserInRole(String, String) |
Obtiene un valor que indica si el usuario especificado está en el grupo de Windows especificado. |
IsUserInRole(String, WindowsBuiltInRole) |
Obtiene un valor que indica si el usuario especificado está incluido en el rol integrado de Windows especificada. |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
RemoveUsersFromRoles(String[], String[]) |
Este método no es compatible con el proveedor de roles del token de Windows. |
RoleExists(String) |
Este método no es compatible con el proveedor de roles del token de Windows. |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |