¶ Manual Usuário de Serviço
Este manual tem como finalidade explicar o funcionamento, configuração e regras de uso dos Usuários de Serviço no sistema Questor, especificamente para acesso via API (nWeb/nHttp) sem consumir uma licença adicional de estação.
¶ O que é um Usuário de Serviço?
Usuário de Serviço é um tipo especial de usuário criado exclusivamente para realizar integrações via API (nWeb/nHttp) ou automações com Jobs. Sua principal característica é não consumir licença de estação ao realizar operações automatizadas.
¶ Motivo da Implementação
Anteriormente, as integrações com o sistema por meio do nHttp/nServerConfig contavam como uma estação logada, impactando na contagem de licenças. Para evitar esse consumo indevido e alinhar com a política comercial (que já não considera consumo de licença via nWeb legado), foi criada a funcionalidade de Usuário de Serviço.
¶ Funcionalidades e Restrições
-
Permissões:
- Acesso via API (endpoint /api) com token.
- Acesso via nWeb e nSQL com token.
- Execução de Jobs e integrações automatizadas.
-
Restrições:
- Não pode acessar o Cloud normalmente;
- Não pode acessar módulos do sistema desktop;
- Ao tentar logar fora da API, será exibida mensagem de erro.
¶ Como configurar um Usuário de Serviço
- Acesse o cadastro de usuários no sistema.
- Localize o novo campo “Usuário de Serviço”.
- Marque a opção como “Sim”.
¶ Comportamento Esperado
| Situação | Resultado Esperado |
|---|---|
| Login via API com token (usuário de serviço) | ■ Permitido |
| Login no Cloud ou módulos (usuário de serviço) | ■ Negado com erro |
| Login via API com usuário comum | ■ Permitido, conta estação |
| Uso via Jobs ou nWeb com usuário comum | ■ Conta estação |
| Uso via Jobs ou nWeb com usuário de serviço | ■ Não conta estação |
¶ Considerações Técnicas
- Caso o campo “Usuário de Serviço” não exista na base, o sistema assume que o usuário não é de serviço, sem gerar erros:
- A funcionalidade está disponível a partir da versão 25.7.0.0 (branch) e 25.8.0.0 (trunk).
- Não interfere nas regras de autenticação para usuários comuns.
¶ Comunicação com o Cliente
A equipe comercial e de implantação deve orientar o cliente a:
- Criar um usuário específico marcado como “Usuário de Serviço”.
- Utilizar este usuário apenas para integração via API ou Jobs.
- Evitar o uso desse usuário para login manual no sistema.
¶ Conclusão
O recurso de Usuário de Serviço evita o consumo indevido de licenças em integrações automatizadas, mantendo o controle e a rastreabilidade no sistema Questor.