Conectando ao Anthropic (NHI)
Last updated: September 28, 2026
O que você está configurando
Você está concedendo ao Lumos acesso somente leitura a uma organização do Claude Console por meio da API de administração da Anthropic, para que ele possa identificar o inventário e os riscos de identidades não humanas: agentes gerenciados e contas de serviço, as chaves de API que os autenticam, chaves sem expiração, chaves vinculadas a uma pessoa e os espaços de trabalho e papéis que definem o que cada um deles pode acessar. Não há nada para implantar do seu lado. O Lumos gera a chave de assinatura usada para a Workload Identity Federation, portanto você nunca lida com uma chave privada.
Conecte a organização onde suas cargas de trabalho de API são executadas, em platform.claude.com. Isso vale tanto se ela for independente quanto se estiver vinculada a uma organização principal do Claude Enterprise. Uma organização do claude.ai não executa cargas de trabalho de API, portanto não possui agentes, contas de serviço ou chaves de API do Claude para esta integração ler. No Claude Enterprise, conecte cada organização do Console vinculada.
A configuração usa até três credenciais:
Credencial | O que ela adiciona | Quando você precisa dela |
|---|---|---|
Chave de API da organização | Agentes, chaves de API, espaços de trabalho, membros e papéis | Sempre |
Workload Identity Federation | Contas de serviço e suas associações a espaços de trabalho | Recomendado. Sem ela, o Lumos não consegue ver contas de serviço. |
Chave de acesso de conformidade | Grupos e papéis de conformidade | Opcional. Somente para organizações vinculadas a uma organização principal do Claude Enterprise, e requer federação. |
O que o Lumos NÃO faz:
Nenhuma gravação. Somente recursos de leitura são registrados. O Lumos não pode criar, modificar, arquivar ou excluir um membro, conta de serviço, agente, chave de API, espaço de trabalho ou papel.
Nenhuma conversa, arquivo ou sessão. O Lumos nunca chama a API de Mensagens e, na API de Conformidade, lê somente grupos, membros de grupos e papéis da organização.
Nenhum segredo de chave. A Anthropic mostra o valor completo de uma chave uma única vez, no momento da criação, e nunca o retorna pela API. O Lumos recebe metadados e uma indicação redigida.
Nenhum dado de uso, gastos ou faturamento. As APIs de Uso e custo, Análises e Limites de gastos nunca são chamadas.
Pré-requisitos
Você precisará de um administrador da organização no Claude Console e do ID da organização. O ID é um UUID exibido em Configurações > Organização no Claude Console. Cole-o sem um org_ prefixo.
Para dados de conformidade, você também precisará do proprietário principal da organização principal do Claude Enterprise, que cria a Chave de acesso de conformidade no claude.ai. A API de Conformidade precisa estar ativada primeiro. O proprietário principal a ativa nas configurações da organização no claude.ai, e isso se aplica a todas as organizações vinculadas.
Etapa 1: criar a chave de API da organização
Uma chave de administrador (sk-ant-admin01-...) não funcionará, nem uma chave com escopo de espaço de trabalho. O Lumos rejeita uma chave de administrador no formulário de configuração antes que você possa salvá-la.
Entre no Claude Console como administrador da organização.
Acesse Configurações > chaves de API e selecione Criar chave.
Defina Conta vinculada como uma conta de serviço. Use você mesmo ou outro administrador somente se não existir uma conta de serviço. Uma chave vinculada a uma pessoa para de funcionar quando essa pessoa deixa a organização, e a conexão para junto com ela.
Defina Escopo como Organização.
Copie a chave.
Etapa 2: iniciar a conexão no Lumos
No aplicativo Lumos, acesse Integrações > Adicionar integração e pesquise por "Anthropic (NHI)". A caixa de diálogo Conectar à Anthropic (NHI) é aberta com três seções.
Em Método de autenticação, escolha:
Chave de API da organização + Workload Identity Federation, sem dados de conformidade
Chave de API da organização + Workload Identity Federation + Chave de acesso de conformidade, se você adicionar dados de conformidade na Etapa 4
Em Recursos e configurações da integração:
Defina Escopo como Leitura. O campo usa Leitura + gravação por padrão, o que não concede nada aqui, pois o conector não registra nenhum recurso de gravação.
ID da organização é obrigatório. Cole o UUID dos Pré-requisitos.
Mantenha Plano Enterprise desativado, mesmo que você esteja em um plano Claude Enterprise. Ativá-lo impede que o Lumos leia agentes, contas de serviço e chaves de API.
ID da regra de federação, ID da conta de serviço e ID do espaço de trabalho padrão vêm da Etapa 3. Deixe-os em branco por enquanto.
Em Credenciais de autenticação:
Cole a chave da Etapa 1 em Chave de API da organização.
Em Workload Identity Federation, insira um Identificador da chave usando letras, números e hífens, como
lumos-anthropic-nhi. Selecione Obter chave e copie o JWK exibido. O Lumos gera o par de chaves e mantém a parte privada. O JWK é a parte pública, que você registrará na Anthropic na próxima etapa.
Mantenha a caixa de diálogo aberta se planeja configurar a Workload Identity Federation. Caso contrário, você pode ir para a Etapa 5.
Etapa 3: configurar a Workload Identity Federation na Anthropic
Contas de serviço são a única coisa que a Anthropic não retorna para uma chave de API. Elas precisam de um token OAuth contendo o escopo org:admin , e a federação é como o Lumos obtém um: ele assina uma asserção de curta duração com a chave da Etapa 2 e a troca por um token.
No Claude Console, conectado como administrador da organização, acesse Configurações > Workload Identity Federation e selecione Conectar carga de trabalho.
Crie o emissor:
Em Emissor, selecione Conectar um novo provedor, depois OIDC personalizado.
Preencha Nome.
Defina URL do emissor (declaração iss) como
https://lumos.com.Defina Fonte do JWKS como Chaves incorporadas.
Cole o JWK da Etapa 2 em Conjunto JWK (JSON).
Mantenha Vida útil máxima do token (horas) em 1.
Crie a regra de federação:
Preencha Nome da regra usando letras minúsculas, números e hífens.
Defina a declaração Subject (sub) exatamente como
lumos:anthropic-nhi, sem*à direita.Em Ativar em espaços de trabalho, ative Todos os espaços de trabalho (incluindo os futuros).
Expanda Opções avançadas da regra.
Defina o escopo do OAuth como
org:admin.Defina a duração do token como 1 hora.
Escolha o destino:
Selecione Criar um novo e dê um nome à conta de serviço, como
lumos-anthropic-nhi, ou escolha uma conta de serviço existente usada somente por este conector.A função da organização do destino deve ser de administrador. A Anthropic não concederá
org:adminpor meio de uma regra direcionada a um desenvolvedor.
Copie o ID da regra de federação (começa com fdrl_) e o ID da conta de serviço (começa com svac_).
Etapa 4: crie a chave de acesso de conformidade (opcional)
Ignore esta etapa, a menos que a organização do seu Console esteja vinculada a uma organização principal Claude Enterprise e você queira grupos e papéis de conformidade no Lumos. A caixa de diálogo do Lumos pode permanecer aberta enquanto você faz isso.
O proprietário principal da organização principal entra em claude.ai, acessa Configurações da organização > APIe cria uma chave em Chaves.
Conceda
read:compliance_org_dataeread:compliance_user_data.Copie a chave. Ela começa com
sk-ant-api01-.
Os escopos são fixados quando a chave é criada, portanto, uma chave sem um deles precisa ser substituída. Não conceda read:compliance_activities: o Lumos não lê o feed de atividades.
Etapa 5: conclua a conexão no Lumos
De volta à caixa de diálogo:
Cole o ID da regra de federação e o ID da conta de serviço nos respectivos campos.
Se você criou uma na Etapa 4, cole-a em Chave de acesso de conformidade.
Deixe ID do espaço de trabalho padrão como
default.
Selecione Validar, depois Concluir.
A validação verifica cada credencial com a Anthropic por meio de chamadas em tempo real. Ela confirma que a chave de API da organização pertence ao ID da organização informado, que a federação retorna um token contendo org:admin, e que a chave de acesso de conformidade pode ler grupos, membros e papéis de conformidade. Uma verificação malsucedida informa o que está errado. A opção Concluir executa as mesmas verificações novamente antes de salvar a conexão.
Conectando várias organizações
Uma conexão abrange uma organização, e uma chave criada em uma organização não pode ler outra. Se você tiver várias organizações do Console, incluindo várias vinculadas à mesma organização principal Claude Enterprise, repita estas etapas para cada uma.
O que o Lumos lê
Cada chamada vai para https://api.anthropic.com/v1. Todas são leituras, exceto a troca do token de federação.
Endpoint | Credencial | Para que serve |
|---|---|---|
| Chave de API da organização | Verificação da conexão e ID do locatário |
| Chave de API da organização | Membros e seus papéis na organização |
| Chave de API da organização | Chaves de API como credenciais, com status, criação e expiração, e a entidade principal que cada uma representa |
| Chave de API da organização | Espaços de trabalho como recursos |
| Chave de API da organização | Atribuições de papéis em espaços de trabalho |
| Chave de API da organização | Agentes gerenciados como contas não humanas |
| Federação | Troca uma declaração assinada por um token de curta duração |
| Federação | Contas de serviço como contas não humanas, com seus papéis na organização |
| Federação | Associação da conta de serviço ao espaço de trabalho |
| Chave de acesso de conformidade | Grupos de conformidade como recursos |
| Chave de acesso de conformidade | Associação a grupos de conformidade |
| Chave de acesso de conformidade | Papéis de conformidade como direitos de acesso |
Limitações da API
Estas são limitações do que a API da Anthropic expõe ou do que a integração lê atualmente:
As contas de serviço precisam de federação. A Anthropic as disponibiliza somente para um token OAuth de
org:adminde escopo. Sem federação, uma chave de API vinculada a uma conta de serviço aponta para uma conta que o Lumos ainda não leu.Não há indicação de último uso. O Lumos informa quando uma chave foi criada, quando expira e seu status, mas não quando foi usada pela última vez. O carimbo de data e hora atualizado de um agente corresponde à última alteração de configuração, não à última execução.
Agentes e contas de serviço arquivados aparecem como suspensos, portanto permanecem visíveis no inventário.
Os dados de conformidade exigem o Claude Enterprise. As chaves de acesso de conformidade existem somente em locatários Enterprise, portanto uma organização autônoma do Console se conecta sem elas.
Perguntas frequentes sobre segurança
O Lumos pode alterar algo na nossa organização da Anthropic?
Não. Somente recursos de leitura são registrados. A troca do token de federação é o único POST feito pelo conector, e ele gera um token que o Lumos usa somente para leituras. Nada no conector cria, atualiza ou exclui qualquer coisa.
O Lumos lê nossas conversas, arquivos ou projetos?
Não. Ele nunca chama a API de Messages e, na API de conformidade, chama três endpoints de diretório: grupos, membros de grupos e papéis da organização. Os endpoints que retornam conteúdo nunca são chamados. read:compliance_user_data também abrange alguns endpoints de conteúdo, pois é assim que a Anthropic agrupa seus escopos. O Lumos precisa dele para os membros dos grupos e nunca chama o restante.
O Lumos pode ler os segredos das nossas chaves de API?
Não. A Anthropic mostra o valor de uma chave uma vez, no momento da criação, e nunca o retorna pela API. O Lumos recebe metadados e uma indicação redigida.
Por que a chave precisa ter escopo de organização?
Uma chave com escopo de espaço de trabalho vê somente o próprio espaço de trabalho. O Lumos lê todos os espaços de trabalho e os membros e agentes dentro de cada um, portanto precisa de escopo de organização. Uma chave de administrador também funcionaria com a API, mas o Lumos a rejeita para que você não entregue uma credencial com acesso de gravação.
Por que a federação precisa de org:admin?
A Anthropic não disponibiliza contas de serviço para nenhum escopo mais restrito. org:admin é amplo, então veja o que o limita: cada token dura no máximo uma hora, só pode ser gerado com a chave privada criada pelo Lumos e é usado somente para leituras. Você pode desativar a regra a qualquer momento.
O que acontece quando a pessoa que criou a chave sai?
Uma chave vinculada a uma pessoa para de funcionar, e a conexão é interrompida com ela. Por isso, a Etapa 1 orienta vincular a chave a uma conta de serviço.
Como as credenciais são tratadas?
A Lumos armazena as chaves de API que você cola e a metade privada do par de chaves de federação que ela gerou. A chave privada nunca sai da Lumos e você nunca a vê. A Anthropic mantém apenas o JWK público. Alternar uma chave de API na Anthropic significa atualizá-la na Lumos, porque a antiga para de funcionar quando você a exclui.
Como revogamos o acesso da Lumos?
Exclua as chaves de API nas configurações do Console ou nas configurações da organização do claude.ai e exclua ou desative a regra de federação em Configurações e Federação de Identidade de Carga de Trabalho. A próxima sincronização falha na autenticação e a Lumos exibe um erro de conexão. Não é necessário fazer nenhuma limpeza do lado da Anthropic, pois a Lumos não criou nada lá.
Conexão rejeitada com "Esta é uma chave de API de administrador."
A chave começa com sk-ant-admin01-. Crie uma chave com Escopo definido como Organização, conforme descrito na Etapa 1.
Conexão rejeitada porque a chave pertence a uma organização diferente.
A chave e o ID da organização vêm de organizações diferentes. Corrija o ID da organização ou cole uma chave da organização pretendida.
"A Anthropic não aceitou a asserção assinada."
Verifique se o conjunto de JWKs do emissor contém o JWK de Obter chave, se a URL do emissor é exatamente https://lumos.com, se a declaração Assunto é exatamente lumos:anthropic-nhi, e se o ID da regra de federação e o ID da conta de serviço correspondem à regra.
"A regra de federação concede ...; este conector precisa de org:admin."
O escopo OAuth da regra está definido como outra coisa. Altere-o em Opções avançadas da regra e confirme que a conta de serviço de destino ainda possui o papel de administrador da organização.
"A chave de acesso à conformidade não pode ler grupos de conformidade" (ou papéis ou associações).
Está faltando um escopo na chave. Crie uma nova chave com os escopos da Etapa 2 e cole-a no lugar da anterior. Se uma chave com os escopos corretos ainda falhar, a API de conformidade provavelmente ainda não está habilitada para seu locatário. Consulte a equipe de contas da Anthropic.
A conexão foi salva, mas não há agentes, contas de serviço ou chaves de API.
Verifique se a configuração de integração do Plano Empresa está desativada. Se estiver, confirme se você conectou uma organização do Console, não uma do claude.ai. Se os agentes aparecerem, mas as contas de serviço não, verifique se a federação está configurada e se a regra está habilitada em todos os espaços de trabalho.
Alguns espaços de trabalho não têm agentes gerenciados.
Os Agentes gerenciados ainda não abrangem todos os espaços de trabalho. A Lumos ignora um espaço de trabalho sem esse recurso, portanto uma lacuna no inventário de agentes geralmente indica um espaço de trabalho sem agentes, não uma conexão com defeito.
Dúvidas? Entre em contato com a equipe de contas da Lumos ou pelo e-mail support@lumos.com.