Commencez ici · Authentification
Deux façons de prouver qu'il s'agit bien de vous : un mot de passe ou l'adresse à partir de laquelle vous vous connectez.
Les deux méthodes fonctionnent sur tous les réseaux et sur les deux protocoles. Choisissez par serveur, mélangez-les librement.
Choisir une méthode#
| Nom d'utilisateur et mot de passe | Liste blanche IP | |
|---|---|---|
| Fonctionne à partir de | Toute IP, y compris dynamique et cloud | Les adresses IPv4 publiques que vous avez enregistrées |
| Paramètres de ciblage | Ajouté au nom d'utilisateur | Envoyez n'importe quel nom d'utilisateur pour les transmettre ; le mot de passe est ignoré |
| Titres en transit | Base64 dans le Proxy-Authorization en-tête | Aucun |
| Idéal pour | Ordinateurs portables, conteneurs, sans serveur, navigateurs | Serveurs fixes, navigateurs anti-détection qui ne peuvent pas stocker de mot de passe, drapeaux Chrome |
| Rotation | Régénérez le mot de passe à tout moment | Ajoutez ou supprimez des adresses à tout moment |
Nom d'utilisateur et mot de passe#
Votre compte dispose d'une paire d'identifiants pour les passerelles partagées. Il est affiché dans le tableau de bord sous Informations d'identification et renvoyé par GET /v1/credentials. Le nom d'utilisateur porte le paramètres de ciblage; le mot de passe ne change jamais avec eux.
# 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.orgSous le capot, un client HTTP envoie Proxy-Authorization: Basic base64(username:password) sur demande ou sur CONNECT; un client SOCKS5 utilise la sous-négociation nom d'utilisateur/mot de passe (RFC 1929). Chaque client grand public le fait pour vous lorsque les informations d'identification se trouvent dans l'URL du proxy.
Liste blanche IP#
Enregistrez les adresses IPv4 publiques des machines qui se connecteront et elles pourront utiliser chaque point de terminaison sans informations d'identification. Jusqu'à 50 adresses par compte ; les modifications s’appliquent dans la minute.
- Recherchez l'adresse que la cible verra sur votre serveur :
curl https://api.ipify.orgsans un proxy. - Ajoutez-le sous Paramètres → Liste blanche, ou appelez
POST /v1/whitelist. - Connectez-vous sans nom d'utilisateur ni mot de passe. Sans nom d'utilisateur, la sortie est choisie dans le monde entier et change à chaque connexion.
- Pour cibler, continuez à envoyer un nom d'utilisateur avec les paramètres dont vous avez besoin et n'importe quel mot de passe : une adresse sur liste blanche est fiable quel que soit le mot de passe.
# 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.orgFAI, centre de données et appareils mobiles dédiés#
Chaque adresse dédiée est accompagnée de son propre nom d'utilisateur et mot de passe, imprimés dans votre liste comme ip:port:user:pass. La liste blanche s'applique également à eux : à partir d'un serveur enregistré auquel vous vous connectez ip:8000 sans aucune information d'identification. Aucun paramètre n'est nécessaire sur une adresse dédiée, puisque son emplacement est fixe.
203.0.113.42:8000:u7f3a9c:kq2Lm8Pz1r # HTTP(S)
203.0.113.42:8001:u7f3a9c:kq2Lm8Pz1r # SOCKS5, same credentialsSous-utilisateurs#
Un sous-utilisateur est une paire d'informations d'identification supplémentaire sur les passerelles partagées avec sa propre limite de trafic et sa propre ligne d'utilisation. Créez-en un par client, par projet ou par coéquipier afin qu'une fuite de mot de passe n'expose qu'un budget limité et que vous puissiez lire la consommation par secteur d'activité. Les sous-utilisateurs sont gérés dans le tableau de bord et via POST /v1/subusers.
Rotation d'un mot de passe#
Régénérer depuis le tableau de bord ou avec POST /v1/credentials/rotate. La paire précédente continue de fonctionner pendant dix minutes afin que les tâches en cours d'exécution puissent récupérer la nouvelle sans échouer.
Garder les informations d'identification hors des mauvais endroits#
- Lisez-les à partir de variables d'environnement ou d'un magasin secret, jamais à partir du contrôle de code source.
- Préférez la liste blanche sur les réseaux partagés ou non fiables : le saut de vous à la passerelle est un simple HTTP, donc un en-tête Basic peut être lu sur le chemin.
- Attribuez à chaque outil un sous-utilisateur ; révoquer le sous-utilisateur au lieu du mot de passe du compte lorsqu'un outil est retiré.
- Supprimez les URL proxy des journaux. La plupart des clients impriment l'URL complète, informations d'identification incluses, en cas d'erreur.