Auditoria de Segurança e Acessos
Nesta página
Lição reescrita em 3 de novembro de 2026 com base nas páginas Agent approvals & security, Rules, Compliance API and audit events e no manual do Codex. A versão anterior descrevia um ficheiro
.codexignoreinexistente, afirmava que o Codex apenas executa comandos listados no AGENTS.md, citava um menu “Organization Settings → Audit Logs” e mencionava uma certificação SOC 2 Type II do Codex sem fonte. Fontes: Agent approvals & security · Rules · Compliance API · Pricing.
Controlar o Que o Codex Pode Ver e Fazer
A segurança torna-se crítica no momento em que um agente de IA acede ao seu código-fonte. O Codex inclui salvaguardas integradas, mas configurá-las é da sua responsabilidade: o produto fornece o isolamento, enquanto você define o perímetro. Se ligar um repositório por conveniência durante uma correria noturna ou deixar um segredo num ficheiro de configuração esquecido, o isolamento técnico não o protegerá.
O Modelo de Segurança do Codex
Duas definições complementares governam o que o agente pode fazer: a sandbox, que define o que pode tecnicamente tocar, e a política de aprovação, que determina quando deve parar e pedir permissão — como ao sair da sandbox, usar a rede ou executar um comando fora do conjunto permitido.
- Localmente (CLI, extensão, aplicação de desktop), mecanismos ao nível do sistema operativo impõem a sandbox. Por predefinição, não há acesso à rede e as operações de escrita limitam-se ao espaço de trabalho ativo. Com a predefinição comum
--sandbox workspace-write --ask-for-approval on-request, o Codex lê, modifica e executa livremente dentro do diretório de trabalho, mas pergunta antes de escrever noutros locais ou usar a rede. O modoread-only(via comando/permissions) permite discutir e planear sem fazer alterações. - Na nuvem, cada tarefa do Codex Cloud executa no seu próprio espaço de trabalho num ambiente gerido pela OpenAI; as credenciais e o acesso à rede configuram-se por ambiente, com segredos de rede limitados a serviços HTTPS autorizados.
Ao contrário do que a versão anterior desta lição afirmava, o Codex não está restrito aos comandos listados no AGENTS.md: pode executar comandos, limitado pelo par sandbox/aprovação. Para ir além, as regras governam os comandos permitidos fora da sandbox: uma regra de prefixo pode exigir confirmação ou proibir totalmente um comando.
# .rules file (Starlark syntax)
prefix_rule(
pattern = ["curl"],
decision = "prompt",
justification = "All outgoing network requests must be confirmed.",
)
Impostas pelo administrador, estas regras só podem exigir confirmação ou proibir ações; não podem conceder autorização automática.
Ocultar o Que Não Deve Ser Lido
Não existe nenhum ficheiro .codexignore. Para impedir que o Codex leia ficheiros sensíveis, mesmo que versionados, utilize um perfil de permissões com regras deny em caminhos exatos ou padrões:
# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3
[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"
Colocada sob :workspace_roots, a regra aplica-se a cada raiz de espaço de trabalho: os ficheiros .env tornam-se ilegíveis aí, sem bloquear escritas normais noutros locais. Caminhos exatos funcionam bem para localizações estáveis como ~/.ssh; padrões adequam-se a ficheiros com localizações variáveis. Um administrador pode impor estas negações em toda a organização (permissions.filesystem.deny_read).
A documentação nota duas limitações. No Linux, WSL e Windows, as correspondências de padrões resolvem-se no início de cada processo de sandbox: um ficheiro correspondente criado posteriormente permanece legível para um processo já em execução. Além disso, um padrão ** ilimitado requer glob_scan_max_depth. A abordagem mais segura continua a ser manter os segredos totalmente fora do repositório.
Aplique a mesma cautela ao AGENTS.md, que o Codex lê em cada execução. Nunca coloque segredos reais aí: valores fictícios bastam para explicar o formato esperado pelos seus comandos de teste.
## Environment Variables
Test commands use dummy variables:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only
Rastreio e Monitorização
Nos planos Enterprise e Edu, os registos de auditoria e o rastreio de utilização passam pela Compliance API. Suporta usos de segurança, legais e investigativos que exigem registos verificáveis: exportar eventos para um SIEM ou data lake, aplicar os seus períodos de retenção e detenções legais, e correlacionar a atividade do Codex com os seus dados de identidade. A documentação da Admin API governa os eventos cobertos, filtros e retenção; teste a ingestão num sistema de não-produção antes de agendar a recolha contínua.
Isto não é um painel de produtividade: a OpenAI desaconselha usá-lo para julgar a qualidade do código ou o desempenho individual, remetendo antes para as informações do espaço de trabalho e a Analytics API para métricas de adoção. Alguém deve realmente usar estes registos para além de revisões pós-incidente: mantenha-os fora do ambiente controlado pelo agente e ative alertas para falhas de autenticação repetidas, acessos invulgares e alterações de configuração.
Conformidade e Regulamentação
Se o seu código lida com dados pessoais europeus, quatro pontos recaem sobre a sua responsabilidade, não a do fornecedor. Garanta que o seu contrato com a OpenAI inclui um DPA (Acordo de Processamento de Dados); utilize controlos de retenção e residência de dados quando o seu plano os oferecer (Enterprise e Edu); documente a utilização do Codex no seu registo de atividades de processamento; e, finalmente, informe as equipas de que o seu código é processado por um serviço de terceiros. No plano Business, os dados da empresa não são usados para treino por predefinição.
Para uma auditoria SOC 2 ou ISO 27001, confie nos documentos publicados pela OpenAI — incluindo o Codex Security Whitepaper no seu portal de confiança — e verifique o âmbito e a data de cada atestação: uma atestação expirada, ou uma que não cubra o serviço que utiliza, não tem peso para um auditor. As exportações da Compliance API cumprem os requisitos de rastreabilidade, desde que recolhidas continuamente e produzidas quando solicitado.
Melhores Práticas de Segurança
- - Proiba a leitura de ficheiros sensíveis (regras `deny`)
- - Recolha e audite registos da Compliance API
- - Limite os repositórios ligados ao mínimo necessário
- - Use SSO com MFA
- - Reveja os PR do Codex antes de fazer merge
- - Ligue repositórios com segredos no código
- - Coloque tokens reais no AGENTS.md
- - Faça auto-merge sem revisão
- - Ignore alertas de auditoria
- - Partilhe uma conta Codex entre programadores
A partilha de contas, o último item da coluna da direita, merece menção especial: anula instantaneamente todo o valor dos registos de auditoria, uma vez que nenhuma ação pode ser associada a uma pessoa identificável.
Pontos-chave
- A sandbox limita o que o Codex pode tocar (localmente: sem rede, escritas limitadas ao espaço de trabalho por predefinição); a política de aprovação define quando pede permissão
- As regras governam comandos fora da sandbox (
promptouforbidden) - O
.codexignorenão existe: proíba a leitura de ficheiros sensíveis via regrasdenynum perfil de permissões - Os registos de auditoria passam pela Compliance API (Enterprise e Edu)
- Verifique a conformidade com o RGPD se lidar com dados europeus
- Nunca coloque segredos reais no AGENTS.md