ここから始める · 認証
あなたであることを証明する 2 つの方法: パスワードまたは接続元のアドレス。
どちらの方法も、すべてのネットワークおよび両方のプロトコルで機能します。サーバーごとに選択し、自由に組み合わせてください。
方法の選択#
| ユーザー名とパスワード | IPホワイトリスト | |
|---|---|---|
| からの作品 | 動的 IP やクラウド IP を含む任意の IP | 登録したパブリックIPv4アドレス |
| ターゲティングパラメータ | ユーザー名に追加される | 渡すには任意のユーザー名を送信します。パスワードは無視されます |
| 転送中の認証情報 | Base64 の Proxy-Authorization ヘッダー | なし |
| こんな方に最適 | ラップトップ、コンテナ、サーバーレス、ブラウザ | 固定サーバー、パスワードを保存できないブラウザの検出防止、Chrome フラグ |
| 回転 | いつでもパスワードを再生成できます | アドレスはいつでも追加または削除できます |
ユーザー名とパスワード#
アカウントには、共有ゲートウェイ用の資格情報ペアが 1 つあります。ダッシュボードの下に表示されます 資格情報 そして戻ってきました GET /v1/credentials。ユーザー名には、 ターゲティングパラメータ;パスワードは決して変更されません。
# 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.orgHTTP クライアントが内部で送信するもの Proxy-Authorization: Basic base64(username:password) リクエストに応じて、または CONNECT; SOCKS5 クライアントは、ユーザー名/パスワードのサブネゴシエーション (RFC 1929) を使用します。資格情報がプロキシ URL に含まれている場合、すべての主流クライアントがこれを実行します。
IPホワイトリスト#
接続するマシンのパブリック IPv4 アドレスを登録すると、資格情報なしですべてのエンドポイントを使用できるようになります。アカウントごとに最大 50 個のアドレス。変更は 1 分以内に適用されます。
- サーバーからターゲットに表示されるアドレスを見つけます。
curl https://api.ipify.orgなしで プロキシ。 - 以下に追加します 設定→ホワイトリスト、または電話してください
POST /v1/whitelist. - ユーザー名とパスワードを使用せずに接続します。ユーザー名がない場合、出口は世界中で選択され、接続ごとにローテーションされます。
- ターゲットを設定するには、必要なパラメータを含むユーザー名と任意のパスワードを送信し続けます。ホワイトリストに登録されたアドレスは、パスワードに関係なく信頼されます。
# 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、データセンター、モバイル デバイス#
各専用アドレスには独自のユーザー名とパスワードが付属しており、リストに次のように出力されます。 ip:port:user:pass。ホワイトリストは、接続する登録済みサーバーからそれらにも適用されます。 ip:8000 資格情報がまったくありません。専用アドレスの位置は固定されているため、パラメータは必要ありません。
203.0.113.42:8000:u7f3a9c:kq2Lm8Pz1r # HTTP(S)
203.0.113.42:8001:u7f3a9c:kq2Lm8Pz1r # SOCKS5, same credentialsサブユーザー#
サブユーザーは、独自のトラフィック制限と独自の使用量回線を持つ、共有ゲートウェイ上の追加の資格情報のペアです。クライアントごと、プロジェクトごと、またはチームメイトごとに 1 つ作成すると、パスワードが漏洩しても限られた予算のみが明らかになり、事業分野ごとの消費量を読み取ることができます。サブユーザーはダッシュボードで管理されます。 POST /v1/subusers.
パスワードのローテーション#
ダッシュボードから、または POST /v1/credentials/rotate。前のペアは 10 分間動作し続けるため、実行中のジョブは失敗することなく新しいペアを選択できます。
資格情報を間違った場所に保管しない#
- ソース管理からではなく、環境変数またはシークレット ストアからそれらを読み取ります。
- 共有ネットワークまたは信頼できないネットワークではホワイトリストを使用します。ユーザーからゲートウェイまでのホップはプレーン HTTP であるため、パス上で基本ヘッダーを読み取ることができます。
- 各ツールにサブユーザーを与えます。ツールが廃止されたときに、アカウントのパスワードではなくサブユーザーを取り消します。
- ログからプロキシ URL を削除します。ほとんどのクライアントは、エラー時に資格情報を含む完全な URL を出力します。