Binance API キーで IP アドレス制限を有効にするにはどうすればよいですか?

IP アドレス制限について

1. IP アドレス制限は、API キーを特定の IPv4 アドレスまたは CIDR 範囲にバインドするセキュリティ層です。

2. ホワイトリストにリストされていない IP からのリクエストは、HTTP 401 Unauthorized ステータスで拒否されます。

3. このメカニズムにより、秘密キーが侵害された場合でも、漏洩した資格情報の不正使用が防止されます。

4. この機能は、REST および WebSocket API 呼び出しにのみ適用され、Web インターフェイスのログインやモバイル アプリのセッションには適用されません。

5. Binance は厳密な検証を強制します。空のフィールド、0.0.0.0/0 のようなワイルドカード エントリ、または不正な CIDR 構文は、即座に設定の拒否を引き起こします。

API 管理インターフェイスの操作

1. 検証済みの 2FA を使用して Binance アカウントにログインし、ユーザー センター → セキュリティ → API 管理に移動します。

2. 対象の API キー行を見つけて、右端の[編集]ボタンをクリックします。

3. [IP ホワイトリスト設定]セクションまで下にスクロールします。ホワイトリストを有効にしてキーが作成されない限り、この領域は非表示のままです。

4. 「IP ホワイトリストを有効にする」というラベルの付いたトグル スイッチをクリックします。これにより、IPv4 アドレスの入力フィールドが表示されます。

5. カンマ区切りの 1 つ以上の IPv4 アドレス (例: 203.0.113.42、198.51.100.0/24) を、カンマの前後にスペースを入れずに入力します。

IP 構成の検証

1. ipinfo.ioまたはwhatismyipaddress.comを使用して、取引サーバーまたはローカル マシンのパブリック IPv4 アドレスを確認します。

2. クラウド インフラストラクチャに展開する場合は、プロバイダーのコンソールからプライベート LAN アドレスではなく、アウトバウンド NAT IP を取得します。

3. 動的な住宅用 IP を避けます。代わりに、静的 IP を構成するか、固定出力ルーティングを持つ VPS を使用してください。

4. 変更を保存した後、ホワイトリストに登録されたホストからのみGET /api/v3/timeを呼び出して接続をテストします。

5. 応答が成功すると、バインディングが正しいことが確認されます。失敗は、IP の設定が間違っているか、DNS ベースの解決が意図したルートをバイパスしていることを示します。

複数の展開環境の管理

1. 開発環境、ステージング環境、実稼働環境では、個別の API キーを作成し、それぞれに独自の専用 IP リストを含めます。

2. 単一のキーを環境間で再利用しないでください。環境間の漏洩により、分離の保証が損なわれます。

3. キーをローテーションするときは、IP ホワイトリストを同時に更新します。同期が遅れると、一時的なアクセス ギャップが生じます。

4. Binance のAPI アクティビティ履歴タブで失敗したリクエストのログを監視し、アクセスを試みる予期しないソース IP を検出します。

5. 新しいキーが正しく機能することを確認したら、すぐにレガシー キーを無効にします。重複するアクティブ キーを必要以上に長く維持しないでください。

よくある質問

Q: Binance IP ホワイトリストで IPv6 アドレスを使用できますか?いいえ。Binance は現在、IPv4 アドレスと CIDR 表記のみをサポートしています。 IPv6 エントリは、検証中に何も表示されずに無視されます。

Q: ホワイトリストがアクティブな間にサーバーのパブリック IP が変更された場合はどうなりますか?更新されたアドレスがホワイトリストに手動で追加されるまで、新しい IP からのすべての API リクエストはエラー コード -1015 で失敗します。

Q: IP ホワイトリストを有効にすると、WebSocket 接続に影響しますか?はい。 stream.binance.com:9443などの WebSocket エンドポイントは、REST エンドポイントと同じ IP 制限を適用します。

Q: 1 つのホワイトリストに追加できる IP の数に制限はありますか? Binance では、API キーごとに最大 20 個の個別の IPv4 アドレスまたは CIDR ブロックが許可されます。この数を超えると、保存中に「IP が多すぎます」エラーが発生します。