O JMBA Hub, desenvolvido pela JMBA Soluções, conecta o seu GLPI ao celular para acompanhar chamados e receber notificações. Neste guia, você encontra os links para participar dos testes no Android e o passo a passo para preparar o GLPI com o plugin e a API.
As telas deste tutorial foram capturadas em uma instalação real do GLPI 11.0.8, com o plugin JMBA Hub 1.4.0. O aplicativo está em fase de testes: use a mesma conta Google no grupo de testadores, na adesão ao teste e na Play Store.
1. Entre no grupo de testadores
O primeiro passo é acessar o grupo Testadores JMBA Hub no Google Groups. Faça login com a conta Google que você utiliza no seu celular Android e solicite ou confirme sua participação, conforme as opções apresentadas.
Se aparecer uma mensagem de acesso restrito, verifique se está conectado à conta correta. Caso a entrada dependa de aprovação, aguarde a liberação ou entre em contato com os administradores do grupo antes de tentar instalar o aplicativo.
2. Participe do teste e baixe o aplicativo
Com a conta autorizada no grupo, abra a página de participação no teste do JMBA Hub.
Aceite participar do programa de testes.
Use o link exibido pelo Google para instalar o app ou abra a página do JMBA Hub na Google Play.
O acesso ao download depende da liberação da sua conta no teste. Se a Play Store informar que o aplicativo não foi encontrado ou não está disponível, confira a conta selecionada, a entrada no grupo e a adesão ao teste. O link pode não funcionar para visitantes sem login ou sem acesso ao programa.
Para usar o aplicativo, você também precisa do endereço do GLPI da sua organização e de um usuário válido nessa instalação. A participação no grupo não cria uma conta no GLPI.
3. Baixe e instale o plugin JMBA Hub
O plugin integra o GLPI ao aplicativo e reúne as configurações de controle de acesso e notificações. O código é público e está no repositório JMBA-Solucoes/jmbahub.
Baixe o pacote na release 1.4.0: download ZIP ou download TAR.GZ.
Faça um backup antes de alterar uma instalação em uso.
Extraia o pacote dentro do diretório
pluginsdo GLPI.Confira se o arquivo ficou em
plugins/jmbahub. A pasta deve se chamar jmbahub, sem hífen.Acesse o GLPI com um perfil que possa administrar plugins.
Abra Configuração → Plug-ins, localize JMBA Hub e execute as ações de instalar e ativar.
Prefira os pacotes ZIP ou TAR.GZ anexados à release: eles já incluem a pasta com o nome correto. Consulte o README do plugin para instalação pelo console e detalhes de compatibilidade.
JMBA Hub 1.4.0 na lista de plugins do GLPI, com autoria JMBA Soluções.
4. Habilite a API do GLPI
O aplicativo utiliza a API para autenticar o usuário e consultar os dados conforme as permissões do GLPI. No GLPI 11, a tela distingue a nova API da API REST legada. O fluxo atual de login do JMBA Hub utiliza a API legada com usuário e senha; habilitar apenas a nova API não atende a esse fluxo.
Acesse Configuração → Geral → API.
Na seção API Legada, ative Habilitar REST API legada. Se o GLPI pedir confirmação, confirme para utilizar essa integração.
Ative Habilitar login com credenciais.
Clique em Salvar.
Tela de API do GLPI 11.0.8. Os campos de endereço do servidor foram ocultados no print.
A opção Habilitar que se faça login com token externo é diferente do login com usuário e senha. Ela aparece ligada no ambiente do print, mas não precisa ser ativada apenas para esse fluxo de login do aplicativo.
Crie um cliente de API para o JMBA Hub
Na mesma aba, em Clientes de API (API Legado), crie um cliente para o JMBA Hub e deixe-o Ativo. Essa etapa é necessária para permitir que o aplicativo acesse a API legada do GLPI.
Deixe em branco os campos de intervalo de endereços IPv4 e IPv6 e também o campo App-Token. Assim, o acesso não ficará limitado a um IP específico nem exigirá um App-Token. Salve o cliente antes de continuar.
5. Configure o plugin e o acesso dos usuários
Abra as configurações do JMBA Hub na lista de plugins. O painel permite ajustar o controle de acesso ao aplicativo e as regras de notificações.
Painel do JMBA Hub: notificações e seleção de destinatários por evento.
Controle de acesso ao app: quando ativado, somente os usuários habilitados podem entrar pelo aplicativo. Gerencie o acesso na aba JMBA Hub da ficha do usuário ou pelas ações em massa em Administração → Usuários.
Notificações: use Ativar notificações ou Verificar e reparar, conforme o estado exibido. Confira a URL base do GLPI e a comunicação com o serviço JMBA Hub.
Destinatários: defina quais eventos serão enviados a requerentes, observadores e técnicos.
O plugin depende do backend JMBA Hub para os fluxos móveis e a entrega das notificações. Sua instalação não substitui a configuração dessa integração nem as permissões dos perfis no GLPI.
6. Faça o primeiro login e valide
Abra o JMBA Hub no Android, informe o endereço do GLPI da sua organização e entre com seu usuário e senha. Use o endereço base do sistema, por exemplo https://glpi.suaempresa.com.br, respeitando também eventual subdiretório da instalação.
Confirme que consegue entrar, visualizar os chamados permitidos para seu perfil e abrir os detalhes de um chamado. Se as notificações estiverem configuradas, permita as notificações no Android e valide um evento com a equipe de suporte.
Problemas comuns
App indisponível na Play Store: confira a conta Google, o vínculo com o grupo e a participação no teste.
Login recusado: valide as credenciais, a API REST legada, o login com credenciais e a liberação do usuário no plugin.
Falha de conexão: confira a URL do GLPI, a disponibilidade do servidor e as regras do cliente de API.
Logo ou alterações do plugin não aparecem: limpe o cache do GLPI. Se o PHP usa
opcache.validate_timestamps=0, o administrador precisa recarregar o PHP-FPM para aplicar alterações nos arquivos.
Links para começar
Durante os testes, envie seu feedback pelo grupo. Informe a versão do GLPI, o modelo do celular e os passos para reproduzir o problema, sem incluir senhas, tokens ou dados pessoais dos chamados.
