Referência rápida sobre cabeçalhos de segurança

Saiba mais sobre os cabeçalhos que podem manter seu site seguro e confira rapidamente os detalhes mais importantes.

Neste artigo, listamos os cabeçalhos de segurança mais importantes que você pode usar para proteger seu site. Use-o para entender os recursos de segurança baseados na Web, aprender a implementá-los no seu site e como referência para quando precisar de um lembrete.

Cabeçalhos de segurança recomendados para sites que processam dados sensíveis do usuário:
Política de Segurança de Conteúdo (CSP)
Tipos confiáveis
Cabeçalhos de segurança recomendados para todos os sites:
X-Content-Type-Options
X-Frame-Options
Política de recursos entre origens (CORP)
Política de abertura entre origens (COOP)
HTTP Strict Transport Security (HSTS)
Cabeçalhos de segurança para sites com recursos avançados:
Compartilhamento de recursos entre origens (CORS)
Política de incorporação entre origens (COEP)
Ameaças conhecidas na Web
Antes de falar sobre os cabeçalhos de segurança, aprenda mais sobre as ameaças conhecidas na Web e por que você usaria esses cabeçalhos de segurança.

Antes de aprender mais sobre os cabeçalhos de segurança, saiba mais sobre as ameaças conhecidas na Web e por que você deve usar esses cabeçalhos.

Proteja seu site contra vulnerabilidades de injeção

As vulnerabilidades de injeção surgem quando dados não confiáveis processados pelo aplicativo podem afetar o comportamento dele e, geralmente, levar à execução de scripts controlados por invasores. A vulnerabilidade mais comum causada por bugs de injeção é o scripting em vários sites (XSS) em suas várias formas, incluindo XSS refletido, XSS armazenado, XSS baseado em DOM e outras variantes.

Uma vulnerabilidade de XSS normalmente pode dar a um invasor acesso completo aos dados do usuário processados pelo aplicativo e a qualquer outra informação hospedada na mesma origem da Web.

As defesas tradicionais contra injeções incluem o uso consistente de sistemas de modelos HTML de escape automático, evitando o uso de APIs JavaScript perigosas e processando corretamente os dados do usuário hospedando uploads de arquivos em um domínio separado e limpando o HTML controlado pelo usuário.

  • Use a Política de Segurança de Conteúdo (CSP) para controlar quais scripts podem ser executados pelo aplicativo para reduzir o risco de injeções.
  • Use Tipos confiáveis para aplicar a limpeza de dados transmitidos para APIs JavaScript perigosas.
  • Use X-Content-Type-Options para evitar que o navegador interprete incorretamente os tipos MIME dos recursos do seu site, o que pode levar à execução de scripts.

Isolar seu site de outros sites

A abertura da Web permite que os sites interajam entre si de maneiras que podem violar as expectativas de segurança de um aplicativo. Isso inclui fazer solicitações autenticadas inesperadamente ou incorporar dados de outro aplicativo no documento do invasor, permitindo que ele modifique ou leia dados do aplicativo.

As vulnerabilidades comuns que prejudicam o isolamento da Web incluem roubo de cliques, falsificação de solicitação entre sites (CSRF), inclusão de script entre sites (XSSI) e vários vazamentos entre sites.

Desenvolvimento Web pós-Spectre é uma ótima leitura se você tiver interesse nesses cabeçalhos.

Crie um site poderoso com segurança

O Spectre coloca todos os dados carregados no mesmo grupo de contexto de navegação potencialmente legível, apesar da política de mesma origem. Os navegadores restringem recursos que podem explorar a vulnerabilidade por trás de um ambiente especial chamado "isolamento de origem cruzada". Com o isolamento de origem cruzada, é possível usar recursos avançados, como SharedArrayBuffer.

Criptografar o tráfego para seu site

Os problemas de criptografia aparecem quando um aplicativo não criptografa totalmente os dados em trânsito, permitindo que invasores de interceptação conheçam as interações do usuário com o aplicativo.

A criptografia insuficiente pode surgir nos seguintes casos: não usar HTTPS, conteúdo misto, definir cookies sem o atributo Secure (ou o prefixo __Secure) ou lógica de validação de CORS frouxa.

Política de Segurança de Conteúdo (CSP)

