Skip to main content
Uma conta de serviço é uma identidade nomeada para uma integração. Ela é proprietária de chaves de API ou clientes OAuth e reúne as permissões que essas credenciais podem usar; assim, a revisão de acesso é feita no nível da conta: o que uma integração pode fazer fica visível em um único lugar, independentemente de quantas credenciais ela possua. A conta em si não é uma credencial: o ID dela não pode autenticar uma requisição. Consulte Autenticação para escolher um método; uma integração com chave de API não precisa de OAuth. Gerencie as contas de serviço na guia Service accounts do Developer Hub.

​
Estruture suas contas em torno de workloads

Crie uma conta de serviço por integração ou workload — por exemplo, reporting-pipeline, scim-sync ou soc-enrichment — em vez de uma única conta abrangente para tudo. Contas por workload mantêm as permissões no mínimo necessário, tornam os logs de requisições rastreáveis e permitem desativar uma integração sem afetar as demais.

​
Criar uma conta de serviço

1

Nomeie a conta

Dê à conta um nome que identifique o workload a que ela atende e uma descrição do que ela faz. Ambos aparecem em listas e logs, para que os futuros administradores possam distinguir as contas.
2

Conceda permissões

Selecione as permissões que a conta pode conceder às suas credenciais — por exemplo, entity:read, simulation:read ou reporting:read. Esse conjunto é o limite máximo para cada credencial criada na conta: uma credencial pode ter um subconjunto dessas permissões, nunca mais do que isso.
Conceda o mínimo de que o workload precisa hoje. Você pode adicionar permissões à conta posteriormente; as credenciais existentes mantêm os escopos que lhes foram concedidos.
3

Revise e crie

Confirme o nome e o conjunto de permissões. Após a criação, a página de detalhes da conta é o local para criar as chaves de API dela.

​
Gerencie o ciclo de vida

  • Edite as permissões a qualquer momento. Remover uma permissão da conta a remove do que as chaves de API e os tokens de acesso OAuth da conta podem exercer.
  • Desative uma conta para interromper o acesso à API por meio de todas as suas credenciais — útil ao desativar uma integração ou conter um suspeito vazamento de credencial enquanto você investiga. Reativar a conta permite que as credenciais que ainda estejam ativas e não expiradas voltem a autenticar.
  • Exclua uma conta quando a integração tiver sido desativada em definitivo. Antes, interrompa a integração e revogue as credenciais dela. A exclusão é permanente.
A página de detalhes de cada conta mostra quem a criou, quando foi criada e quando uma de suas chaves foi usada pela última vez — uma forma rápida de identificar integrações abandonadas que devem ser desativadas.