System.Web.Security Namespace
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Contains classes that are used to implement ASP.NET security in Web server applications.
Classes
ActiveDirectoryMembershipProvider |
Manages storage of membership information for an ASP.NET application in Active Directory and Active Directory Application Mode servers. |
ActiveDirectoryMembershipUser |
Exposes and updates membership user information stored in an Active Directory data store. |
AnonymousIdentificationEventArgs |
Provides data for the AnonymousIdentification_Creating event. This class cannot be inherited. |
AnonymousIdentificationModule |
Manages anonymous identifiers for the ASP.NET application. |
AuthorizationStoreRoleProvider |
Manages storage of role-membership information for an ASP.NET application in an authorization-manager policy store, either in an XML file, in an Active Directory, or on an Active Directory Application Mode server. |
DefaultAuthenticationEventArgs |
Provides data for the DefaultAuthentication_OnAuthenticate event. This class cannot be inherited. |
DefaultAuthenticationModule |
Ensures that an authentication object is present in the context. This class cannot be inherited. |
FileAuthorizationModule |
Verifies that the user has permission to access the file requested. This class cannot be inherited. |
FormsAuthentication |
Manages forms-authentication services for Web applications. This class cannot be inherited. |
FormsAuthenticationEventArgs |
Provides data for the FormsAuthentication_OnAuthenticate event. This class cannot be inherited. |
FormsAuthenticationModule |
Sets the identity of the user for an ASP.NET application when forms authentication is enabled. This class cannot be inherited. |
FormsAuthenticationTicket |
Provides access to properties and values of the ticket used with forms authentication to identify users. This class cannot be inherited. |
FormsIdentity |
Represents a user identity authenticated using forms authentication. This class cannot be inherited. |
MachineKey |
Provides a way to encrypt or hash data (or both) by using the same algorithms and key values that are used for ASP.NET forms authentication and view state. |
Membership |
Validates user credentials and manages user settings. This class cannot be inherited. |
MembershipCreateUserException |
The exception that is thrown when a user is not successfully created by a membership provider. |
MembershipPasswordAttribute |
Validates whether a password field meets the current password requirements for the membership provider. |
MembershipPasswordException |
The exception that is thrown when a password cannot be retrieved from the password store. |
MembershipProvider |
Defines the contract that ASP.NET implements to provide membership services using custom membership providers. |
MembershipProviderCollection |
A collection of objects that inherit the MembershipProvider abstract class. |
MembershipUser |
Exposes and updates membership user information in the membership data store. |
MembershipUserCollection |
A collection of MembershipUser objects. |
PassportAuthenticationEventArgs |
The event argument passed to the Authenticate event by a PassportAuthenticationModule. Since there is already an identity at this point, this is useful mainly for attaching a custom IPrincipal object to the context using the supplied identity. This class is deprecated. |
PassportAuthenticationModule |
Provides a wrapper around Passport Authentication services. This class cannot be inherited. This class is deprecated. |
PassportIdentity |
Provides a class to be used by PassportAuthenticationModule. It provides a way for an application to access the Ticket(String) method. This class cannot be inherited. This class is deprecated. |
PassportPrincipal |
Represents a Passport-authenticated principal. This class is deprecated. |
RoleManagerEventArgs |
Provides event data for the GetRoles event of the RoleManagerModule class. |
RoleManagerModule |
Manages a RolePrincipal instance for the current user. This class cannot be inherited. |
RolePrincipal |
Represents security information for the current HTTP request, including role membership. This class cannot be inherited. |
RoleProvider |
Defines the contract that ASP.NET implements to provide role-management services using custom role providers. |
RoleProviderCollection |
A collection of objects that inherit the RoleProvider abstract class. |
Roles |
Manages user membership in roles for authorization checking in an ASP.NET application. This class cannot be inherited. |
SqlMembershipProvider |
Manages storage of membership information for an ASP.NET application in a SQL Server database. |
SqlRoleProvider |
Manages storage of role membership information for an ASP.NET application in a SQL Server database. |
UrlAuthorizationModule |
Verifies that the user has permission to access the URL requested. This class cannot be inherited. |
ValidatePasswordEventArgs |
Provides event data for the ValidatingPassword event of the MembershipProvider class. |
WindowsAuthenticationEventArgs |
Provides data for the WindowsAuthentication_OnAuthenticate event. This class cannot be inherited. |
WindowsAuthenticationModule |
Sets the identity of the user for an ASP.NET application when Windows authentication is enabled. This class cannot be inherited. |
WindowsTokenRoleProvider |
Gets role information for an ASP.NET application from Windows group membership. |
Enums
ActiveDirectoryConnectionProtection |
Specifies the connection protection options supported by the ActiveDirectoryMembershipProvider class. |
CookieProtection |
Describes how information in a cookie is protected. |
MachineKeyProtection |
Specifies values that indicates whether data should be encrypted or decrypted, whether a hash-based message authentication code (HMAC) should be appended or validated, or both. |
MembershipCreateStatus |
Describes the result of a CreateUser(String, String) operation. |
MembershipPasswordFormat |
Describes the encryption format for storing passwords for membership users. |
Delegates
AnonymousIdentificationEventHandler |
Represents the method that handles the AnonymousIdentification_Creating event of a AnonymousIdentificationModule. |
DefaultAuthenticationEventHandler |
Represents the method that handles the DefaultAuthentication_OnAuthenticate event of a DefaultAuthenticationModule. |
FormsAuthenticationEventHandler |
Represents the method that handles the FormsAuthentication_OnAuthenticate event of a FormsAuthenticationModule. |
MembershipValidatePasswordEventHandler |
Represents the method that will handle the ValidatingPassword event of the MembershipProvider class. |
PassportAuthenticationEventHandler |
Represents the method that handles the |
RoleManagerEventHandler |
Defines the delegate for the GetRoles event of the RoleManagerModule class. |
WindowsAuthenticationEventHandler |
Represents the method that handles the WindowsAuthentication_OnAuthenticate event of a WindowsAuthenticationModule. |
Remarks
The Membership class is used by ASP.NET applications to validate user credentials and manage user settings such as passwords and email addresses. The Roles class enables you to manage authorization for your application based on groups of users assigned to roles in the Web application.
Both the Membership class and the Roles class work with providers, classes that access your application's data store to retrieve membership and role information. Membership and role information can be stored in a Microsoft SQL Server database using the SqlMembershipProvider and SqlRoleProvider classes; in an Active Directory using the ActiveDirectoryMembershipProvider and AuthorizationStoreRoleProvider classes, or in a custom data source using implementations of the MembershipProvider and RoleProvider classes.
You configure ASP.NET membership using the membership Element (ASP.NET Settings Schema). When an application using membership is accessed, ASP.NET creates an instance of the Membership class that you can use to query membership information. Provider-specific implementations of the MembershipUser class contain information about the user accessing the page. You can create custom implementations of the MembershipUser class for your application.
You configure ASP.NET roles using the roleManager Element (ASP.NET Settings Schema). ASP.NET creates an instance of the Roles class that contains information about the role membership of the current user.
ASP.NET provides server controls that interact with the Membership class and the Roles class. The Login, CreateUserWizard, and ChangePassword controls work with the Membership class to simplify creating an authenticated Web application, and the LoginView control uses role-specific templates to customize Web pages for specific groups of users.