Plugin B9 para Openfire

Atualizado em 30/08/2015 às 12:02hs (UTC-3)

O plugin B9 foi criado para agilizar a administração do seu servidor Openfire (versão 3.10.0 ou superior – uma versão compatível com Openfire >= 3.8.0 está disponível aqui) permitindo que tarefas sejam realizadas diretamente em seu cliente XMPP sem que haja necessidade de acessar o console admin no navegador.

Instalação

Você pode utilizar o console admin web para instalar o plugin através do recurso de upload disponível na página. Para atualizar basta fazer o upload da nova versão.

Estou verificando a possibilidade de colocar o plugin na lista oficial do Openfire, facilitando a instalação e atualização do mesmo.

Mais notícias sobre isso em breve.

Usando o plugin

Para usar o plugin, basta adicionar o JID b9@adminbot.seudominiojabber.com em sua conta e começar a enviar mensagens para ele. Os comandos válidos são:

anonymous login: informa se o servidor aceita login anônimo.
anonymous login disable: proíbe o login anônimo.
anonymous login enable: permite o login anônimo.
c2s compression: verifica o status da compressão das conexões dos clientes.
c2s compression disable: desativa a compressão das conexões dos clientes.
c2s compression enable: permite a compressão das conexões dos clientes (opcional).
create conference room_name [members]: cria a conferência room_name e convida membros (JIDs separados por vírgula – parâmetro opcional).
free memory: exibe a memória livre disponível para a jvm.
group members <nome do grupo>: exibe a lista de membros do grupo informado.
help: exibe a ajuda (em inglês).
invite conference room_name members: convida membros (JIDs separados por vírgulas) para juntar-se a sala de conferência.
java version: exibe a versão do Java.
list conferences: lista as salas de conferência disponíveis.
list groups: lista os grupos disponíveis.
max memory: exibe a memório máxima disponivel para a jvm.
online users: exibe o número de usuários online.
openfire version: exibe a versão do openfire.
openfire host: exibe o hostname do servidor openfire.
openfire uptime: exibe a última data de inicialização do serviço.
s2s compression: verifica o status da compressão das conexões dos servidores.
s2s compression disable: desativa a compressão das conexões dos servidores.
s2s compression enable: permite a compressão das conexões dos servidores (opcional).
s2s config: exibe a configuração atual do s2s.
s2s config disable: desativa o s2s.
s2s config enable: ativa o s2s.
s2s blacklist: exibe os domínios cadastrados na lista negra do s2s.
s2s blacklist add <domínio jabber>: adiciona um domínio à lista negra do s2s.
s2s blacklist del <domínio jabber>: deleta um domínio da lista negra do s2s.
s2s blacklist disable: desativa a lista negra do s2s (e ativa a lista branca).
s2s blacklist enable: ativa a lista negra do s2s (e desativa a lista branca).
s2s whitelist: exibe os domínios cadastrados na lista branca do s2s.
s2s whitelist add <domínio jabber> [porta]: adiciona um domínio à lista branca do s2s.
s2s whitelist del <domínio jabber>: deleta um domínio da lista branca do s2s.
s2s whitelist disable: desativa a lista branca do s2s (e ativa a lista negra).
s2s whitelist enable: ativa a lista branca do s2s (e desativa a lista negra).
server sessions: exibe o número de sessões de entrada de servidores (s2s).
total memory: exibe a memória total disponível para a jvm.
total users: exibe o número total de usuários.
used memory: exibe a memória usada pela jvm.
user info <nome do usuário>: exibe informações do usuário.
version: exibe a versão do plugin b9.

Conexão por socket

A partir da versão 0.3 é possível conectar-se ao plugin e enviar comandos através de sockets. A porta padrão é a 4556 e o IP é o localhost. O recurso vem desativado por padrão, sendo necessário ativá-lo na página de configuração do plugin no console admin.

Página web de administração do plugin

A partir da versão 0.3 o B9 possui uma página de administração no console admin onde é possível ativar/desativar as conexões via socket, bem como alterar a porta e o IP padrão e também a senha de acesso.

Acesso restrito

Acesso XMPP: o acesso XMPP ao plugin está restrito aos usuários (JIDs) listados como administradores do Openfire.

Acesso via socket: o acesso via socket foi protegido com uma senha (definida na página de configuração do plugin), que deve ser indicada para que o plugin passe a aceitar os comandos. Para enviar a senha basta usar o comando:

login senha

Onde senha é a senha que você definiu para o plugin.

Questões conhecidas

A adição de servidores as listas brancas e negras não valida o hostname ou IP informado (comportamento similar ao do Openfire).

Roadmap

Desenvolvimento de um webservices.

Download

Você pode baixar o plugin B9 versão 0.3.1 diretamente do site do Mundo Open Source. Caso você esteja rodando uma versão mais antiga do Openfire(>= 3.8.0), baixe a versão 0.3 aqui.

Changelog

Disponível aqui.

Código fonte

O código fonte foi colocado no GitHub e está disponível nesta URL (licenciado sobre a GPL v2.0).