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 possui as permissões que essas credenciais podem utilizar; por isso, a revisão de acesso ocorre 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 respectivo ID 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 Contas de serviço do Developer Hub.

​
Estruture suas contas em torno de cargas de trabalho

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

​
Criar uma conta de serviço

1

Nomeie a conta

Atribua à conta um nome que identifique a carga de trabalho atendida e uma descrição de sua finalidade. 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 todas as credenciais criadas na conta: uma credencial pode conter um subconjunto dessas permissões, nunca mais do que isso.
Conceda o mínimo de que a carga de trabalho 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 em que você cria as chaves de API correspondentes.

​
Gerencie o ciclo de vida

  • Edite as permissões a qualquer momento. Remover uma permissão da conta a remove do que suas chaves de API e tokens de acesso OAuth podem exercer.
  • Desative uma conta para interromper o acesso à API por meio de todas as suas credenciais — útil ao desligar uma integração ou ao conter um suspeito vazamento de credencial enquanto você investiga. Reativá-la permite que as credenciais que ainda estejam ativas e não tenham expirado voltem a autenticar.
  • Exclua uma conta quando a integração tiver sido desativada em definitivo. Interrompa a integração e revogue suas credenciais antes. 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 utilizada pela última vez — uma forma rápida de identificar integrações abandonadas que devem ser desativadas.