~ / blog / backend
11 out 2026backend40 min de leitura

CORS explicado: o que é, preflight e como configurar sem abrir o mundo

CORS de forma clara: por que o browser bloqueia, o que é preflight OPTIONS, headers principais e erros de configuração perigosos.

CORSHTTPbrowserAPI

“CORS error”, “Access-Control-Allow-Origin” e “preflight OPTIONS” dominam fóruns de front e back. CORS (Cross-Origin Resource Sharing) é o mecanismo pelo qual o browser relaxa a same-origin policy de forma controlada — não é um firewall de servidor.

O que é CORS

Quando uma página em https://app.exemplo.com chama https://api.exemplo.com, a origem é diferente (host diferente). O browser só expõe a resposta ao JavaScript se o servidor da API autorizar aquela origem via headers CORS.

Chamadas server-to-server (curl, backend) não seguem CORS do browser. Por isso “no Postman funciona e no front não”.

Por que existe

Sem restrição, um site malicioso poderia ler respostas autenticadas de outro site usando o cookie da vítima. CORS + cookies exige cuidado extra (Access-Control-Allow-Credentials e origem explícita — nunca * com credenciais).

Preflight (OPTIONS)

Para pedidos “não simples” (certos métodos, headers ou content-types), o browser envia antes um OPTIONS perguntando se a origem, o método e os headers são permitidos. Só então envia o pedido real.

Veja também: CORS preflight.

Headers que você vai ver

  • Access-Control-Allow-Origin — origem permitida
  • Access-Control-Allow-Methods — métodos
  • Access-Control-Allow-Headers — headers customizados
  • Access-Control-Allow-Credentials — permite cookies/credenciais
  • Access-Control-Max-Age — cache do preflight

Configurações perigosas

  • Refletir qualquer Origin com credentials
  • Allow-Origin: * em API autenticada por cookie
  • Desligar CORS no browser via extensão e achar que “resolveu produção”
  • Tratar CORS como autenticação

Checklist

  • Lista explícita de origens de produção e staging?
  • Credentials só com origem precisa?
  • Preflight testado para o header Authorization?
  • Erros de CORS investigados no Network do DevTools, não só no console?

Aprofundamento operacional e de produto

Quando o time discute CORS, o primeiro passo é alinhar o problema de negócio e o modelo de ameaça ou de falha, antes de escolher ferramenta ou biblioteca da moda.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Um desenho cuidadoso de CORS considera operação do dia a dia: quem é acionado, como se diagnostica, como se faz rollback e como se evita repetir o mesmo incidente.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Documentação interna curta e exemplos no repositório reduzem a distância entre a teoria de CORS e o código que realmente vai para produção.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Metas mensuráveis ajudam: tempo de diagnóstico, taxa de erro, tempo de recuperação ou número de falsos positivos relacionados a CORS.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Treinamento periódico, pair review em mudanças críticas e checklist de PR são tão importantes quanto a escolha tecnológica em CORS.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Ambientes de staging devem exercitar CORS de forma parecida com produção, senão a primeira validação real ocorre sob pressão.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Custo e complexidade devem aparecer na decisão. Soluções de CORS que ninguém sabe operar tornam-se risco operacional.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Integração com observabilidade — logs, métricas e traces — torna CORS auditável e depurável.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Segurança e privacidade atravessam CORS: dados em trânsito, dados em repouso, segredos e acesso humano.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Por fim, revise CORS após incidentes reais. A melhoria contínua vem de evidência, não de preferência estética de arquitetura.

Na prática, equipes que tratam CORS como projeto único de duas semanas descobrem depois débitos: falta de runbook, falta de teste, falta de métrica de sucesso. Trate como capacidade contínua. Reserve tempo de calendário para higiene, não só para feature. A conversa com stakeholders fica mais fácil quando há indicadores antes e depois de cada melhoria relevante em CORS.