O scripting em vários sites (XSS) é um ataque em que uma vulnerabilidade em um site permite que um script malicioso seja injetado e executado.

Content-Security-Policy fornece uma camada extra para mitigar ataques de XSS, restringindo quais scripts podem ser executados pela página.

Recomendamos que você ative a CSP estrita usando uma das seguintes abordagens:

  • Se você renderizar suas páginas HTML no servidor, use uma CSP rigorosa com base em valor de uso único.
  • Se o HTML precisar ser veiculado de forma estática ou armazenado em cache, por exemplo, se for um aplicativo de página única, use uma CSP estrita baseada em hash.

Exemplo de uso: uma CSP baseada em valor de uso único

Content-Security-Policy:
  script-src 'nonce-{RANDOM1}' 'strict-dynamic' https: 'unsafe-inline';
  object-src 'none';
  base-uri 'none';
Como usar a CSP

1. Usar uma CSP estrita baseada em valor de uso único {: #nonce-based-csp}

Se você renderizar suas páginas HTML no servidor, use uma CSP rigorosa com base em valor de uso único.

Gere um novo valor de valor de uso único de script para cada solicitação no lado do servidor e defina o seguinte cabeçalho:

arquivo de configuração do servidor

Content-Security-Policy:
  script-src 'nonce-{RANDOM1}' 'strict-dynamic' https: 'unsafe-inline';
  object-src 'none';
  base-uri 'none';

Em HTML, para carregar os scripts, defina o atributo nonce de todas as tags <script> como a mesma string {RANDOM1}.

index.html

<script nonce="{RANDOM1}" src="https://example.com/script1.js"></script>
<script nonce="{RANDOM1}">
  // Inline scripts can be used with the <code>nonce</code> attribute.
</script>

O Google Fotos é um bom exemplo de CSP rigorosa com base em valor de uso único. Use o DevTools para ver como ele é usado.

2. Usar uma CSP estrita baseada em hash {: #hash-based-csp}

Se o HTML precisar ser veiculado de forma estática ou armazenado em cache, por exemplo, se você estiver criando um aplicativo de página única, use uma CSP estrita baseada em hash.

arquivo de configuração do servidor

Content-Security-Policy:
  script-src 'sha256-{HASH1}' 'sha256-{HASH2}' 'strict-dynamic' https: 'unsafe-inline';
  object-src 'none';
  base-uri 'none';

No HTML, é necessário incorporar os scripts para aplicar uma política baseada em hash, porque a maioria dos navegadores não é compatível com o hash de scripts externos.

index.html

<script>
...// your script1, inlined
</script>
<script>
...// your script2, inlined
</script>

Para carregar scripts externos, leia "Carregar scripts de origem dinamicamente" na seção Opção B: cabeçalho de resposta da CSP com base em hash.

O CSP Evaluator é uma boa ferramenta para avaliar sua CSP, mas também um bom exemplo de CSP estrita baseada em valor de uso único. Use o DevTools para ver como ele é usado.

Navegadores compatíveis

Outras observações sobre a CSP

  • A diretiva frame-ancestors protege seu site contra clickjacking, um risco que surge se você permitir que sites não confiáveis incorporem o seu. Se preferir uma solução mais simples, use X-Frame-Options para bloquear o carregamento, mas frame-ancestors oferece uma configuração avançada para permitir apenas origens específicas como incorporadores.
  • Talvez você tenha usado uma CSP para garantir que todos os recursos do seu site sejam carregados por HTTPS. Isso se tornou menos relevante: hoje em dia, a maioria dos navegadores bloqueia conteúdo misto.
  • Também é possível definir uma CSP no modo somente relatório.
  • Se não for possível definir uma CSP como um cabeçalho do lado do servidor, você também poderá defini-la como uma metatag. Não é possível usar o modo somente relatório para metatags, mas isso pode mudar.

Saiba mais

Tipos confiáveis

O XSS baseado em DOM é um ataque em que dados maliciosos são transmitidos para um coletor que oferece suporte à execução de código dinâmico, como eval() ou .innerHTML.

Os Tipos Confiáveis oferecem as ferramentas para escrever, analisar a segurança e manter aplicativos livres de DOM XSS. Eles podem ser ativados pela CSP e tornam o código JavaScript seguro por padrão, limitando as APIs da Web perigosas para aceitar apenas um objeto especial: um tipo confiável.

Para criar esses objetos, é possível definir políticas de segurança que garantem que as regras de segurança (como escape ou limpeza) sejam aplicadas de forma consistente antes que os dados sejam gravados no DOM. Essas políticas são os únicos lugares no código que podem introduzir o DOM XSS.

Exemplos de uso

Content-Security-Policy: require-trusted-types-for 'script'
// Feature detection
if (window.trustedTypes && trustedTypes.createPolicy) {
  // Name and create a policy
  const policy = trustedTypes.createPolicy('escapePolicy', {
    createHTML: str => {
      return str.replace(/\</g, '&lt;').replace(/>/g, '&gt;');
    }
  });
}

// Assignment of raw strings is blocked by Trusted Types.
el.innerHTML = &#39;some string&#39;; // This throws an exception.

// Assignment of Trusted Types is accepted safely.
const escaped = policy.createHTML(&#39;&lt;img src=x onerror=alert(1)&gt;&#39;);
el.innerHTML = escaped;  // &#39;&amp;lt;img src=x onerror=alert(1)&amp;gt;&#39;

Como usar os Trusted Types

  1. Aplicar Tipos Confiáveis para coletores de DOM perigosos Cabeçalho de CSP e Tipos Confiáveis:

    Content-Security-Policy: require-trusted-types-for 'script'

    No momento, 'script' é o único valor aceitável para a diretiva require-trusted-types-for.

    É claro que você pode combinar os Tipos confiáveis com outras diretivas de CSP:

Mesclando uma CSP baseada em nonce acima com Tipos Confiáveis:

Content-Security-Policy:
  script-src &#39;nonce-{RANDOM1}&#39; &#39;strict-dynamic&#39; https: &#39;unsafe-inline&#39;;
  object-src &#39;none&#39;;
  base-uri &#39;none&#39;;
  require-trusted-types-for &#39;script&#39;;

<aside class="note"><b>Observação</b>: é possível limitar os nomes de política de Tipos confiáveis permitidos definindo uma diretiva <code>trusted-types</code> adicional (por exemplo, <code>trusted-types myPolicy</code>). No entanto, isso não é obrigatório. </aside>

  1. Definir uma política

    Política:

    // Feature detection
    if (window.trustedTypes && trustedTypes.createPolicy) {
      // Name and create a policy
      const policy = trustedTypes.createPolicy('escapePolicy', {
        createHTML: str => {
          return str.replace(/\/g, '>');
        }
      });
    }
  2. Aplique a política:

    Use a política ao gravar dados no DOM:

    // Assignment of raw strings are blocked by Trusted Types.
    el.innerHTML = &#39;some string&#39;; // This throws an exception.</p>
    
    <p>// Assignment of Trusted Types is accepted safely.
    const escaped = policy.createHTML(&#39;<img src="x" onerror="alert(1)">&#39;);
    el.innerHTML = escaped;  // &#39;&lt;img src=x onerror=alert(1)&gt;&#39;

    Com o require-trusted-types-for 'script', o uso de um tipo confiável é um requisito. O uso de qualquer API DOM perigosa com uma string vai resultar em um erro.

Navegadores compatíveis

Saiba mais

X-Content-Type-Options

Quando um documento HTML mal-intencionado é veiculado no seu domínio (por exemplo, se uma imagem enviada para um serviço de fotos contém uma marcação HTML válida), alguns navegadores o tratam como um documento ativo e permitem que ele execute scripts no contexto do aplicativo, levando a um bug de scripting em vários sites.

X-Content-Type-Options: nosniff impede isso instruindo o navegador que o tipo MIME definido no cabeçalho Content-Type para uma determinada resposta está correto. Esse cabeçalho é recomendado para todos os seus recursos.

Exemplo de uso

X-Content-Type-Options: nosniff
Como usar X-Content-Type-Options

X-Content-Type-Options: nosniff é recomendado para todos os recursos veiculados pelo seu servidor, junto com o cabeçalho Content-Type correto.

X-Content-Type-Options: nosniff

Exemplo de cabeçalhos enviados com um HTML de documento

X-Content-Type-Options: nosniff
Content-Type: text/html; charset=utf-8

Navegadores compatíveis

Browser Support

  • Chrome: 64.
  • Edge: 12.
  • Firefox: 50.
  • Safari: 11.

Source

Saiba mais

X-Frame-Options

Se um site mal-intencionado puder incorporar seu site como um iframe, isso pode permitir que invasores invoquem ações não intencionais do usuário com clickjacking. Além disso, em alguns casos, os ataques do tipo Spectre dão aos sites maliciosos a chance de saber mais sobre o conteúdo de um documento incorporado.

X-Frame-Options indica se um navegador pode ou não renderizar uma página em um <frame>, <iframe>, <embed> ou <object>. Recomendamos que todos os documentos enviem esse cabeçalho para indicar se permitem ser incorporados por outros documentos.

Exemplo de uso

X-Frame-Options: DENY
Como usar X-Frame-Options

Todos os documentos que não foram projetados para serem incorporados precisam usar o cabeçalho X-Frame-Options.

Protege seu site contra incorporação por outros sites.

Negar a incorporação por qualquer outro documento.

X-Frame-Options: DENY
X-Frame-Options: DENY

Protege seu site contra incorporação por sites entre origens.

Permitir a incorporação apenas por documentos da mesma origem.

X-Frame-Options: SAMEORIGIN

Navegadores compatíveis

Browser Support

  • Chrome: 4.
  • Edge: 12.
  • Firefox: 4.
  • Safari: 4.

Source

Saiba mais

Política de recursos entre origens (CORP)

Um invasor pode incorporar recursos de outra origem, por exemplo, do seu site, para saber informações sobre eles explorando vazamentos entre sites baseados na Web.

O Cross-Origin-Resource-Policy reduz esse risco indicando o conjunto de sites que podem carregá-lo. O cabeçalho usa um de três valores: same-origin, same-site e cross-origin. Recomendamos que todos os recursos enviem esse cabeçalho para indicar se permitem o carregamento por outros sites.

Exemplo de uso

Cross-Origin-Resource-Policy: same-origin
Como usar o CORP

Recomendamos que todos os recursos sejam disponibilizados com um dos três cabeçalhos a seguir.

Permitir que os recursos sejam carregados cross-origin

É recomendável que serviços semelhantes a CDNs apliquem cross-origin aos recursos (já que geralmente são carregados por páginas entre origens), a menos que já sejam veiculados pelo CORS, que tem um efeito semelhante.

Cross-Origin-Resource-Policy: cross-origin
Cross-Origin-Resource-Policy: cross-origin

Limitar os recursos a serem carregados do same-origin

same-origin precisa ser aplicado a recursos que devem ser carregados apenas por páginas de mesma origem. Aplique isso a recursos que incluem informações sensíveis sobre o usuário ou respostas de uma API que deve ser chamada apenas da mesma origem.

Os recursos com esse cabeçalho ainda podem ser carregados diretamente, por exemplo, acessando o URL em uma nova janela do navegador. A política de recursos entre origens apenas protege o recurso contra incorporação por outros sites.

Cross-Origin-Resource-Policy: same-origin
Cross-Origin-Resource-Policy: same-origin

Limitar os recursos a serem carregados do same-site

Recomendamos aplicar same-site a recursos semelhantes aos acima, mas que devem ser carregados por outros subdomínios do seu site.

Cross-Origin-Resource-Policy: same-site
Cross-Origin-Resource-Policy: same-site

Navegadores compatíveis

Browser Support

  • Chrome: 73.
  • Edge: 79.
  • Firefox: 74.
  • Safari: 12.

Source

Saiba mais

Política de abertura entre origens (COOP)

O site de um invasor pode abrir outro site em uma janela pop-up para saber informações sobre ele, explorando vazamentos entre sites baseados na Web. Em alguns casos, isso também pode permitir a exploração de ataques de canal lateral com base no Spectre.

O cabeçalho Cross-Origin-Opener-Policy permite que um documento se isole de janelas entre origens abertas por window.open() ou um link com target="_blank" sem rel="noopener". Como resultado, qualquer abridor de origem cruzada do documento não terá referência a ele e não poderá interagir com ele.

Exemplo de uso

Cross-Origin-Opener-Policy: same-origin-allow-popups
Como usar o COOP

Isolar um documento de janelas entre origens

A configuração same-origin isola o documento das janelas de documentos entre origens.

Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Opener-Policy: same-origin

Isolar um documento de janelas entre origens, mas permitir pop-ups

Definir same-origin-allow-popups permite que um documento mantenha uma referência às janelas pop-up, a menos que elas definam COOP com same-origin ou same-origin-allow-popups. Isso significa que o same-origin-allow-popups ainda pode proteger o documento de ser referenciado quando aberto como uma janela pop-up, mas permitir que ele se comunique com os próprios pop-ups.

Cross-Origin-Opener-Policy: same-origin-allow-popups
Cross-Origin-Opener-Policy: same-origin-allow-popups

Permitir que um documento seja referenciado por janelas entre origens

unsafe-none é o valor padrão, mas é possível indicar explicitamente que esse documento pode ser aberto por uma janela de origem cruzada e manter o acesso mútuo.

Cross-Origin-Opener-Policy: unsafe-none
Cross-Origin-Opener-Policy: unsafe-none

Denunciar padrões incompatíveis com COOP

Você pode receber relatórios quando a COOP impede interações entre janelas com a API Reporting.

Cross-Origin-Opener-Policy: same-origin; report-to="coop"

A COOP também é compatível com um modo somente relatório para que você possa receber relatórios sem bloquear a comunicação entre documentos de origens diferentes.

Cross-Origin-Opener-Policy-Report-Only: same-origin; report-to="coop"

Navegadores compatíveis

Browser Support

  • Chrome: 83.
  • Edge: 83.
  • Firefox: 79.
  • Safari: 15.2.

Source

Saiba mais

Compartilhamento de recursos entre origens (CORS, na sigla em inglês)

Ao contrário de outros itens neste artigo, o Compartilhamento de recursos entre origens (CORS) não é um cabeçalho, mas um mecanismo de navegador que solicita e permite o acesso a recursos entre origens.

Por padrão, os navegadores aplicam a política de mesma origem para impedir que uma página da Web acesse recursos entre origens. Por exemplo, quando uma imagem entre origens é carregada, mesmo que seja exibida visualmente na página da Web, o JavaScript na página não tem acesso aos dados da imagem. O provedor de recursos pode flexibilizar as restrições e permitir que outros sites leiam o recurso ao ativar o CORS.

Exemplo de uso

Access-Control-Allow-Origin: https://example.com
Access-Control-Allow-Credentials: true
Como usar o CORS

Antes de analisar como configurar o CORS, é útil entender a distinção entre os tipos de solicitação. Dependendo dos detalhes, uma solicitação será classificada como simples ou pré-vôo.

Critérios para uma solicitação simples:

  • O método é GET, HEAD ou POST.
  • Os cabeçalhos personalizados incluem apenas Accept, Accept-Language, Content-Language e Content-Type.
  • O Content-Type é application/x-www-form-urlencoded, multipart/form-data ou text/plain.

Todo o restante é classificado como uma solicitação de simulação. Para mais detalhes, confira Compartilhamento de recursos entre origens (CORS) - HTTP | MDN.

Solicitação simples

Quando uma solicitação atende aos critérios de solicitação simples, o navegador envia uma solicitação entre origens com um cabeçalho Origin que indica a origem da solicitação.

Exemplo de cabeçalho da solicitação

Get / HTTP/1.1
Origin: https://example.com

Exemplo de cabeçalho de resposta

Access-Control-Allow-Origin: https://example.com
Access-Control-Allow-Credentials: true
  • Access-Control-Allow-Origin: https://example.com indica que o https://example.com pode acessar o conteúdo da resposta. Os recursos que podem ser lidos por qualquer site podem definir esse cabeçalho como *. Nesse caso, o navegador só vai exigir que a solicitação seja feita sem credenciais.
  • Access-Control-Allow-Credentials: true indica que as solicitações que carregam credenciais (cookies) podem carregar o recurso. Caso contrário, as solicitações autenticadas serão rejeitadas, mesmo que a origem da solicitação esteja presente no cabeçalho Access-Control-Allow-Origin.

Solicitações de simulação

Uma solicitação de simulação é precedida por uma solicitação OPTIONS para verificar se a solicitação subsequente pode ser enviada.

Exemplo de cabeçalho da solicitação

OPTIONS / HTTP/1.1
Origin: https://example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: X-PINGOTHER, Content-Type
  • Access-Control-Request-Method: POST permite que a seguinte solicitação seja feita com o método POST.
  • Access-Control-Request-Headers: X-PINGOTHER, Content-Type permite que o solicitante defina os cabeçalhos HTTP X-PINGOTHER e Content-Type na solicitação subsequente.

Exemplos de cabeçalhos de resposta

Access-Control-Allow-Origin: https://example.com
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-PINGOTHER, Content-Type
Access-Control-Max-Age: 86400
  • Access-Control-Allow-Methods: POST, GET, OPTIONS indica que as solicitações subsequentes podem ser feitas com os métodos POST, GET e OPTIONS.
  • Access-Control-Allow-Headers: X-PINGOTHER, Content-Type indica que as solicitações subsequentes podem incluir os cabeçalhos X-PINGOTHER e Content-Type.
  • Access-Control-Max-Age: 86400 indica que o resultado da solicitação de simulação pode ser armazenado em cache por 86.400 segundos.

Navegadores compatíveis

Browser Support

  • Chrome: 4.
  • Edge: 12.
  • Firefox: 3.5.
  • Safari: 4.

Source

Saiba mais

Política de incorporador entre origens (COEP)

Para reduzir a capacidade de ataques baseados em Spectre de roubar recursos entre origens, recursos como SharedArrayBuffer ou performance.measureUserAgentSpecificMemory() são desativados por padrão.

Cross-Origin-Embedder-Policy: require-corp impede que documentos e workers carreguem recursos de origem cruzada, como imagens, scripts, folhas de estilo, iframes e outros, a menos que esses recursos aceitem explicitamente o carregamento por cabeçalhos CORS ou CORP. A COEP pode ser combinada com Cross-Origin-Opener-Policy para ativar o isolamento de origem cruzada em um documento.

Use Cross-Origin-Embedder-Policy: require-corp quando quiser ativar o isolamento de origem cruzada para seu documento.

Exemplo de uso

Cross-Origin-Embedder-Policy: require-corp
Como usar a COEP

Exemplos de uso

A COEP usa um único valor de require-corp. Ao enviar esse cabeçalho, você pode instruir o navegador a bloquear o carregamento de recursos que não são ativados por CORS ou CORP.

Como a COEP funciona

Ativar o isolamento de origem cruzada

Ative o isolamento de origem cruzada enviando Cross-Origin-Embedder-Policy: require-corp com Cross-Origin-Opener-Policy: same-origin.

Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin

Denunciar recursos incompatíveis com a COEP

Você pode receber relatórios de recursos bloqueados causados pela COEP com a API Reporting.

Cross-Origin-Embedder-Policy: require-corp; report-to="coep"

A COEP também é compatível com o modo somente relatório para que você possa receber relatórios sem realmente bloquear o carregamento de recursos.

Cross-Origin-Embedder-Policy-Report-Only: require-corp; report-to="coep"

Navegadores compatíveis

Browser Support

  • Chrome: 83.
  • Edge: 83.
  • Firefox: 79.
  • Safari: 15.2.

Source

Saiba mais

HTTP Strict Transport Security (HSTS)

A comunicação por uma conexão HTTP simples não é criptografada, o que torna os dados transferidos acessíveis a interceptadores no nível da rede.

O cabeçalho Strict-Transport-Security informa ao navegador que ele nunca deve carregar o site usando HTTP, mas sim HTTPS. Depois de definido, o navegador vai usar HTTPS em vez de HTTP para acessar o domínio sem um redirecionamento por um período definido no cabeçalho.

Exemplo de uso

Strict-Transport-Security: max-age=31536000
Como usar o HSTS

Todos os sites que migram de HTTP para HTTPS precisam responder com um cabeçalho Strict-Transport-Security quando uma solicitação com HTTP é recebida.

Strict-Transport-Security: max-age=31536000

Navegadores compatíveis

Browser Support

  • Chrome: 4.
  • Edge: 12.
  • Firefox: 4.
  • Safari: 7.

Source

Saiba mais

Leitura adicional