DefaultAuthenticationModule Classe

Définition

S'assure qu'un objet d'authentification est présent dans le contexte.Ensures that an authentication object is present in the context. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule
public sealed class DefaultAuthenticationModule : System.Web.IHttpModule
type DefaultAuthenticationModule = class
    interface IHttpModule
Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule
Héritage
DefaultAuthenticationModule
Implémente

Exemples

L’exemple suivant utilise l’événement DefaultAuthentication_OnAuthenticate pour déterminer si la User propriété de l’instance HttpContext actuelle est null.The following example uses the DefaultAuthentication_OnAuthenticate event to test whether the User property of the current HttpContext instance is null. Si la User propriété a nullla valeur, l’exemple affecte User à la propriété de HttpContext l’instance actuelle GenericPrincipal un objet où Identity le de GenericPrincipal l’objet est GenericIdentity un avec un Name valeur «default».If the User property is null, then the sample sets the User property of the current HttpContext instance to a GenericPrincipal object where the Identity of the GenericPrincipal object is a GenericIdentity with a Name value of "default."

Notes

L’événement DefaultAuthentication_OnAuthenticate est déclenché avant l' AuthorizeRequest événement.The DefaultAuthentication_OnAuthenticate event is raised before the AuthorizeRequest event. Par conséquent, si vous affectez une User identité personnalisée à la HttpContext propriété de l’instance actuelle, cela peut affecter le comportement de votre application.As a result, if you set the User property of the current HttpContext instance to a custom identity, it can affect the behavior of your application. Par exemple, si FormsAuthentication vous utilisez la classe et que vous spécifiez <deny users="?" /> dans la section Configuration de l' autorisation pour vous assurer que seuls les utilisateurs authentifiés ont accès à votre site, cet exemple entraîne l’utilisation de l’élément Deny ignoré, car l’utilisateur aura un nom, qui est «default».For example, if you are using the FormsAuthentication class and you specify <deny users="?" /> in the authorization configuration section to ensure that only authenticated users have access to your site, this sample will cause the deny element to be ignored, as the user will have a name, which is "default." Au lieu de cela, <deny users="default" /> vous devez spécifier pour vous assurer que seuls les utilisateurs authentifiés peuvent accéder à votre site.Instead, you would specify <deny users="default" /> to ensure that only authenticated users can access your site.

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}
Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

Remarques

Le DefaultAuthenticationModule garantit que la User propriété de l’instance HttpContext actuelle est définie sur un IPrincipal objet pour chaque requête.The DefaultAuthenticationModule ensures that the User property of the current HttpContext instance is set to an IPrincipal object for each request. Examine la User propriété après l' AuthenticateRequest événement et avant l' AuthorizeRequest événement. DefaultAuthenticationModuleThe DefaultAuthenticationModule examines the User property after the AuthenticateRequest event and before the AuthorizeRequest event. Si la User propriété a nullla valeur DefaultAuthenticationModule , le User définit la propriété GenericPrincipal sur un objet qui ne contient aucune information utilisateur.If the User property is null, the DefaultAuthenticationModule sets the User property to a GenericPrincipal object that contains no user information.

Si le module d’authentification affecte StatusCode à la propriété la valeur DefaultAuthenticationModule 401, le affiche une page d’erreur d’accès refusé.If the authentication module sets the StatusCode property to 401, the DefaultAuthenticationModule will render an access-denied error page. Si la valeur de la StatusCode propriété est supérieure à 200, l' DefaultAuthenticationModule objet met fin à la requête.If the value of the StatusCode property is set to a value greater than 200, the DefaultAuthenticationModule object will end the request. Dans ce cas, seuls les modules http qui s’abonnent à l' EndRequest événement sont appelés avant la fin de la requête actuelle.In that case, only HTTP modules that subscribe to the EndRequest event are called prior to the completion of the current request.

Expose un Authenticateévénement. DefaultAuthenticationModuleThe DefaultAuthenticationModule exposes an Authenticate event. Vous pouvez utiliser cet événement pour fournir un objet IPrincipal personnalisé pour la User propriété de l’instance HttpContext actuelle.You can use this event to provide a custom IPrincipal object for the User property of the current HttpContext instance. L' Authenticate événement est accessible en spécifiant un événement nommé DefaultAuthentication_OnAuthenticate dans le fichier global. asax de l’application.The Authenticate event is accessed by specifying an event named DefaultAuthentication_OnAuthenticate in the application's Global.asax file.

Constructeurs

DefaultAuthenticationModule()

Initialise une nouvelle instance de la classe DefaultAuthenticationModule.Initializes a new instance of the DefaultAuthenticationModule class.

Méthodes

Dispose()

Libère toutes les ressources (autres que la mémoire) utilisées par DefaultAuthenticationModule.Releases all resources, other than memory, used by the DefaultAuthenticationModule.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
Init(HttpApplication)

Initialise l'objet DefaultAuthenticationModule.Initializes the DefaultAuthenticationModule object.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Événements

Authenticate

Se produit après l'authentification de la requête.Occurs after the request has been authenticated.

S’applique à

Voir aussi