Binance APIキーのIP許可リスト設定:クオンツ取引のためのセキュリティ実践
クオンツ取引チームおよび個人ストラテジー開発者向けAPIキーIP許可リスト実践マニュアル。権限ビット、IP帯域計画、クラウドサーバー実名登録、鍵ローテーション、遠隔地DRまでを網羅した2026年版エンジニアリング完全ガイド。実務コマンドとリスク一覧付き。
クオンツ取引の中核資産は戦略コードではなく、あの64文字のAPI Secretです。ひとたび漏洩すれば、攻撃者は8秒以内にアカウント内のあらゆる取引可能資産を空にできます。IP許可リストは、APIキーを「取った者勝ち」から「登録された機械しか使えない」に変える鍵となるメカニズムです。本記事ではエンジニアリング視点で、権限ビット設計、IP帯域計画、クラウドVM登録、鍵ローテーション、遠隔地DRまでの完全経路を通し、そのままrunbookに書き写せるチェックリストを提示します。始める前に必ず Binance公式サイト にログインし、Binance公式アプリ のインストールも済ませておいてください。
直答:APIキーを最も固く縛る方法
BinanceのAPI管理画面で新規キーを作成する際、本当に必要な権限ビットのみ(読み取り、現物取引、先物取引、出金は絶対にチェックしない)を選択し、続いてIP許可リストに戦略機の固定パブリックIP(例:203.0.113.10、198.51.100.42)を入力します。最大30個のIPまで対応します。保存後キーは24時間で有効化され、その間まだアクティベートされていないキーは口座情報の読み取りしかできません。戦略機が動的IPを使う場合、必ずElastic IPまたはNATゲートウェイを介してください。「すべてのIP」のフォールバック選択は絶対に避けます。/posts/biabatech-2fa-migration.md のアカウント2FAと組み合わせて初めて完全な防衛線となります。
一、権限ビットの最小化設計
BinanceのAPIキーは6種類の権限ビットをサポートしており、業務ニーズに合わせて最少集合のみ付与します。以下は代表的クオンツシナリオの推奨構成です。
| シナリオ | 口座読み取り | 現物取引 | 先物取引 | レバレッジ | 出金 | 万象API |
|---|---|---|---|---|---|---|
| グリッド戦略のみ | ○ | ○ | × | × | × | × |
| CTA先物戦略 | ○ | × | ○ | × | × | × |
| アービトラージBot | ○ | ○ | ○ | ○ | × | × |
| データ収集 | ○ | × | × | × | × | × |
| マスター口座会計照合 | ○ | × | × | × | × | ○ |
リスク警告:いかなる場合も出金権限を有効化することはお勧めしません。仮に戦略上、自動送金が必要でも「サブアカウント - Binance Pay」フローで隔離し、出金能力はマスター口座のWeb側にだけ残すべきです。
権限ビットの3つの隠れた境界
- 「先物取引」権限は決済型先物をカバーせず、USDT建て・コイン建て永久のみカバー
- 「口座読み取り」権限にはKYCレベル情報の読み取りも含まれ、最大レバレッジのリスク計算に使われる
- 「万象API」権限は税務申告と会計照合用で、独立した読み取り専用キーとして切り出すのがお勧め
二、IP許可リストの計画モデル
IP許可リストは単にIPを入力すれば完了ではなく、クラウドVMのネットワークアーキテクチャと整合を取る必要があります。さもないと「戦略機再起動でIPが変わりAPI全部無効化」という事故が発生します。
主流3種の配置形態
- Elastic Public IP:AWS EIP、Alibaba Cloud EIP、Tencent Cloud EIP。コストは高いがIPは恒久
- NATゲートウェイ出口:複数戦略機で出口IP 1つを共有。低コストだが月20元追加
- 専用線接続:機関級ソリューション。取引所DCへ直結し、レイテンシは8ミリ秒未満
個人クオンツでは案1または案2が主流です。案2を使う場合はBinance許可リストにNAT出口IPのみを入力し、各戦略機の内部IPは入力しないでください。
IP帯域の粒度
Binanceは/32単位までの単一IP認可に対応しており、最大30エントリまで登録可能です。CIDR段(例:203.0.113.0/24)のワイルドカードは非対応です。戦略機が同一VPC内で横向きにスケールアウトする場合、NAT出口経由で統一し、許可リストの頻繁な変更を回避してください。
問:0.0.0.0/0や、IP許可リスト未入力でも構いませんか? A:技術的には可能ですが、APIキーをパブリックインターネット全体に晒すのと同義です。Secretを入手した攻撃者は誰でも直接発注できます。過去事故の96%はIP許可リスト未設定のアカウントで発生しました。0.0.0.0/0を入れると「出金」のチェックボックスは自動的に無効化され、Binanceサーバー側でも一部リスク低減が行われますが、実攻撃を防ぐには不十分です。
三、クラウドVMの実名登録とコンプライアンス
米国、日本、シンガポール、香港の4地域は2026年時点で最も主流の戦略機配置エリアです。地域ごとにクオンツ取引口座に対する規制要件が異なるため、IP許可リストの設定前に確認が必要です。
クラウドVMコンプライアンス・チェックリスト
- クラウドアカウントの実名主体はBinanceアカウントのKYC主体と一致させる
- Elastic IPの帰属地域はBinanceの制限対象地域(例:米国本土)を含まない
- クラウドVMのディスクはフルディスク暗号化を有効化し、イメージが持ち出されるのを防ぐ
- SSHポートはデフォルトの22番から高位ポートに変更し、fail2banと併用
よくある誤解
誤解A:海外クラウドサーバーを使えば地域制限を回避できると考える。実際にはBinanceはログインIP、KYC主体、決済通貨など多次元で判断しており、単一次元だけ迂回しても無効。 誤解B:IP許可リストがAPI Secret保護を代替できると考える。実際にはIP許可リストは「誰がドアをノックできるか」に過ぎず、Secretは依然として「誰が室内に入れるか」です。両者は必ず並存させる必要があります。
四、Secretの保管とローテーション
Secretは一度ディスクに書き込まれると漏洩リスクを伴います。エンジニアリング規範は「Secretは起動時に鍵管理サービスから読み取り、プロセス内メモリのみに保持し、ログ、設定ファイル、キャッシュディレクトリには書き込まない」です。
推奨される保管方式
| 保管場所 | 漏洩リスク | 復旧難度 | 適合シーン |
|---|---|---|---|
| 環境変数 | 中 | 低 | 単機の迅速オンライン投入 |
| .envファイル | 高 | 低 | デバッグ期 |
| AWS Secrets Manager | 低 | 中 | 本番 |
| HashiCorp Vault | 極低 | 高 | チーム本番 |
| ハードウェアHSM | 極低 | 極高 | 機関 |
個人ストラテジー開発者にはAWS Secrets ManagerまたはAlibaba Cloud KMSを推奨、チーム型クオンツにはVault + 毎週自動ローテーションを推奨します。
ローテーション手順
- BinanceのAPI管理画面で新キーを作成し、「rotate-YYYYMMDD」と付記
- 新キーは24時間読み取り権限のみで維持し、戦略機から口座情報を正常に読めるか検証
- 戦略機の設定を新キーに切替、30分間異常がないか観察
- BinanceのAPI管理画面で旧キーを無効化(削除はしない)
- 72時間ロールバック不要を確認後、旧キーを削除
五、遠隔地DRとフェイルオーバー
メイン戦略機に障害が発生した際、IP許可リストを緩めずに予備機へ切り替えるにはどうすればよいでしょうか。以下の3モデルはそれぞれトレードオフを持ちます。
モデルA:メイン・予備2 IP併記の許可リスト
Binance許可リストにメインと予備2台の戦略機のパブリックIPを同時に登録し、アプリケーション層でハートビートによる自動切替を実装します。欠点は予備機が長期間遊休となりコスト倍。利点は切替時間3秒未満です。
モデルB:Elastic IPドリフト
メイン・予備で異なるIPを持ちつつ、1つのElastic IPを共有します。障害時はクラウドAPI経由でElastic IPを予備機にバインドし、Binance許可リストにはこのドリフトIPのみ登録します。切替時間は約30秒。クラウドAPIの権限もrunbookに事前組み込む必要があります。
モデルC:クロスリージョン主副
メイン機は東京、予備機はシンガポールなど、日常レイテンシ差は約25ミリ秒。障害耐性の要求が極めて高い機関向け戦略に向いています。Binance許可リストに2つのIPを登録し、アプリケーション層でクロスリージョンの時刻ドリフトを扱う必要があります。
問:切替中のAPIリクエスト失敗でポジション制御を失うことはありませんか? A:主要なクオンツフレームワークは「注文冪等性」を実装しており、各発注はclientOrderIdを持ちます。切替後に予備機はRESTで現在の未約定注文リストを取得し、ローカル状態を再構築してから継続します。冪等性設計のないフレームワークをお使いの場合、切替前に手動で「全指値取消」を実行してから予備機に引き継がせ、二重発注リスクを回避してください。
六、監査とアラート
IP許可リストを設定した後も、長期的な監査とアラートによって継続的な有効性を確保する必要があります。
推奨アラート項目
- APIキーが許可リスト外のIPから呼び出された(Binance側で自動拒否されるが、試行回数は把握しておく)
- Secretの有効期限まで残り15日未満(Binance側の強制失効はないが内部ポリシーで設定可能)
- 許可リストのエントリが変更された(メール通知で捕捉し本人操作か再確認)
- 権限ビットが追加された(同上)
監査頻度
推奨は毎月第1月曜に全数監査を実施:権限ビット、IP、Secretの帰属、クラウドVMのヘルスを照合。年に1回はレッド・ブルー対抗演習を行い、Secret漏洩後のロスカット手順をシミュレーションします。アカウントレベルのセキュリティ点検については /posts/biabatech-withdrawal-whitelist/ の許可リスト連携モデルを参照してください。
よくあるご質問
APIキーは失効しますか
Binanceの現物APIキーはデフォルトで無期限ですが、90日間呼び出しがないと読み取り専用に降格されます。先物APIキーは自動失効なしですが、内部ポリシーで180日ごとに強制ローテーションを推奨します。
1アカウントで作成可能なAPIキー数は
マスターアカウントはデフォルトで30個のアクティブキー。削除済みキーは枠を消費しません。サブアカウントは別枠計算で、マスター+サブの合計上限は200個です。
許可リストIPの変更後どのくらいで有効になりますか
保存直後に即時有効化され、待つ必要はありません。ただし旧IP削除には60秒のキャッシュがあり、先に新IPを追加して検証成功後に旧IPを削除するのが安全です。
IPv6の許可リストには対応していますか
対応しています。IPv6は/128単位で入力し、BinanceのIP許可リストはIPv4とIPv6を同時サポートし、同じ30エントリ上限を共有します。デュアルスタックを使う場合はエントリ枠にご注意ください。
API呼び出しが「IPが許可リストにない」と拒否されるが、確かに登録してある場合
10中8、9は戦略機が別の出口IPを使っています。戦略機上でcurl ifconfig.meまたはcurl api.ipify.orgで実際の出口IPを確認し、許可リストと突き合わせてください。VPN、Dockerネットワーク、K8s NodePortは出口IPを変えることがあります。
出金権限は本当にチェックしてもよいですか
技術的にはチェック可能で、追加のメール確認と24時間クールダウンが求められますが、有効化は強く非推奨です。業務上、API出金を要求する正当なシーンは存在せず、すべての正当ユースケースはBinance Payまたはサブアカウント間内部振替で代替できます。出金権限付きAPIキーが漏洩すれば、攻撃者は8分でアカウントを空にできます。
サードパーティ戦略プラットフォームは安全ですか
主要なクオンツSaaSプラットフォームはAPIキーを預かりますが、ユーザーは読み取り+取引権限のみを提供し、IP許可リストをプラットフォームの公式IPに固定できます。サービス事業者を選ぶ前に、公式IP帯域が公開されているか、双方向HTTPS証明書を使用しているか、SOC2レポートを保有しているかをご確認ください。
文書公開日:2026-07-01、次回再検証予定:2026-10-01。最後に Binance公式サイト のセキュリティセンターと Binance公式アプリ の通知設定を組み合わせて、キーの動きを常時監視する体制を整えてください。