O JMBA Hub leva o GLPI para o telemóvel: o técnico acompanha os pedidos e recebe as notificações na aplicação Android, sem abrir o navegador. Este guia mostra como instalar a aplicação, preparar o GLPI com o plugin e a API e iniciar sessão pela primeira vez.
O JMBA Hub é desenvolvido pela JMBA Soluções. Os ecrãs deste tutorial são de uma instalação real do GLPI 11.0.11 com o plugin JMBA Hub 1.4.0.
O que precisa
- Um telemóvel Android com acesso à Google Play.
- O endereço do GLPI da sua organização e um utilizador válido nele.
- Para os passos 2 a 4, um perfil no GLPI que possa administrar plugins e a configuração geral.
1. Instale a aplicação
O JMBA Hub está publicado na Google Play. No telemóvel, abra a página do JMBA Hub na Google Play (ou pesquise JMBA Hub na loja) e toque em Instalar.
2. Instale o plugin JMBA Hub no GLPI
O plugin liga o GLPI à aplicação e reúne as definições de acesso e de notificações. O código é público, no repositório JMBA-Solucoes/jmbahub, e o pacote está na release 1.4.0: transferência ZIP ou transferência TAR.GZ.
Atenção: faça uma cópia de segurança do GLPI antes de instalar um plugin numa instalação em uso.
- Extraia o pacote para o diretório
pluginsdo GLPI. - Confirme que a pasta ficou em
plugins/jmbahub, com esse nome exato, sem hífen. - Entre no GLPI com um perfil que possa administrar plugins.
- Abra Configuração > Plugins, localize o JMBA Hub, clique em instalar e depois em ativar.
Se tem acesso ao servidor, os passos 1 e 2 ficam assim (ajuste o caminho do GLPI e o utilizador do servidor web: www-data no Debian e no Ubuntu, apache no Red Hat e derivados):
# Descarregar e extrair o plugin para a pasta de plugins do GLPI
cd /var/www/glpi/plugins
sudo wget https://github.com/JMBA-Solucoes/jmbahub/releases/download/v1.4.0/jmbahub-1.4.0.tar.gz
sudo tar -xzf jmbahub-1.4.0.tar.gz
sudo chown -R www-data:www-data jmbahub
# Confirmar que a pasta tem o nome certo
ls -d jmbahubPrefira os pacotes da release: já trazem a pasta com o nome certo. O README do plugin tem a instalação pela consola e os detalhes de compatibilidade.
3. Ative a API REST legada
A aplicação usa a API do GLPI para autenticar o utilizador e consultar os dados de acordo com as permissões de cada perfil. No GLPI 11, o ecrã separa a API nova da API REST legada. O início de sessão do JMBA Hub usa hoje a API legada com utilizador e palavra-passe, por isso ativar só a API nova não chega.
- Abra Configuração > Geral > API.
- Na secção API legada, ative Ativar REST API legada e confirme se o GLPI pedir.
- Ative Ativar início de sessão com credenciais.
- Clique em Guardar.
Dica: a opção Ativar início de sessão com token externo é outra coisa. Aparece ligada na captura, mas não é necessária para o início de sessão da aplicação com utilizador e palavra-passe.
Crie um cliente de API para o JMBA Hub
No mesmo ecrã, em Clientes de API (API legada), crie um cliente chamado JMBA Hub e deixe-o Ativo. Sem ele, a aplicação não consegue aceder à API legada.
Deixe em branco as gamas de endereços IPv4 e IPv6 e o campo App-Token: assim o acesso não fica preso a um IP, já que o telemóvel muda de rede, nem exige App-Token. Guarde o cliente antes de continuar.
4. Configure o plugin e autorize os utilizadores
Abra a configuração do JMBA Hub na lista de plugins. O painel tem o controlo de acesso à aplicação e as regras de notificação.
- Controlo de acesso à aplicação: ligado, só os utilizadores autorizados entram pela aplicação. Autorize cada um no separador JMBA Hub da ficha do utilizador ou pelas ações em massa em Administração > Utilizadores.
- Notificações: use Ativar notificações ou Verificar e reparar, conforme o estado apresentado. Confirme o URL base do GLPI e a comunicação com o serviço do JMBA Hub.
- Destinatários: escolha que eventos vão para requerentes, observadores e técnicos.
Os ecrãs da aplicação e o envio das notificações dependem do serviço do JMBA Hub. O plugin não substitui as permissões dos perfis no GLPI: a aplicação mostra só o que o perfil de cada utilizador pode ver.
5. Inicie sessão pela primeira vez
Abra o JMBA Hub no Android, indique o endereço do GLPI e inicie sessão com o seu utilizador e palavra-passe do GLPI. Use o endereço base, com o subdiretório se existir, por exemplo https://glpi.suaempresa.pt ou https://suaempresa.pt/glpi.
Confirme que consegue entrar, ver os pedidos que o seu perfil permite e abrir os detalhes de um deles. Depois, permita as notificações da aplicação no Android e teste com um evento real.
Checklist de instalação
- Instalar a aplicação JMBA Hub a partir da Google Play.
- Extrair o plugin para
plugins/jmbahub, instalar e ativar. - Ativar a API REST legada e o início de sessão com credenciais.
- Criar o cliente de API JMBA Hub e deixá-lo ativo.
- Autorizar os utilizadores no controlo de acesso do plugin.
- Entrar na aplicação e abrir os detalhes de um pedido.
- Permitir as notificações no Android e testar com um evento.
Problemas comuns
- Início de sessão recusado: confirme utilizador e palavra-passe, a API REST legada, o início de sessão com credenciais, o cliente de API ativo e a autorização do utilizador no plugin.
- Falha de ligação: confirme o URL do GLPI (com
httpse o subdiretório, se existir), se o servidor responde fora da rede interna e as regras do cliente de API. - As notificações não chegam: confirme que estão permitidas para a aplicação no Android e use Verificar e reparar no painel do plugin.
- O logótipo ou as alterações do plugin não aparecem: limpe a cache do GLPI. Se o PHP usa
opcache.validate_timestamps=0, recarregue o PHP-FPM para as alterações nos ficheiros terem efeito.
Ligações para começar
Encontrou um problema? Fale com a JMBA Soluções e indique a versão do GLPI, o modelo do telemóvel e os passos para o reproduzir, sem enviar palavras-passe, tokens ou dados pessoais dos pedidos.
As capturas de ecrã são de uma instalação real do GLPI 11 com o plugin JMBA Hub 1.4.0. GLPI é marca registada da Teclib'.
