DefaultAuthenticationModule Classe

  • Référence

Définition

Espace de noms:
System.Web.Security
Assembly:
System.Web.dll

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
Object
DefaultAuthenticationModule
Implémente
IHttpModule

Exemples

L’exemple suivant utilise l’événement DefaultAuthentication_OnAuthenticate pour tester si la User propriété du instance actuel HttpContext est null. Si la propriété a la User valeur null, l’exemple définit la User propriété de la instance actuelle HttpContext sur un GenericPrincipal objet où le 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é du instance actuel 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

le DefaultAuthenticationModule garantit que la User propriété du instance actuel 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 propriété sur User un GenericPrincipal objet qui ne contient aucune information utilisateur.

Si le module d’authentification définit la StatusCode propriété sur 401, affiche DefaultAuthenticationModule 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 requête. Dans ce cas, seuls les modules HTTP qui s’abonnent à l’événement EndRequest sont appelés avant la fin de la requête actuelle.

Expose DefaultAuthenticationModule un Authenticate événement. Vous pouvez utiliser cet événement pour fournir un objet personnalisé IPrincipal pour la User propriété du instance actuel 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