Ajustes de la solicitud

La pestaña Ajustes contiene cómo viaja una solicitud: qué versión de HTTP usa, si sigue redirecciones, si guarda cookies, si comprueba certificados y cuánto puede tardar. Los proxies y los certificados se definen para todo el espacio de trabajo o para la app, más abajo en esta página.

La pestaña AjustesCopy Anchor Link

Solo los ajustes que cambias se guardan en el archivo de la solicitud. La pestaña muestra un punto cuando algún ajuste difiere de su valor predeterminado, y dice Ajustes (sin procesar) mientras el modo sin procesar está activado. Restablecer valores predeterminados devuelve todos los ajustes a su valor original.

En el archivo de la solicitud, los ajustes se ven así:

[settings]
http-version = "http2"
follow-redirects = false
timeout = 10.0

Versión de HTTPCopy Anchor Link

HTTP/3 tiene límites:

• Necesita macOS 27 o posterior. En un Mac más antiguo, la pestaña lo indica y no se puede enviar una solicitud establecida en HTTP/3; Automático se queda en HTTP/2 y HTTP/1.1.
• Solo direcciones https://.
• Sin proxies (incluido el del sistema), sin archivos de CA personalizados y sin certificados de cliente. Una solicitud establecida en HTTP/3 que necesita alguno de ellos se rechaza con el motivo. En Automático, esas solicitudes se quedan en TCP.
• El modo sin procesar no se puede usar con HTTP/3.

En Automático, cuando una respuesta ofrece HTTP/3, su tarjeta de detalles muestra HTTP/3 ofrecido. Si falla la conexión QUIC de la solicitud siguiente, Echolot la envía por TCP, olvida la oferta y la tarjeta de detalles dice por qué. Nada se envía dos veces.

Otros dos casos cambian de versión por sí solos:

• NTLM necesita HTTP/1.1. En Automático, las solicitudes NTLM van por HTTP/1.1; en HTTP/2 o HTTP/3 se rechazan.
• Cuando un servidor restablece una solicitud HTTP/2 con HTTP_1_1_REQUIRED, Echolot habla HTTP/1.1 con ese servidor a partir de entonces. Una solicitud que se puede repetir sin riesgo se envía de nuevo enseguida por HTTP/1.1; cualquier otra solicitud se detiene con un error que lo indica, y va por HTTP/1.1 cuando la envías otra vez.

La tarjeta de detalles de la respuesta muestra la versión que se usó, junto a la versión de TLS.

RedireccionesCopy Anchor Link

Con Seguir redirecciones activado, Echolot sigue las respuestas 301, 302, 303, 307 y 308 hacia direcciones http:// y https://:

• 303 se convierte en un GET (un HEAD sigue siendo HEAD), sin el cuerpo.
• 301 y 302 convierten un POST en un GET, como hacen los navegadores.
• 307 y 308 conservan el método y el cuerpo.

Cada salto queda registrado. La tarjeta de detalles muestra 3 redirecciones (o cuántas haya); haz clic para ver el estado, el método, la dirección y el tiempo de cada salto, y la dirección final. Pruébalo con Echo › Follow redirects en Alpenglow.

Una redirección a otro origen descarta tus credenciales: las cabeceras Authorization y Cookie, las cabeceras de clave de API, las cabeceras que contienen un secreto, la firma (Digest, AWS, Hawk, EdgeGrid, NTLM) y el certificado de cliente. Consulta Las credenciales se quedan con su origen.

Con Seguir redirecciones desactivado, la respuesta 3xx es la respuesta.

CookiesCopy Anchor Link

Cada ventana tiene un almacén de cookies. Con Enviar y guardar cookies activado, una solicitud envía las cookies del almacén que coinciden con su dirección, y las cookies que establece su respuesta se guardan en él. Desactívalo para una solicitud que no deba enviar ni conservar ninguna.

La pestaña Cookies de la respuesta muestra tres listas: Enviada con la solicitud, Establecida por la respuesta y Guardada en esta ventana. Elimina una cookie con su botón, o todas con Borrar todo. Consulta Respuestas.

El almacén sigue las reglas de los navegadores: una respuesta no puede establecer una cookie para todo un sufijo público como .com o .co.uk. Prueba Echo › Set a cookie en Alpenglow y después cualquier otra solicitud a demo.echolot.dev.

Descomprimir respuestasCopy Anchor Link

Con Descomprimir respuestas activado, Echolot envía Accept-Encoding: gzip, deflate, br, zstd (salvo que definas tú esa cabecera) y decodifica las respuestas gzip, deflate, Brotli y Zstandard. La pestaña Cuerpo muestra el cuerpo decodificado; los bytes tal como llegaron se quedan en la pestaña Red, y el menú de guardado del cuerpo ofrece Guardar cuerpo codificado…. La tarjeta de detalles dice, por ejemplo, br, 12 KB → 48 KB.

Desactívalo para ver una respuesta exactamente como la comprimió el servidor, o para no enviar ninguna cabecera Accept-Encoding.

Verificar certificados TLSCopy Anchor Link

