Compliance API e eventos de auditoria
Compreenda a finalidade e os limites administrativos da Compliance API
Utilize a Compliance API em fluxos de trabalho de segurança, jurídicos, de governação e de investigação que exijam registos auditáveis. Utilize dados analíticos, não registos de conformidade, para medir a adoção e as tendências.
A referência da Admin API é a fonte fidedigna dos requisitos de acesso, da cobertura de eventos, das rotas, dos esquemas, dos filtros, da retenção e do comportamento dos pedidos atuais.
Para obter uma visão geral das interfaces de conformidade disponíveis e dos padrões comuns de integração, consulte o Guia da Compliance Platform.
Quando utilizar a Compliance API
A Compliance API é adequada quando precisa de:
- Exportar registos compatíveis para um sistema de auditoria ou investigação.
- Aplicar processos organizacionais de retenção e preservação legal.
- Correlacionar a atividade do Codex com outros dados de segurança ou identidade.
- Apoiar investigações aprovadas de segurança, jurídicas ou de governação.
Não é um painel de produtividade. Não a utilize para inferir a qualidade do código nem o desempenho individual. Utilize Dados analíticos do espaço de trabalho ou a Analytics API para relatórios de adoção.
Começar
- Abra a referência da Admin API e confirme que a sua função de administrador pode aceder aos recursos de conformidade de que necessita.
- Utilize o fluxo de registos de conformidade apenas de anexação para a recolha contínua. Consulte a referência da API para saber quais são os recursos e os padrões de obtenção atualmente suportados.
- Transfira os ficheiros de registo e teste a ingestão num sistema de gestão de eventos e informações de segurança (SIEM) ou num lago de dados que não seja de produção.
- Agende a recolha contínua e aplique aos registos exportados os controlos de acesso, retenção e preservação legal da sua organização. Não pressuponha que a janela de retenção da origem substitui a política de retenção da sua organização.
Por exemplo, uma equipa de segurança pode transmitir eventos de conformidade imutáveis para o respetivo SIEM para fins de investigação ou encaminhá-los para um fluxo de trabalho aprovado de descoberta eletrónica. Utilize a referência da API para consultar as rotas e os esquemas atuais, em vez de copiar um contrato de endpoint deste guia.
Transferir registos
Transfira o script Bash ou o script PowerShell. Ambos listam e transferem todos os ficheiros de registo disponíveis após um determinado carimbo de data/hora, seguem a paginação e escrevem JSONL na saída padrão. Os erros são enviados para o erro padrão.
Defina COMPLIANCE_API_KEY como a sua API key da Enterprise Compliance API. Substitua
<workspace_or_org_id> pelo ID do seu espaço de trabalho do ChatGPT ou pelo ID da organização
da API Platform e <after> por um carimbo de data/hora ISO 8601 que inclua um fuso
horário. Este exemplo obtém ficheiros AUTH_LOG, 100 de cada vez.
No macOS ou Linux, instale o Bash, curl e jq e, em seguida, execute:
bash ./download_compliance_files.sh "<workspace_or_org_id>" AUTH_LOG 100 "<after>" > output.jsonlO script do Windows suporta PowerShell 5.1 ou posterior. Analise o ficheiro transferido.
Se o Windows o bloquear e a política de execução da sua organização o permitir, execute
Unblock-File -Path .\download_compliance_files.ps1. Este exemplo utiliza o
PowerShell 7 para guardar UTF-8 sem marca de ordem de bytes:
.\download_compliance_files.ps1 "<workspace_or_org_id>" AUTH_LOG 100 "<after>" |
Set-Content -Encoding utf8NoBOM output.jsonlRegistos de auditoria para o acesso ao computador local com Work Cloud
O acesso ao computador local com Work Cloud tem o mesmo suporte da Compliance API que o Work Cloud. Os registos aparecem nos tipos de evento conversation_message e codex_log. A execução local também gera eventos OpenTelemetry (OTel), que pode recolher configurando um endpoint de um coletor OTel. Recolha estes eventos locais separadamente dos registos da Compliance API. Estas fontes não constituem um registo completo de todos os comandos locais, operações de ficheiros, capturas de ecrã, aprovações ou ações externas.
Ao configurar a recolha:
Utilize
conversation_messageecodex_logpara os registos do Work suportados. Consulte a referência da API para obter os respetivos esquemas, identificadores de ações e carimbos de data/hora.Confirme o comportamento de retenção e eliminação do fluxo de trabalho.
Execute uma tarefa representativa e compare os registos exportados com as ações realizadas.
Automatização de políticas. Utilize a API de políticas para gerir as definições Global. Faça a gestão das definições Local e Codex Cloud na interface do Agent Security. Os fluxos de trabalho existentes da API Global continuam disponíveis após a migração. Teste os scripts e as integrações com Terraform e confirme que as atribuições e a ordenação das políticas se mantêm inalteradas. Reveja a automatização de políticas separadamente da obtenção de registos de auditoria. O suporte da API de políticas não altera a cobertura de eventos da Compliance API.
Auditoria baseada em hooks. Quando estiverem ativados para o seu espaço de trabalho, utilize hooks MCP definidos pelo administrador que são executados no coordenador na nuvem (orquestrador) para os eventos de ciclo de vida e de ferramentas suportados. Antes de substituir um fluxo de trabalho de auditoria existente, teste a ligação de callback, a cobertura de eventos e o comportamento em caso de falha. Verifique estes registos separadamente da cobertura da Compliance API.
Confirmar os limites administrativos
A cobertura de conformidade acompanha o espaço de trabalho do ChatGPT e os produtos representados na referência da API atual. Os dados da organização da Platform API seguem os respetivos controlos de dados e administração da API.
A referência da API define as rotas, a cobertura de eventos, os esquemas, os filtros, o comportamento de retenção, os requisitos de permissões e os mecanismos de pedido atuais. Esta página não duplica esse contrato.