> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contas de serviço

> Crie e gerencie as identidades de integração que são proprietárias das chaves de API e dos clientes OAuth da sua organização.

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](/pt-BR/developers/v1/authentication)
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](/pt-BR/developers/developer-hub/overview).

## 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](/pt-BR/developers/developer-hub/request-logs)
rastreáveis e permitem desativar uma integração sem afetar as
demais.

## Criar uma conta de serviço

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.

    <Tip>
      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.
    </Tip>
  </Step>

  <Step title="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](/pt-BR/developers/developer-hub/api-keys).
  </Step>
</Steps>

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.