Déjalo activado salvo que pruebes contra un servidor cuyo certificado tu Mac no considera de confianza y no puedas añadir su CA. Con él desactivado, la tarjeta de detalles muestra un candado naranja abierto, y su ventana emergente dice La verificación de certificados está desactivada.

Una forma mejor para una CA privada es darle confianza para ese host: consulta Certificados.

Tiempo de esperaCopy Anchor Link

El tiempo de espera es el tiempo total que puede tardar el intercambio, desde la conexión hasta el último byte. Cuando se agota, la solicitud se detiene con Se agotó el tiempo de espera de la solicitud y se cierra la conexión.

Modo sin procesarCopy Anchor Link

El modo sin procesar sirve para enviar una solicitud byte a byte tal como la escribiste, incluso si está mal formada, para probar cómo la trata un servidor. Echolot omite las cabeceras que añade a toda solicitud (Host, User-Agent, Accept, Accept-Encoding, Cookie, Content-Length y la delimitación) y no comprueba que la solicitud esté bien formada. Bajo GENERADAS AUTOMÁTICAMENTE, la pestaña Cabeceras dice Modo sin procesar: Echolot no añade cabeceras; solo se envían las de arriba.

Para una solicitud que envíe solo tus propias cabeceras, define también Autenticación en Sin autenticación y escribe tu propio Content-Type si el cuerpo necesita uno. El modo sin procesar escribe HTTP/1.1, así que no se puede usar con HTTP/3.

ReintentosCopy Anchor Link

Echolot mantiene las conexiones abiertas y las reutiliza, lo que ahorra el tiempo de DNS, de conexión y de TLS; la tarjeta de detalles dice Conexión reutilizada cuando lo hace. A veces un servidor ha cerrado una conexión mantenida abierta justo cuando sale una solicitud. Entonces:

• Una solicitud que se puede repetir sin riesgo se envía de nuevo por una conexión nueva: un GET, HEAD, OPTIONS, TRACE, PUT o DELETE, o cualquier solicitud con una cabecera Idempotency-Key. La tarjeta de detalles dice que se envió de nuevo.
• Cualquier otra solicitud (un POST sin Idempotency-Key, por ejemplo) no se envía de nuevo, porque el servidor puede haber actuado sobre ella. Se detiene con La conexión se cerró antes de llegar ninguna respuesta; puede que el servidor haya aplicado la solicitud.

Echolot nunca reintenta en ningún otro caso.

ProxiesCopy Anchor Link

De forma predeterminada, las solicitudes pasan por el proxy elegido en Ajustes › Red:

Un espacio de trabajo puede definir su propio proxy, que viaja con él hasta los compañeros y la herramienta de línea de comandos:

1. Abre Ajustes del espacio de trabajo… en el selector de espacio de trabajo al pie de la barra lateral.
2. Elige la pestaña Proxy y desactiva Usar el ajuste de proxy de la app.
3. Elige Ajustes del Sistema, Entorno (HTTPS_PROXY…) (lee HTTPS_PROXY, HTTP_PROXY y NO_PROXY), Ninguno o Manual.
4. Para Manual, rellena Proxy (admite variables, como {{proxy}}), Nombre de usuario y Contraseña, y Sin proxy para. Escribe la contraseña como variable secreta, {{proxy_password}}: los archivos del espacio de trabajo nunca contienen secretos. Una contraseña literal ofrece Trasladar al llavero.

HTTP/3 nunca pasa por un proxy. Consulta Espacios de trabajo.

CertificadosCopy Anchor Link

Para un host que usa una autoridad de certificación privada, o que pide un certificado de cliente (TLS mutuo), añade una regla en el espacio de trabajo:

1. Abre Ajustes del espacio de trabajo… y elige la pestaña Certificados.
2. Haz clic en Añadir host y escribe el host, como api.example.com, o *.internal para todos los subdominios.
3. Junto a CA de confianza, haz clic en Elegir… y selecciona uno o varios archivos PEM. Se consideran de confianza además de los del sistema.
4. Para un certificado de cliente, elige el archivo junto a Certificado de cliente: un archivo PEM o un .p12 (.pfx). Para un certificado PEM cuyo archivo no tiene clave, elige también el archivo de Clave privada.
5. Si la clave o el .p12 tiene una frase de contraseña, escríbela como variable secreta en Frase de contraseña, como {{p12_passphrase}}.

Cuenta la primera regla que coincide con un host. Los archivos dentro del espacio de trabajo se guardan como rutas relativas a él, así que la regla funciona para todas las personas que tienen el espacio de trabajo. Los certificados de cada regla se usan solo para su host: una redirección a otro host nunca presenta el certificado de cliente del primer host.

Ajustes de toda la appCopy Anchor Link

El proxy es el único ajuste de solicitud con un valor predeterminado para toda la app (Ajustes › Red). Todos los demás ajustes parten, para cada solicitud, de los valores predeterminados de la tabla de arriba, y el archivo de la solicitud conserva lo que cambias. Para cambiar ajustes de muchas solicitudes a la vez, selecciónalas en la barra lateral y usa Editar N solicitudes… para sus cabeceras, parámetros y autenticación, o edita los archivos.