Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Auditoria de Segurança e Acessos

Aula 17 de 20 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Controlar o Que o Codex Pode Ver e Fazer
  2. O Modelo de Segurança do Codex
  3. Ocultar o Que Não Deve Ser Lido
  4. Rastreio e Monitorização
  5. Conformidade e Regulamentação
  6. Melhores Práticas de Segurança
  7. Pontos-chave

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 .codexignore inexistente, 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 modo read-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

Faç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
Não faça
  • - 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 (prompt ou forbidden)
  • O .codexignore não existe: proíba a leitura de ficheiros sensíveis via regras deny num 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