--- title: Configurar a Compliance API url: https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access description: Habilite a Compliance API para sua organização, depois crie uma Compliance Access Key (com permissões de escopo definido) ou uma chave de Admin API, e saiba qual delas usar. --- Organizações Claude Enterprise e organizações Claude Console independentes elegíveis têm acesso self-service à Compliance API. Esta página descreve como habilitar a Compliance API para sua organização e criar chaves de API. **Função necessária:** administrador da organização (Claude Console), ou proprietário principal ou proprietário da organização (claude.ai). A Compliance API usa dois tipos de chave, e qual delas você cria depende de qual produto Claude sua organização usa. Proprietários principais e proprietários da organização criam Compliance Access Keys no claude.ai; essas chaves desbloqueiam a Compliance API completa. A chave de um proprietário principal pode cobrir todas as organizações sob a organização pai; a chave de um proprietário da organização cobre apenas sua própria organização. Administradores da organização criam chaves de Admin API no Claude Console; essas chaves desbloqueiam apenas o [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) (feed de atividades). ## De qual chave você precisa? | Tipo de chave | Criada em | Usada para | Funciona com a Compliance API? | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | **Compliance Access Key** (`sk-ant-api01-...`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Activity Feed, chats, arquivos, projetos, sessões (em aplicativos como Cowork e Claude Code), usuários, metadados da organização e configurações da organização | Sim (todos os endpoints) | | **Chave de Admin API** (`sk-ant-admin01-...`) | Página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) no Claude Console | A [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api) e o Activity Feed da Compliance API | Apenas Activity Feed | | **Chave de Analytics API** | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | A Claude Enterprise Analytics API (consulte [Analytics APIs](https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api)) | Não | | **Chave de Claude API** (`sk-ant-api03-...`) | Página [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) no Claude Console | Chamar modelos Claude por meio da [Claude API](https://platform.claude.com/docs/pt-BR/api/overview) | Não | Um tenant Claude Enterprise tem uma **organização pai** que centraliza identidade, SSO e SCIM para todas as organizações de carga de trabalho abaixo dela. Essas organizações de carga de trabalho são as **organizações vinculadas** da organização pai. **Organizações pai do Claude Enterprise não aparecem no Claude Console (`platform.claude.com`).** A organização pai não possui cargas de trabalho, nem chaves de Claude API, nem chaves de Admin API. Crie Compliance Access Keys em **Organization settings** no claude.ai, não no Claude Console. ## Configurar a Compliance API A configuração é um único fluxo: habilite a Compliance API para sua organização e, em seguida, crie uma Compliance Access Key no claude.ai. Uma organização Claude Console, em vez disso, [cria uma chave de Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access#create-an-admin-api-key) após a habilitação; chaves de Admin API alcançam apenas o [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed). Uma Compliance Access Key com `read:compliance_user_data` pode ler todos os chats, arquivos, projetos e transcrições de sessão em todas as organizações vinculadas, incluindo conteúdo que o proprietário principal não viu. Uma chave com `delete:compliance_user_data` pode excluir permanentemente chats, arquivos e projetos. Trate as Compliance Access Keys como credenciais de banco de dados de produção: armazene-as em um gerenciador de segredos, nunca no controle de versão ou na configuração de encaminhadores de SIEM. Onde você habilita a Compliance API depende de como sua organização está configurada: * **Organizações Claude Enterprise:** O proprietário principal habilita a Compliance API em [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). A habilitação acontece no nível da organização pai e se propaga para todas as organizações vinculadas, tanto claude.ai quanto Claude Console. * **Organizações Claude Console independentes:** Um administrador da organização ativa o botão de alternância **Compliance API** na página [Compliance](https://platform.claude.com/settings/security) (`platform.claude.com/settings/security`) no Claude Console. A habilitação é self-service para organizações elegíveis, e a alteração entra em vigor imediatamente. Se a página mostrar um erro de página não encontrada, ou não mostrar a seção **Compliance API**, você não tem a função de administrador, sua organização está vinculada a uma organização pai (nesse caso, a Compliance API é habilitada a partir da organização pai) ou sua organização não é elegível para habilitação self-service; entre em contato com sua equipe de conta ou com o [suporte da Anthropic](https://support.claude.com) se não tiver certeza de qual caso se aplica. * **Organizações Claude Console vinculadas a uma organização pai:** Não há nada para ativar no Claude Console. Peça ao proprietário principal da sua organização pai para habilitar a Compliance API no claude.ai, ou entre em contato com sua equipe de conta. **Desativar a Compliance API interrompe o registro de atividades.** Um administrador da organização pode desativar a Compliance API a qualquer momento com o mesmo botão de alternância **Compliance API** que a ativa. Enquanto a Compliance API estiver desativada, nenhum evento de atividade é registrado para sua organização, portanto o [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) não recebe novos eventos. Se sua organização estiver inscrita no [Access Transparency](https://platform.claude.com/docs/pt-BR/manage-claude/access-transparency), desativar a Compliance API também interrompe a entrega de eventos do Access Transparency. Atividades que não forem registradas enquanto a Compliance API estiver desativada não podem ser recuperadas posteriormente. Reativar a Compliance API retoma o registro a partir desse ponto; atividades que já foram registradas não são excluídas. Para organizações Claude Enterprise, a configuração da Compliance API no claude.ai também governa a captura de transcrições para [sessões locais](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions#retrieve-local-sessions) (sessões nas máquinas dos usuários): a captura começa quando a Compliance API é habilitada e para enquanto ela estiver desativada, e o conteúdo de transcrições de sessões executadas enquanto ela estiver desativada não é capturado e não pode ser recuperado posteriormente. Uma organização Claude Console independente usa chaves de Admin API em vez de Compliance Access Keys: após a habilitação, pule as etapas restantes e [crie uma nova chave de Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access#create-an-admin-api-key). As etapas restantes provisionam Compliance Access Keys, que estão disponíveis apenas para organizações que fazem parte de um tenant Claude Enterprise. O acesso de uma chave é definido quando ela é criada. Decida quais organizações a chave cobre: * Uma chave para a **organização pai** pode acessar todas as organizações sob a organização pai. * Uma chave para uma **única organização** pode acessar apenas essa organização. Faça login no claude.ai. O proprietário principal da organização pai pode criar uma chave com qualquer um dos escopos. Um proprietário da organização pode criar uma chave restrita apenas à sua própria organização. Se a página **API** descrita na próxima etapa não estiver visível, ou se os escopos de compliance não estiverem disponíveis ao criar uma chave, ou sua função não pode criar Compliance Access Keys, ou a Compliance API ainda não foi habilitada para sua organização (volte à primeira etapa). Acesse [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) e encontre a seção **Keys**. Clique em **Create key**, dê um nome à chave e selecione um ou mais escopos da tabela a seguir. Clique em **Create**. | Escopo | Concede | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `read:compliance_activities` | Ler o Activity Feed. Uma chave que cobre a organização pai lê eventos da organização pai e de todas as organizações vinculadas. | | `read:compliance_user_data` | Ler chats, mensagens, arquivos, projetos, metadados e transcrições de sessão dos usuários, usuários da organização, preferências de usuário e membros de grupos | | `delete:compliance_user_data` | Excluir chats, arquivos e projetos dos usuários | | `read:compliance_org_data` | Ler metadados da organização (nomes, tipos, funções e grupos) e as configurações efetivas em vigor para organizações sob a organização pai. Listagens de usuários e associação a grupos exigem `read:compliance_user_data`. | Com a API de Plugins, `read:compliance_org_data` também lê o inventário de plugins e marketplaces de plugins da sua organização por meio da Admin API, incluindo os plugins pessoais dos membros e seus arquivos. Esse inventário identifica membros: ele contém o ID de usuário de cada membro que possui ou criou um plugin, ou com quem um plugin foi compartilhado individualmente, e o endereço de e-mail do criador de um plugin enquanto ele ainda for membro; consulte [Ler plugins e marketplaces de plugins](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#read-plugins-and-plugin-marketplaces). Escolha o menor conjunto de escopos de que sua integração precisa: * Um pipeline de auditoria que apenas lê o Activity Feed precisa somente de `read:compliance_activities`. * Uma ferramenta de eDiscovery que lê chats e arquivos, mas nunca os exclui, não precisa de `delete:compliance_user_data`. * Se seu fluxo de trabalho lê e exclui, use **duas chaves** com escopos separados, para que uma chave de leitura vazada não possa excluir dados. Os escopos de uma Compliance Access Key são imutáveis após a criação. Para alterar escopos, crie uma nova chave com os escopos desejados e, em seguida, exclua a antiga. Copie a chave secreta exibida (começando com `sk-ant-api01-`) e armazene-a em seu gerenciador de segredos. O segredo completo é exibido apenas uma vez. Defina a chave como uma variável de ambiente para que os exemplos de shell deste guia possam lê-la: ```bash export ANTHROPIC_COMPLIANCE_ACCESS_KEY=sk-ant-api01-... ``` ## Criar uma chave de Admin API A Compliance API já deve estar [habilitada para sua organização Claude Console](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access#set-up-the-compliance-api) antes que uma chave de Admin API possa chamar o Activity Feed. Siga as etapas em [Criar uma chave de Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization) e, em seguida, defina a chave como uma variável de ambiente: ```bash export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-... ``` O nome de variável distinto impede que a chave de Admin API sobrescreva uma Compliance Access Key caso você provisione ambas. Os exemplos de cURL deste guia leem a chave de `$ANTHROPIC_COMPLIANCE_ACCESS_KEY`; substitua por `$ANTHROPIC_ADMIN_KEY` ao chamar o [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) com uma chave de Admin API. Chaves de Admin API possuem o escopo `read:compliance_activities` apenas se a Compliance API estava habilitada para a organização no momento em que a chave foi criada; consulte [Configurar a Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access#set-up-the-compliance-api). Elas não podem receber nenhum outro escopo da Compliance API, portanto chamadas a qualquer endpoint que não seja o Activity Feed retornam [403 Forbidden](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden). Para o papel dessa mesma chave no gerenciamento da sua organização Claude Console, consulte [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api). ## Verificar os escopos da sua chave Para inspecionar os escopos de uma chave que você já possui, use um dos seguintes sinais. * **Prefixo da chave.** `sk-ant-admin01-` é uma chave de Admin API (possui apenas `read:compliance_activities`, sujeito ao momento da habilitação descrito na seção anterior). `sk-ant-api01-` é uma Compliance Access Key; seus escopos são o subconjunto que você selecionou na criação. * **Interface de configurações.** Para uma Compliance Access Key, abra a seção **Keys** em [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) e leia a coluna **Scopes** da chave. Chaves de Admin API, listadas na página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) no Claude Console, não têm escopos selecionáveis. * **Respostas de erro.** Uma chamada que excede os escopos da chave retorna um 403 com uma mensagem no formato `Missing required scopes. Got: [] Needed one of: []` (`Needed: [...]` nos endpoints de exclusão). Consulte [Tratar erros da Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden) para o catálogo completo de erros. ```json { "error": { "type": "permission_error", "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']" } } ``` ## Gerenciar e rotacionar chaves Exclua uma Compliance Access Key na mesma tabela **Keys** em que você a criou: acesse [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Exclua uma chave de Admin API na página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) no Claude Console. A exclusão de uma chave entra em vigor na próxima requisição: não há período de carência. Compliance Access Keys não expiram por conta própria. Para rotacionar uma chave sem interrupção: 1. Crie uma nova chave com os mesmos escopos. 2. Atualize sua integração para usar a nova chave. 3. Verifique se a integração funciona com a nova chave. 4. Exclua a chave antiga. Cursores de paginação armazenados antes de uma rotação permanecem válidos: os cursores têm escopo na organização, não na chave. Se uma Compliance Access Key vazar, exclua-a imediatamente, audite o [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) em busca de atividades `compliance_api_accessed` realizadas pela chave comprometida e rotacione quaisquer credenciais downstream que a chave vazada pudesse alcançar. Passe `activity_types[]=compliance_api_accessed` para restringir a consulta e, em seguida, no seu cliente, mantenha as atividades cujo `actor.type` seja `api_actor` e cujo `actor.api_key_id` corresponda à chave comprometida; consulte [Entender o objeto Activity](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed#understand-the-activity-object) para o esquema do actor. ## Próximos passos Leia eventos de atividade de toda a organização com qualquer chave que tenha `read:compliance_activities`. Use uma Compliance Access Key com `read:compliance_user_data` para recuperar chats, arquivos e projetos do claude.ai, e `delete:compliance_user_data` para excluí-los. Use uma Compliance Access Key com `read:compliance_user_data` para listar as sessões que seus usuários executam em aplicativos e agentes Claude, como Cowork e Claude Code, e recuperar suas transcrições.