> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Logs de auditoria

## Visão geral

Os logs de auditoria fornecem um registro cronológico das ações administrativas realizadas no seu workspace, ajudando no monitoramento de segurança, nos relatórios de conformidade e na investigação de incidentes. A cobertura abrange mais de 100 endpoints de provisionamento de usuários, autenticação, gerenciamento de chaves de API e outras áreas administrativas.

Os logs são emitidos no esquema [OCSF v1.6.0](https://schema.ocsf.io/1.6.0), com os perfis `datetime` e `host` aplicados, para que a maioria das entradas possa ser ingerida em um SIEM com normalização mínima.

## Requisitos de acesso

Duas verificações independentes controlam a recuperação:

| Requisito                 | Detalhe          |
| ------------------------- | ---------------- |
| Nível do workspace        | Enterprise       |
| Permissão da chave de API | `audit_log_read` |

As solicitações são autenticadas com uma chave de API do workspace. O usuário ou a conta de serviço associada à chave deve ter a permissão `audit_log_read`.

## Recuperando logs

Os logs de auditoria são retornados por [`GET /v1/workspace/audit-logs`](/docs/pt/api-reference/workspace/audit-logs/list). Consulte a referência da API para ver a lista completa de parâmetros de consulta e detalhes de paginação.

#### Python

```python
from dotenv import load_dotenv
import os
from elevenlabs import ElevenLabs

load_dotenv()

elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))

page = elevenlabs.workspace.audit_logs.list(limit=50)
for entry in page.entries:
    print(entry.time_dt, entry.class_name, entry.activity_name)
```

#### TypeScript

```typescript
import 'dotenv/config';
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({ apiKey: process.env.ELEVENLABS_API_KEY });

const page = await elevenlabs.workspace.auditLogs.list({ limit: 50 });
for (const entry of page.entries) {
  console.log(entry.timeDt, entry.className, entry.activityName);
}
```

### Limites de taxa

As solicitações são limitadas a 30 por minuto por usuário. Combinado com o `limit` máximo de 100, isso permite até 3.000 entradas por minuto.

## Esquema

Os logs de auditoria seguem a especificação [OCSF v1.6.0](https://schema.ocsf.io/1.6.0). Campos específicos da classe de evento complementam uma base comum; consulte a referência da API para ver o esquema de resposta de cada campo.

### Classes de evento

As seguintes classes OCSF são emitidas atualmente:

| Classe                              | UID    | Exemplos                                                                       |
| ----------------------------------- | ------ | ------------------------------------------------------------------------------ |
| Alteração de conta                  | `3001` | Usuário criado, senha alterada, fator de MFA ativado.                          |
| Autenticação                        | `3002` | Login, logout, troca de conta.                                                 |
| Gerenciamento de entidades          | `3004` | Recurso criado, atualizado, excluído ou movido.                                |
| Gerenciamento de acesso de usuários | `3005` | Privilégios atribuídos ou revogados.                                           |
| Gerenciamento de grupos             | `3006` | Grupo criado, usuário adicionado ou removido, subgrupo adicionado ou removido. |

A conformidade com OCSF é feita com o melhor esforço. Quando existe um campo OCSF canônico, as entradas de auditoria o usam; o campo `unmapped` contém atributos específicos do ElevenLabs que não se encaixam no padrão.

## Redação

Informações confidenciais que, de outra forma, apareceriam em caminhos de URL ou parâmetros de consulta são ocultadas antes que as entradas de auditoria sejam gravadas. Tokens de redefinição de senha são um desses casos; a mesma ocultação se aplica a qualquer solicitação relevante para auditoria cuja estrutura de URL contenha segredos.