A instalação do
PhpDansAdmin é bem simplificada. No primeiro passo é necessário descompactar o arquivo phpdansadmin.tar.gz1, como mostrado abaixo (atentar ao diretório onde foi especificado no DocumentRoot do Apache).
# pwd
/home/suporte
# ls
phpdansadmin.tar.gz
# tar -xzvf phpdansadmin.tar.gz phpdansadmin/
phpdansadmin/menu/
phpdansadmin/menu/index.html
phpdansadmin/menu/jdMenu-demo.html
phpdansadmin/menu/sair.php
phpdansadmin/menu/Conteudo.html
phpdansadmin/menu/iframes.html
...
# ls
phpdansadmin phpdansadmin.tar.gz
# rm -rf phpdansadmin.tar.gz
Acessar a página http://ipdoservidor/phpdansadmin/install/ e iniciar o processo de instalação. A figura 2.1 exibe a tela inicial da instalação do PhpDansAdmin, na primeira etapa deve-se clicar no botão Next e acessar a próxima página de instalação.
Figura 2.1
No segundo passo da instalação é necessário informar um login, o qual será o administrador do ambiente. Não é obrigatório utilizar o login admin ou sinônimos, é possível criar qualquer denominação.
Figura 2.2
O terceiro passo irá configurar e testar a conexão com o servidor onde estará o DansGuardian. Primeiramente, enquanto não há a conexão ssh chaveada, será apresentada a tela como está representada na figura 2.3, que indica que é necessário executar o script install-ssh.sh, que se encontra no diretório /phpdansadmin/install.
Figura 2.3
A figura 2.4 demonstra a execução do script install-ssh.sh, que irá criar a conexão chaveada do usuário do Apache com o servidor proxy. Ao executar o script deve-se teclar enter nas primeiras perguntas até ser solicitada a senha de root do servidor, onde se encontra o DansGuardian, e em um segundo passo redigitar a senha. O script faz a verificação se está sendo executado com o mesmo usuário do Apache e também se o IP passado como parâmetro é válido.
Figura 2.4
Após a execução do script, se a conexão for bem-sucedida, será apresentado automaticamente a tela como mostra a figura 2.5, caso não seja apresentada, será necessário executar novamente o script install-ssh.sh.
finalizada a instalação, serão efetuados os testes para verificar se o PhpDansAdmin pode executar as tarefas. Caso esteja corretamente configurado exibirá uma tela, como demonstrado na Figura 2.6.
Figura 2.6
Ao clicar no botão Finish, a aplicação estará pronta para utilização, e irá trazer a página para login. Por questões de maior segurança, ao acessar novamente a URL:
http://ipdoservidor/phpdansadmin/install
Será apresentada a tela representada na figura 2.7, isso evita a alteração de senha de administrador por qualquer pessoa mal-intencionada.
Figura 2.7
Para executar nova instalação, em que será possível a criação de um novo login e senha para o administrador, deve-se acessar a aplicação e executar o item New installation do menu Help. Após esses passos será possível executar a instalação normalmente.
Em um próximo artigo apresentarei um caso de uso, demonstrando na prática como a aplicação minimiza o nível de complexidade da administração dos perfis de acessos do DansGuardian, com uma rotina bem comum utilizada por um administrador.
Conclusão
A ferramenta apresentada está na primeira versão, eventuais melhorias poderão ser realizadas pelo autor ou pela comunidade Open Source, que serão bem vindas.
Seu código fonte está disponibilizado e pode ser encontrado em:
Ainda é preciso realizar muitos testes para assegurar o bom funcionamento da ferramenta, a sugestão é que seja testado em uma VM de exemplo antes da sua implantação.
Referências
DansGuardian Organization. Site. [S.l.], 2009. Acessado em 10 de julho de 2010. Disponível em: <
http://dansguardian.org>