DefaultAuthenticationModule Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour