“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 permitidaAccess-Control-Allow-Methods— métodosAccess-Control-Allow-Headers— headers customizadosAccess-Control-Allow-Credentials— permite cookies/credenciaisAccess-Control-Max-Age— cache do preflight
Configurações perigosas
- Refletir qualquer
Origincom 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.