> ## 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 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](/pt/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 **Contas de serviço** do
[Developer Hub](/pt/developers/developer-hub/overview).

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

## Criar uma conta de serviço

<Steps>
  <Step title="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.
  </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 todas as credenciais criadas na conta: uma credencial pode conter um subconjunto
    dessas permissões, nunca mais do que isso.

    <Tip>
      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.
    </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 em que você [cria as chaves de API correspondentes](/pt/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 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.


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