WEB GET OPTION

4D v20 R7

WEB GET OPTION


WEB GET OPTION ( selector ; valor )

Parámetro	Tipo	Descripción
selector	Entero largo	Código de la opción a modificar
valor	Entero largo, Texto, Collection	Valor de la opción

Descripción

El comando WEB GET OPTION permite leer el valor actual de una opción de funcionamiento del servidor web de 4D.

El parámetro selector indica la opción web a leer. Pase en este parámetro una constante del tema Servidor web:

Constante

Valor

Comentario

Web character set

Alcance: 4D local, 4D Server
Descripción: conjunto de caracteres que el servidor Web 4D (con 4D en modo local y 4D Server) utiliza para comunicarse con los navegadores web que se conectan a base. El valor por defecto depende del lenguaje del sistema operativo. Este parámetro se define en las Propiedades de la base.
Valores: los valores posibles dependen del modo de ejecución de la base relativos al conjunto de caracteres.

Modo Unicode: cuando la aplicación se ejecuta en modo Unicode, los valores a pasar para este parámetro son los identificadores de conjunto de caracteres (MIBEnum longint o Name string, identificadores definidos por IANA, consulte: http://www.iana.org/assignments/character-sets). Esta es la lista de los identificadores correspondientes a los conjuntos de caracteres que admite el 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-1256

Modo compatibilidad ASCII:
0: Occidental
1: Japonés
2: Chino
3: Coreano
4: Definido por el usuario
5: Reservado
6: Europa central
7: Cirílico
8: Árabe
9: Griego
10: Hebreo
11: Turco
12: Nórdico

Web Client IP address to listen

Alcance: todas las máquinas remotas 4D
Valores posibles: ver Web IP address to listen
Descripción: se utiliza para especificar este parámetro para todas las máquinas 4D remotas utilizadas como servidores web (aplicado al servidor web remoto únicamente).

Web CORS enabled

Alcance: servidor web local

Descripción: estado del servicio CORS (Cross-origin resource sharing) para el servidor web. Si está habilitado, se pueden permitir llamadas XHR (por ejemplo, REST) desde páginas web fuera del dominio en su aplicación. (Nota: también se debe definir una lista de direcciones y métodos permitidos para utilizar el servicio CORS; ver Web CORS settings). Cuando el servicio CORS está deshabilitado, las solicitudes CORS se ignoran. Cuando el servicio CORS está habilitado y un dominio o método no permitido envía una solicitud entre sitios, se rechaza con una respuesta de error "403 prohibido".

Valores posibles: 0 (deshabilitado, predeterminado) o 1 (habilitado)

Web CORS settings

Alcance: servidor web local
Descripción: lista de host(s) y métodos(s) permitidos para el servicio CORS.
Valores posibles: Colección de objetos CORS con las siguientes propiedades:

Propiedad	Tipo	Descripción
[ ].host	Texto	Obligatorio -- Si el host no está presente o vacío, el objeto se ignora. Nombre de dominio o dirección IP desde donde las páginas externas pueden enviar solicitudes de datos al Servidor a través de CORS. Se pueden agregar múltiples atributos de dominio para crear una lista blanca. Se soporatn varias sintaxis: 192.168.5.17:8081 192.168.5.17 192.168.* 192.168.:8081 http://192.168.5.17:8081 http://.myDomain.com http://myProject.myDomain.com .myDomain.com myProject.myDomain.com
[ ].methods	Texto	Método(s) HTTP aceptado(s) para el host CORS correspondiente. Separe cada método con un ";" (por ejemplo: "post;get") Si los métodos están vacíos, son nulos o no están definidos: todos los métodos están habilitados.

Web debug log

Alcance: servidor web local
Nota: si se reinicia el servidor HTTP, se utiliza un nuevo archivo de historial
Descripción: le permite obtener o definir el estado del archivo de historial de peticiones HTTP del servidor Web 4D. Cuando se activa, este archivo, llamado "HTTPDebugLog_nn.txt", se guarda en la carpeta "Logs" de la aplicación (nn es el número de archivo). Es útil para problemas de depuración relacionados con el servidor web. Registra cada petición y cada respuesta en modo raw. La totalidad de las peticiones, encabezados, se registran; opcionalmente, también se pueden registrar partes del cuerpo. Para mayor información sobre archivos HTTPDebugLog, consulte la sección Descripción de archivos de historial.
Valores: una de las constantes con el prefijo "wdl" (consulte las descripciones de estas constantes en este tema).
Valor por defecto: 0 (no activado)

Web HSTS enabled

Alcance: 4D local, 4D Server.
Descripción: estado HTTP Strict Transport Security (HSTS). HSTS permite que el servidor Web 4D declare que los navegadores solo deberían interactuar con él a través de conexiones HTTPS seguras. Una vez activado, el servidor web 4D agregará automáticamente información relacionada con HSTS a todos los encabezados de respuesta.Los navegadores registrarán la información HSTS la primera vez que reciban una respuesta del servidor web 4D, luego toda solicitud HTTP futura se transformará automáticamente en solicitudes HTTPS. El tiempo que el navegador almacena esta información se especifica con el selector Web HSTS max age.
HSTS requiere que HTTPS esté habilitado en el servidor. HTTP también debe estar habilitado para permitir las conexiones iniciales del cliente.
Valores posibles: 0 (desactivado, predeterminado) o 1 (activado)
Nota: el servidor web 4D debe reiniciarse para que se aplique esta configuración.

Web HSTS max age

Alcance: 4D local, 4D Server
Descripción: especifica el tiempo máximo (en segundos) que HSTS está activo para cada conexión de cliente nuevo. Esta información se almacena en el lado del cliente durante la duración especificada.
Valores posibles: Entero largo (segundos)
Valor por defecto: 63072000 (2 años)

Atención: una vez que HSTS esté habilitado, las conexiones cliente continuarán usando este mecanismo por la duración especificada. Cuando esté probando sus aplicaciones, se recomienda establecer una duración corta para poder cambiar entre los modos de conexión segura y no segura si es necesario.

Web HTTP compression level

Alcance: Servidor web local
Descripción: nivel de compresión para todos los intercambios HTTP comprimidos efectuados para el servidor HTTP de 4D (peticiones cliente o respuestas servidor, Web y servicio web). Este selector permite optimizar los intercambios con un enfoque en la velocidad de ejecución (menor compresión) o la cantidad de compresión (menor velocidad). La elección de un valor depende del tamaño y la naturaleza de los datos intercambiados. Pase de 1 a 9 en el parámetro valor, 1 es la compresión más rápida y 9 la más alta. También puede pasar -1 para obtener un compromiso entre velocidad y tasa de compresión. El nivel de compresión por defecto es 1 (compresión rápida).
Valores posibles: 1 a 9 (1 = más rápido, más comprimido = 9) o -1 = mejor compromiso.

Web HTTP compression threshold

Alcance: Servidor HTTP local
Descripción: en intercambios HTTP optimizados, límite de tamaño de petición por debajo del cual los intercambios no deben comprimirse. Esta opción es útil para evitar pérdidas de tiempo de máquina para comprimir intercambios muy pequeños.
Pase en valor un tamaño en bytes. Por defecto, el límite de compresión se establece en 1024 bytes.
Valores posibles: todo valor de tipo entero largo. El parámetro valor contiene una tamaño expresado en bytes. Por defecto, el umbral de compresión está definido en 1024 bytes.

Web HTTP enabled

Alcance: 4D local, 4D Server
Descripción: estados para comunicación sobre HTTP.
Valores posibles: 0 (desactivado) o 1 (activado)

Web HTTP TRACE

Alcance: servidor web local
Descripción: le permite activar o desactivar el método HTTP TRACE en el servidor web de 4D. Por razones de seguridad, a partir de 4D v15 R2, por defecto, el servidor web 4D rechaza peticiones TRACE HTTP con un error 405 (ver desactivación de HTTP TRACE). Si es necesario, puede activar el método HTTP TRACE para la sesión pasando esta constante con el valor 1. Cuando se activa esta opción, el servidor web 4D responde a las solicitudes HTTP TRACE con la línea de petición, el encabezado y el cuerpo.
Valores posibles: 0 (desactivado) o 1 (activado)
Valor por defecto: 0 (desactivado)

Web HTTPS enabled

Alcance: 4D local, 4D Server
Descripción: estado para comunicación sobre HTTPS.
Valores posibles: 0 (desactivado) o 1 (activado)

Web HTTPS port ID

Alcance: 4D local, 4D Server
Valores posibles: 0 a 65535
Descripción: número del puerto TCP utilizado por el servidor web de 4D en modo local y de 4D Server para conexiones seguras vía TLS (protocolo HTTPS). El número de puerto HTTPS se define en la página "Web/Configuración" de la caja de diálogo Propiedades de la base.
Por defecto, el valor es 443 (valor estándar). Puede utilizar las constantes del tema Números de puerto TCP para el parámetro valor.

Web inactive process timeout

Alcance: servidor web local
Descripción: permite modificar el timeout del proceso utilizado para la sesión (opción relativa al proceso). Después del timeout, el proceso se elimina en el servidor, se llama al Método base On Web Legacy Close Session y luego el contexto de la sesión se destruye.
Valores: Entero largo (minutos)
Valores por defecto: 480 minutos (pase 0 para restablecer el valor por defecto)

Web inactive session timeout

Alcance: servidor web local
Descripción: permite modificar la duración de vida de las sesiones inactivas (duración definida en cookie). Al final de este periodo, la cookie de sesión expira y no se envía más al cliente HTTP.
Valores: Entero largo (minutos)
Valores por defecto: 480 minutos (pase 0 para restablecer el valor por defecto)

Web IP address to listen

Alcance: 4D local, 4D Server
Descripción: dirección IP en la que el servidor web debe recibir las peticiones HTTP con 4D en modo local y 4D Server. Por defecto, ninguna dirección se especifica. Este parámetro se define en las Propiedades de la base. Este selector es útil en el caso de los servidores web 4D compilados y fusionados con 4D Desktop (no hay acceso al modo Diseño).
Valores posibles: dirección IP en forma de cadena. Ambos formatos cadena IPv6 (por ejemplo, "2001:0db8:0000:0000:0000:ff00:0042:8329") y los formatos cadena IPv4 (por ejemplo, "123.45.67.89") son compatibles.
Nota: por compatibilidad, las direcciones IPv4 expresadas en como longitudes hexadecimales (obsoletas) aún son compatibles.

Web legacy session

Alcance: servidor web local
Descripción: permite activar o desactivar el modo de gestión de las sesiones (descrito en la sección Gestión de las sesiones web (heredado)).
Valores: 1 (activar modo) ó 0 (desactivar modo)
Valor por defecto: 1 para bases creadas en la versión 13, 0 para bases convertidas. Note que este modo activa igualmente el mecanismo de reutilización de los contextos temporales en modo remoto. Para mayor información sobre este mecanismo, consulte la descripción de esta opción en la sección Parámetros del servidor web.

Web log recording

Alcance: 4D local, 4D Server
Descripción: inicia o detiene el registro de peticiones solicitudes Web recibida por el servidor web de 4D en modo local o 4D Server. Por defecto, el valor es 0 (no hay registro de peticiones).
El historial de las peticiones web se guarda en un archivo texto llamado "logweb.txt" que se ubica automáticamente en la carpeta Logs de la base, junto al archivo de estructura. El formato de este fichero es determinado por el valor que se pase. Para más información sobre los diferentes formatos de historial de las peticiones, consulte la sección [#title id= "2833"/]. La activación de este archivo también se puede definir en la página "Web/Avanzado" de las Preferencias de 4D.
Valores posibles: 0 = No guardar (por defecto), 1 = Registrar en formato CLF, 2 = Registrar en formato DLF, 3 = Registrar en formato DLF, 4 = Guardar en formato WLF.
Atención: los formatos 3 y 4 formatos son formatos personalizados, los contenidos deben ser definidos de antemano en las Preferencias de la aplicación, página "Web/Formato del historial". Si usted utiliza uno de estos formatos sin que sus campos hayan sido seleccionados, el archivo de las peticiones no se generará.

Web max concurrent processes

Alcance: 4D local, 4D Server
Descripción: límite estrictamente superior del número de procesos web de todo tipo aceptados por el servidor web con 4D en modo local y 4D Server. Cuando se alcanza el número límite (menos uno), 4D no crea un nuevo proceso y devuelve el mensaje "Servidor no disponible" (estado HTTP 503 - Servicio no disponible) a toda nueva petición.
Este parámetro previene la saturación del servidor web de 4D que puede ocurrir durante un envío masivo de peticiones o de una demanda excesiva de creación de contextos. También puede definirse en la caja de diálogo de la Propiedades de la base.
En teoría, el número máximo de procesos web es el resultado de dividir la memoria disponible / tamaño de la pila de un proceso web. Otra solución es ver la información sobre los procesos web que se muestra en el Explorador de ejecución: se indican el número actual de procesos web y el número máximo alcanzado desde el inicio del servidor web.
Valores: todo valor entre 10 y 32 000. El valor por defecto es 100.

Web max sessions

Alcance: servidor web local
Descripción: permite limitar el número de sesiones simultáneas. Cuando se alcanza el número definido, la sesión más antigua se cierra (y se llama al Método base On Web Legacy Close Session) si el servidor web necesita crear una nueva.
Valores posibles: Entero largo. El número de sesiones simultáneas no puede superar el número total de procesos web (opción Web Max Concurrent Processes, 100 por defecto)
Valores por defecto: 100 (pase 0 para restablecer el valor por defecto)

Web maximum requests size

Alcance: 4D local, 4D Server
Descripción: tamaño máximo (en bytes) de las peticiones HTTP entrantes (POST) que el servidor Web está autorizado a tratar. Por defecto, el valor es 2 000 000, es decir, un poco menos de 2 MB. El valor máximo (2 147 483 648) significa en la práctica que ningún límite se establece.
Esta configuración evita la saturación del servidor Web, causada por peticiones entrantes de gran tamaño. Cuando una petición llega al límite, el servidor web de 4D la rechaza.
Valores posibles: 500 000 a 2 147 483 648.

Web port ID

Alcance: 4D en modo local y 4D Server.
Descripción: establece u obtiene el número del puerto TCP utilizado por el servidor web 4D con 4D en modo local y 4D Server. Por defecto, el valor es 80. El número de puerto TCP se define en la página "Web/Configuración" de la caja de diálogo Propiedades de la base. Puede utilizar una de las constantes del tema Números de puerto TCP para el parámetro valor. Este selector es útil en el marco de servidores web 4D que se compilan y fusionan utilizando 4D de escritorio (sin acceso al entorno Diseño).
Valores posibles: para obtener más información sobre el número de puerto TCP, consulte la sección Parámetros del servidor web.
Valor por defecto: 80

Web scalable session

Alcance: servidor Web local
Descripción: activa o desactiva el modo de gestión de sesiones escalable (descrito en la página Sesiones de usuario en developer.4d.com)
Valores posibles: 1 (modo de activación) o 0 (modo de desactivación). Si se modifica el valor, el servidor web debe ser reiniciado para que se tenga en cuenta el cambio. Cuando se habilita este modo, se ignoran las siguientes opciones: Web inactive process timeout, Web max concurrent processes, Web session cookie name y Web inactive session timeout.

Web session cookie domain

Alcance: Servidor web local
Descripción: define u obtiene el valor del campo "dominio" de la cookie de sesión. Este selector (así como el selector 82) es útil para controlar el alcance de las cookies de sesión: si configura, por ejemplo, el valor "/*.4d.fr" para este selector, el cliente sólo enviará una cookie cuando la petición se dirige al dominio ".4d.fr", que excluye los servidores que alojan los datos estáticos externos.
Valores posibles: Texto

Web session cookie name

Alcance: servidor web local
Descripción: permite definir el nombre de la cookie utilizada para almacenar el ID de la sesión.
Valores: Texto
Valores por defecto: "4DSID" (pase una cadena vacía para restablecer el valor por defecto)

Web session cookie path

Alcance: servidor web local
Descripción: define u obtiene el valor del campo "path" de la cookie de sesión. Este selector (así como elselector 81) es útil para controlar el alcance de las cookies de sesión: si configura, por ejemplo, el valor "/4DACTION" para este selector, el cliente deberá enviar sólo una cookie para peticiones dinámicas que comiencen con 4DACTION , y no para las imágenes, páginas estáticas, etc.
Valores posibles: Texto

Web session enable IP address validation

Alcance: servidor Web Local
Descripción: Activa o desactiva la validación de las direcciones IP para las cookies de sesión. Por razones de seguridad, por defecto, el servidor web de 4D verifica la dirección IP de cada solicitud que contiene una cookie de sesión y la rechaza si esta dirección no coincide con la dirección IP utilizada para crear la cookie. En algunas aplicaciones específicas, es posible que desee desactivar esta validación y aceptar las cookies de sesión, incluso cuando sus direcciones IP no coincidan. Por ejemplo, cuando los dispositivos móviles cambian entre redes WiFi y 3G/4G, su dirección IP cambia. En este caso, debe pasar 0 en esta opción para permitir que los clientes puedan seguir utilizando sus sesiones web incluso cuando las direcciones IP cambien. Tenga en cuenta que esta configuración reduce el nivel de seguridad de la aplicación.
Cuando se modifica, esta configuración es efectiva inmediatamente (no es necesario reiniciar el servidor HTTP).
Valores posibles: 0 (desactivado) o 1 (activado)
Valor por defecto: 1 (las direcciones IP son verificadas)

Cuando utiliza el selector Web debug log, puede recibir una de las siguientes constantes en el parámetro valor:

Constante	Tipo	Valor	Comentario
wdl disable web log	Entero largo	0	El archivo de historial de peticiones HTTP Web está desactivado
wdl enable with all body parts	Entero largo	7	El archivo de historial de peticiones HTTP Web está activado con el cuerpo de la respuesta y la respuesta
wdl enable with request body	Entero largo	5	El archivo de historial de peticiones HTTP Web está activado con el cuerpo de la respuesta únicamente
wdl enable with response body	Entero largo	3	El archivo de historial de peticiones HTTP Web está activado con el cuerpo de la respuesta únicamente
wdl enable without body	Entero largo	1	El archivo de historial de peticiones HTTP Web está desactivado sin el cuerpo (el tamaño del cuerpo se entrega en este caso)

Ver también

WEB SET OPTION