Intergiciels (« middleware »)Lien vers cette rubrique#

Intergiciel de cacheLien vers cette rubrique#

class UpdateCacheMiddlewareLien vers cette définition#

class FetchFromCacheMiddlewareLien vers cette définition#

Active le cache global du site. Quand il est actif, chaque page générée par Django est mise en cache pour une durée équivalente au réglage CACHE_MIDDLEWARE_SECONDS. Voir la documentation du cache.

Intergiciel « common »Lien vers cette rubrique#

class CommonMiddlewareLien vers cette définition#

Ajoute quelques commodités pour les perfectionnistes :

• Interdit l’accès aux agents utilisateurs (navigateurs) mentionnés dans le réglage DISALLOWED_USER_AGENTS, qui devrait contenir une liste d’objets expression régulière compilés.

• Effectue une réécriture d’URL sur la base des réglages APPEND_SLASH et PREPEND_WWW.

  Si APPEND_SLASH vaut True et que l’URL initiale ne se termine pas par une barre oblique et que l’URL n’est pas trouvée dans les configuration d’URL, une nouvelle URL est formée en y ajoutant une barre oblique à la fin. Si la nouvelle URL est trouvée dans la configuration d’URL, Django redirige la requête vers cette URL. Sinon, l’URL de départ est traitée comme d’habitude.

  Par exemple, foo.com/bar sera redirigée vers foo.com/bar/ s’il n’existe pas de motif d’URL valide correspondant à foo.com/bar mais qu’il existe un motif valide pour foo.com/bar/.

  Si PREPEND_WWW vaut True, les URL ne commençant pas par « www. » seront redirigées vers la même URL commençant par « www. ».

  Ces deux options visent à normaliser les URL. L’idée étant que chaque URL devrait exister sous une et une seule forme. Techniquement, une URL foo.com/bar est différente de foo.com/bar/ – un index de moteur de recherche les traiterait comme des URL distinctes – ce qui justifie la bonne pratique de normaliser les URL.

• Gère les en-têtes ETags sur la base du réglage USE_ETAGS. Si USE_ETAGS vaut True, Django génère l’en-tête ETag pour chaque requête en calculant l’empreinte MD5 du contenu de la page, et il se chargera d’envoyer des réponses Not Modified le cas échéant.

• Définit l’en-tête Content-Length pour les réponses qui ne sont pas de type flux.

CommonMiddleware.response_redirect_classLien vers cette définition#

La valeur par défaut est HttpResponsePermanentRedirect. Créez une sous-classe de CommonMiddleware et surchargez cet attribut pour personnaliser les redirections émises par l’intergiciel.

class BrokenLinkEmailsMiddlewareLien vers cette définition#

• Envoie des courriels de notification de lien brisé aux MANAGERS (voir Signalement d’erreurs).

Intergiciel GZipLien vers cette rubrique#

class GZipMiddlewareLien vers cette définition#

Compresse le contenu pour les navigateurs qui prennent en charge la compression GZip (tous les navigateurs modernes).

Cet intergiciel devrait être placé avant tout autre intergiciel qui a besoin de lire ou d’écrire le corps de la réponse afin que la compression puisse avoir lieu après.

Il ne compresse PAS le contenu si l’un des critères suivants est vrai :

• La taille du corps du contenu est plus petite que 200 octets.

• La réponse a déjà défini l’en-tête Content-Encoding.

• La requête (le navigateur) n’a pas envoyé d’en-tête Accept-Encoding incluant gzip.

Si la réponse possède un en-tête ETag, l’ETag est rendu faible pour se conformer à RFC 7232 Section 2.1.

Vous pouvez appliquer la compression GZip pour des vues individuelles en utilisant le décorateur gzip_page().

Intergiciel GET conditionnelLien vers cette rubrique#

class ConditionalGetMiddlewareLien vers cette définition#

Traite les opérations GET conditionnelles. Si la réponse ne possède pas d’en-tête ETag, l’intergiciel en crée un si nécessaire. Si la réponse possède un en-tête ETag ou Last-Modified et que la requête possède l’en-tête If-None-Match ou If-Modified-Since, la réponse est remplacée par HttpResponseNotModified.

Intergiciel de localeLien vers cette rubrique#

class LocaleMiddlewareLien vers cette définition#

Active le choix de la langue en fonction de données de la requête. Le contenu est alors personnalisé par utilisateur. Voir la documentation sur l’internationalisation.

LocaleMiddleware.response_redirect_classLien vers cette définition#

La valeur par défaut est HttpResponseRedirect. Créez une sous-classe de LocaleMiddleware et surchargez cet attribut pour personnaliser les redirections émises par l’intergiciel.

Intergiciel de messagesLien vers cette rubrique#

class MessageMiddlewareLien vers cette définition#

Active la prise en charge des messages par session ou par cookie. Voir la documentation sur les messages.

Intergiciel de sécuritéLien vers cette rubrique#

class SecurityMiddlewareLien vers cette définition#

L’intergiciel django.middleware.security.SecurityMiddleware fournit plusieurs améliorations de sécurité au cycle de requête/réponse. Chaque amélioration peut être activée ou désactivée indépendamment par un réglage.

• SECURE_BROWSER_XSS_FILTER

• SECURE_CONTENT_TYPE_NOSNIFF

• SECURE_HSTS_INCLUDE_SUBDOMAINS

• SECURE_HSTS_PRELOAD

• SECURE_HSTS_SECONDS

• SECURE_REDIRECT_EXEMPT

• SECURE_SSL_HOST

• SECURE_SSL_REDIRECT

Intergiciel de sessionLien vers cette rubrique#

class SessionMiddlewareLien vers cette définition#

Active la prise en charge des sessions. Voir la documentation sur les sessions.

Intergiciel de siteLien vers cette rubrique#

class CurrentSiteMiddlewareLien vers cette définition#

Ajoute l’attribut site représentant le site en cours à chaque objet HttpRequest entrant. Voir la documentation sur les sites.

Intergiciel d’authentificationLien vers cette rubrique#

class AuthenticationMiddlewareLien vers cette définition#

Ajoute l’attribut user représentant l’utilisateur actuellement connecté à chaque objet HttpRequest entrant. Voir Authentification dans les requêtes Web.

class RemoteUserMiddlewareLien vers cette définition#

Intergiciel permettant d’exploiter l’authentification fournie par le serveur Web. Voir Authentification avec REMOTE_USER pour les détails d’utilisation.

class PersistentRemoteUserMiddlewareLien vers cette définition#

Intergiciel permettant d’exploiter l’authentification fournie par le serveur Web lorsqu’elle n’est activée que sur la page de connexion. Voir Utilisation de REMOTE_USER uniquement pour les pages de connexion pour les détails d’utilisation.

Intergiciel de protection CSRFLien vers cette rubrique#

class CsrfViewMiddlewareLien vers cette définition#

Ajoute la protection contre les attaques Cross Site Request Forgeries en ajoutant des champs de formulaires masqués aux formulaires POST et en contrôlant que les requêtes contiennent la valeur correcte. Voir la documentation concernant la protection contre les attaques Cross Site Request Forgery.

Intergiciel X-Frame-OptionsLien vers cette rubrique#

class XFrameOptionsMiddlewareLien vers cette définition#

Protection simple contre les attaques par détournement de clic au moyen de l’en-tête X-Frame-Options.