Visão geral dos usuários de serviço

Um usuário de serviço é uma identidade para um sistema, e não para uma pessoa: uma integração, uma automação, um script ou uma rotina de back-end que precisa trabalhar com os dados da sua organização pela API do BreezeAuth. Por exemplo, o sistema que mantém a sua plataforma de RH sincronizada com o BreezeAuth, ou uma rotina noturna que exporta os seus logs de auditoria.

Os usuários de serviço ficam na sua organização, ao lado das pessoas, em Usuários › Usuários de Serviço. Como qualquer usuário, cada um tem um papel administrativo que define o que ele pode fazer. Diferentemente das pessoas, eles não têm e-mail nem senha, não podem entrar no console de administração nem nas aplicações e se autenticam apenas com credenciais.

Por que usar um usuário de serviço

É tentador deixar uma integração usar a conta da pessoa que a configurou. Os usuários de serviço evitam os problemas que vêm com isso:

As integrações não dependem de uma pessoa. Quando alguém muda de equipe ou sai da empresa e a sua conta é removida, as integrações que a usavam deixariam de funcionar. Um usuário de serviço pertence à organização, não a uma pessoa.
Apenas o acesso de que a integração precisa. Cada usuário de serviço tem o seu próprio papel, normalmente bem mais restrito que o do administrador que o configura.
Nenhuma senha compartilhada, nenhum desafio de MFA. As integrações se autenticam com um client ID e um client secret feitos para máquinas e nunca precisam responder a um desafio de autenticação multifator.
Trilha de auditoria clara. As ações aparecem nos Logs de Auditoria com o nome do usuário de serviço, então você sempre sabe qual integração fez o quê.
Revogar uma integração sem afetar as outras. Desativar um usuário de serviço, ou uma das suas credenciais, interrompe apenas aquela integração.

Usuários de serviço comparados a pessoas

	Pessoas (usuários humanos)	Usuários de serviço
Representa	Uma pessoa	Um sistema: integração, automação, script
Entra com	E-mail e senha, passkeys, single sign-on	Apenas credenciais (client ID e client secret)
Autenticação multifator	Sim	Não se aplica
Console de administração	Sim, conforme o papel	Não
Usa a API do BreezeAuth	Pelo console de administração	Diretamente, com tokens de acesso
Papel administrativo	Qualquer um, inclusive Proprietário	Qualquer um, exceto Proprietário
Grupos e aplicações	Pode ser adicionado a grupos e atribuído a aplicações	Não pode ser adicionado a grupos nem atribuído a aplicações

Como funciona

Crie um usuário de serviçoDê a ele um nome e o papel de que a sua integração precisa.
Crie uma credencialVocê recebe um client ID e um client secret. O secret é exibido uma única vez.
Solicite um token de acessoA integração envia a credencial para /oauth/token e recebe um token de curta duração.
Chame a APIA integração envia o token em cada requisição. Quando ele expira, ela solicita um novo.

Usos comuns

Provisionamento. Um sistema como uma plataforma de RH ou outro diretório cria, atualiza e remove usuários e grupos no BreezeAuth. O papel Provisionador SCIM foi feito para isso. Veja Provisionamento SCIM.
Reagir a webhooks. Quando um webhook avisa o seu sistema de que algo mudou, um usuário de serviço lê os detalhes na API.
Relatórios e conformidade. Uma rotina agendada exporta os logs de auditoria ou lista usuários e os seus acessos. O papel Auditor dá acesso somente leitura.
Ferramentas internas. Scripts de back-office que automatizam tarefas administrativas rotineiras.

Nesta seção

Criar e gerenciar usuários de serviço: criar, escolher um papel, desativar e excluir.
Credenciais: criar, rotacionar, desativar e excluir as credenciais de um usuário de serviço.
Tokens de acesso: trocar uma credencial por um token e chamar a API (técnico).
Restrições e segurança: limitar o que os usuários de serviço podem fazer e de onde podem se conectar.