crphp/wmic

Está biblioteca disponibiliza um mecanismo para CONSULTAR máquinas Windows remotamente

crphp/wmic

Está biblioteca faz uso do WQL (WMI Query Language) para disparar exclusivamente consultas remotas a máquinas Windows., _(*1)

crphp/wmi e crphp/wmic possuem os mesmos recursos de consulta, porém, somente crphp/wmi tem a capacidade de gerenciar recursos remotos, como parar serviços, matar processos etc., _(*2)

Está biblioteca segue os padrões descritos na PSR-2, logo, isso implica que a mesma está em conformidade com a PSR-1., _(*3)

As palavras-chave "DEVE", "NÃO DEVE", "REQUER", "DEVERIA", "NÃO DEVERIA", "PODERIA", "NÃO PODERIA", "RECOMENDÁVEL", "PODE", e "OPCIONAL" neste documento devem ser interpretadas como descritas no RFC 2119. Tradução livre RFC 2119 pt-br., _(*4)

1. Referências
2. Funcionalidades
3. Requisitos (recomendados)
4. Compilando e testando o WMIC
5. Preparando as máquinas cliente
6. Baixando o pacote crphp/wmic para o servidor
7. Exemplos de uso
8. Licença (MIT)

1 - Referências

• PSR-1
• PSR-2
• RFC 2119. Tradução livre RFC 2119 pt-br

2 - Funcionalidades

• [x] Consultar CPU
• [x] Consultar RAM
• [x] Consultar Disco Rígido
• [x] Consultar Serviço
• [x] Listar Serviços
• [x] Consultar processo
• [x] Listar processos
• [x] Transformação de timestamp Windows para data/hora
• [ ] Listar sessões

3 - Preparando o servidor

:exclamation: Os requisitos sugeridos logo abaixo representam as versões utilizadas em nosso ambiente de desenvolvimento e produção, logo não garantimos que a solução aqui apresentada irá rodar integralmente caso as versões dos elementos abaixo sejam outras., _(*5)

3.1 - Requisitos (recomendados)

Servidor - REQUER Debian >= 8.5.0 (32 ou 64 Bits) - REQUER wmi-1.3.14 (código fonte) - REQUER Apache >= 2.4.10 - REQUER PHP >= 5.5.12, _(*6)

Cliente - REQUER Windows (desktop >= Windows 7 ou Windows Server >= 2003) - NÃO REQUER a instalação de nenhum componente, _(*7)

4 - Compilando e testando o WMIC

Estou presupondo que você já tem uma distribuição GNU/Linux, preferencialmente Debian, com Apache e PHP devidamente configurados., _(*8)

4.1 - autoconf

Instalando autoconf, make e gcc:, _(*9)

# apt-get install autoconf
# apt-get install make
# apt-get install gcc

4.2 - wmi-1.3.14

Etapa 1 - download e extração dos fonts do WMIC:, _(*10)

$ wget http://www.openvas.org/download/wmi/wmi-1.3.14.tar.bz2
$ tar -xvf wmi-1.3.14.tar.bz2

Etapa 2 - Configurar GNUmakefile, _(*11)

$ cd wmi-1.3.14/
$ sed -i "1s/^/ZENHOME=..\/..\n/" GNUmakefile

Etapa 3 - Compilar WMIC, _(*12)

$ make "CPP=gcc -E -ffreestanding"

Ao fim da execução do comando make você saberá que terá corrido tudo bem caso as ultimas 3 linhas de output sejam algo parecido com:, _(*13)

cp: o alvo “../../lib/python” não é um diretório
GNUmakefile:43: recipe for target 'pywmi-installed' failed
make: *** [pywmi-installed] Error 1

Etapa 4 - Renomear binário e testando:, _(*14)

$ mv bin wmic
$ ./wmic -U usuario%'senha' //ip "SELECT Caption FROM Win32_OperatingSystem"

Output do comando executado acima:, _(*15)

CLASS: Win32_OperatingSystem
Caption
Microsoft« Windows Server« 2008 Enterprise 

Obs: Caso ocorra erro de conexão consulte o tópico 5 para liberar regra de firewall no cliente, _(*16)

Etapa 5 - Adicionando binário a um diretório de "sistema":, _(*17)

$ mv wmic /usr/bin/

5 - Preparando a máquina cliente

Essas configurações DEVE ser executadas em todas as máquinas (cliente) alvos de gerenciamento remoto., _(*18)

Caminho para as regras de firewall:, _(*19)

Painel de Controle > Ferramentas Administrativas > Firewall do Windows com Segurança Avançada

Para permitir as conexões externa teremos que habilitar as Regras de Entrada:, _(*20)

Instrumentação de Gerenciamento do Windows (DCOM-In)
Instrumentação de Gerenciamento do Windows (WMI-In)

E as Regras de Saída:, _(*21)

Instrumentação de Gerenciamento do Windows (WMI-Saída)

Para não ter problema, é RECOMENDÁVEL que o usuário de conexão remota tenha privilégio de administrador na máquina de destino. Obviamente você PODE configurar o contexto de acesso caso tenha alguma familiridade com este assunto., _(*22)

6 - Baixando o pacote crphp/wmic para o servidor

Para a etapa abaixo estou pressupondo que você tenha o composer instalado e saiba utilizá-lo:, _(*23)

composer require crphp/wmic

Ou se preferir criar um projeto:, _(*24)

composer create-project --prefer-dist crphp/wmic nome_projeto

Caso ainda não tenha o composer instalado, obtenha este em: https://getcomposer.org/download/, _(*25)

7 - Exemplos de uso

Consultar CPU:, _(*26)

use Crphp\Wmic\Sistema\Cpu;
use Crphp\Wmic\Conector\Wmic;

$wmi = new Wmic;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status()) {
    $cpu = new Cpu($wmi);
    echo "

";
    print_r($cpu->detalhes());
    echo "

";   
} else {
    echo $wmi->mensagemErro();
}

Todas as demais classes funcionam praticamente da mesma forma., _(*27)

Consultar Disco Rígido, _(*28)

use Crphp\Wmic\Conector\Wmic;
use Crphp\Wmic\Sistema\DiscoRigido;

$wmi = new Wmic;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status())
{
    $obj = new DiscoRigido($wmi, "C"); // a unidade pode ser omitida
    echo "

";
    print_r($obj->detalhes());
    echo "

";   
} else {
    echo $wmi->mensagemErro();
}

Você DEVE sempre instânciar o conector Wmi e a classe referente ao elemento que deseja manipular, _(*29)

Também é possível executar suas próprias consultas customizadas, _(*30)

use Crphp\Wmic\Conector\Wmic;

$wmi = new Wmic;
$wmi->conectar('ip_ou_hostname', 'usuario', 'senha');

if($wmi->status()) {
    $memoria = $wmi->executar("select AvailableBytes from Win32_PerfRawData_PerfOS_Memory");
    // Será retornado um objeto em caso de sucesso ou uma string em caso de erro
} else {
    echo $wmi->mensagemErro();
}

8 - Licença (MIT)

Para maiores informações, leia o arquivo de licença disponibilizado junto desta biblioteca., _(*31)