Begin hier · Authenticatie
Twee manieren om te bewijzen dat jij het bent: een wachtwoord, of het adres waar je vandaan komt.
Beide methoden werken op elk netwerk en op beide protocollen. Kies per server, meng ze vrij.
Een methode kiezen#
| Gebruikersnaam en wachtwoord | IP-witte lijst | |
|---|---|---|
| Werkt van | Elk IP-adres, inclusief dynamische en cloud-IP's | De publieke IPv4-adressen die u hebt geregistreerd |
| Targetingparameters | Toegevoegd aan de gebruikersnaam | Stuur een gebruikersnaam om ze door te geven; het wachtwoord wordt genegeerd |
| Referenties onderweg | Basis64 in de Proxy-Authorization koptekst | Geen |
| Beste voor | Laptops, containers, serverless, browsers | Vaste servers, anti-detect browsers die geen wachtwoord kunnen opslaan, Chrome-vlaggen |
| Rotatie | Genereer het wachtwoord op elk gewenst moment opnieuw | U kunt op elk gewenst moment adressen toevoegen of verwijderen |
Gebruikersnaam en wachtwoord#
Uw account heeft één credential paar voor de gedeelde gateways. Het wordt getoond in het dashboard onder Referenties en teruggestuurd door GET /v1/credentials. De gebruikersnaam draagt de targetingparameters; bij hen verandert het wachtwoord nooit.
# 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.orgOnder de motorkap verzendt een HTTP-client Proxy-Authorization: Basic base64(username:password) op verzoek of op de CONNECT; een SOCKS5 client gebruikt de gebruikersnaam/wachtwoord sub-onderhandeling (RFC 1929). Elke mainstream client doet dit voor u als de referenties in de proxy-URL staan.
IP-witte lijst#
Registreer de openbare IPv4-adressen van de machines die zullen aansluiten, en ze kunnen elk eindpunt zonder referenties gebruiken. Tot 50 adressen per account; wijzigingen zijn binnen een minuut van toepassing.
- Zoek het adres dat het doel zal zien van uw server:
curl https://api.ipify.orgzonder een proxy. - Voeg het toe onder Instellingen → Witte lijst, of bel
POST /v1/whitelist. - Verbinden zonder gebruikersnaam en wachtwoord. Zonder gebruikersnaam wordt de exit wereldwijd gekozen en draait op elke verbinding.
- Om een doel te bereiken, blijf een gebruikersnaam versturen met de parameters die u nodig hebt en een wachtwoord: een adres op de whitelist is vertrouwd, ongeacht het wachtwoord.
# 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.orgSpecifieke ISP, datacenter en mobiele apparaten#
Elk dedicated adres wordt geleverd met een eigen gebruikersnaam en wachtwoord, afgedrukt in uw lijst als ip:port:user:pass. De whitelist is ook op hen van toepassing: vanaf een geregistreerde server waarmee u verbinding maakt ip:8000 Parameters zijn niet nodig op een specifiek adres, omdat de locatie is vastgesteld.
203.0.113.42:8000:u7f3a9c:kq2Lm8Pz1r # HTTP(S)
203.0.113.42:8001:u7f3a9c:kq2Lm8Pz1r # SOCKS5, same credentialsSub-gebruikers#
Een sub-gebruiker is een extra credential pair op de gedeelde gateways met zijn eigen verkeerslimiet en zijn eigen gebruikslijn. Maak er een per client, per project of per teamgenoot, zodat een gelekt wachtwoord alleen een begrensd budget blootlegt en u het verbruik per lijn kunt lezen. Sub-gebruikers worden beheerd in het dashboard en door POST /v1/subusers.
Een wachtwoord roteren#
Regenereer vanaf het dashboard of met POST /v1/credentials/rotate. De vorige paar blijft werken voor tien minuten, zodat lopende banen kunnen de nieuwe op te pikken zonder te falen.
Criminaliteiten uit de verkeerde plaatsen houden#
- Lees ze uit omgevingsvariabelen of een geheime winkel, nooit vanuit broncontrole.
- Liever de whitelist op gedeelde of niet-vertrouwde netwerken: de hop van u naar de gateway is gewoon HTTP, zodat een Basic header kan worden gelezen op het pad.
- Geef elke tool een sub-gebruiker; herroep de sub-gebruiker in plaats van het wachtwoord van het account wanneer een tool wordt gepensioneerd.
- Verwijder proxy-URL's van logs. De meeste clients drukken de volledige URL af, inclusief referenties, op fouten.