Configurar a componente de Administração Web

O componente interno do WebAdmin foi incluído no 4D v18 R6. Este componente é a base de muitos módulos de administração futura. É baseado na web para que possa ser utilizado com ambientes sem cabeça. O primeiro módulo de administração baseado na web publicado é o Data Explorer, que explicámos exaustivamente neste post do blog.

Vamos ver como configurá-lo.

Um Servidor Web dedicado

Como certamente aprendeu a ler este post do blog, 4D permite que cada componente tenha o seu próprio servidor web. É particularmente eficiente para a divisão do código de aplicação em várias unidades de negócio. Assim, quando precisámos de criar um novo ambiente de administração baseado na web, decidimos utilizar a nossa própria tecnologia!

O Data Explorer utiliza o servidor WebAdmin do componente Web para que as definições explicadas neste post do blog também se lhe apliquem.

Protegido por defeito

Não há necessidade de se preocupar quando usa 4D, as suas definições e dados não são expostos a olhos maliciosos!

O acesso aos componentes é protegido por uma chave de acesso. Se a chave de acesso não estiver definida, não há maneira de aceder ao servidor WebAdmin (ou ao Data Explorer) usando um browser.

Assim, por defeito, a única forma de utilizar o Data Explorer é iniciar o servidor web e abrir a sua interface, clicando no item de menu Data Explorer. Desta forma, não há necessidade de definir uma chave de acesso porque a principal questão de segurança, neste caso, está localizada entre o computador e a cadeira!

Permitir acessos utilizando a interface

Começando com 4D v18 R6, verá uma nova entrada no menu File de 4D e 4D Server: Administração Web. O seu primeiro submenu é Definições, o que lhe permite exibir o diálogo de definições abaixo:

Como pode ver, o servidor web WebAdmin não é iniciado automaticamente por defeito. Se quiser que ele seja executado automaticamente no arranque 4D, basta activar a primeira caixa de verificação.

Pode também configurar os protocolos disponíveis e as suas portas de publicação. Basta ter em mente que as ligações HTTP ao WebAdmin estão disponíveis apenas para o anfitrião local. Se quiser ligar-se a partir de outro computador, deve utilizar o protocolo HTTPS.

O componente WebAdmin incorpora o seu próprio certificado, mas como não está definido para o seu próprio domínio, pode utilizar o seu próprio certificado e definir a pasta que contém os ficheiros correspondentes.

Por último, mas não menos importante, pode definir a chave de acesso que protege o seu acesso ao WebAdmin contra navegadores.

Note que todas as definições só são efectivas após o servidor WebAdmin ser reiniciado.

Permitir o acesso utilizando CLI

O CLI (Command Line Interface) é utilizado quando se lança um Servidor 4D ou 4D em modo sem cabeça. Uma vez que não há forma de exibir a interface de configuração no modo sem cabeça, vários novos parâmetros relativos ao componente WebAdmin foram adicionados ao CLI:

–webadmin-settings-file
Este parâmetro permite-lhe utilizar outro ficheiro de definições. Todas as definições estabelecidas neste ficheiro irão substituir as definições actuais do WebAdmin.

No exemplo seguinte, o componente WebAdmin utilizará as configurações definidas no ficheiro “customWA.4DSettings” quando o 4D for iniciado:

./4D –webadmin-settings-file “/Users/John Doe/Documents/customWA.4DSettings”.

–webadmin-access-chave
Este parâmetro permite-lhe definir a chave de acesso.

No exemplo seguinte, a componente WebAdmin utilizará a chave de acesso “MicKey” quando a 4D começar:

./4D –webadmin-access-chave “MicKey”.

–webadmin-auto-start
Este parâmetro permite iniciar o servidor web WebAdmin no arranque 4D.

No exemplo seguinte, o componente WebAdmin iniciará automaticamente o seu servidor Web quando o 4D for iniciado:

./4D –webadmin-auto-start true

–webadmin-store-settings
Este parâmetro permite guardar as duas definições anteriores no ficheiro de definições (o ficheiro de definições personalizadas se for utilizado o parâmetro correspondente, ou o ficheiro de definições de componentes WebAdmin). Se não utilizar este parâmetro, as duas definições anteriores são utilizadas apenas para a execução 4D actual.

No exemplo seguinte, quando 4D inicia, o componente WebAdmin começará automaticamente a usar a chave de acesso “MicKey” e guardará estas definições no seu próprio ficheiro de definições:

./4D –webadmin-access-chave de acesso “MicKey”. –webadmin-auto-arranque verdadeiro –webadmin-store-settings

Pode ver mais detalhes sobre estes parâmetros na documentação 4D.

Execução de múltiplas instâncias 4D

As configurações são partilhadas por todas as instâncias do Servidor 4D ou 4D. Caso contrário, o arranque automático do servidor web WebAdmin teria gerado problemas. Não se preocupe se uma porta de publicação não estiver disponível quando 4D iniciar o servidor web WebAdmin, tentará com as seguintes portas.

Lembrete

Tal como mencionado na introdução, a componente WebAdmin é a base de muitas características a vir. Portanto, sinta-se à vontade para nos dizer o que pensa no fórum e descrever qualquer tipo de componente que possa imaginar!