Partager via


DefaultAuthenticationModule Classe

Définition

S'assure qu'un objet d'authentification est présent dans le contexte. Cette classe ne peut pas être héritée.

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 tester si la User propriété de l’instance actuelle HttpContext est null. Si la User propriété est null, l’exemple définit la User propriété de l’instance active HttpContext sur un GenericPrincipal objet où l’objet Identity de l’objet GenericPrincipal est un GenericIdentity avec la Name valeur « default ».

Notes

L’événement DefaultAuthentication_OnAuthenticate est déclenché avant l’événementAuthorizeRequest. Par conséquent, si vous définissez la User propriété de l’instance actuelle HttpContext sur une identité personnalisée, cela peut affecter le comportement de votre application. Par exemple, si vous utilisez la FormsAuthentication 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’ignorer de l’élément deny , car l’utilisateur aura un nom, qui est « par défaut ». Au lieu de cela, vous devez spécifier <deny users="default" /> pour vous assurer que seuls les utilisateurs authentifiés peuvent accéder à votre 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

garantit DefaultAuthenticationModule que la User propriété de l’instance actuelle HttpContext est définie sur un IPrincipal objet pour chaque requête. examine DefaultAuthenticationModule la User propriété après l’événement AuthenticateRequest et avant l’événement AuthorizeRequest . Si la User propriété est null, définit DefaultAuthenticationModule la User propriété sur un GenericPrincipal objet qui ne contient aucune information utilisateur.

Si le module d’authentification définit la StatusCode propriété sur 401, le DefaultAuthenticationModule affiche une page d’erreur d’accès refusé. Si la valeur de la StatusCode propriété est définie sur une valeur supérieure à 200, l’objet DefaultAuthenticationModule met fin à la demande. Dans ce cas, seuls les modules HTTP qui s’abonnent à l’événement EndRequest sont appelés avant la fin de la demande actuelle.

expose DefaultAuthenticationModule un Authenticate événement. Vous pouvez utiliser cet événement pour fournir un objet personnalisé IPrincipal pour la User propriété de l’instance actuelle HttpContext . L’événement Authenticate est accessible en spécifiant un événement nommé DefaultAuthentication_OnAuthenticate dans le fichier Global.asax de l’application.

Constructeurs

DefaultAuthenticationModule()

Initialise une nouvelle instance de la classe DefaultAuthenticationModule.

Méthodes

Dispose()

Libère toutes les ressources (autres que la mémoire) utilisées par DefaultAuthenticationModule.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

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

Initialise l'objet DefaultAuthenticationModule.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Événements

Authenticate

Se produit après l'authentification de la requête.

S’applique à

Voir aussi