Logs de auditoria da OpenAI
Beta
O Lakewatch está em Beta. Os administradores do Workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias no nível do workspace.
Use o conector da API do Lakewatch para ingerir eventos de log de auditoria da organização da plataforma da API da OpenAI. Esta página aborda pré-requisitos, instruções de configuração, esquema do conector e observáveis de segurança.
Pré-requisitos
O conector exige:
- Lakeflow pipelines serverless ativados em seu workspace.
- Unity Catalog, com privilégios para criar ou usar uma conexão do Unity Catalog. Consulte Permissões de conexão.
- A visualização do Lakeflow Connect for OpenAI foi ativada no seu workspace por um administrador do workspace. Consulte Ativar a visualização do conector.
- Se a política de rede serverless do seu workspace usar acesso restrito, os domínios da API da origem deverão estar na lista Domínios permitidos da política. Consulte Permitir os domínios da API de origem na sua política de rede.
- O log de auditoria está ativado para sua organização OpenAI. Depois que o log de auditoria for ativado, somente o suporte da OpenAI poderá desativá-lo. Consulte Documentação da API de logs de administração e auditoria da OpenAI.
- A função de proprietário da organização na sua organização OpenAI para criar a key da API de administrador que autentica o conector. Consulte o guia de APIs de administração da OpenAI.
Limitações conhecidas
- Não há suporte para SCD (dimensão de alteração lenta) tipo 2.
- O conector suporta autenticação de key de API de administrador da OpenAI. As key de API de projeto padrão e o OAuth não são suportados.
- A primeira sincronização da tabela
audit_log_entriescomeça na hora de início da fonte de dados, que deve estar dentro dos últimos 365 dias. Se você não definir um horário para começar, a ingestão começará quando você criar a fonte de dados. As sincronizações posteriores recomeçam a partir do último valoreffective_atingerido. Consulte Escolha até onde retroceder para ingerir.
Configurar o OpenAI para ingestão
O conector autentica na API de Administração do OpenAI com uma key da Admin API, que ele envia como um token Bearer. As key da Admin API funcionam apenas com os endpoints da API de Administração. Para os passos completos, consulte Configurar autenticação no OpenAI.
- Entre na plataforma OpenAI como Proprietário da Organização.
- Abra a página key de administrador para sua organização.
- Crie uma key de API de administrador e defina sua permissão como Somente leitura . O acesso somente leitura é suficiente para ingestão. Consulte o guia da OpenAI para atribuir permissões de key de API.
- Copie a key da Admin API. O OpenAI mostra a key completa apenas uma vez.
Ao criar uma conexão através da UI do Lakewatch, insira a key da API de administrador que você copiou no passo anterior.
Os passos seguintes
Depois de configurar o OpenAI, crie uma fonte de dados com o conector OpenAI na UI do Lakewatch. Consulte conectores de API para instruções.
Esquemas de conectores e Lakewatch
O Lakewatch ingere eventos de logs de auditoria da organização da OpenAI em uma única tabela chamada audit_log_entries.
Tabela de origem | Dados da OpenAI | Analisador Lakewatch integrado |
|---|---|---|
| Eventos de Logs de auditoria da organização, como alterações de key de API, usuário, projeto e configurações da organização |
|
O conector grava cada tabela de origem diretamente no destino configurado para seu analisador integrado. Por default, a tabela de destino é denominada <parser>_<datasource>, onde <datasource> é o nome da fonte de dados. Por exemplo, com o nome de fonte de dados default openai, a tabela é openai_audit_openai. Você pode definir um destino diferente durante a criação da fonte de dados. Não há nenhuma tabela de staging bruta separada ou o passo de análise posterior.
Colunas gerenciadas pelo Lakewatch
O conector usa o campo de origem id como o primary key não nulo e o campo de origem effective_at como o cursor para ingestão incremental. Ao contrário dos conectores que sintetizam um ID Lakewatch, este conector não adiciona uma coluna lw_id ou time. Para definir o escopo de uma query ou regra de detecção para uma janela de tempo, passe a coluna effective_at para IN_TIMERANGE().
Para fontes de dados do Lakewatch, o conector também adiciona:
lw_meta: A identidade da fonte de dados e da conexão, o nome e a versão do parser e o tempo de ingestão.lw_observables: Observáveis de segurança extraídos pelo conector.
Veja Tabelas de saída do conector.
Esquema da tabela de saída do conector
O destino inclui as colunas de origem e evento abaixo, juntamente com as colunas lw_meta e lw_observables descritas acima.
A tabela audit_log_entries grava uma linha por evento de log de auditoria. Cada linha contém o ID, o tipo e a hora do evento, juntamente com o autor e o projeto ao qual o evento está associado. A coluna data armazena o registro completo do log de auditoria original como VARIANT, incluindo o objeto de detalhes nomeado após o evento type, como project.updated.
Esquema
Column | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Para definições de campo, consulte a documentação do objeto de log de auditoria da OpenAI.
Observáveis de segurança
O conector extrai esses campos em lw_observables:
Observáveis
Field | Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Os campos em data dependem do evento type. O conector verifica data e extrai valores para lw_observables fazendo a correspondência dos nomes dos subcampos. A correspondência não diferencia maiúsculas de minúsculas.
Observáveis de dados
| Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|