TL;DR
- La autenticación de usuario y contraseña demuestra el acceso con las credenciales suministradas al gateway proxy; la autenticación por lista blanca de IP permite el tráfico desde direcciones de egreso de fuente aprobadas.
- La autenticación de usuario y contraseña se adapta a IPs de cliente cambiantes y trabajos portátiles; la lista blanca de IP se adapta a egresos estables bajo control de red centralizado.
- Una respuesta 407 significa que el proxy no aceptó la autenticación. Un 401 de destino es una capa diferente.
- Nunca coloque credenciales de proxy activas en el control de versiones, registros, capturas de pantalla o una URL compartida con otro servicio.
- Nstdata documenta tanto las credenciales del canal como la solución de problemas de la lista blanca; verifique las opciones exactas de autenticación de su canal seleccionado antes de la implementación.
What Is Proxy Authentication?
La autenticación de proxy es la verificación del gateway de que un cliente tiene permiso para usar su ruta de red. Ocurre antes o durante el intento del cliente de alcanzar el destino. Las opciones comunes son un nombre de usuario y una contraseña enviados al gateway, o una lista blanca de las direcciones IP públicas de egreso del cliente. Algunos productos combinan ambos. El inicio de sesión en el sitio de destino es separado: una credencial de proxy no lo inicia sesión en una cuenta objetivo.
La documentación de Proxy de Nstdata muestra un nombre de usuario de gateway construido a partir de la ID del canal y los parámetros de enrutamiento, más una contraseña del canal. Su guía de solución de problemas identifica credenciales de usuario y contraseña incorrectas y un desajuste entre la IP en la lista blanca y la fuente de conexión real como causas del HTTP 407. El canal y producto seleccionados determinan qué opciones están disponibles, así que inspeccione el panel actual en lugar de asumir que todos los productos de proxy se comportan de la misma manera.
How Do User-Pass and IP Whitelisting Differ?
La autenticación de usuario y contraseña y la lista blanca de IP difieren en lo que confían. La autenticación de usuario y contraseña confía en un secreto presentado por el cliente; la lista blanca de IP confía en la ubicación de red desde la cual llega la conexión.
| Criterio | Usuario y contraseña | Lista blanca de IP |
|---|---|---|
| Material de identidad | Nombre de usuario y contraseña | IP pública de egreso aprobada |
| Mejor ajuste | Desarrolladores, trabajos en la nube con egreso cambiante, enrutamiento por canal | Egreso estable de oficina o servidor con redes controladas |
| Riesgo principal | Filtración de credenciales a través de código, registros o URL copiada | Cambio de egreso inesperado o NAT compartido que otorga acceso a más clientes |
| Esfuerzo de rotación | Rotar secreto y actualizar clientes | Actualizar IPs permitidas cuando la infraestructura cambia |
| Pregunta de depuración | ¿El cliente envió las credenciales correctas del canal? | ¿Qué IP pública vio realmente el gateway? |
Ninguno es automáticamente “más seguro” en cada entorno. Una lista blanca de IP puede ser estrecha cuando el egreso es dedicado y el cambio es controlado; puede ser amplia cuando muchas cargas de trabajo comparten una dirección NAT. Una contraseña puede ser delimitada y rotada, pero integrarla en una URL requiere un manejo cuidadoso. Cuando ambos controles son compatibles, su combinación puede reducir la exposición accidental, aunque también agrega modos de fallo operativo.
What Do You Need Before Configuring Either Method?
Necesita un canal proxy activo, el Host y el Puerto generados, el protocolo que su cliente utilizará, y ya sea las credenciales del canal o la IP pública de egreso estable para la lista blanca. Cree un canal y genere una URL de Proxy a través de Detalles del canal → Generación de proxy. Registre el producto de proxy seleccionado, el país, la duración de la sesión y la ID de sesión si el formato del nombre de usuario los utiliza. Un canal es una unidad de uso y facturación, así que asegúrese de que el equipo previsto posea el canal correcto.
Para la lista blanca de IP, determine la IP pública de salida de la máquina o NAT que se conectará a Nstdata. Una laptop detrás de un VPN o NAT en la nube puede tener una IP de egreso diferente de su dirección de interfaz local. Para la autenticación de usuario y contraseña, coloque el secreto en un almacén de secretos aprobado y distribúyalo solo al trabajo que lo requiere. No publique una URL de proxy real en un ticket o base de conocimientos.
Method 1: How Do You Use Username and Password?
La autenticación de usuario y contraseña se configura en la URL de proxy del cliente o en el campo de autenticación proxy utilizando las credenciales generadas del canal Nstdata.
Step 1: Generate the proxy configuration
Abra la página de detalles del canal, habilite la Generación de Proxy, elija los parámetros admitidos y copie la URL generada. Tenga en cuenta el Host, Puerto, Nombre de usuario, Contraseña y Protocolo. Utilice el valor generado en lugar de adivinar manualmente la estructura del gateway o del nombre de usuario.
Step 2: Configure the client
Para un cliente que acepta una URL de proxy, utilice el formato documentado a continuación con marcadores de posición. El nombre de usuario puede incluir Canal, tipo de proxy, país, duración de la sesión y ID de sesión; el valor exacto generado es autoritativo.
curl --proxy 'http://<host>:<port>' \ --proxy-user '<generated-username>:<channel-password>' \ 'https://api.ipapi.is/'
Evite la exposición del historial de la terminal en una ejecución real obteniendo secretos de un mecanismo de ejecución protegido. El comando es ilustrativo; no hay ninguna credencial activa de Nstdata disponible aquí.
Paso 3: Verificar y monitorear
Inspeccione la respuesta de verificación de IP para la ubicación de salida esperada y registre solo metadatos de enrutamiento redactados. Si el gateway devuelve 407, verifique el nombre de usuario generado, la contraseña, el estado del Canal y si las credenciales se URL-encoding correctamente en los clientes que lo incrustan en una URL.
Método 2: ¿Cómo se utiliza una lista blanca de IP?
La lista blanca de IP se configura en el lado del proveedor para una dirección de salida de cliente estable, cuando el Canal seleccionado lo admite.
Paso 1: Confirmar la IP de salida real
Desde el tiempo de ejecución que llamará al proxy, determine su IP pública de salida. Repita la verificación después de cambios en VPN, NAT o redes en la nube; no permita una dirección privada 10.x o 192.168.x.
Paso 2: Agregar la IP a través del control Nstdata aprobado
Utilice el control de lista blanca de Canal o API actual disponible para su cuenta. La documentación de la interfaz API de Nstdata hace referencia a un comando API de lista blanca-IP, pero no hace que el camino exacto de la interfaz actual sea universal para todos los productos proxy. Registre al propietario del cambio y la fecha de revisión. Evite rangos amplios a menos que sean necesarios y revisados.
Paso 3: Probar desde el tiempo de ejecución intendido
Conéctese a través del gateway y verifique la IP de salida. Luego, intente desde un egreso de prueba no aprobado solo si la política de seguridad de su organización lo permite. Un 407 desde el tiempo de ejecución intendido a menudo significa que el gateway ve una IP de origen diferente a la que asumió. Verifique NAT, VPN y el enrutamiento IPv4/IPv6.
¿Cómo manejar las fallas de autenticación de manera segura?
Maneje las fallas de autenticación identificando la capa que falla antes de volver a intentar. Un 407 de gateway no es lo mismo que un 401 de destino. Reintentar repetidamente credenciales incorrectas solo aumenta el ruido y puede consumir recursos. Registre el host de destino, el identificador de Canal redactado, el producto proxy, el código de error y la hora; nunca registre la contraseña o la URL completa.
Una breve secuencia de diagnóstico es: confirmar que el Canal está activo, confirmar el Host y el Puerto del gateway, inspeccionar el Nombre de Usuario y la Contraseña generados, confirmar el modo de autenticación seleccionado y verificar la IP de salida real si se aplica la lista blanca. La página de problemas comunes de Nstdata también aconseja revisar el tráfico del Canal y la expiración. Para varias aplicaciones que comparten rutas, Nstdata Proxy Manager puede centralizar la visibilidad operativa, pero no reemplaza la gobernanza de credenciales.
¿Qué método de autenticación deberías elegir?
Elige usuario-contraseña cuando los trabajos se mueven entre redes o necesitan una credencial portátil por Canal. Elige una lista blanca de IP cuando la salida sea estable, dedicada y fácil de cambiar el control. Utiliza ambos solo donde el producto Nstdata seleccionado lo soporte y el control adicional valga la pena el esfuerzo operativo.
Empieza con una prueba de conexión autorizada y documenta cómo revocar el acceso. Si su necesidad real es el descubrimiento de páginas y la salida de Markdown en lugar de la configuración directa del proxy, Nstdata Crawl es una API de rastreo web separada para datos listos para LLM con orquestación de proxy incorporada.
FAQ
P: ¿Es HTTP 407 lo mismo que el destino 401?
No. Un 407 significa que el gateway proxy requiere o rechazó la autenticación; un 401 generalmente proviene de la aplicación de destino.
P: ¿Puedo usar una IP privada en una lista blanca?
No. El gateway ve la IP pública de salida después del enrutamiento NAT o VPN, no la dirección de la interfaz privada de su máquina.
P: ¿El parámetro auth= de Requests autentica un proxy?
No. En Requests, las credenciales del proxy pertenecen a la URL del proxy configurado; auth= es para el destino.
P: ¿Una lista blanca de IP elimina todo riesgo de seguridad?
No. NAT compartido, rangos no revisados y cambios de salida pueden ampliar el acceso o causar interrupciones.
P: ¿Qué debo rotar después de una filtración de contraseña de proxy?
Rote o revoque las credenciales del Canal afectado, actualice los clientes autorizados y revise el uso y los registros del gateway de acuerdo con su proceso de incidentes.
