Infrastructure de contrôle système

L’infrastructure de contrôle système est un ensemble de contrôles statiques pour valider les projets Django. Elle détecte les problèmes courants et fournit des conseils sur la façon de les corriger. L’infrastructure est extensible de sorte que vous pouvez facilement ajouter vos propres contrôles.

Pour plus de détails sur la façon d’ajouter vos propres contrôles et les intégrer aux contrôles systèmes de Django, consultez le Guide thématique sur la vérification système.

Référence de l’API

CheckMessage

class CheckMessage(level, msg, hint=None, obj=None, id=None)

Les avertissements et les erreurs signalés par les contrôles systèmes doivent être des instances de CheckMessage. Une instance encapsule une seule erreur à signaler ou un seul avertissement. Elle fournit également des indicateurs et le contexte applicables au message, et un identifiant unique qui est utilisé à des fins de filtrage.

Les arguments du constructeur sont :

level

La gravité du message. Utilisez l’une des valeurs prédéfinies : DEBUG, INFO, WARNING, ERROR, CRITICAL. Si le niveau est supérieur ou égal à ERROR, Django empêchera l’exécution des commandes de gestion. Les messages avec un niveau inférieur à ERROR (i.e. les avertissements) sont présentés dans la console, mais peuvent être réduits au silence.

msg

Une courte chaîne (moins de 80 caractères) décrivant le problème. La chaîne ne doit pas contenir des sauts de ligne.

hint

Une chaîne d’une seule ligne offrant un indicateur pour résoudre le problème. Si aucun indicateur ne peut être fourni, ou s’il est évident à partir du message d’erreur, l’indicateur peut être omis, ou une valeur None peut être utilisée.

obj

Facultatif. Un objet fournissant le contexte du message (par exemple, le modèle où le problème a été découvert). L’objet doit être un modèle, un champ, un gestionnaire ou tout autre objet qui définit la méthode __str__(). La méthode est utilisée lors de la collecte de tous les messages et son résultat précède le message.

id

Chaîne facultative. Un identifiant unique pour le problème. Les identifiants doivent suivre le modèle applabel.X001, où X est l’une des lettres CEWID, indiquant la gravité du message (C pour critique, E pour les erreurs et ainsi de suite). Le numéro peut être attribué par l’application, mais doit être unique au sein de cette application.

Il existe des sous-classes pour faciliter la création des messages avec les niveaux de base. Lorsque vous les utilisez, vous pouvez omettre le paramètre level car il est sous-entendu par le nom de la classe.

class Debug(msg, hint=None, obj=None, id=None)

class Info(msg, hint=None, obj=None, id=None)

class Warning(msg, hint=None obj=None, id=None)

class Error(msg, hint=None, obj=None, id=None)

class Critical(msg, hint=None, obj=None, id=None)

Étiquettes prédéfinies

Les contrôles systèmes de Django sont organisés en utilisant les étiquettes suivantes :

• admin: contrôles de toutes les déclarations de sites d’administration.
• async_support: contrôle la configuration liée au code asynchrone.
• caches: contrôle la configuration liée aux caches (mémoire tampon).
• compatibility: identification de problèmes potentiels avec les mises à jour.
• database: vérifie des problèmes de configuration liés aux bases de données. Les contrôles de base de données ne sont pas exécutés par défaut car ils font plus que de l’analyse de code statique comme le font les autres contrôles. Ils ne sont lancés que par la commande migrate ou si vous indiquez des alias de base de données configurés avec l’option database lors de l’appel à la commande check.
• files: contrôle la configuration liée aux fichiers.
• models: contrôles régissant les définitions de modèles, champs et gestionnaires.
• security: contrôle la configuration liée à la sécurité.
• signals: contrôles des déclarations de signaux et des enregistrements de gestionnaires.
• sites: contrôle la configuration de django.contrib.sites.
• staticfiles: contrôle la configuration liée à django.contrib.staticfiles.
• templates: contrôle la configuration liée aux gabarits.
• translation: vérifie la configuration liée aux traductions.
• urls: contrôle la configuration des URL.

Certains contrôles peuvent être enregistrés sous plusieurs étiquettes.

Vérifications systèmes du noyau

Gestion du code asynchrone

Les contrôles suivants vérifient votre configuration concernant Asynchronous support:

• async.E001 : vous ne devez pas définir la variable d’environnement envvar:DJANGO_ALLOW_ASYNC_UNSAFE en déploiement. Cela désactive la protection de sécurité async.

Rétrocompatibilité

Les contrôles de compatibilité alertent sur des problèmes potentiels pouvant se produire après une mise à jour de Django.

