WEB SET OPTION
WEB SET OPTION ( seletor ; valor )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| seletor | Integer | → | Código da opção a modificar |
| valor | Integer, Text, Collection | → | Valor da opção |
Descrição
O comando WEB SET OPTION modifica o valor atual das diferentes opções de funcionamento do servidor web de 4D.
As mudanças realizadas nessas opções são conservadas se o servidor 4D Web for parado e reiniciado, entretanto, não se conservam se a aplicação 4D for parada e reiniciada.
No parâmetro selector, passe uma das constantes do tema Web Server e passe o novo valor da opção em value:
| Constante | Tipo | Valor | Comentário | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Web character set | Inteiro longo | 17 | Alcance: 4D local, 4D Server Descrição: conjunto de caracteres que o servidor Web 4D (com 4D em modo local e 4D Server) utiliza para comunicar-se com os navegadores web que se conectam a base. O valor por defeito depende da linguagem do sistema operativo. Este parâmetro se define nas Propriedades da base. Valores: os valores possíveis dependem do modo de execução da base relativos ao conjunto de caracteres. Modo Unicode: quando a aplicação é executada em modo Unicode, os valores a ser passados para este parâmetro são os identificadores de conjunto de caracteres (MIBEnum longint ou nome de cadeia de caracteres, identificadores definidos por IANA, consulte: http://www.iana.org/assignments/character-sets). Está é a lista dos identificadores correspondentes aos conjuntos de caracteres que admite o servidor Web de 4D: 4=ISO-8859-1 12=ISO-8859-9 13=ISO-8859-10 17=Shift-JIS 2024=Windows-31J 2026=Big5 38=euc-kr 106=UTF-8 2250=Windows-1250 2251=Windows-1251 2253=Windows-1253 2255=Windows-1255 2256=Windows-1256Modo compatibilidade ASCII: 0: Ocidental 1: Japonês 2: Chinês 3: Coreano 4: Definido pelo usuário 5: Reservado 6: Europa central 7: Cirílico 8: Árabe 9: Grego 10: Hebraico 11: Turco 12: Nórdico | |||||||||
| Web Client IP address to listen | Inteiro longo | 23 | Escopo: Todas máquinas remotas 4D Mantido entre duas sessões: Sim Valores possíveis: Ver seletor 16 Descrição: Usado para especificar este parâmetro para todas as máquinas remotas 4D usadas como servidores Web. Os valores definidos usando o seletor são aplicadas a todas as máquinas remotas usadas como servidores WEb. Se quiser definir valores apenas para certas máquinas remotas, use a caixa de diálogo Configurações de banco de dados de 4D em modo remoto. | |||||||||
| Web CORS enabled | Inteiro longo | 92 | Escopo: Servidor Web Local Description: CORS (Cross-origin resource sharing) estado serviço para servidor Web. Se ativdo, XHR (por exemplo. REST) chamdas de páginas Web de fora do domínimo podem ser permitidas na aplicação. (Nota: uma lista de endereços e métodos permitidos para usar o serviço CORS também deve ser definida, ver Web CORS settings). Quando o serviço CORS estiver desativado, petições CORS são ignoradas. Quando o serviço CORS estiver ativado e um domínio ou método não permitido enviar uma petição crosssite, será rejeitada com uma respota de erro "403 - forbidden". Valores possíveis: 0 (desativado, normal) ou 1 (ativado) | |||||||||
| Web CORS settings | Inteiro longo | 93 | Escopo: Servidor Web Local Descripção: Lista de hosts e métodos permitidos para o serviço CORS. Valores possíveis: Coleção d eobjetos CORS com as propriedades abaixo:
| |||||||||
| Web debug log | Inteiro longo | 84 | Alcance: servidor web local Descrição: lhe permite obter ou definir o estado do arquivo de histórico de petições HTTP do servidor Web 4D. Quando for ativado, este arquivo, chamado "HTTPDebugLog_nn.txt", é guardado na pasta "Logs" do aplicativo (nn é o número de arquivo). É útil para problemas de depuração relacionados com o servidor web. Registra cada petição e cada resposta em modo raw. A totalidade das petições, cabeçalhos, se registram; opcionalmente, também se podemn registrar partes do corpo.Para maior informação sobre arquivos HTTPDebugLog, consulte a seção Descrição de arquivos de log. Valores: uma das constantes com o prefixo "wdl" (consulte as descrições destas constantes neste tema). Valor por padrão: 0 (não ativado) | |||||||||
| Web HSTS enabled | Inteiro longo | 86 | Escopo: 4D local, 4D Server. Descrição: status HTTP Strict Transport Security (HSTS). HSTS permite que 4D Web server declare que browsers devem interagir apenas com as conexões HTTPS seguras. Quando for ativado, o web server 4D vai adicionar automaticamente informação HSTS-relacionada para todos os cabeçalhos de resposta. Os navegadores vão gravar a informação HSTS na primeiva vez que recebam a resposta do servidor 4D Web, então qualquer petições futuras HTTP vão automaticamente ser transformadas em petições HTTPS. O tamanho de tempo que essa informação será armazenada pelo navegador está especificada com o seletor Web HSTS max age. HSTS exige que HTTPS esteja ativado no servidor. HTTP também deve estar ativado para permitir conexões iniciais do cliente. Valores possíveis: 0 (desativado, default) ou 1 (ativado) Nota: o servidor 4D Web deve ser reiniciado para esta configuração ser aplicada | |||||||||
| Web HSTS max age | Inteiro longo | 87 | EScopo: 4D local, 4D Server Descrição: Especifica o tamanho máximo de tempo (em segundos) que HSTS está ativado para cada nova conexão cliente. Essa informação é armazenada no lado do cliente para a duração especificada. Valores possíveis: Longint (segundos) Valor Default: 63072000 (2 anos) Aviso: Assim que HSTS for ativado, conexões cliente vão continuar a usar esse mecanismo para a duração especificada. Quando estiver testando suas aplicações, é recomendado estabelecer uma duração pequena para poder trocar entre modos de conexão seguro e não seguro se necessário. | |||||||||
| Web HTTP compression level | Inteiro longo | 50 | Alcance: Servidor web local** ** Descrição: nível de compreensão para todos os intercâmbios HTTP comprimidos efetuados para o servidor HTTP de 4D (pedidos cliente ou respostas servidor, Web e serviço web). Este seletor permite otimizar os intercâmbios com um enfoque na velocidade de execução (menor compreensão) ou a quantidade de compreensão (menor velocidade). A escolha de um valor depende do tamanho e a natureza dos dados trocados . Passe de 1 a 9 no parâmetro valor, 1 é a compreensão mais rápida e 9 a mais alta. Também pode passar -1 para obter um compromisso entre velocidade e taxas de compreensão. O nível de compreensão por padrão é 1 (compreensão rápida). Valores possíveis: 1 a 9 (1 = mais rápido, mais comprimido = 9) o -1 = melhor compromisso. | |||||||||
| Web HTTP compression threshold | Inteiro longo | 51 | Alcance: Servidor HTTP local Descrição: em intercâmbios HTTP otimizados, limite de tamanho de petição por debaixo do qual os intercâmbios no devem comprimir-se. Esta opção é útil para evitar perder tempo de máquina para comprimir intercâmbios muito pequenos. Passe em valor um tamanho em bytes. Por defeito, o limite de compreensão é estabelecido em 1024 bytes. Valores possíveis: todo valor de tipo inteiro largo. O parâmetro valor contém um tamanho expressado em bytes. Por defeito, o limiar de compreensão está definido em 1024 bytes. | |||||||||
| Web HTTP enabled | Inteiro longo | 88 | Escopo: 4D local, 4D Server Descrição: Status para comunicação vai HTTP. Valores possíveis: 0 (desativado) ou 1 (ativado) | |||||||||
| Web HTTP TRACE | Inteiro longo | 85 | Escopo: Servidor Web Local Mantido entre duas sessões: Não Descrição: Permite que ative ou desative o método HTTP TRACE no 4D Web server. Por razões de segurança, a partir de 4D v15 R2, o servidor 4D Web rejeita, como padrão, resquisições HTTP TRACE com um erro 405 (ver HTTP TRACE desativado). Se necessário, pode ativar o método HTTP TRACE para a sessão passando a constante com valor 1. Quando esta opção estiver ativada, o servidor 4D Web responde às requisições HTTP TRACE com a linha de requisição, cabeçalho e corpo. Possíveis valores: 0 (desativado) ou 1 (ativado) Valor padrão: 0 (desativado) | |||||||||
| Web HTTPS enabled | Inteiro longo | 89 | Alcance: 4D local, 4D Server Descrição: estado para comunicação sobre HTTPS. Valores possíveis: 0 (desativado) ou 1 (ativado) | |||||||||
| Web HTTPS port ID | Inteiro longo | 39 | Alcance: 4D local, 4D Server Valores possíveis: 0 a 65535 Descrição: número da porta TCP utilizado pelo servidor web de 4D em modo local e de 4D Server para conexões seguras via TLS (protocolo HTTPS). O número de porta HTTPS se define na página "Web/Configuração" da caixa de diálogo Propriedades da base. Por defeito, o valor é 443 (valor padrão). Pode utilizar as constantes do tema Números de puerto TCP para o parâmetro valor. | |||||||||
| Web inactive process timeout | Inteiro longo | 78 | Alcance: servidor web local Descrição: permite modificar o timeout do processo utilizado para la sessão (opção relativa ao processo). Depois do timeout, o processo se elimina no servidor, se chama ao Método de banco de dados On Web Legacy Close Session e logo o contexto da sessão é destruída. Valores: Inteiro longo (minutos) Valores por defeito: 480 minutos (passe 0 para restabelecer o valor por defeito) | |||||||||
| Web inactive session timeout | Inteiro longo | 72 | Alcance: servidor web local Descrição: permite modificar a duração de vida das sessões inativas (duração definida em cookie). Ao final de este período, a cookie de sessão expira e não se envia mais ao cliente HTTP. Valores: Inteiro longo (minutos) Valores por defeito: 480 minutos (passe 0 para restabelecer o valor por defeito) | |||||||||
| Web IP address to listen | Inteiro longo | 16 | Escopo: 4D local, 4D Server Mantido entre sessões: Sim Descrição: endereços IP nos quais o servidor 4D Web vai receber petições HTTP com 4D em modo local e Servidor 4D. Como padrão, nenhum endereço específico é definido. Este parâmetro pode ser estabelecido nas configurações de Banco de Dados. Este seletor é útil para servidores 4D Web compilados e fusionados com 4D Desktop (no qula não há acesso ao modo design ). Valores possíveis: endereço IP em forma de string. Ambos formatos string IPv6 (por exemplo, "2001:0db8:0000:0000:0000:ff00:0042:8329") e os formatos string IPv4 (por exemplo, "123.45.67.89") são compatíveis. Nota: por compatibilidade,os endereços IPv4 expressos como longitudes hexadecimais (obsoletas) ainda são compatíveis | |||||||||
| Web legacy session | Inteiro longo | 70 | Alcance: servidor web local Descrição: permite ativar ou desativar o modo de gestão das sessões (descrito na seção Web Sessions Management (Legacy)). Valores: 1 (ativar modo) ou 0 (desativar modo) Valor por defeito: 1 para bases criadas na versão 13, 0 para bases convertidas. Note que este modo ativa igualmente o mecanismo de reutilizar os contextos temporais em modo remoto. Para maior informação sobre este mecanismo, consulte a descrição desta opção na seção Web Server Settings. | |||||||||
| Web log recording | Inteiro longo | 29 | Alcance: 4D local 4D Server Descrição: inicia ou detém o registro de petições solicitações Web recebida pelo servidor web de 4D em modo local ou 4D Server. Por defeito, o valor é 0 (não têm registro de petições). O registro das petições web é guardado em um arquivo texto chamado "logweb.txt" que encontra automaticamente na pasta Logs da base, junto ao arquivo de estrutura. O formato deste arquivo é determinado pelo valor que seja passado. Para mais informação sobre os diferentes formatos de registro das petições, consulte a seção [#title id= "2833"/]. A ativação deste arquivo também pode ser definido na página "Web/Avanzado" das Preferências de 4D. Valores possíveis: 0 = Não guardar (por defeito), 1 = Registrar em formato CLF, 2 = Registrar em formato DLF, 3 = Registrar em formato DLF, 4 = Guardar em formato WLF. Atenção: os formatos 3 e 4 formatos são formatos personalizados, os conteúdos devem ser definidos de antemão nas Preferências da aplicação, página "Web/Formato do registro". Se você utilizar um destes formatos sem que seus campos sejam selecionados, o arquivo das petições não será gerado. | |||||||||
| Web max concurrent processes | Inteiro longo | 18 | Alcance: 4D local, 4D Server Descrição: limite estritamente superior no número de processos de web de todos os tipos aceitos pelo servidor web com o 4D Server e 4D em modo local. Quando o número atinge limite (menos um), 4D não cria um novo processo e retorna a mensagem "Servidor não disponível" (estado HTTP 503 - Serviço indisponível) para qualquer nova solicitação. Este parâmetro impede a saturação do servidor Web 4D que podem ocorrer durante um envio maciço de solicitações ou uma demanda excessiva para a criação de contextos. Ele também pode ser definido nas propriedades da caixa de diálogo base. Em teoria, o número máximo de processos de web é o resultado de dividir a memória disponível / tamanho de um pilha de um processo web. Outra solução é para exibir informações sobre os processos de web mostrado no desempenho Explore: indica o número atual de processos da web e o número máximo alcançado desde o início do servidor web. Valores: todo valor entre 10 y 32 000. O valor por defeito é 100. | |||||||||
| Web max sessions | Inteiro longo | 71 | Alcance: servidor web local** ** Descrição: permite limitar o número de sessões simultâneas. Quando é alcançado o número definido, a seção mais antiga é fechada (e se chama ao Método de banco de dados On Web Legacy Close Session se o servidor web necessita criar uma nova. Valores possíveis: Intero longo.O número de sessões simultâneas não pode superar o número total de processos web (opção Web max concurrent processes, 100 por defeito) Valores por defeito: 100 (passe 0 para restabelecer o valor por defeito) | |||||||||
| Web maximum requests size | Inteiro longo | 27 | Alcance: 4D local, 4D Server Descrição: tamanho máximo (em bytes) das petições HTTP de entrada (POST) que o servidor web está autorizado a tratar. Por padrão, o valor predeterminado é 2 000 000, ou seja, um pouco menos de 2 MB. O valor máximo (2 147 483 648) significa na prática que nenhum limite é estabelecido. Esta configuração evita la saturação do servidor web, causadas por petições de entrada muito grandes. Quando uma petição chega ao limite, o servidor web de 4D rechaça. Valores possíveis: 500 000 a 2 147 483 647. | |||||||||
| Web port ID | Inteiro longo | 15 | Alcance: 4D em modo local e 4D Server. Descrição: estabelece ou obtém o número da porta TCP utilizado pelo servidor web 4D com 4D em modo local e 4D Server. Por padrão, o valor é 80. O número de porta TCP se define na página "Web/Configuração" da caixa de diálogo Propriedades da base. Pode utilizar uma das constantes do tema Números de porta TCP para o parâmetro valor. Este seletor é útil no marco de servidores web 4D que se compilam e fundem utilizando 4D de escritório (sem acesso ao ambiente Desenho). Valores possíveis: para obter mais informação sobre o número de porta TCP, consulte a seção Web Server Settings. Valor por padrão: 80 | |||||||||
| Web scalable session | Inteiro longo | 90 | Alcance: servidor Web local Descripción: ativa ou desativa o modo de gestão de sessões escalável (descrito na página Sessões de usuário em developer.4d.com) Valores possíveis: 1 (modo de ativação) ou 0 (modo de desativação). Se modificar o valor, o servidor web deve ser reiniciado para que leve em consideração a mudança. Quando se habilitar este modo, as opções a seguir são ignoradas: Web inactive process timeout, Web max concurrent processes, Web session cookie name e Web inactive session timeout. | |||||||||
| Web session cookie domain | Inteiro longo | 81 | Alcance: Servidor web local Descrição: define ou obtém o valor do campo "domínio" da cookie de sessão. Este seletor (assim como o seletor 82) é útil para controlar o alcance das cookies de sessão: se configura, por exemplo, o valor "/*.4d.fr" para este seletor, o cliente só enviará uma cookie quando a petição se dirige ao domínio ".4d.fr", que exclui os servidores que alojam os dados estáticos externos. Valores possíveis: Texto | |||||||||
| Web session cookie name | Inteiro longo | 73 | Alcance: servidor web local Descrição: permite definir o nome da cookie utilizada para armazenar o ID da sessão. Valores: Texto Valores por defeito: "4DSID" (passe uma cadeia vazia para restabelecer o valor por defeito) | |||||||||
| Web session cookie path | Inteiro longo | 82 | Alcance: Servidor web local Descrição: define ou obtém o valor do campo "path" da cookie de sessão. Este seletor (assim como o seletor 81) é útil para controlar o alcance das cookies de sessão: se configura, por exemplo, o valor"/4DACTION" para este seletor, o cliente deverá enviar só uma cookie para petições dinâmicas que comecem com 4DACTION, e não para as imagens, páginas estáticas, etc. Valores possíveis: Texto | |||||||||
| Web session enable IP address validation | Inteiro longo | 83 | Alcance: servidorWeb Local Descrição: Ativa ou desativa a validação dos endereços IP para as cookies de sessão. Por razões de segurança, por padrão, o servidor web de 4D verifica o endereço IP de cada solicitação que contém uma cookie de sessão e a rejeita se este endereço não coincide com o endereço IP utilizado para criar a cookie. Em algumas aplicações específicas, é possível que deseje desativar esta validação e aceitar as cookies de sessão, inclusive quando seus endereços IP não coincidam. Por exemplo, quando os dispositivos móveis mudam entre redes WiFi e 3G/4G, seu endereço IP muda. Neste caso, deve passar 0 nesta opção para permitir que os clientes podam seguir utilizando seus sessões web inclusive quando as endereços IP mudem. Tenha em conta que esta configuração reduz o nível de segurança da aplicação. Quando se modifica, esta configuração é efetiva imediatamente (não é necessário reiniciar o servidor HTTP). Valores possíveis: 0 (desativado) ou 1 (ativado) Valor por padrão: 1 (os endereços IP são verificados) |
Ao utilizar o selector Web debug log, pode passar uma das constantes abaixo no parâmetro valor:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| wdl disable web log | Inteiro longo | 0 | O arquivo de histórico de petições HTTP Web está desativado |
| wdl enable with all body parts | Inteiro longo | 7 | O arquivo de histórico de petições Web está ativado com o corpo da resposta e a resposta |
| wdl enable with request body | Inteiro longo | 5 | O arquivo de histórico de petições Web está ativado apenas com o corpo da resposta |
| wdl enable with response body | Inteiro longo | 3 | O arquivo de histórico de petições HTTP Web está ativado com o corpo da resposta unicamente |
| wdl enable without body | Inteiro longo | 1 | O arquivo de histórico de petições Web está desativado sem o corpo (o tamanho do corpo é entregue neste caso) |
Exemplo
A ativação do arquivo de histórico de depuração das petições HTTP sem as partes body:
WEB SET OPTION(Web debug log;wdl enable without body)
Uma entrada registrada se vê dessa maneira:
# REQUEST# SocketID: 1592# PeerIP: 127.0.0.1# PeerPort: 54912# TimeStamp: 39089388#ConnectionID: 9808E3B4B06E4EB5A60E9A3FC69116BD#SequenceNumber:5GET /4DWEBTEST HTTP/1.1Accept: text/html,(...)Accept-Encoding: gzip, deflateConnection: keep-aliveHost: 127.0.0.1User-Agent: 4D_HTTP_Client/0.0.0.0# RESPONSE# SocketID: 1592# PeerIP: 127.0.0.1# PeerPort: 54912# TimeStamp: 39089389 (tempo transcorrido: 1 minuto) #ConnectionID: 9808E3B4B06E4EB5A60E9A3FC69116BD#SequenceNumber:6HTTP/1.1 200 OKAccept-Ranges: bytesConnection: keep-aliveContent-Encoding: gzipContent-Length: 3555Content-Type: text/plain; charset=UTF-8Date: Thu, 20 Apr 2017 10:51:29 GMTExpires: Thu, 20 Apr 2017 10:51:29 GMTServer: 4D/16.0.1
[Body Size: 3555]