Dos formas de autenticarte: con contraseña o mediante una IP autorizada.

Elegir un método#

Nombre de usuario y contraseña#

Su cuenta tiene un par de credenciales para las puertas de enlace compartidas. Se muestra en el tablero debajo Credenciales y regresado por GET /v1/credentials. El nombre de usuario lleva el parámetros de orientación; la contraseña nunca cambia con ellos.

# HTTP(S) target through the residential gateway
curl -x http://USER-cc-us:PASS@res.proxy-cyber.com:9000 https://api.ipify.org

# Same thing over SOCKS5 (socks5h = resolve the hostname at the exit)
curl --proxy socks5h://USER-cc-us:PASS@res.proxy-cyber.com:9001 https://api.ipify.org

Debajo del capó, un cliente HTTP envía Proxy-Authorization: Basic base64(username:password) en la solicitud o en el CONNECT; un cliente SOCKS5 utiliza la subnegociación de nombre de usuario/contraseña (RFC 1929). Todos los clientes convencionales hacen esto por usted cuando las credenciales están en la URL del proxy.

lista blanca de IP#

Registre las direcciones IPv4 públicas de las máquinas que se conectarán y podrán usar todos los puntos finales sin credenciales. Hasta 50 direcciones por cuenta; los cambios se aplican en un minuto.

1. Encuentre la dirección que el objetivo verá en su servidor: curl https://api.ipify.org sin un proxy.
2. Agréguelo debajo Configuración → Lista blanca, o llamar POST /v1/whitelist.
3. Conéctese sin nombre de usuario y contraseña. Sin nombre de usuario, la salida se elige en todo el mundo y rota en cada conexión.
4. Para apuntar, siga enviando un nombre de usuario con los parámetros que necesita y cualquier contraseña: una dirección incluida en la lista blanca es confiable independientemente de la contraseña.

# From a whitelisted server: no credentials at all
curl -x http://res.proxy-cyber.com:9000 https://api.ipify.org

# Still whitelisted, but with targeting: any password works
curl -x http://USER-cc-fr-city-paris:x@res.proxy-cyber.com:9000 https://api.ipify.org

ISP dedicado, centro de datos y dispositivos móviles#

Cada dirección dedicada viene con su propio nombre de usuario y contraseña, impresos en su lista como ip:port:user:pass. La lista blanca también se aplica a ellos: desde un servidor registrado al que se conecta ip:8000 sin ninguna credencial. No se necesitan parámetros en una dirección dedicada, ya que su ubicación es fija.

203.0.113.42:8000:u7f3a9c:kq2Lm8Pz1r        # HTTP(S)
203.0.113.42:8001:u7f3a9c:kq2Lm8Pz1r        # SOCKS5, same credentials

Subusuarios#

Un subusuario es un par de credenciales adicional en las puertas de enlace compartidas con su propio límite de tráfico y su propia línea de uso. Cree una por cliente, por proyecto o por compañero de equipo para que una contraseña filtrada solo exponga un presupuesto limitado y pueda leer el consumo por línea de negocio. Los subusuarios se gestionan en el panel y a través de POST /v1/subusers.

Rotar una contraseña#

Regenerar desde el tablero o con POST /v1/credentials/rotate. El par anterior sigue funcionando durante diez minutos para que los trabajos en ejecución puedan retomar el nuevo sin fallar.

Mantener las credenciales fuera de los lugares equivocados#

• Léalos desde variables de entorno o un almacén secreto, nunca desde el control de fuente.
• Prefiera la lista blanca en redes compartidas o que no sean de confianza: el salto desde usted hasta la puerta de enlace es HTTP simple, por lo que se puede leer un encabezado básico en la ruta.
• Asigne a cada herramienta un subusuario; revocar el subusuario en lugar de la contraseña de la cuenta cuando se retira una herramienta.
• Elimina las URL de proxy de los registros. La mayoría de los clientes imprimen la URL completa, incluidas las credenciales, en caso de errores.