Outro ponto recorrente em CORS é a dependência de pessoas-chave. Se apenas uma pessoa sabe o desenho, férias ou turnover viram incidente anunciado. Compartilhe contexto em ADR (architecture decision records), diagramas simples e sessões curtas de alinhamento. O objetivo é reduzir a carga cognitiva do próximo engenheiro a intervir.

Checklist estendido de maturidade

  • Item de maturidade 1 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 2 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 3 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 4 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 5 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 6 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 7 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 8 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 9 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 10 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 11 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 12 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 13 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 14 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 15 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 16 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 17 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 18 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 19 para CORS: documentado, testado, observável e com dono claro
  • Item de maturidade 20 para CORS: documentado, testado, observável e com dono claro

Use o checklist acima como ponto de partida e adapte à realidade do produto. Nem todo item se aplica a todo contexto de CORS, mas a ausência total de checklist costuma correlacionar-se com surpresas em produção.

Guia estendido de decisões em CORS

Esta seção amplia o material sobre CORS com orientações de decisão que costumam aparecer depois do tutorial inicial. O objetivo é ultrapassar a faixa superficial e cobrir operação, risco, colaboração entre times e manutenção ao longo de meses.

Ponto de decisão 1. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 1: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 1: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 2. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 2: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 2: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 3. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 3: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 3: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 4. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 4: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 4: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 5. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 5: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 5: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 6. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 6: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 6: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 7. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 7: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 7: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 8. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 8: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 8: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 9. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 9: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 9: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 10. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 10: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 10: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 11. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 11: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 11: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 12. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 12: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 12: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 13. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 13: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 13: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 14. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 14: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 14: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Ponto de decisão 15. Em CORS, avalie impacto ao usuário, custo operacional, complexidade cognitiva para o próximo engenheiro e capacidade de observar o comportamento em produção. Evite adotar uma variante só porque é popular em redes sociais. Peça evidência: incidente anterior, métrica, restrição de compliance ou requisito de produto. Se a motivação for apenas moda, registre isso honestamente — moda também pode ser válida como experimento, desde que delimitada no tempo e mensurável.

Complemento ao ponto 15: escreva um parágrafo de ADR sobre a escolha feita em CORS. Inclua contexto, opções consideradas, decisão e consequências. ADRs curtos reduzem re-litigação. Em revisões semestrais, releia os ADRs e marque o que ficou obsoleto. CORS evolui com o produto; documentação parada mente.

Ainda sobre o item 15: treine o cenário de falha. Se CORS falhar no pior horário, quem faz o quê nos primeiros quinze minutos? Sem resposta clara, a implementação técnica está incompleta. Inclua contatos, dashboards e critérios de comunicação a stakeholders.

Erros de campo relatados com frequência em CORS

Erro de campo 1 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 2 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 3 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 4 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 5 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 6 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 7 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 8 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 9 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Erro de campo 10 em CORS: atalho de prazo que virou permanente; ausência de teste automatizado do caminho crítico; falta de métrica de sucesso; conhecimento concentrado em uma pessoa; divergência entre ambientes; documentação desatualizada; alerta inexistente ou ruidoso; revisão de PR superficial em mudança sensível; dependência oculta não mapeada; ausência de plano de rollback. Cada um desses itens já derrubou sistemas reais. Use a lista como auditoria honesta, não como acusação.

Síntese final ampliada

Dominar CORS é menos sobre memorizar comandos e mais sobre encadear diagnóstico, decisão e aprendizado. Mantenha o ciclo: implementar com segurança, observar em produção, corrigir com evidência, documentar o essencial. Esse ciclo, repetido, vale mais do que qualquer checklist estático.

Se você chegou ao final deste texto sobre CORS, revise o checklist principal, escolha três melhorias de alto impacto e baixo risco, e execute-as em um horizonte de duas semanas. Depois meça se o tempo de diagnóstico ou a taxa de incidente melhorou. A melhoria contínua precisa de feedback numérico sempre que possível.

Fontes externas

publicidade