Como gerenciar usuários API
Este guia apresenta como gerenciar os usuários API existentes, incluindo visualização, edição e consulta.
ETAPA 1 – Acessar a lista de Usuários
1.1 – Selecione o acesso Galgo com perfil Supervisor
Antes de gerenciar usuários API, certifique-se de estar com um acesso Galgo com perfil Supervisor ou Administrador selecionado.
No menu superior direito, clique no ícone ao lado do nome e abra o modal "Meus acessos". Selecione um acesso com serviço Galgo e perfil adequado.
1.2 – Acesse a lista de usuários
No menu superior, acesse USUÁRIOS e clique em "Ver Usuários".
ETAPA 2 – Consultar Usuários API
2.1 – Visualize a lista de usuários
Na tela de Consulta Usuários, você verá todos os usuários cadastrados na instituição.
2.2 – Identificando usuários API
Os usuários API são identificados pela tag "USUÁRIO DE API GALGO" na coluna "Tipo de usuário".
2.3 – Filtrar usuários
Você pode usar a barra de busca para filtrar usuários por nome, e-mail ou username.
Utilize também o botão "Filtro avançado" para filtros mais específicos.
| Coluna | Descrição |
|---|---|
| Dados do usuário | Nome/username do usuário |
| Dados da instituição | Instituição vinculada |
| Tipo de usuário | Indica se é usuário de API Galgo |
| Papel | Papel do usuário no sistema |
| Perfil | Perfil de acesso |
| Serviço | Serviço vinculado |
| Ações | Opções de edição |
ETAPA 3 – Editar Usuário API
3.1 – Acessar a edição
Na lista de usuários, clique no ícone de editar (lápis) na coluna "Ações" do usuário que deseja alterar.
3.2 – Campos editáveis
Ao editar um usuário API, você pode alterar:
• Configurações de acesso – Adicionar ou remover configurações (instituição, papel, permissões)
• Permissões e Funcionalidades – Alterar as permissões do usuário
⚠️ Campos NÃO editáveis:
• E-mail – O e-mail não pode ser alterado após a criação
• Username – O username é fixo e não pode ser modificado
• Toggle Usuário API Galgo – Não é possível converter um usuário API em usuário portal (ou vice-versa)
3.3 – Salvando alterações
Após fazer as alterações desejadas:
- Navegue pelas etapas usando os botões "Voltar" e "Próximo"
- Revise as alterações na etapa de Revisão
- Clique em "Finalizar" para salvar
Boas Práticas de Gerenciamento
✅ Recomendado
• Revise periodicamente os usuários API – Desative ou remova usuários que não estão mais em uso
• Mantenha o mínimo de permissões necessárias – Princípio do menor privilégio
• Documente internamente quais sistemas usam cada usuário API – Facilita a manutenção
• Monitore o uso das APIs – Identifique comportamentos anômalos
❌ Evite
• Compartilhar o mesmo usuário API entre múltiplos sistemas independentes
• Criar usuários API com permissões excessivas
• Deixar usuários API inativos sem desativar
Problemas Comuns
Não consigo ver a opção de Usuários API
Causa: Você não está com um acesso Galgo com perfil Supervisor/Administrador selecionado.
Solução: Acesse "Meus acessos" e selecione um acesso Galgo com o perfil adequado.
As credenciais do usuário API não funcionam
Possíveis causas:
- Credenciais digitadas incorretamente
- Senha foi resetada
- Usuário foi desativado
Solução: Verifique o status do usuário e considere realizar um reset de senha.
Preciso alterar o e-mail ou username
Situação: O e-mail ou username não podem ser alterados após a criação.
Solução: Crie um novo usuário API com os dados corretos e desative o anterior.
Próximos Passos
• Como criar um usuário API – Voltar ao guia de criação
• Como usar o usuário API – Ver como autenticar nas APIs