Bybit API アクセス用の IP ホワイトリストを構成するにはどうすればよいですか?

Bybit API IP ホワイトリスト構成の概要

1. Bybit では、運用環境で使用されるすべての API キーに対して厳密なネットワーク レベルの認証が必要です。リクエストの起点を制限するには、各 API キーを定義済みの IPv4 アドレスのセットに関連付ける必要があります。

2. IP ホワイトリストは、認証または許可チェックが行われる前に、交換のゲートウェイ層で適用されます。ホワイトリストに登録されていない IP からのリクエストは、HTTP 403 Forbidden 応答を即座に受け取ります。

3. Bybit は IPv6 ホワイトリストをサポートしていません。構成中には、IPv4 アドレスまたは CIDR 表記 (例: 203.0.113.42/32 または 192.0.2.0/24) のみが受け入れられます。

4. 単一の API キーは、個別のアドレスやサブネット範囲を含む最大 20 個の異なる IPv4 エントリを保持できますが、重複する CIDR ブロックは送信時に拒否されます。

5. IP ホワイトリストへの変更は、キーの再生成やサービスの再起動を必要とせずに 30 秒以内に有効になります。

Bybit Web インターフェイスを介した段階的なホワイトリストのセットアップ

1. 公式ドメインwww.bybit.comを使用して Bybit アカウントにログインし、Bybit Limited に発行された SSL 証明書を確認し、2 要素認証がアクティブであることを確認します。

2. [アカウント設定] → [セキュリティ] → [API 管理]に移動し、ターゲットの API キー エントリを見つけます。

3. キーの横にある鉛筆アイコンをクリックして編集モードを開き、「IP ホワイトリスト」セクションを展開します。

4. 1 つ以上の IPv4 アドレスまたは CIDR ブロックを改行で区切って入力します。カンマやセミコロンは使用できません。

5. メール認証と Google 認証コードの両方を使用して変更を確認します。いずれかの手順で失敗すると、アップデート全体が元に戻ります。

ホワイトリストの検証とトラブルシューティング

1. 保存後、正しいヘッダーと署名を使用して、curl または Postman を使用して/v5/account/infoへのテスト呼び出しを開始します。

2. 応答にretCode: 10004が含まれている場合は、資格情報が有効であっても、発信元 IP が承認リストに載っていないことを示します。

3. ip138.comまたはcurl ifconfig.meを使用して、取引ボットまたはスクリプトをホストしているマシンのパブリックIPアドレスを確認します。

4. クラウド インフラストラクチャにデプロイする場合は、パブリック向け IP のみが評価されるため、プライベート VPC アドレスではなく、Elastic IP または NAT ゲートウェイ アドレスを取得します。

5. Bybit の API を通じてホワイトリストを自動的に更新する信頼性の高い DDNS サービスと組み合わせない限り、動的レジデンシャル IP の使用は避けてください。

誤って設定されたホワイトリストによるセキュリティへの影響

1. ホワイトリストを空のままにすると、キーの有効性に関係なくすべてのアクセスが無効になり、正規のトラフィックが事実上ロックアウトされます。

2. 0.0.0.0/0または同様の広範なマスクを入力すると、Bybit のセキュリティ ポリシーに違反し、自動システムによってキーが即座に無効化されます。

3. ホワイトリストを更新せずに複数のサーバーで同じ API キーを再利用すると、1 つのホストが侵害された場合に認証情報が水平移動の危険にさらされます。

4. インフラストラクチャの移行後に IP をローテーションしないと、資格情報がそのままで権限が変更されていない場合でも、永続的な 403 エラーが発生します。

5. ホワイトリストに登録された IP を暗号化せずにバージョン管理された構成ファイルに保存すると、コード監査またはリポジトリ漏洩時に偶発的に公開されるリスクが高まります。

よくある質問

Q1: Bybit の IP ホワイトリストで localhost または 127.0.0.1 を使用できますか? Bybit はループバック アドレスを完全に拒否します。ローカル開発では、パブリックにルーティング可能な IP を介してルーティングするか、ホワイトリストが無効になっている Bybit のテストネット環境を使用する必要があります。

Q2: Bybit ではワイルドカード ドメインまたはホスト名ベースのホワイトリストが許可されていますか?いいえ。数値の IPv4 アドレスと CIDR ブロックのみが受け入れられます。検証中に DNS 解決は実行されません。

Q3: ホワイトリストが静的なままでサーバーのパブリック IP が変更された場合はどうなりますか?ホワイトリストが現在のアドレスで手動で更新されるまで、新しい IP からのすべての API リクエストはエラー コード 10004 で失敗します。

Q4: Bybit の REST API を使用して IP ホワイトリストをプログラムで更新する方法はありますか? Bybit は、API キー設定を変更するためのエンドポイントを公開していません。ホワイトリストの編集には、Web インターフェイスまたはモバイル アプリを介した対話型認証が必要です。