--- title: "O framework de verificação do sistema." version: 4.2 locale: pt-br source: https://docs.djangoproject.com/pt-br/4.2/ref/checks/ canonical: https://djangodocs.dev/pt-br/4.2/ref/checks/ --- # O framework de verificação do sistema. O framework de verificação do sistema é um conjunto de verificações estáticas para validação de projetos Django. Ele detecta problemas comuns e fornece dicas de como arrumá-los. O framework é extensível e você pode facilmente adicionar suas próprias validações. Para detalhes de como adicionar suas próprias verificações e integrar isso com os sistema de verificação do Django, veja o [Tópico sistema de verificação do giua.](/pt-br/4.2/topics/checks/). ## Referência da API ### `CheckMessage` #### `class CheckMessage(level, msg, hint=None, obj=None, id=None)` Os alertas e erros emitidos pelo sistema de verificação devem ser uma instância de `CheckMessage`. Uma instância encapsula um único erro ou aviso. Ele também fornece contexto e dicas aplicáveia a mensagem, e um identificador único que é usado para propósitos de filtragem. Os argumentos do Construtor são: **`level`** A gravidade da mensagem. Use um dos valores pré-definidos: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`. Se o nível é maior ou igual a ```ERROR`, então o Django irá impedir que comandos de gerenciamento sejam exeutados. Mensagens com nível menor que ``ERROR``` (ex. alertas) são reportados no console, mas pode ser silenciados. **`msg`** Uma string curta (menor que 80 caracetres) descrevendo o problema. A string não deve conter outras linhas. **`hint`** Uma string de uma única linha que forneça uma dica para arrumar o problema. Se não pode ser fornecida uma dica, ou a dica é auto-evidente baseado na mensagem de erro, a dica pode ser omitida, ou o valor `None` pode ser usado. **`obj`** Opcional. Um objeto que fornece contexto para a mensagem (por exemplo, o modelo onde o problema foi descoberto). O objeto deve ser um modelo, campo ou gerenciador ou qualquer outro objeto que defina um método `__str__()`. O método é usado durante a exibição de todas as mensagens e seu resultado precede a mensagem. **`id`** String opcional. Um identificador único para esse problema. Identificadores devem seguir o formato padrão `applabel.X001`, onde `X` é uma das letras de `CEWID`, indicando a gravidade da mensagem (`C` para crítico, `E` para erro e assim por diante). O número pode ser alocado pela aplicação, mas deve ser único dentro daquela aplicação. Existem subclasses para tornar a criação de mensagens de níveis comuns mais fácil. Quando usá-los você pode omitir o argumento `level` porque ele está implícito no nome da 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)` ## Tags embutidas As verificações do sistema do Django estão organizadas usando as seguintes tags: - `admin`: verifica qualquer declarações do “admin site”. - async\_support: Verifica a configuração relacionada a assincronia. - `caches`: Verifica configuração relacionada a cache. - `compatibility`: Indica potenciais problemas com atualizações da versão. - `database`: Verifica problemas de configuração relacionados ao banco de dados. As verificações do banco de dados não são executadas por padrão porque elas fazem mais do que a análise de código estático, como as verificações regulares. Elas só são executadas pelo comando [`migrate`](/pt-br/4.2/ref/django-admin/#django-admin-migrate) ou se você especificar os aliases de banco de dados configurados usando a opção `--database` ao chamar o comando [`check`](/pt-br/4.2/ref/django-admin/#django-admin-check). - `files`: Verifica as configurações relacionadas a arquivos. - `models`: Verificações de definições de modelos, campos e gerenciadores. - `security`: verifica configurações relacionadas com segurança. - `signals`: verifica sobre declarações de “signals” e com o registro dos manipuladores. - `sites`: Verifica a configuração do :mod:django.contrib.sites. - `staticfiles`: Verifica a configuração do [`django.contrib.staticfiles`](/pt-br/4.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles). - `templates`: verifica configuração relacionadas a templates. - `translation`: Verifica a configuração relacionada à tradução. - `urls`: verifica a configuração da URL. Algumas verificações talvez sejam registradas com múltiplas tags. ## Verificações do núcleo do sistema ### Suporte assíncrono As seguintes checagens verificarão seu setup para [Suporte assíncrono](/pt-br/4.2/topics/async/): - **async.E001**: Você não deve definir a variável de ambiente [`DJANGO_ALLOW_ASYNC_UNSAFE`](/pt-br/4.2/topics/async/#envvar-DJANGO_ALLOW_ASYNC_UNSAFE) em produção. Isso desabilita a [proteção de segurança assíncrona](/pt-br/4.2/topics/async/#async-safety). ### Retrocompatibilidade Testes de compatibilidade notificam sobre problemas que podem ocorrer após atualizar o Django. - **2\_0.W001**: Sua URL `` tem um `route` que contém `(?P<`, começa com um `^` ou termina com um `$`. Isso provavelmente foi um descuido ao migrar de `url()` para [`path()`](/pt-br/4.2/ref/urls/#django.urls.path). - **4\_0.E001**: A partir do Django 4.0, os valores na configuração [`CSRF_TRUSTED_ORIGINS`](/pt-br/4.2/ref/settings/#std-setting-CSRF_TRUSTED_ORIGINS) devem começar com um esquema (geralmente `http://` ou `https://`), mas foi encontrado ``. ### Caches As verificações seguintes averiguam se seu [`CACHES`](/pt-br/4.2/ref/settings/#std-setting-CACHES) está configurado corretamente: - **caches.E001**: Você deve definir um cache `'default'` para a definição de [`CACHES`](/pt-br/4.2/ref/settings/#std-setting-CACHES). - **caches.W002**: Sua configuração `` pode expor o seu cache ou levar à corrupção dos seus dados porque a `LOCATION` \ coincide/está dentro/contém a [`MEDIA_ROOT`](/pt-br/4.2/ref/settings/#std-setting-MEDIA_ROOT)/[`STATIC_ROOT`](/pt-br/4.2/ref/settings/#std-setting-STATIC_ROOT)/[`STATICFILES_DIRS`](/pt-br/4.2/ref/settings/#std-setting-STATICFILES_DIRS). - **caches.W003**: Your `` cache [`LOCATION`](/pt-br/4.2/ref/settings/#std-setting-CACHES-LOCATION) is relative. Use an absolute path instead. ### Banco de dados #### MySQL e MariaDB If you’re using MySQL or MariaDB, the following checks will be performed: - **mysql.E001**: MySQL/MariaDB does not allow unique `CharField`s to have a `max_length` \> 255. *This check was changed to* `mysql.W003` *in Django 3.1 as the real maximum size depends on many factors.* - **mysql.W002**: MySQL/MariaDB Strict Mode is not set for database connection ``. See also [Setting sql\_mode](/pt-br/4.2/ref/databases/#mysql-sql-mode). - **mysql.W003**: MySQL/MariaDB may not allow unique `CharField`s to have a `max_length` \> 255. ### Gerenciando arquivos The following checks verify your setup for [Gerenciando arquivos](/pt-br/4.2/topics/files/): - **files.E001**: The [`FILE_UPLOAD_TEMP_DIR`](/pt-br/4.2/ref/settings/#std-setting-FILE_UPLOAD_TEMP_DIR) setting refers to the nonexistent directory ``. ### Campos Modelos - **fields.E001**: Nomes de campos não devem terminar com “underscore”. - **fields.E002**: nome de campos não devem conter `"__"`. - **fields.E003**: `pk` é uma palavra reservada que não pode ser usada como nome de campo. - **fields.E004**: `choices` deve ser um iterável (ex.:uma lista de tuplas). - **fields.E005**: `choices` must be an iterable containing `(actual value, human readable name)` tuples. - **fields.E006**: `db_index` deve ser `None`, `True` ou `False`. - **fields.E007**: Chaves-primárias não devem ter `null=True`. - **fields.E008**: All `validators` must be callable. - **fields.E009**: `max_length` is too small to fit the longest value in `choices` (`` characters). - **fields.E010**: `` default should be a callable instead of an instance so that it’s not shared between all field instances. - **fields.E100**: `AutoField`s devem setar primary\_key=True. - **fields.E110**: `BooleanField`s do not accept null values. *This check appeared before support for null values was added in Django 2.1.* - **fields.E120**: `CharField`s deve definir um atributo `max_length`. - **fields.E121**: `max_length` deve ser um inteiro positivo. - **fields.W122**: `max_length` is ignored when used with ``. - **fields.E130**: `DecimalField`s deve definir um atributo `decimal_places`. - **fields.E131**: `decimal_places` deve ser um inteiro não negativo. - **fields.E132**: `DecimalField`s deve ter um atributo `max_digits`. - **fields.E133**: `max_digits` must be a positive integer. - **fields.E134**: `max_digits` deve ser igual ou maior que `decimal_places`. - **fields.E140**: `FilePathField`s deve ter `allow_files` ou `allow_folders` definidos como True. - **fields.E150**: `GenericIPAddressField`s cannot have `blank=True` if `null=False`, as blank values are stored as nulls. - **fields.E160**: As opções `auto_now`, `auto_now_add`, e `default` são mutualmente exclusivas. Somente uma destas opções deve estar presente. - **fields.W161**: Fornecido um valor fixo padrão. - **fields.W162**: `` does not support a database index on `` columns. - **fields.W163**: `` does not support comments on columns (`db_comment`). - **fields.E170**: `BinaryField`’s `default` cannot be a string. Use bytes content instead. - **fields.E180**: `` does not support `JSONField`s. - **fields.E190**: `` does not support a database collation on ``s. - **fields.E900**: `IPAddressField` foi removido exceto para suportar migrações históricas. - **fields.W900**: `IPAddressField` está obsoleto. O suporte para este (exceto para histórico de migrações) será removido no Django 1.9. *Esta verificação apareceu em Django 1.7 and 1.8*. - **fields.W901**: `CommaSeparatedIntegerField` has been deprecated. Support for it (except in historical migrations) will be removed in Django 2.0. *This check appeared in Django 1.10 and 1.11*. - **fields.E901**: `CommaSeparatedIntegerField` is removed except for support in historical migrations. - **fields.W902**: `FloatRangeField` is deprecated and will be removed in Django 3.1. *This check appeared in Django 2.2 and 3.0*. - **fields.W903**: `NullBooleanField` is deprecated. Support for it (except in historical migrations) will be removed in Django 4.0. *This check appeared in Django 3.1 and 3.2*. - **fields.E903**: `NullBooleanField` is removed except for support in historical migrations. - **fields.W904**: `django.contrib.postgres.fields.JSONField` is deprecated. Support for it (except in historical migrations) will be removed in Django 4.0. *This check appeared in Django 3.1 and 3.2*. - **fields.E904**: `django.contrib.postgres.fields.JSONField` is removed except for support in historical migrations. - **fields.W905**: `django.contrib.postgres.fields.CICharField` is deprecated. Support for it (except in historical migrations) will be removed in Django 5.1. - **fields.W906**: `django.contrib.postgres.fields.CIEmailField` is deprecated. Support for it (except in historical migrations) will be removed in Django 5.1. - **fields.W907**: `django.contrib.postgres.fields.CITextField` is deprecated. Support for it (except in historical migrations) will be removed in Django 5.1. #### Campos de Arquivo - **fields.E200**: `unique` não é um argumento válido para `FileField`. *Esta verificação foi removida no Django 1.11*. - **fields.E201**: `primary_key` não é um argumento válido para um `FileField`. - **fields.E202**: `FileField`’s `upload_to` argument must be a relative path, not an absolute path. - **fields.E210**: Não é possível usar `ImageField` porque o Pillow não está instalado. #### Campos relacionados - **fields.E300**: Campo define uma relação com o modelo ``, o qual ou não está instalado, ou é abstrato. - **fields.E301**: Field defines a relation with the model `.` which has been swapped out. - **fields.E302**: Reverse accessor `.` for `..` clashes with field name `..`. - **fields.E303**: Reverse query name for `..` clashes with field name `..`. - **fields.E304**: Reverse accessor `.` for `..` clashes with reverse accessor for `..`. - **fields.E305**: Reverse query name for `..` clashes with reverse query name for `..`. - **fields.E306**: The name `` is invalid `related_name` for field `.`. - **fields.E307**: O campo `..` foi declarado com uma referência “lazy” para `.`, mas a aplicação `` não está instalada ou não fornece o modelo ``. - **fields.E308**: Reverse query name `` must not end with an underscore. - **fields.E309**: Reverse query name `` must not contain `'__'`. - **fields.E310**: No subset of the fields ``, ``, … on model `` is unique. - **fields.E311**: `.` must be unique because it is referenced by a `ForeignKey`. - **fields.E312**: The `to_field` `` doesn’t exist on the related model `.`. - **fields.E320**: Campo especifica `on_delete=SET_NULL`, mas não pode ser nulo. - **fields.E321**: O campo especifíca `on_delete=SET_DEFAULT`, mas não tem um valor padrão. - **fields.E330**: `ManyToManyField`s não pode ser único. - **fields.E331**: O campo especifíca uma relação como muitos-para-muitos através do modelo ``, o qual não foi instalado. - **fields.E332**: Many-to-many fields with intermediate tables must not be symmetrical. *This check appeared before Django 3.0.* - **fields.E333**: O modelo é usado como um modelo intermediário pelo ``, mas este tem mais de duas chaves estrangeiras para ``, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento `through_fields`. - **fields.E334**: O modelo é usado como um modelo intermediário pelo ``, mas este tem mais de uma chave estrangeira para ``, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento `through_fields`. - **fields.E335**: O modelo é usado como um modelo intermediário pelo ``, mas este tem mais de uma chave estrangeira para ``, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento `through_fields`. - **fields.E336**: O modelo é usado como um modelo intermediário pelo ``, mas este não tem uma chave-estrangeira para `` ou ``. - **fields.E337**: O campo especifíca `through_fields` mas não fornece os nomes dos dois campos de ligação que deve ser usados para a relação através do ``. - **fields.E338**: O modelo intermediário `` não tem o campo ``. - **fields.E339**: `.` não é uma chave estrangeira para ``. - **fields.E340**: The field’s intermediary table `` clashes with the table name of ``/`.`. - **fields.W340**: `null` não tem efeito no `ManyToManyField`. - **fields.W341**: `ManyToManyField` não dá suporte para `validators`. - **fields.W342**: Definir `unique=True` para uma `ForeignKey` tem o mesmo efeito quanto usar um `OneToOneField`. - **fields.W343**: `limit_choices_to` has no effect on `ManyToManyField` with a `through` model. *This check appeared before Django 4.0.* - **fields.W344**: The field’s intermediary table `
` clashes with the table name of ``/`.`. - **fields.W345**: `related_name` has no effect on `ManyToManyField` with a symmetrical relationship, e.g. to “self”. - **fields.W346**: `db_comment` has no effect on `ManyToManyField`. ### Models - **models.E001**: `` não está no formato `app_label.app_name`. - **models.E002**: `` referencia ``, o qual nao foi instalado, ou é abstrato. - **models.E003**: The model has two identical many-to-many relations through the intermediate model `.`. - **models.E004**: `id` somente pode ser usado como nome de um campo se o campo também definir `primary_key=True`. - **models.E005**: O campo `` do modelo pai `` colide com o campo `` do modelo pai ``. - **models.E006**: The field `` clashes with the field `` from model ``. - **models.E007**: Campo `` tem o nome de coluna `` que é usado por outro campo. - **models.E008**: `index_together` deve ser uma lista de tuplas. - **models.E009**: Todos os elementos `index_together` devem ser uma lista de tuplas. - **models.E010**: `unique_together` deve ser uma lista de tuplas. - **models.E011**: Todos os elementos de `unique_together` devem ser uma lista de tuplas. - **models.E012**: `constraints/indexes/index_together/unique_together` refers to the nonexistent field ``. - **models.E013**: `constraints/indexes/index_together/unique_together` refers to a `ManyToManyField` ``, but `ManyToManyField`s are not supported for that option. - **models.E014**: `ordering` deve ser uma tupla ou listat (mesmo que você queira ordernar por um único campo). - **models.E015**: `ordering` refers to the nonexistent field, related field, or lookup ``. - **models.E016**: `constraints/indexes/index_together/unique_together` refers to field `` which is not local to model ``. - **models.E017**: O modelo proxy `` cotém campos de modelo. - **models.E018**: Nome de coluna gerado automaticamente é muito longo para o campo ``. O comprimento máximo é `` para o banco de dados ``. - **models.E019**: Nome de campo gerado automaticamente para o campo M2M `` é muito longo. O comprimento máximo é `` para o banco de dados ``. - **models.E020**: The `.check()` método da classe está neste momento sobrescrito. - **models.E021**: `ordering` e `order_with_respect_to` não podem ser usados juntos. - **models.E022**: `` contains a lazy reference to `.`, but app `` isn’t installed or doesn’t provide model ``. - **models.E023**: The model name `` cannot start or end with an underscore as it collides with the query lookup syntax. - **models.E024**: The model name `` cannot contain double underscores as it collides with the query lookup syntax. - **models.E025**: The property `` clashes with a related field accessor. - **models.E026**: The model cannot have more than one field with `primary_key=True`. - **models.W027**: `` does not support check constraints. - **models.E028**: `db_table` `` is used by multiple models: ``. - **models.E029**: index name `` is not unique for model ``. - **models.E030**: index name `` is not unique among models: ``. - **models.E031**: constraint name `` is not unique for model ``. - **models.E032**: constraint name `` is not unique among models: ``. - **models.E033**: The index name `` cannot start with an underscore or a number. - **models.E034**: The index name `` cannot be longer than `` characters. - **models.W035**: `db_table` `` is used by multiple models: ``. - **models.W036**: `` does not support unique constraints with conditions. - **models.W037**: `` does not support indexes with conditions. - **models.W038**: `` does not support deferrable unique constraints. - **models.W039**: `` does not support unique constraints with non-key columns. - **models.W040**: `` does not support indexes with non-key columns. - **models.E041**: `constraints` refers to the joined field ``. - **models.W042**: Auto-created primary key used when not defining a primary key type, by default `django.db.models.AutoField`. - **models.W043**: `` does not support indexes on expressions. - **models.W044**: `` does not support unique constraints on expressions. - **models.W045**: Check constraint `` contains `RawSQL()` expression and won’t be validated during the model `full_clean()`. - **models.W046**: `` does not support comments on tables (`db_table_comment`). ### Segurança The security checks do not make your site secure. They do not audit code, do intrusion detection, or do anything particularly complex. Rather, they help perform an automated, low-hanging-fruit checklist, that can help you to improve your site’s security. Algumas dessas verificações talvez não sejam apropriadas para uma configuração de implantação particular. Por exemlo, se você faz redirecionamento do HTTP para HTTPS em um balanceador de carga, isso pode ser irritante de ser constantemente alertado sobre não ter habilitado o [`SECURE_SSL_REDIRECT`](/pt-br/4.2/ref/settings/#std-setting-SECURE_SSL_REDIRECT). Use o [`SILENCED_SYSTEM_CHECKS`](/pt-br/4.2/ref/settings/#std-setting-SILENCED_SYSTEM_CHECKS) para silenciar verificações desnecessárias. As seguintes verificações são executadas se você usa a opção [`check --deploy`](/pt-br/4.2/ref/django-admin/#cmdoption-check-deploy): - **security.W001**: You do not have [`django.middleware.security.SecurityMiddleware`](/pt-br/4.2/ref/middleware/#django.middleware.security.SecurityMiddleware) in your [`MIDDLEWARE`](/pt-br/4.2/ref/settings/#std-setting-MIDDLEWARE) so the [`SECURE_HSTS_SECONDS`](/pt-br/4.2/ref/settings/#std-setting-SECURE_HSTS_SECONDS), [`SECURE_CONTENT_TYPE_NOSNIFF`](/pt-br/4.2/ref/settings/#std-setting-SECURE_CONTENT_TYPE_NOSNIFF), [`SECURE_REFERRER_POLICY`](/pt-br/4.2/ref/settings/#std-setting-SECURE_REFERRER_POLICY), [`SECURE_CROSS_ORIGIN_OPENER_POLICY`](/pt-br/4.2/ref/settings/#std-setting-SECURE_CROSS_ORIGIN_OPENER_POLICY), and [`SECURE_SSL_REDIRECT`](/pt-br/4.2/ref/settings/#std-setting-SECURE_SSL_REDIRECT) settings will have no effect. - **security.W002**: You do not have [`django.middleware.clickjacking.XFrameOptionsMiddleware`](/pt-br/4.2/ref/middleware/#django.middleware.clickjacking.XFrameOptionsMiddleware) in your [`MIDDLEWARE`](/pt-br/4.2/ref/settings/#std-setting-MIDDLEWARE), so your pages will not be served with an `'x-frame-options'` header. Unless there is a good reason for your site to be served in a frame, you should consider enabling this header to help prevent clickjacking attacks. - **security.W003**: You don’t appear to be using Django’s built-in cross-site request forgery protection via the middleware ([`django.middleware.csrf.CsrfViewMiddleware`](/pt-br/4.2/ref/middleware/#django.middleware.csrf.CsrfViewMiddleware) is not in your [`MIDDLEWARE`](/pt-br/4.2/ref/settings/#std-setting-MIDDLEWARE)). Enabling the middleware is the safest approach to ensure you don’t leave any holes. - **security.W004**: Você não definiu um valor para a definição de [`SECURE_HSTS_SECONDS`](/pt-br/4.2/ref/settings/#std-setting-SECURE_HSTS_SECONDS). Se todo o seu site é servido via SSL, talvez queira considerar definir o valor e habilitar [HTTP Strict Transport Security](/pt-br/4.2/ref/middleware/#http-strict-transport-security). Tenha certeza de ler a documentação primeiro; habilitando HSTS sem cuidados você pode causar problema sérios e irreversíveis. - **security.W005**: Você não definiu a definição de [`SECURE_HSTS_INCLUDE_SUBDOMAINS`](/pt-br/4.2/ref/settings/#std-setting-SECURE_HSTS_INCLUDE_SUBDOMAINS) para `True`. Sem isso, seu site está pontencialmente vulnerável a ataques através de uma conexão insegura para um subdomínio. Somente definica como `True` se você está certo de que todos os subdomínios do seu domínio devem ser servidos exclusivamente via SSL. - **security.W006**: Your [`SECURE_CONTENT_TYPE_NOSNIFF`](/pt-br/4.2/ref/settings/#std-setting-SECURE_CONTENT_TYPE_NOSNIFF) setting is not set to `True`, so your pages will not be served with an `'X-Content-Type-Options: nosniff'` header. You should consider enabling this header to prevent the browser from identifying content types incorrectly. - **security.W007**: Your `SECURE_BROWSER_XSS_FILTER` setting is not set to `True`, so your pages will not be served with an `'X-XSS-Protection: 1; mode=block'` header. You should consider enabling this header to activate the browser’s XSS filtering and help prevent XSS attacks. *This check is removed in Django 3.0 as the* `X-XSS-Protection` *header is no longer honored by modern browsers.* - **security.W008**: Sua definição para [`SECURE_SSL_REDIRECT`](/pt-br/4.2/ref/settings/#std-setting-SECURE_SSL_REDIRECT) não é `True`. A menos que seu site deva estar disponível tanto para conexões SSL quanto para não SSL, você talvez queira definir este como `True` ou configurar o balanceador de carga ou o servidor de proxy reverso para redirecionar todas as conexões para HTTPS. - **security.W009**: Your [`SECRET_KEY`](/pt-br/4.2/ref/settings/#std-setting-SECRET_KEY) has less than 50 characters, less than 5 unique characters, or it’s prefixed with `'django-insecure-'` indicating that it was generated automatically by Django. Please generate a long and random value, otherwise many of Django’s security-critical features will be vulnerable to attack. - **security.W010**: Você tem [`django.contrib.sessions`](/pt-br/4.2/topics/http/sessions/#module-django.contrib.sessions) no seu [`INSTALLED_APPS`](/pt-br/4.2/ref/settings/#std-setting-INSTALLED_APPS) mas não definiu [`SESSION_COOKIE_SECURE`](/pt-br/4.2/ref/settings/#std-setting-SESSION_COOKIE_SECURE) como `True`. Usando uma “cookie” de sessão “somente-segura” é mais difícil para um “sniffer” de tráfego de rede capturar sessões do usuário. - **security.W011**: You have [`django.contrib.sessions.middleware.SessionMiddleware`](/pt-br/4.2/ref/middleware/#django.contrib.sessions.middleware.SessionMiddleware) in your [`MIDDLEWARE`](/pt-br/4.2/ref/settings/#std-setting-MIDDLEWARE), but you have not set [`SESSION_COOKIE_SECURE`](/pt-br/4.2/ref/settings/#std-setting-SESSION_COOKIE_SECURE) to `True`. Using a secure-only session cookie makes it more difficult for network traffic sniffers to hijack user sessions. - **security.W012**: [`SESSION_COOKIE_SECURE`](/pt-br/4.2/ref/settings/#std-setting-SESSION_COOKIE_SECURE) não é `True`. Usando uma “cookie” de sessão como “somente-segura” é mais difícil para um “sniffer” de tráfego de rede capturar sessões do usuário. - **security.W013**: Você [`django.contrib.sessions`](/pt-br/4.2/topics/http/sessions/#module-django.contrib.sessions) no seu [`INSTALLED_APPS`](/pt-br/4.2/ref/settings/#std-setting-INSTALLED_APPS), mas não definiu [`SESSION_COOKIE_HTTPONLY`](/pt-br/4.2/ref/settings/#std-setting-SESSION_COOKIE_HTTPONLY) como `True`. Usando uma “cookie” de sessão `HttpOnly` faz com que seja mais difícil um ataque de script extra-site capturar sessões de usuários. - **security.W014**: You have [`django.contrib.sessions.middleware.SessionMiddleware`](/pt-br/4.2/ref/middleware/#django.contrib.sessions.middleware.SessionMiddleware) in your [`MIDDLEWARE`](/pt-br/4.2/ref/settings/#std-setting-MIDDLEWARE), but you have not set [`SESSION_COOKIE_HTTPONLY`](/pt-br/4.2/ref/settings/#std-setting-SESSION_COOKIE_HTTPONLY) to `True`. Using an `HttpOnly` session cookie makes it more difficult for cross-site scripting attacks to hijack user sessions. - **security.W015**: [`SESSION_COOKIE_HTTPONLY`](/pt-br/4.2/ref/settings/#std-setting-SESSION_COOKIE_HTTPONLY) não está definido como `True`. Usando uma cookie de sessão como `HttpOnly` torna mais difícil um ataque de script extra-site capturar sessões de usuários. - **security.W016**: [`CSRF_COOKIE_SECURE`](/pt-br/4.2/ref/settings/#std-setting-CSRF_COOKIE_SECURE) não está como `True`. Usando a “secure-only” para a “cookie” CSRF torna mais difícil para um “sniffer” de tráfego de rede roubar o token CSRF. - **security.W017**: [`CSRF_COOKIE_HTTPONLY`](/pt-br/4.2/ref/settings/#std-setting-CSRF_COOKIE_HTTPONLY) is not set to `True`. Using an `HttpOnly` CSRF cookie makes it more difficult for cross-site scripting attacks to steal the CSRF token. *This check is removed in Django 1.11 as the* [`CSRF_COOKIE_HTTPONLY`](/pt-br/4.2/ref/settings/#std-setting-CSRF_COOKIE_HTTPONLY) *setting offers no practical benefit.* - **security.W018**: Você não deve definir [`DEBUG`](/pt-br/4.2/ref/settings/#std-setting-DEBUG) como `True` em produção. - **security.W019**: You have [`django.middleware.clickjacking.XFrameOptionsMiddleware`](/pt-br/4.2/ref/middleware/#django.middleware.clickjacking.XFrameOptionsMiddleware) in your [`MIDDLEWARE`](/pt-br/4.2/ref/settings/#std-setting-MIDDLEWARE), but [`X_FRAME_OPTIONS`](/pt-br/4.2/ref/settings/#std-setting-X_FRAME_OPTIONS) is not set to `'DENY'`. Unless there is a good reason for your site to serve other parts of itself in a frame, you should change it to `'DENY'`. - **security.W020**: [`ALLOWED_HOSTS`](/pt-br/4.2/ref/settings/#std-setting-ALLOWED_HOSTS) não deve estar vazio durante a implantação. - **security.W021**: You have not set the [`SECURE_HSTS_PRELOAD`](/pt-br/4.2/ref/settings/#std-setting-SECURE_HSTS_PRELOAD) setting to `True`. Without this, your site cannot be submitted to the browser preload list. - **security.W022**: You have not set the [`SECURE_REFERRER_POLICY`](/pt-br/4.2/ref/settings/#std-setting-SECURE_REFERRER_POLICY) setting. Without this, your site will not send a Referrer-Policy header. You should consider enabling this header to protect user privacy. - **security.E023**: You have set the [`SECURE_REFERRER_POLICY`](/pt-br/4.2/ref/settings/#std-setting-SECURE_REFERRER_POLICY) setting to an invalid value. - **security.E024**: You have set the [`SECURE_CROSS_ORIGIN_OPENER_POLICY`](/pt-br/4.2/ref/settings/#std-setting-SECURE_CROSS_ORIGIN_OPENER_POLICY) setting to an invalid value. - **security.W025**: Your [`SECRET_KEY_FALLBACKS[n]`](/pt-br/4.2/ref/settings/#std-setting-SECRET_KEY_FALLBACKS) has less than 50 characters, less than 5 unique characters, or it’s prefixed with `'django-insecure-'` indicating that it was generated automatically by Django. Please generate a long and random value, otherwise many of Django’s security-critical features will be vulnerable to attack. The following checks verify that your security-related settings are correctly configured: - **security.E100**: `DEFAULT_HASHING_ALGORITHM` must be `'sha1'` or `'sha256'`. *This check appeared in Django 3.1 and 3.2*. - **security.E101**: The CSRF failure view `'path.to.view'` does not take the correct number of arguments. - **security.E102**: The CSRF failure view `'path.to.view'` could not be imported. ### Signals - **signals.E001**: `` was connected to the `` signal with a lazy reference to the sender `.`, but app `` isn’t installed or doesn’t provide model ``. ### Templates As verificações seguintes averiguam se sua definição de [`TEMPLATES`](/pt-br/4.2/ref/settings/#std-setting-TEMPLATES) está corretamente configurada. - **templates.E001**: Você tem `'APP_DIRS': True` no seu [`TEMPLATES`](/pt-br/4.2/ref/settings/#std-setting-TEMPLATES) mas também especifica o `'loaders'` nas `OPTIONS`. Ou remova o `APP_DIRS` ou a opção `'loaders'`. - **templates.E002**: `string_if_invalid` in [`TEMPLATES`](/pt-br/4.2/ref/settings/#std-setting-TEMPLATES) [`OPTIONS`](/pt-br/4.2/ref/settings/#std-setting-TEMPLATES-OPTIONS) must be a string but got: `{value}` (`{type}`). - **templates.E003**:`` is used for multiple template tag modules: ``. *This check was changed to* `templates.W003` *in Django 4.1.2*. - **templates.W003**:`` is used for multiple template tag modules: ``. ### Translation The following checks are performed on your translation configuration: - **translation.E001**: You have provided an invalid value for the [`LANGUAGE_CODE`](/pt-br/4.2/ref/settings/#std-setting-LANGUAGE_CODE) setting: ``. - **translation.E002**: You have provided an invalid language code in the [`LANGUAGES`](/pt-br/4.2/ref/settings/#std-setting-LANGUAGES) setting: ``. - **translation.E003**: You have provided an invalid language code in the [`LANGUAGES_BIDI`](/pt-br/4.2/ref/settings/#std-setting-LANGUAGES_BIDI) setting: ``. - **translation.E004**: You have provided a value for the [`LANGUAGE_CODE`](/pt-br/4.2/ref/settings/#std-setting-LANGUAGE_CODE) setting that is not in the [`LANGUAGES`](/pt-br/4.2/ref/settings/#std-setting-LANGUAGES) setting. ### URLs As verificações seguintes são realizadas na sua configuração de URL: - **urls.W001**: Your URL pattern `` uses [`include()`](/pt-br/4.2/ref/urls/#django.urls.include) with a `route` ending with a `$`. Remove the dollar from the `route` to avoid problems including URLs. - **urls.W002**: Your URL pattern `` has a `route` beginning with a `/`. Remove this slash as it is unnecessary. If this pattern is targeted in an [`include()`](/pt-br/4.2/ref/urls/#django.urls.include), ensure the [`include()`](/pt-br/4.2/ref/urls/#django.urls.include) pattern has a trailing `/`. - **urls.W003**: Seu formato padrão de `` tem um `name` incluindo um `:`. Remova os dois-pontos para evitar referências anbíguas de domínios baseados em nomes. - **urls.E004**: Your URL pattern `` is invalid. Ensure that `urlpatterns` is a list of [`path()`](/pt-br/4.2/ref/urls/#django.urls.path) and/or [`re_path()`](/pt-br/4.2/ref/urls/#django.urls.re_path) instances. - **urls.W005**: URL namespace `` isn’t unique. You may not be able to reverse all URLs in this namespace. - **urls.E006**: The [`MEDIA_URL`](/pt-br/4.2/ref/settings/#std-setting-MEDIA_URL)/ [`STATIC_URL`](/pt-br/4.2/ref/settings/#std-setting-STATIC_URL) setting must end with a slash. - **urls.E007**: The custom `handlerXXX` view `'path.to.view'` does not take the correct number of arguments (…). - **urls.E008**: The custom `handlerXXX` view `'path.to.view'` could not be imported. - **urls.E009**: Your URL pattern `` has an invalid view, pass `.as_view()` instead of ``. ## `contrib` app checks ### `admin` Verificações do Admin são todas realizadas como parte da etiqueta `admin`. As seguintes verificações sào realizadas em qualquer [`ModelAdmin`](/pt-br/4.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin) (ou subclasse) que está registrada com o site Admin: - **admin.E001**: O valor de `raw_id_fields` deve ser uma lista de tuplas. - **admin.E002**: The value of `raw_id_fields[n]` refers to ``, which is not a field of ``. - **admin.E003**: O valor de `raw_id_fields[n]` deve ser uma chave estrangeira ou m campo muitos-para-muitos. - **admin.E004**: O valor do `fields` deve ser uma lista de tuplas. - **admin.E005**: Ambos `fieldsets` e `fields` são especificados. - **admin.E006**: O valor do `fields` contém campo(s) duplicados. - **admin.E007**: O valor do `fieldsets` deve ser uma lista de tuplas. - **admin.E008**: O valor do `fieldsets[n]` deve ser uma lista de tuplas. - **admin.E009**: O valor do `fieldsets[n]` deve ter o comprimento igual a 2. - **admin.E010**: O valor do `fieldsets[n][1]` deve ser um dicionário. - **admin.E011**: O valor do `fieldsets[n][1]` deve conter a chave `fields`. - **admin.E012**: Existem campo(s) ducplicados em `fieldsets[n][1]`. - **admin.E013**: The value of `fields[n]/fieldsets[n][m]` cannot include the `ManyToManyField` ``, because that field manually specifies a relationship model. - **admin.E014**: O valor do `exclude` deve ser uma lista de tuplas. - **admin.E015**: O valor do `exclude` contém campos duplicado(s). - **admin.E016**: O valor do `form` deve herdar de `BaseModelForm`. - **admin.E017**: O valor do `filter_vertical` deve ser uma lista de tuplas. - **admin.E018**: O valor de `filter_horizontal` deve ser uma lista de tuplas. - **admin.E019**: The value of `filter_vertical[n]/filter_horizontal[n]` refers to ``, which is not a field of ``. - **admin.E020**: The value of `filter_vertical[n]/filter_horizontal[n]` must be a many-to-many field. - **admin.E021**: O valor de `radio_fields` deve ser um dicionário. - **admin.E022**: The value of `radio_fields` refers to ``, which is not a field of ``. - **admin.E023**: The value of `radio_fields` refers to ``, which is not an instance of `ForeignKey`, and does not have a `choices` definition. - **admin.E024**: O valor de `radio_fields[]` deve ser `admin.HORIZONTAL` ou `admin.VERTICAL`. - **admin.E025**: O valor de `view_on_site` deve ser um “callable” ou um booleano. - **admin.E026**: O valor de `prepopulated_fields` deve ser um dicionário. - **admin.E027**: The value of `prepopulated_fields` refers to ``, which is not a field of ``. - **admin.E028**: The value of `prepopulated_fields` refers to ``, which must not be a `DateTimeField`, a `ForeignKey`, a `OneToOneField`, or a `ManyToManyField` field. - **admin.E029**: O valor de `prepopulated_fields[]` deve ser uma lista de tuplas. - **admin.E030**: The value of `prepopulated_fields` refers to ``, which is not a field of ``. - **admin.E031**: O valor de `ordering` deve ser uma lista de tuplas. - **admin.E032**: O valor de `ordering` tem o operador para ordem randômica `?`, mas contém outros campos também. - **admin.E033**: The value of `ordering` refers to ``, which is not a field of ``. - **admin.E034**: O valor de `readonly_fields` deve ser uma lista de tuplas. - **admin.E035**: O valor de `readonly_fields[n]` não é um “callable”, um atributo da ``, ou um atributo do ``. - **admin.E036**: The value of `autocomplete_fields` must be a list or tuple. - **admin.E037**: The value of `autocomplete_fields[n]` refers to ``, which is not a field of ``. - **admin.E038**: The value of `autocomplete_fields[n]` must be a foreign key or a many-to-many field. - **admin.E039**: An admin for model `` has to be registered to be referenced by `.autocomplete_fields`. - **admin.E040**: `` must define `search_fields`, because it’s referenced by `.autocomplete_fields`. #### `ModelAdmin` A verificações seguintes são realizadas para qualquer [`ModelAdmin`](/pt-br/4.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin) que é registrada com site Admin: - **admin.E101**: O valor de `save_as` deve ser um booleano. - **admin.E102**: O valor de `save_on_top` deve ser um booleano. - **admin.E103**: O valor de `inlines` deve ser uma lista de tuplas. - **admin.E104**: `` must inherit from `InlineModelAdmin`. - **admin.E105**: `` deve ter um atributo `model`. - **admin.E106**: O valor de `.model` deve ser um `Model`. - **admin.E107**: O valor de `list_display` deve ser uma lista de tuplas. - **admin.E108**: O valor de `list_display[n]` referencia a `