• 2_0.W001 : le motif d’URL <pattern> possède une route contenant (?P<, commençant par ^ ou se terminant par $. Il s’agit probablement d’un oubli lors du passage de url() à path().
• 4_0.E001: à partir de Django 4.0, les valeurs du réglage CSRF_TRUSTED_ORIGINS doivent commencer par un protocole (généralement http://` ou https://), mais <nom_hôte> a été trouvé.

Caches

Les contrôles suivants vérifient que le réglage CACHES est configuré correctement :

• caches.E001 : vous devez définir un cache 'default' dans votre réglage CACHES.
• caches.W002 : votre configuration de <cache> peut exposer votre cache ou permettre une corruption de vos données car son emplacement LOCATION correspond à, ou se trouve dans un des réglages MEDIA_ROOT/STATIC_ROOT/STATICFILES_DIRS.
• caches.W003 : l’emplacement LOCATION du <cache> est relatif. Utilisez plutôt un chemin absolu.

Base de données

MySQL et MariaDB

Si vous utilisez MySQL ou MariaDB, les contrôles suivants seront effectués :

• mysql.E001 : MySQL/MariaDB ne permet pas aux champs CharField uniques d’avoir un attribut max_length > 255. Ce contrôle a été transformé en mysql.W003 dans Django 3.1 car la taille maximale réelle dépend de plusieurs facteurs.
• mysql.W002 : le mode strict de MySQL/MariaDB n’est pas défini pour la connexion de base de données <alias>. Voir aussi Définition de sql_mode.
• mysql.W003 : MySQL/MariaDB pourrait ne pas permettre aux champs CharField uniques d’avoir un attribut max_length > 255.

Gestion des fichiers

Les contrôles suivants vérifient votre configuration concernant Managing files:

• files.E001 : le réglage FILE_UPLOAD_TEMP_DIR se réfère au répertoire inexistant <path>.

Champs de modèle

• fields.E001 : les noms de champ ne doivent pas se terminer par un trait de soulignement.
• fields.E002 : les noms de champ ne doivent pas contenir "__".
• fields.E003* : pk est un mot réservé et ne peut pas être utilisé comme nom de champ.
• fields.E004 : choices doit être un élément itérable (par ex. une liste ou un tuple).
• fields.E005 : choices doit être un élément itérable contenant des tuples (valeur réelle, nom convivial).
• fields.E006 : db_index ne peut contenir que None, True ou False.
• fields.E007 : les clés primaires ne peuvent pas contenir null=True.
• fields.E008 : tous les validators doivent être exécutables.
• fields.E009 : max_length est trop court pour accueillir la plus longue valeur de choices (<count> caractères).
• fields.E010 : la valeur par défaut de <champ> doit être un objet exécutable plutôt qu’une instance afin qu’elle ne soit pas partagée entre toutes les instances de ce champ.
• fields.E100 : les champs AutoField doivent déclarer primary_key=True.
• fields.E110 : les champs BooleanField n’acceptent pas les valeurs nulles. Ce contrôle est apparu avant la prise en charge des valeurs nulles ajoutée dans Django 2.1.
• fields.E120 : les champs CharField doivent définir un attribut max_length.
• fields.E121 : max_length doit être un entier positif.
• fields.W122 : max_length est ignoré lorsqu’il est utilisé pour un champ <type de champ entier>.
• fields.E130 : les champs DecimalField doivent définir un attribut decimal_places.
• fields.E131 : decimal_places doit être un entier non négatif.
• fields.E132 : les champs DecimalField doivent définir un attribut max_digits.
• fields.E133 : max_digits doit être un entier positif.
• fields.E134 : max_digits doit être supérieur ou égal à decimal_places.
• fields.E140 : les champs FilePathField doivent comporter l’un des deux attributs allow_files et allow_folders défini à True.
• fields.E150 : les champs GenericIPAddressField ne peuvent avoir blank=True si null=False, car les valeurs vides sont stockées sous forme de valeurs nulles.
• fields.E160 : les options auto_now, auto_now_add et default sont mutuellement exclusives. Une seule de ces options doit être conservée.
• fields.W161 : une valeur par défaut fixe est indiquée.
• fields.W162 : <base_de_données> ne prend pas en charge les index sur les colonnes <type données champ>.
• fields.W163: <base_de_données> ne gère pas les commentaires sur les colonnes (db_comment).
• fields.E170 : la valeur par défaut de BinaryField ne peut pas être une chaîne. Utilisez plutôt un contenu binaire.
• fields.E180 : <base de données> ne prend pas en charge les champs JSONField.
• fields.E190 : <base_de_données> ne prend pas en charge les collations sur les colonnes <field_type>.
• fields.E900 : IPAddressField a été supprimé, sauf pour la prise en charge de migrations historiques.
• fields.W900 : IPAddressField est obsolète. Sa prise en charge (à l’exception des migrations historiques) sera supprimée dans Django 1.9. Ce contrôle apparaît dans Django 1.7 et 1.8.
• fields.W901 : CommaSeparatedIntegerField est obsolète. Sa prise en charge (à l’exception des migrations historiques) sera supprimée dans Django 2.0. Ce contrôle apparaît avec Django 1.10 et 1.11.
• fields.E901 : CommaSeparatedIntegerField a été supprimé, sauf pour la prise en charge de migrations historiques.
• fields.W902: FloatRangeField est obsolète et sera supprimé dans Django 3.1. Ce contrôle est apparu dans Django 2.2 et 3.0.
• fields.W903 : NullBooleanField est obsolète. Sa prise en charge (à l’exception des migrations historiques) sera supprimée dans Django 4.0. Ce contrôle apparaît dans Django 3.1 et 3.2.
• fields.E903 : NullBooleanField a été supprimé, sauf pour la prise en charge de migrations historiques.
• fields.W904 : django.contrib.postgres.fields.JSONField est obsolète. Sa prise en charge (à l’exception des migrations historiques) sera supprimée dans Django 4.0. Ce contrôle apparaît dans Django 3.1 et 3.2.
• fields.E904 : django.contrib.postgres.fields.JSONField a été supprimé, sauf pour la prise en charge de migrations historiques.
• fields.W905 : django.contrib.postgres.fields.CICharField est osbolète. Sa prise en charge (sauf pour les migrations historiques) sera supprimée dans Django 5.1.
• fields.W906 : django.contrib.postgres.fields.CIEmailField est obsolète. Sa prise en charge (à l’exception des migrations historiques) sera supprimée dans Django 5.1.
• fields.W907 : django.contrib.postgres.fields.CITextField est obsolète. Sa prise en charge (à l’exception des migrations historiques) sera supprimée dans Django 5.1.

Champs de type fichier

• fields.E200 : unique n’est pas un paramètre valable pour un champ FileField. Ce contrôle est supprimé dans Django 1.11.
• fields.E201 : primary_key n’est pas un paramètre valable pour un champ FileField.
• fields.E202 : le paramètre upload_to de FileField doit être un chemin relatif, et non absolu.
• fields.E210 : impossible d’utiliser ImageField car Pillow n’est pas installé.

Champs de liaison

• fields.E300 : le champ définit une relation avec le modèle <model>, qui n’est pas installé ou qui est abstrait.
• fields.E301 : le champ définit une relation avec le modèle <étiquette_app>.<modèle> qui a été substitué.
• fields.E302 : l’accesseur inverse <modèle lié>.<nom accesseur> pour <étiquette_app>.<modèle>.<nom champ> entre en conflit avec le nom du champ <étiquette_app>.<modèle>.<nom champ>.
• fields.E303 : le nom de requête inverse pour <étiquette_app>.<modèle>.<nom_de_champ> entre en conflit avec le nom du champ <étiquette_app>.<modèle>.<nom_de_champ>.
• fields.E304 : l’accesseur inverse <modèle lié>.<nom accesseur> pour <étiquette_app>.<modèle>.<nom champ> entre en conflit avec l’accesseur inverse pour <étiquette_app>.<modèle>.<nom champ>.
• fields.E305 : le nom de requête inverse de <étiquette_app>.<modèle>.<nom_de_champ> entre en conflit avec le nom de requête inverse de <étiquette_app>.<modèle>.<nom_de_champ>.
• fields.E306 : le nom <name> n’est pas un nom related_name valable pour le champ <modèle>.<nom_de_champ>.
• fields.E307 : le champ <étiquette_app>.<modèle>.<nom_de_champ> a été déclaré avec une référence différée à <étiquette_app>.<modèle>, mais l’application <étiquette_app> n’est pas installée ou ne fournit pas de modèle <modèle>.
• fields.E308 : le nom de requête inverse <nom_requête_inverse> ne doit pas se terminer par un soulignement.
• fields.E309 : le nom de requête inverse <nom_requête_inverse> ne doit pas contenir '__'.
• fields.E310 : aucun sous-ensemble des champs <champ1>, <champ2>, … du modèle <modèle> n’a de contrainte unique.
• fields.E311 : <modèle>.<nom de champ> doit être unique car il est référencé par une clé ForeignKey.
• fields.E312 : le paramètre to_field <nom_champ> n’existe pas dans le modèle lié <étiquette_app>.<modèle>.
• fields.E320 : le champ contient on_delete=SET_NULL mais il ne peut pas être nul.
• fields.E321 : le champ contient on_delete=SET_DEFAULT mais il n’a pas de valeur par défaut.
• fields.E330 : les champs ManyToManyField ne peuvent pas être uniques.
• fields.E331 : le champ définit une relation plusieurs-à-plusieurs via le modèle <modèle> qui n’a pas été installé.
• fields.E332 : les champs plusieurs-à-plusieurs avec des tables intermédiaires ne peuvent pas être symétriques. Ce contrôle est apparu avant Django 3.0.
• fields.E333 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il a plus de deux clés étrangères vers <modèle>, ce qui est ambigu. Vous devez indiquer laquelle des deux clés étrangères Django doit utiliser via le paramètre nommé through_fields.
• fields.E334 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il a plus d’une clé étrangère depuis <modèle>, ce qui est ambigu. Vous devez indiquer quelle clé étrangère Django doit utiliser via le paramètre nommé through_fields.
• fields.E335 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il a plus d’une clé étrangère vers <modèle>, ce qui est ambigu. Vous devez indiquer quelle clé étrangère Django doit utiliser via le paramètre nommé through_fields.
• fields.E336 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il n’a pas de clé étrangère vers <modèle> ou <modèle>.
• fields.E337 : le champ définit through_fields mais ne fournit pas le nom des deux champs de liaison qui doivent être utilisés pour la relation via <modèle>.
• fields.E338 : le modèle intermédiaire <through model> n’a pas de champ <nom_de_champ>.
• fields.E339 : <modèle>.<nom_de_champ> n’est pas une clé étrangère vers <modèle>.
• fields.E340 : la table intermédiaire du champ <nom table> entre en conflit avec le nom de la table de <modèle>/<modèle>.<nom champ>.
• fields.W340 : null n’a pas d’effet sur le champ ManyToManyField.
• fields.W341 : ManyToManyField ne prend pas en charge le paramètre validators.
• fields.W342 : la définition de unique=True sur un champ ForeignKey a le même effet que d’utiliser un champ OneToOneField.
• fields.W343 : limit_choices_to n’a aucun effet sur le champ ManyToManyField avec modèle intermédiaire. Ce contrôle est apparu avant Django 4.0.
• fields.W344 : la table intermédiaire du champ <nom table> entre en conflit avec le nom de la table de <modèle>/<modèle>.<nom champ>.
• fields.W345 : related_name n’a aucun effet sur le champ ManyToManyField avec une relation symétrique, par ex. vers self.
• fields.W346 : db_comment n’a aucun effet sur les champs ManyToManyField.

Modèles

• models.E001 : <swappable> n’est pas sous la forme étiquette_app.nom_app.
• models.E002 : <RÉGLAGE> fait référence à <modèle>, qui n’est pas installé ou qui est abstrait.
• models.E003 : le modèle possède deux relations plusieurs-à-plusieurs identiques via le modèle intermédiaire <étiquette_app>.<modèle>.
• models.E004 : id ne peut être utilisé comme nom de champ que si le champ définit aussi primary_key=True.
• models.E005 : le champ <nom_de_champ> du modèle parent <modèle> entre en conflit avec le champ <nom_de_champ> du modèle parent <modèle>.
• models.E006 : le champ <nom_de_champ> entre en conflit avec le champ <nom_de_champ> du modèle <modèle>.
• models.E007 : le champ <nom_de_champ> a le nom de colonne <nom_de_colonne> qui est utilisé par un autre champ.
• models.E008 : index_together doit être une liste ou un tuple.
• models.E009 : tous les éléments de index_together doivent être des listes ou des tuples.
• models.E010 : unique_together doit être une liste ou un tuple.
• models.E011: tous les éléments de unique_together doivent être des listes ou des tuples.
• models.E012 : contrainte/index/index_together/unique_together fait référence au champ inexistant <nom_de_champ>.
• models.E013 : contrainte/index/index_together/unique_together fait référence à un <nom_de_champ> de type ManyToManyField, mais ces champs ne sont pas pris en charge pour cette option.
• models.E014 : ordering doit être un tuple ou une liste (même si vous souhaitez trier sur un seul champ).
• models.E015 : ordering fait référence au champ, champ lié ou recherche inexistant <nom_de_champ>.
• models.E016 : contrainte/index/index_together/unique_together se réfèrent au champ <nom_de_champ> qui n’est pas local au modèle <modèle>.
• models.E017 : le modèle mandataire <modèle> contient des champs de modèle.
• models.E018 : nom de colonne auto-généré trop long pour le champ <champ>. La longueur maximale est de <longueur_maximum> pour la base de données <alias>.
• models.E019 : nom de colonne auto-généré trop long pour le champ plusieurs-à-plusieurs <champ>. La longueur maximale est de <longueur_maximum> pour la base de données <alias>.
• models.E020 : La méthode de classe <modèle>.check() est actuellement surchargée.
• models.E021 : ordering et order_with_respect_to ne peuvent pas être utilisés simultanément.
• models.E022 : <fonction> contient une référence différée à <étiquette_app>.<modèle>, mais l’application <étiquette_app> n’est pas installée ou ne fournit pas de modèle <modèle>.
• models.E023 : le nom de modèle <modèle> ne peut pas commencer ni se terminer par un soulignement car cela entre en conflit avec la syntaxe de requête.
• models.E024 : le nom de modèle <modèle> ne peut pas contenir de double soulignement car cela entre en conflit avec la syntaxe de requête.
• fields.E025 : la propriété <nom_de_propriété> entre en conflit avec un accesseur de champ lié.
• models.E026 : le modèle ne peut avoir plus d’un champ avec primary_key=True.
• models.W027: <base de données> ne prend pas en charge les contraintes de vérification.
• models.E028: db_table <table_bd> est utilisée par plusieurs modèles : <liste de modèles>.
• models.E029 : le nom d’index <index> n’est pas unique pour le modèle <modèle>.
• models.E030 : le nom d’index <index> n’est pas unique parmi les modèles : <liste_modèles>.
• models.E031 : le nom de contrainte <contrainte> n’est pas unique pour le modèle <modèle>.
• models.E032 : le nom de contrainte <contrainte> n’est pas unique parmi les modèles <liste_modèles>.
• models.E033 : le nom d’index <index> ne peut pas commencer par un soulignement, ni par un nombre.
• models.E034 : le nom d’index <index> ne peut pas dépasser <max_length> caractères.
• models.W035: db_table <table_bd> est utilisée par plusieurs modèles : <liste de modèles>.
• models.W036: <base de données> ne prend pas en charge les contraintes d’unicité avec conditions.
• models.W037: <base de données> ne prend pas en charge les index avec conditions.
• models.W038: <base de données> ne prend pas en charge les contraintes d’unicité différables.
• models.W039: <base de données> ne prend pas en charge les contraintes d’unicité avec des colonnes qui ne sont pas des clés.
• models.W040: <base de données> ne prend pas en charge les index avec des colonnes qui ne sont pas des clés.
• models.E041 : constraints fait référence au champ joint <nom_de_champ>.
• models.W042 : clé primaire créée automatiquement sans qu’un type de clé primaire ne soit défini, par défaut django.db.models.AutoField.
• models.W043: <base de données> ne prend pas en charge les index sur les expressions.
• models.W044: <base de données> ne prend pas en charge les contraintes d’unicité avec les expressions.
• models.W045 : la contrainte d’intégrité <contrainte> contient une expression RawSQL() et ne sera pas validée dans la méthode full_clean() du modèle.
• models.W046 : <database> ne prend pas en charge les commentaires sur les tables (db_table_comment).

Sécurité

Les contrôles de sécurité ne rendent pas votre site sûr. Ils n’auditent pas votre code, ne font pas de détection d’intrusion ou quoi que ce soit d’autre de particulièrement complexe. Ils s’occupent plutôt d’une liste de contrôles automatisés détectant les problèmes les plus évidents qui peuvent vous aider à améliorer la sécurité d’un site.

Certains de ces contrôles ne sont pas forcément adéquats pour votre configuration de déploiement particulière. Par exemple, si vous avez délégué la redirection HTTP vers HTTPS à un répartiteur de charge, il serait gênant d’être constamment averti que le réglage SECURE_SSL_REDIRECT n’est pas actif. Utilisez SILENCED_SYSTEM_CHECKS pour réduire au silence les contrôles non nécessaires.

Les contrôles suivants sont exécutés si l’option check --deploy est indiquée :

• security.W001 : l’intergiciel django.middleware.security.SecurityMiddleware ne figure pas dans MIDDLEWARE ce qui rendra ineffectif les réglages SECURE_HSTS_SECONDS, SECURE_CONTENT_TYPE_NOSNIFF, SECURE_REFERRER_POLICY, SECURE_CROSS_ORIGIN_OPENER_POLICY et SECURE_SSL_REDIRECT.
• security.W002 : l’intergiciel django.middleware.clickjacking.XFrameOptionsMiddleware ne figure pas dans MIDDLEWARE, ce qui fait que vos pages ne seront pas servies avec un en-tête 'x-frame-options'. Sauf dans les cas où il existe une bonne raison pour que votre site apparaisse dans un cadre, il est recommandé d’activer cet en-tête pour contribuer à prévenir les attaques par détournement de clic.
• security.W003 : il semble que vous n’utilisiez pas la protection intégrée de Django contre la falsification de requêtes inter-sites avec l’intergiciel dédié (django.middleware.csrf.CsrfViewMiddleware ne figure pas dans MIDDLEWARE). L’activation de l’intergiciel est l’approche la plus sûre pour s’assurer qu’aucun trou ne subsiste dans cette protection.
• security.W004 : vous n’avez pas défini de valeur pour le réglage SECURE_HSTS_SECONDS. Si tout votre site est entièrement servi par SSL, il est possible d’envisager définir une valeur et d’activer HSTS (HTTP Strict Transport Security). Mais prenez soin de lire premièrement la documentation ; l’activation précipitée de HSTS peut être la cause de problèmes sérieux et irréversibles.
• security.W005 : vous n’avez pas défini le réglage SECURE_HSTS_INCLUDE_SUBDOMAINS à True. Sans cela, votre site est potentiellement vulnérable à des attaques via une connexion non sécurisée à un sous-domaine. Ne choisissez la valeur True que si vous êtes sûr que tous les sous-domaines de votre domaine sont exclusivement servis par SSL.
• security.W006 : le réglage SECURE_CONTENT_TYPE_NOSNIFF n’est pas défini à True, ce qui fait que vos pages ne seront pas servies avec un en-tête 'X-Content-Type-Options: nosniff'. Vous devriez envisager d’activer cet en-tête pour empêcher les navigateurs d’identifier de manière incorrecte les types de contenu.
• security.W007 : le réglage SECURE_BROWSER_XSS_FILTER n’est pas défini à True, ce qui fait que vos pages ne seront pas servies avec un en-tête 'X-XSS-protection: 1; mode=block'. Vous devriez envisager d’activer cet en-tête pour activer le filtrage XSS des navigateurs et aider ainsi à prévenir les attaques XSS. Ce contrôle a été supprimé dans Django 3.0 car l’en-tête X-XSS-Protection n’est plus pris en compte par les navigateurs modernes.
• security.W008 : le réglage SECURE_SSL_REDIRECT n’est pas défini à True. Sauf si votre site doit être accessible à la fois par des connexions SSL et non SSL, il est conseillé de soit définir ce réglage à True, soit de configurer un répartiteur de charge ou un serveur mandataire inverse pour rediriger toutes les connexions vers HTTPS.
• security.W009 : la clé secrète SECRET_KEY contient moins de 50 caractères, moins de 5 caractères différents ou est préfixée par 'django-insecure-', ce qui indique qu’elle a été générée automatiquement par Django. Veuillez générer une valeur longue et aléatoire, faute de quoi de nombreuses fonctionnalités de Django liées à la sécurité seront vulnérables aux attaques.
• security.W010 : l’application django.contrib.sessions se trouve dans votre réglage INSTALLED_APPS mais vous n’avez pas défini SESSION_COOKIE_SECURE à True. L’utilisation d’un cookie de session sécurisé complique la tâche des renifleurs de trafic réseau quand ils essaient de s’immiscer dans les sessions des utilisateurs.
• security.W011 : django.contrib.sessions.middleware.SessionMiddleware figure dans MIDDLEWARE, mais vous n’avez pas défini SESSION_COOKIE_SECURE à True. L’utilisation d’un cookie de session sécurisé complique la tâche des renifleurs de trafic réseau quand ils essaient de s’immiscer dans les sessions des utilisateurs.
• security.W012 : SESSION_COOKIE_SECURE n’est pas défini à True. L’utilisation d’un cookie de session sécurisé complique la tâche des renifleurs de trafic réseau quand ils essaient de s’immiscer dans les sessions des utilisateurs.
• security.W013 : l’application django.contrib.sessions se trouve dans votre réglage INSTALLED_APPS mais vous n’avez pas défini SESSION_COOKIE_HTTPONLY à True. L’utilisation d’un cookie de session HttpOnly complique la tâche des attaques par script inter-site quand elles essaient de s’immiscer dans les sessions des utilisateurs.
• security.W014 : django.contrib.sessions.middleware.SessionMiddleware figure dans MIDDLEWARE, mais vous n’avez pas défini SESSION_COOKIE_HTTPONLY à True. L’utilisation d’un cookie de session HttpOnly complique la tâche des attaques par script inter-site quand elles essaient de s’immiscer dans les sessions des utilisateurs.
• security.W015 : SESSION_COOKIE_HTTPONLY n’est pas défini à True. L’utilisation d’un cookie de session HttpOnly complique la tâche des attaques par script inter-site quand elles essaient de s’immiscer dans les sessions des utilisateurs.
• security.W016 : CSRF_COOKIE_SECURE n’est pas défini à True. L’utilisation d’un cookie CSRF sécurisé complique la tâche des renifleurs de trafic réseau quand ils essaient de voler le jeton CSRF.
• security.W017 : CSRF_COOKIE_HTTPONLY n’est pas défini à True. L’utilisation d’un cookie CSRF HttpOnly complique la tâche des attaques par script inter-site quand elles essaient de voler le jeton CSRF. Ce contrôle est supprimé dans Django 1.11 car le réglage CSRF_COOKIE_HTTPONLY n’offre aucun bénéfice concret.
• security.W018 : le réglage DEBUG ne devrait pas être défini à True pour une application Django déployée.
• security.W019 : django.middleware.clickjacking.XFrameOptionsMiddleware figure dans MIDDLEWARE, mais X_FRAME_OPTIONS n’est pas défini à 'DENY'. Sauf dans les cas où un site a une bonne raison de servir certaines de ses parties dans un cadre, vous devriez modifier ce réglage à 'DENY'.
• security.W020 : le réglage ALLOWED_HOSTS ne peut pas être vide en déploiement.
• security.W021 : vous n’avez pas défini le réglage SECURE_HSTS_PRELOAD à True. Sans cela, votre site ne peut pas être proposé à la liste de préchargement des navigateurs.
• security.W022 : vous n’avez pas défini le réglage SECURE_REFERRER_POLICY. Sans cela, votre site n’enverra pas d’en-tête Referrer-Policy. Vous devriez envisager d’activer cet en-tête pour protéger la confidentialité des utilisateurs.
• security.E023 : la valeur contenue dans le réglage SECURE_REFERRER_POLICY n’est pas valable.
• security.E024 : la valeur contenue dans le réglage SECURE_CROSS_ORIGIN_OPENER_POLICY n’est pas valable.
• security.W025 : la clé SECRET_KEY_FALLBACKS[n] contient moins de 50 caractères, moins de 5 caractères différents ou est préfixée par 'django-insecure-', ce qui indique qu’elle a été générée automatiquement par Django. Veuillez générer une valeur longue et aléatoire, faute de quoi de nombreuses fonctionnalités de Django liées à la sécurité seront vulnérables aux attaques.

Les contrôles suivants vérifient que les réglages liés à la sécurité sont correctement configurés :

• security.E100 : DEFAULT_HASHING_ALGORITHM doit contenir 'sha1' ou 'sha256'. Ce contrôle est apparu dans Django 3.1 et 3.2.
• security.E101 : la vue d’échec CSRF chemin.vers.vue n’accepte pas le bon nombre d’arguments.
• security.E102 : la vue d’échec CSRF chemin.vers.vue n’a pas pu être importée.

Signaux

• signals.E001 : <gestionnaire> est connecté au signal <signal> avec une référence différée vers l’expéditeur <étiquette app>.<modèle>, mais <étiquette app> n’est pas installé ou ne fournit pas le modèle <modèle>.

Gabarits

Les contrôles suivants vérifient que le réglage TEMPLATES est configuré correctement :

• templates.E001 : 'APP_DIRS': True figure dans votre réglage TEMPLATES mais 'loaders' est aussi dans OPTIONS. Supprimez APP_DIRS ou l’option 'loaders'.
• templates.E002 : string_if_invalid dans TEMPLATES OPTIONS doit être une chaîne, mais c’est actuellement : {valeur} ({type}).
• templates.E003: <name> est utilisé pour plusieurs modules de balises de gabarits: <module list>. Ce contrôle a été modifié en templates.W003 dans Django 4.1.2.
• templates.W003 : <name> est utilisé pour plusieurs modules de balises de gabarits : <module list>.

Traduction

Les contrôles suivants sont effectués sur votre configuration de traduction :

• translation.E001: le réglage LANGUAGE_CODE contient une valeur non valide : <valeur>.
• translation.E002 : le code de langue contenu dans le réglage LANGUAGES n’est pas valable : <valeur>.
• translation.E003 : le code de langue contenu dans le réglage LANGUAGES_BIDI n’est pas valable : <valeur>.
• translation.E004: la valeur contenue dans le réglage LANGUAGE_CODE n’est pas présente dans le réglage LANGUAGES.

URL

Les contrôles suivants sont effectués sur votre configuration d’URL :

• urls.W001 : le motif d’URL <pattern> utilise include() avec une expression route se terminant par $. Enlevez le dollar de l’expression route pour éviter des problèmes lors de l’inclusion d’URL.
• urls.W002 : le motif d’URL <pattern> possède une expression route commençant par /. Enlevez cette barre oblique car elle n’est pas nécessaire. Si ce motif est référencé par un include(), vérifiez que le motif include() se termine par /.
• urls.W003 : le motif d’URL <pattern> possède un nom name contenant un :. Enlevez ces deux-points pour éviter des références d’espaces de noms ambigus.
• urls.E004 : le motif d’URL <motif> n’est pas valide. Vérifiez que urlpatterns est bien une liste d’instances path() ou re_path().
• urls.W005 : l’espace de noms d’URL <espace de nom> n’est pas unique. Il est possible que certains URL de cet espace de noms ne puissent pas être résolus.
• urls.E006 : les réglages MEDIA_URL/ STATIC_URL doivent se terminer par une barre oblique.
• urls.E007: la vue handlerXXX personnalisée 'chemin.vers.vue' ne prend pas le nombre correct de paramètres (…).
• urls.E008 : la vue handlerXXX personnalisée 'chemin.vers.vue' n’a pas pu être importée.
• urls.E009 : le motif d’URL <motif> possède un vue non valable, passez <vue>.as_view() au lieu de <vue>.

Contrôles des applications contrib

admin

Les contrôles de l’interface d’administration sont tous effectués sous l’étiquette admin.

Les contrôles suivants sont effectués sur toute classe (ou sous-classe de) ModelAdmin qui est inscrite auprès du site d’administration :

• admin.E001 : la valeur de raw_id_fields doit être une liste ou un tuple.
• admin.E002 : la valeur de raw_id_fields[n] fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E003 : la valeur de raw_id_fields[n] doit être une clé étrangère ou un champ plusieurs-à-plusieurs.
• admin.E004 : la valeur de fields doit être une liste ou un tuple.
• admin.E005 : fieldsets et fields sont tous deux spécifiés.
• admin.E006 : la valeur de fields contient des champs en double.
• admin.E007 : la valeur de fieldsets doit être une liste ou un tuple.
• admin.E008 : la valeur de fieldsets[n] doit être une liste ou un tuple.
• admin.E009 : la valeur de fieldsets[n] doit être de longueur 2.
• admin.E010 : la valeur de fieldsets[n][1] doit être un dictionnaire.
• admin.E011 : la valeur de fieldsets[n][1] doit contenir la clé fields.
• admin.E012 : il y a des champs en double dans fieldsets[n][1].
• admin.E013 : la valeur de fields[n]/fieldsets[n][m] ne peut pas inclure le champ ManyToManyField <nom_de_champ>, car ce champ définit manuellement un modèle de relation.
• admin.E014 : la valeur de exclude doit être une liste ou un tuple.
• admin.E015 : la valeur de exclude contient des champs en double.
• admin.E016 : la valeur de form doit hériter de BaseModelForm.
• admin.E017 : la valeur de filter_vertical doit être une liste ou un tuple.
• admin.E018 : la valeur de filter_horizontal doit être une liste ou un tuple.
• admin.E019 : la valeur de filter_vertical[n]/filter_horizontall[n] fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E020 : la valeur de filter_vertical[n]/filter_horizontal[n] doit être un champ plusieurs-à-plusieurs.
• admin.E021 : la valeur de radio_fields doit être un dictionnaire.
• admin.E022 : la valeur de radio_fields fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E023 : la valeur de radio_fields fait référence à <nom_de_champ>, qui n’est pas une instance de clé ForeignKey et n’a pas de définition choices.
• admin.E024 : la valeur de radio_fields[<nom_de_champ>] doit être soit admin.HORIZONTAL soit admin.VERTICAL.
• admin.E025 : la valeur de view_on_site doit être soit un objet exécutable, soit une valeur booléenne.
• admin.E026 : la valeur de prepopulated_fields doit être un dictionnaire.
• admin.E027 : la valeur de prepopulated_fields fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E028 : la valeur de prepopulated_fields fait référence à <nom_de_champ>, qui ne doit pas être un champ DateTimeField, ForeignKey, OneToOneField ni ManyToManyField.
• admin.E029 : la valeur de prepopulated_fields[<nom_de_champ>] doit être une liste ou un tuple.
• admin.E030 : la valeur de prepopulated_fields fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E031 : la valeur de ordering doit être une liste ou un tuple.
• admin.E032 : la valeur de ordering a le marqueur d’ordre aléatoire ?, mais contient aussi d’autres champs.
• admin.E033 : la valeur de ordering fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E034 : la valeur de readonly_fields doit être une liste ou un tuple.
• admin.E035: La valeur de readonly_fields[n] n’est pas appelable, un attribut de <ModelAdmin class>, ou un attribut de <model>.
• admin.E036 : la valeur de autocomplete_fields doit être une liste ou un tuple.
• admin.E037 : la valeur de autocomplete_fields[n] fait référence à <nom_de_champ>, qui n’est pas un champ de <modèle>.
• admin.E038 : la valeur de autocomplete_fields[n] doit être une clé étrangère ou un champ plusieurs-à-plusieurs.
• admin.E039 : une classe admin du modèle <modèle> doit être inscrite pour être référencée par <modeladmin>.autocomplete_fields.
• admin.E040 : <modeladmin> doit définir search_fields car il est référencé par <autre_modeladmin>.autocomplete_fields .

ModelAdmin

Les contrôles suivants sont effectués sur toute classes (ou sous-classe de) ModelAdmin qui est enregistrée auprès du site d’administration:

• admin.E101: La valeur de save_as doit être un booléen.
• admin.E102: La valeur de save_on_top doit être un booléen.
• admin.E103: La valeur de inlines doit être une liste ou un tuple.
• admin.E104 : <InlineModelAdmin class> doit hériter de InlineModelAdmin.
• admin.E105: <InlineModelAdmin class> doit avoir un attribut model.
• admin.E106: La valeur de <InlineModelAdmin class>.model doit être un Model.
• admin.E107: La valeur de list_display doit être une liste ou un tuple.
• admin.E108 : la valeur de list_display[n] fait référence à <label>, qui n’est pas un objet exécutable, un attribut de <classe ModelAdmin>, ni un attribut ou une méthode de <modèle>.
• admin.E109 : la valeur de list_display[n] ne peut pas être un champ ManyToManyField.
• admin.E110 : La valeur de list_display_links doit être une liste, un tuple ou None.
• admin.E111 : la valeur de list_display_links[n] fait référence à <label>, qui n’est pas défini dans list_display.
• admin.E112 : La valeur de list_filter doit être une liste ou un tuple.
• admin.E113 : la valeur de list_filter[n] doit hériter de ListFilter.
• admin.E114 : la valeur de list_filter[n] ne doit pas hériter de FieldListFilter.
• admin.E115 : la valeur de list_filter[n][1] doit hériter de FieldListFilter.
• admin.E116 : la valeur de list_filter[n] fait référence à <label>, qui ne fait pas référence à un champ Field.
• admin.E117 : la valeur de list_select_related doit être une valeur booléenne, un tuple ou une liste.
• admin.E118 : la valeur de list_per_page doit être un nombre entier.
• admin.E119 : la valeur de list_max_show_all doit être un nombre entier.
• admin.E120 : la valeur de list_editable doit être une liste ou un tuple.
• admin.E121 : la valeur de list_editable[n] fait référence à <label>, qui n’est pas un champ de <modèle>.
• admin.E122 : la valeur de list_editable[n] fait référence à <label>, qui ne figure pas dans list_display.
• admin.E123 : la valeur de list_editable[n] ne peut pas être à la fois dans list_editable et dans list_display_links.
• admin.E124 : la valeur de list_editable[n] fait référence au tout premier champ dans list_display (<label>), qui ne peut pas utilisé tant que list_display_links n’est pas défini.
• admin.E125 : la valeur de list_editable[n] fait référence à <nom_de_champ>, qui n’est pas modifiable dans l’interface d’administration.
• admin.E126 : La valeur de search_fields doit être une liste ou un tuple.
• admin.E127 : la valeur de date_hierarchy fait référence à <nom_de_champ>, qui ne se réfère pas à un champ.
• admin.E128 : la valeur de date_hierarchy doit être un champ DateField ou DateTimeField.
• admin.E129 : <modeladmin> doit définir une méthode has_<foo>_permission() pour l’action <action>.
• admin.E130 : les attributs __name__ des actions définies dans <modeladmin> doivent être uniques. Le nom <nom> n’est pas unique.

InlineModelAdmin

Les contrôles suivants sont effectués sur chaque InlineModelAdmin qui est inscrit comme élément intégré dans une classe ModelAdmin.

• admin.E201 : vous ne pouvez pas exclure le champ <nom_de_champ>, car il s’agit de la clé étrangère vers le modèle parent <étiquette_application>.<modèle>.
• admin.E202 : <modèle> n’a pas de clé ForeignKey vers <modèle parent>./ <modèle> `` a plus d'une clé ``ForeignKey vers <modèle parent>. Vous devez indiquer un attribut fk_name.
• admin.E203 : la valeur de extra doit être un nombre entier.
• admin.E204 : la valeur de max_num doit être un nombre entier.
• admin.E205 : la valeur de min_num doit être un nombre entier.
• admin.E206 : la valeur de formset doit hériter de BaseModelFormSet.

GenericInlineModelAdmin

Les contrôles suivants sont effectués sur chaque GenericInlineModelAdmin qui est inscrit comme élément intégré dans une classe ModelAdmin.

• admin.E301 : 'champ_ct' fait référence à <label>, qui n’est pas un champ de <modèle>.
• admin.E302 : 'champ_ct_fk' fait référence à <label>, qui n’est pas un champ de <modèle>.
• admin.E303 : <modèle> n’a pas de clé GenericForeignKey.
• admin.E304 : <modèle> n’a pas de clé GenericForeignKey utilisant le champ de type de contenu <nom_de_champ> et le champ d’identifiant d’objet <nom_de_champ>.

AdminSite

Les contrôles suivants sont effectués sur l’objet AdminSite par défaut :

• admin.E401 : django.contrib.contenttypes doit être dans INSTALLED_APPS pour pouvoir utiliser l’application d’administration.
• admin.E402 : django.contrib.auth.context_processors.auth doit être activé dans DjangoTemplates (TEMPLATES) si le moteur d’authentification par défaut est actif pour pouvoir utiliser l’application d’administration.
• admin.E403 : une instance de DjangoTemplates doit être configurée dans TEMPLATES pour pouvoir utiliser l’application d’administration.
• admin.E404 : django.contrib.messages.context_processors.messages doit être activé dans DjangoTemplates (TEMPLATES) pour pouvoir utiliser l’application d’administration.
• admin.E405 : django.contrib.auth doit être dans INSTALLED_APPS pour pouvoir utiliser l’application d’administration.
• admin.E406 : django.contrib.messages doit être dans INSTALLED_APPS pour pouvoir utiliser l’application d’administration.
• admin.E408 : django.contrib.auth.middleware.AuthenticationMiddleware doit être dans MIDDLEWARE pour pouvoir utiliser l’application d’administration.
• admin.E409 : django.contrib.messages.middleware.MessageMiddleware doit être dans MIDDLEWARE pour pouvoir utiliser l’application d’administration.
• admin.E410 : django.contrib.sessions.middleware.SessionMiddleware doit être dans MIDDLEWARE pour pouvoir utiliser l’application d’administration.
• admin.W411 : django.template.context_processors.request doit être activé dans DjangoTemplates (TEMPLATES) pour pouvoir utiliser le panneau latéral du site d’administration.

auth

• auth.E001 : REQUIRED_FIELDS doit être une liste ou un tuple.
• auth.E002 : le champ désigné en tant que USERNAME_FIELD pour un modèle utilisateur personnalisé ne doit pas être inclus dans REQUIRED_FIELDS.
• auth.E003 : <champ> doit être unique car il est désigné comme USERNAME_FIELD.
• auth.W004 : <champ> est désigné comme USERNAME_FIELD, mais il n’est pas unique.
• auth.E005 : le nom de code de permission <nom_code> entre en conflit avec une permission intégrée du modèle <modèle>.
• auth.E006 : le nom de code de permission <nom_code> est à double pour le modèle <modèle>.
• auth.E007 : l’attribut verbose_name du modèle <modèle> ne doit pas dépasser 244 caractères pour que ses noms de permissions automatiques ne dépassent pas 255 caractères.
• auth.E008 : la permission nommée <nom> du modèle <modèle> est plus longue que 255 caractères.
• auth.C009 : <modèle utilisateur>.is_anonymous doit être un attribut ou une propriété plutôt qu’une méthode. Il s’agit d’un problème de sécurité car avec une méthode, les utilisateurs anonymes seront considérés comme authentifiés !
• auth.C010 : <modèle utilisateur>.is_authenticated doit être un attribut ou une propriété plutôt qu’une méthode. Il s’agit d’un problème de sécurité car avec une méthode, les utilisateurs anonymes seront considérés comme authentifiés !
• auth.E011 : le nom du modèle <modèle> ne doit pas dépasser 93 caractères pour que ses noms de permissions automatiques ne dépassent pas 100 caractères.
• auth.E012 : la permission avec nom de code <nom_code> du modèle <modèle> est plus longue que 100 caractères.

contenttypes

Les contrôles suivants sont effectués quand un modèle contient une clé GenericForeignKey ou une relation GenericRelation:

• contenttypes.E001 : l’ID d’objet GenericForeignKey fait référence au champ <field> qui n’existe pas.
• contenttypes.E002 : le type de contenu GenericForeignKey fait référence au champ <field> inexistant.
• contenttypes.E003 : <champ> n’est pas une clé ForeignKey.
• contenttypes.E004 : <field> n’est pas une ForeignKey vers contenttypes.ContentType.
• contenttypes.E005 : les noms de modèles ne peuvent pas dépasser 100 caractères.

postgres

Les contrôles suivants s’appliquent aux champs de modèle django.contrib.postgres:

• postgres.E001 : le champ de base du tableau comporte des erreurs : …
• postgres.E001 : le champ de base du tableau ne peut pas être un champ de relation.
• postgres.E003 : la valeur par défaut de <champ> doit être un objet exécutable plutôt qu’une instance afin qu’elle ne soit pas partagée entre toutes les instances de ce champ. Ce contrôle a été modifié en fields.E010 dans Django 3.1.
• postgres.W004: le champ de base du tableau génère des avertissements : …

sites

Les contrôles suivants sont effectués sur chaque modèle utilisant un gestionnaire CurrentSiteManager:

• sites.E001 : CurrentSiteManager n’a pas réussi à trouver un champ nommé <nom_de_champ>.
• sites.E002 : CurrentSiteManager ne peut pas utiliser <champ> car ce n’est pas une clé étrangère ni un champ plusieurs-à-plusieurs.

Les contrôles suivants vérifient que django.contrib.sites est configuré correctement :

• sites.E101 : le réglage SITE_ID doit être un nombre entier.

staticfiles

Les contrôles suivants vérifient que django.contrib.staticfiles est configuré correctement :

• staticfiles.E001 : le réglage STATICFILES_DIRS n’est pas un tuple ni une liste.
• staticfiles.E002 : le réglage STATICFILES_DIRS ne doit pas contenir le réglage STATIC_ROOT.
• staticfiles.E003 : le préfixe <préfixe> dans le réglage STATICFILES_DIRS ne peut pas se terminer par une barre oblique.
• staticfiles.W004 : le répertoire <répertoire> dans le réglage STATICFILES_DIRS n’existe pas.