Saltar para o conteúdo principal
Versão: 19

Administração Web

Um componente de servidor web integrado, chamado WebAdmin, é utilizado por 4D e 4D Server para dar um acesso web seguro a funções de gestão específicas como Explorador de dados. Pode conectar localmente ou remotamente ao servidor web de um navegador ou uma aplicação web e acessar a aplicação 4D associada.

O webAdmin maneja a autenticação de usuários com privilégios "WebAdmin" de forma que possa abrir sessões administrativas e acessar interfaces dedicadas.

Essa funcionalidade pode ser usada em aplicações 4D rodando headless (sem monitor e periféricos) assim como aplicações 4D rodando sem interfaces.

Iniciar o web server WebAdmin​

Como padrão, o servidor web WebAdmin não é lançado. Precisa configurar o lançamento ao início ou (em versões com interface) lançar manualmente usando um item de menu.

Lançar ao início​

Pode configurar o servidor web WebAdmin para que se lance ao início da aplicação 4D ou 4D Server (antes de que se carregue qualquer projeto).

  • Se utilizar uma aplicação 4D con interface, selecione a opção de menu Arquivo > Administração web > Propriedades....

alt-text

Selecione a opção Inicio automático da administração do servidor web na caixa de diálogo de configuração:

alt-text

  • Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo Interface de linha de comandos:
open ~/Desktop/4D.app --webadmin-auto-start true

Se a porta TCP usada pelo WebAdmin servidor web (HTTPS ou HTTP, dependendo das configurações) não estiver disponível ao início, 4D vai tentar repetidademente os 20 portos a seguintes, e usar o primeiro que estiver disponível. Se nenhum porto estiver disponível, o servidor web não é lançado e um erro é exibido (ou em aplicação headless, aparece no console)

Iniciar e parar​

Se utilizar uma aplicação 4D com interface, pode iniciar ou parar o servidor web WebAdmin de seu projeto a qualquer momento:

Selecione a opção de menu Arquivo > Administração web > Iniciar o servidor.

alt-text

O item de menu vira Stop Server quando o servidor for lançado; selecione Parar o servidor para parar o WebAdmin servidor web.

Propriedades WebAdmin​

A configuração do componente WebAdmin é obrigatória, em particular para definir a** chave de acesso**. Por padrão, quando a chave de acesso não for estabelecida, o acesso via uma url não é permitido.

Pode configurar o componente WebAdmin usando Web Administration a caixa de diálogo de configurações (ver abaixo).

Se usar uma aplicação 4D headless pode usar os argumentos daInterface de Linha de comando para definir as configurações básicas. Se quiser personalizar o arquivo de configurações para definir os parâmetros avançados.

Caixa de diálogos de configurações​

Para abrir a caixa de diálogo de configurações de administração web, selecione o item de menu File > Web Administration > Configurações....

alt-text

A caixa de diálogo abaixo é mostrada:

alt-text

Inicio automático da administração de servidor web​

Marque esta opção para lançar o servidor web WebAdmin automaticamente quando iniciar a aplicação 4D ou 4D Server (ver (acima). Como padrão essa opção não é marcada.

Conexões HTTP em localhost aceitas​

Quando esta opção for marcada, pode conectar ao servidor web WebAdmin através de HTTP na mesma máquina que a aplicação 4D. Como padrão, essa opção é marcada.

Notas:

  • Conexões com HTTP outras que localhost nunca são aceitas.
  • Mesmo se esta opção for marcada, quando Accept HTTPS for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS.

Porta HTTP​

Número de porta a usar para conexões com HTTP para o servidor web WebAdmin web server quando a opção Accept HTTP connections on localhost estiver marcada. Valor normal padrão é 7080

Aceitar HTTPS​

Quando esta opção for marcada, pode se conectar ao servidor web WebAdmin através de HTTPS. Como padrão, essa opção é marcada.

Porta HTTPS​

Número de porta a utilizar para as conexôes ao servidor web WebAdmin através de HTTPS quando a opção HTTPS aceita estiver marcada. Valor normal padrão é 7443

Rota da pasta de certificados​

Rota da pasta onde o certificado TLS está localizado. Como padrão, a rota da pasta de certificados está vazia e 4D ou Servidor 4D usa os arquivos de certificados contidos na apicação 4D (certificados personalizados devem ser armazenados do lado da pasta projeto).

Modo de registro de depuração​

O estado ou formato do arquivo de registro da petição HTTP (HTTPDebugLog_nn.txt, armazenada na pasta "Logs" da aplicação -- nn é o número do arquivo). As opções abaixo estão disponíveis:

  • Desativado (padrão)
  • Com todas as partes do corpo - habilitado com partes do cuerpo das petições e respostas
  • Sem as partes do corpo - ativado sem partes do corpo (se indica o tamanho do corpo)
  • Com os corpos das petições - ativado com as partes do corpo unicamente nas petições
  • Com a resposta corpos - ativado com as partes do corpo unicamente nas respostas

Chave de acesso​

Defining an access key is mandatory to unlock access to the WebAdmin web server through an URL (access via a 4D menu command does not require an access key). When no access key is defined, no web client is allowed to connect through an URL to a web administration interface like the Data Explorer page. Uma página de erro é retornada no caso uma solicitação de conexão:

alt-text

Uma chave de acesso é parecida a uma senha, mas não está associada com um login.

  • Para definir uma nova chave de acesso: clique no botão Definir, introduza a string da chave de acesso na caixa de diálogo e clique em OK. A etiqueta botão vira Modificar.
  • Para modificar a chave de acesso: clique no botão Modificar, introduza a nova string da chave de acesso na caixa de diálogo e clique em OK.
  • Para eliminar a chave de acesso: clique no botãoModificar, deixe vazia a área daa chave de acesso e clique em OK.

Configuração de WebAdmin sem interface​

Todos os parâmetros de WebAdmin são armazenados no arquivo WebAdmin.4DSettings. Ha un arquivo WebAdmin.4DSettings por padrão para cada aplicação 4D e 4D Server, pelo qual é possível lançar várias aplicações na mesma máquina local.

Quando rodar uma aplicação sem interface 4D ou 4D Servidor, pode estabelecer e usar o arquivo padrão WebAdmin.4DSettings , ou determinar um arquivo personalizado .4DSettings.

Para estabelecer o conteúdo do arquivo, pode utilizar a janela de parâmetros WebAdmin da aplicação 4D com uma interface e ejecutá-la depois sem interface. Se utiliza então o arquivo padrão WebAdmin.4DSettings.

Ou, pode estabelecer um arquivo personalizado .4DSettings (formato xml) e usar ao invés do arquivo padrão. Na Interfaz de linha de comandos há vários argumentos dedicados para compatibilidade com esta funcionalidade.

A chave de acesso não é armazenada de forma transparente no arquivo .4DSettings.

Exemplo:

"%HOMEPATH%\Desktop\4D Server.exe" MyApp.4DLink --webadmin-access-key 
 "my Fabulous AccessKey" --webadmin-auto-start true   
 --webadmin-store-settings

Autenticação e sessão​

  • When a web management page is accessed by entering an URL and without prior identification, an authentication is required. O usuário deve introduzir a chave-de-acesso em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de WebAdmin, não é possível o acesso via URL.

  • Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como Records > Data Explorer ou Window > Data Explorer (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente.

Quando o acesso é concedido, uma sessão web com o privilégio "WebAdmin" é criado na aplicação 4D. Enquanto a sessão atual tiver o privilégio "WebAdmin", o componente WebAdmin entrega páginas solicitadas.