Inizia qui · Autenticazione

Due modi per dimostrare che sei tu: una password o l'indirizzo da cui ti connetti.

Entrambi i metodi funzionano su ogni rete e su entrambi i protocolli. Scegli per server, mescolali liberamente.

3 minuti di lettura 7 sezioni Aggiornato 26 settembre 2026

Scegliere un metodo#

	Nome utente e password	Lista bianca IP
Funziona da	Qualsiasi IP, compresi quelli dinamici e cloud	Gli indirizzi IPv4 pubblici che hai registrato
Parametri di targeting	Aggiunto al nome utente	Invia qualsiasi nome utente per passarli; la password viene ignorata
Credenziali in transito	Base64 nel `Proxy-Authorization` intestazione	Nessuno
Meglio per	Laptop, contenitori, serverless, browser	Server fissi, browser anti-rilevamento che non possono memorizzare una password, flag di Chrome
Rotazione	Rigenera la password in qualsiasi momento	Aggiungi o rimuovi indirizzi in qualsiasi momento

Nome utente e password#

Il tuo account ha una coppia di credenziali per i gateway condivisi. È mostrato nella dashboard sotto Credenziali e restituito da GET /v1/credentials. Il nome utente porta il parametri di targeting; la password non cambia mai con loro.

arricciatura

# 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

Sotto il cofano invia un client HTTP Proxy-Authorization: Basic base64(username:password) su richiesta o su CONNECT; un client SOCKS5 utilizza la sottonegoziazione nome utente/password (RFC 1929). Ogni client tradizionale lo fa per te quando le credenziali si trovano nell'URL del proxy.

Lista bianca IP#

Registra gli indirizzi IPv4 pubblici delle macchine che si connetteranno e potranno utilizzare ogni endpoint senza credenziali. Fino a 50 indirizzi per account; le modifiche vengono applicate entro un minuto.

Trova l'indirizzo che la destinazione vedrà dal tuo server: curl https://api.ipify.org senza una proxy.
Aggiungilo sotto Impostazioni → Lista biancaoppure chiama POST /v1/whitelist.
Connettiti senza nome utente e password. Senza nome utente l'uscita viene scelta in tutto il mondo e ruota ad ogni connessione.
Per targettizzare, continua a inviare un nome utente con i parametri necessari e l'eventuale password: un indirizzo inserito nella whitelist è affidabile indipendentemente dalla password.

arricciatura

# 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, datacenter e dispositivi mobili dedicati#

Ogni indirizzo dedicato viene fornito con il proprio nome utente e password, stampati nell'elenco come ip:port:user:pass. Anche per loro vale la whitelist: da un server registrato a cui ti connetti ip:8000 senza alcuna credenziale. Non sono necessari parametri su un indirizzo dedicato, poiché la sua posizione è fissa.

Esempio di voce di elenco

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

Sottoutenti#

Un sottoutente è una coppia di credenziali extra sui gateway condivisi con il proprio limite di traffico e la propria linea di utilizzo. Creane uno per cliente, per progetto o per compagno di squadra in modo che una password trapelata esponga solo un budget limitato e tu possa leggere il consumo per linea di business. I sottoutenti vengono gestiti nella dashboard e tramite POST /v1/subusers.

Rotazione di una password#

Rigenera dal dashboard o con POST /v1/credentials/rotate. La coppia precedente continua a funzionare per dieci minuti in modo che i processi in esecuzione possano riprendere quella nuova senza errori.

Mantenere le credenziali fuori dai posti sbagliati#

Leggili dalle variabili di ambiente o da un archivio segreto, mai dal controllo del codice sorgente.
Preferisci la whitelist su reti condivise o non attendibili: il passaggio da te al gateway è semplice HTTP, quindi è possibile leggere un'intestazione Basic sul percorso.
Assegna a ogni strumento un sottoutente; revocare il subutente invece della password dell'account quando uno strumento viene ritirato.
Elimina gli URL proxy dai log. La maggior parte dei client stampa l'URL completo, credenziali incluse, in caso di errori.

Proxy

Menù