Binance API key の権限最小化と IP ホワイトリスト実践

API key の最大リスクは盗難ではなく「業務に必要な以上の権限を持たせていること」。BiabaEdge が読み取り/取引/出金の3階層権限分離、IP ホワイトリストバインド、90 日ローテーション、漏洩調査アクション、Postman セルフテストを解説し、各 key を最小可用面に制限する方法を提示。

公開日 2026-07-10 · 約 18 分 · セキュリティ設定

先に結論から。API key の最大リスクは「盗難」ではなく「業務に実際に必要な量を超える権限を持たせていること」です——多くのユーザーは key 申請時に手間を惜しんで「出金を有効化」にチェックを入れますが、実際の戦略では出金アクションを一切使用せず、最高リスクの窓口を半年間開けっ放しにしています。正しい方法は key を3階層に分けること:読み取り key は市況モニタリング、取引 key は戦略発注、出金 key は週次決済に用い、各階層に必要最小限の権限のみを付与します。さらに IP ホワイトリストを重ねて key を戦略機の固定出口 IP に固定バインドし、90 日ごとに強制ローテーション、Binance 側でいつでもワンクリック無効化できるようにします。BiabaEdge は今回の実測で使用した戦略機1台と3本の key の実際構成を基に、各階層の具体的なチェック項目、Postman セルフテスト方法、漏洩後の10分緊急フローを整理しました。key を直接作成したい方は Binance公式サイト から API 管理ページに入ってください。メインアカウントでは Binance公式アプリ で新規 key のリアルタイムアラートを有効化することを推奨します。

権限最小化の3階層 key 分離

1本の key に3種類の権限を持たせるのは最悪のやり方です。機能を3本の独立 key に分割すれば、いずれか1本が漏洩しても全損失にはなりません。これは BiabaEdge がクオンツユーザーとの交流を経てまとめた汎用モデルです。

3階層 key の権限と用途

key タイプ チェック権限 用途シナリオ 常駐位置
読み取り key Enable Reading 市況モニタリング、アカウント照会 モニタリングダッシュボードサーバー
取引 key Enable Reading + Enable Spot/Futures Trading 戦略発注 戦略実行機
出金 key Enable Reading + Enable Withdrawals 定期決済 オフライン署名環境

読み取り key を独立させる理由

端的に言えば、読み取りは一見「損失を生まない」ように見えますが、あなたの全資産、ポジション、約定履歴を読めます——これは精密フィッシングの燃料です。攻撃者は読み取り key を入手すればあなたのポジションから次の狙いを定め、戦略の特徴を推定し、さらには「ソーシャルエンジニアリングメール」の信頼できる書き出しとして利用できます(「3日の BTC/USDT 12,340 USDT 売却により異常を検知しました...」)。

取引 key の最小チェック原則

現物取引だけなら Spot Trading だけにチェック、Futures Trading を軽々しくチェックしないこと。USDT 本位のみなら USDT 本位だけにチェックし、コイン本位はチェックしないこと。オプションを扱わないなら絶対にオプションをチェックしないこと。「将来使うかも」という理由は API 権限の氾濫の最大原因——本当に将来必要になったらその時に変更すればよく、Binance の API 権限調整は key の再作成を必要とせず、管理ページでチェックボックスを変更するだけです。

出金 key の隔離原則

A:出金 key は全 key の中で唯一「実際の資金損失を引き起こせる」階層で、必ず物理隔離が必要です。BiabaEdge は出金 key をオフライン署名機(例:ネット非接続の古い Mac Mini)に保管し、出金発起時に署名結果を USB でオンライン機に運ぶ運用を推奨します。出金 key を戦略機、CI 環境、Docker イメージに保存することは絶対に避けてください——これらは全て攻撃面です。

IP ホワイトリストの正しいバインド方法

IP ホワイトリストは Binance API 層の第2防衛線です——key が漏洩しても、攻撃者は他 IP からのインタフェース呼び出しができません。ほぼ全てのクオンツユーザーが有効化する機能ですが、隠れた落とし穴がいくつかあります。

出口 IP の正確な取得

戦略機の公網出口 IP は、通信キャリアが提供する IP ではありません。クラウドサーバの出口は Elastic IP(EIP)、自宅サーバの出口は NAT を経由したルーターの WAN IP。正確な出口 IP の取得:

  1. 戦略機で curl -s https://api.ipify.org を実行して IPv4 出口を取得
  2. curl -s https://api64.ipify.org で IPv6 出口を取得(有効化している場合)
  3. ホワイトリストに両方の IP を入力
  4. traceroute の中間ホップは使用しない。whois の CIDR ブロックも使用しない
  5. 戦略機が複数 NIC を持つ場合、各 NIC の出口 IP を全て追加

Elastic IP 変動への対応

A:クラウドプロバイダの従量課金 EIP は停止後に変化します——戦略機の起動停止が頻繁だと、IP ホワイトリストは毎回失効します。解決策は固定 EIP を月額数千円で購入するか、BYOIP にアップグレードして自分の IP ブロックを持ち込むこと。動的 DNS は使えません。Binance API ホワイトリストは IP のみを認識し、ドメインは認識しません。

家庭回線出口の IP 更新

家庭回線の出口 IP はルータ再起動や ISP 側の再ダイヤルで変動します。この環境は直接本番戦略を稼働させるのに向かないため、まずクラウドサーバをジャンプホストとして借り、戦略機からは SSH トンネル経由でアクセスすることを推奨します。ジャンプホストの IP は固定で、自宅の IP 変動は API ホワイトリストに影響しません。

IP ホワイトリストのバインドアクション

ステップ 具体的操作
1 API key を作成または編集し、「IP アクセス制限」にチェック
2 戦略機の出口 IP を入力、複数 IP は改行区切り
3 保存後、直ちに戦略機で1回インタフェース呼び出しテスト
4 他 IP から同じ key をテスト、-2015 権限拒否が返るはず
5 IP ホワイトリストバインド日を記録し、次四半期の再点検リストに追加

鍵ローテーションの周期とフロー

鍵は「一度作れば永久使用」ではありません。BiabaEdge は 90 日ごとに強制ローテーションし、四半期の再点検リズムと連動することを推奨します。ローテーションの意義は「漏洩したから交換する」ではなく、「漏洩しているかどうか分からなくても事前に無効化する」ことにあります。

90 日ローテーションの具体的フロー

  1. 戦略コードを開き、現在の key 参照を独立設定ファイルに切り出す
  2. Binance API 管理ページで新 key を作成(新 IP ホワイトリスト、新権限チェック)
  3. Postman または curl で新 key の各インタフェースが通ることをテスト
  4. 設定ファイルの key を新 key に置換
  5. 戦略機でサービスをリロードし、30 分間エラーがないことを観察
  6. Binance API 管理ページに戻り、旧 key のステータスを「削除」に変更
  7. 旧 key は即座に無効化され、外部に漏れたコピーもこの瞬間から無効

ローテーション期間中のリスクウィンドウ

端的に言えば、旧 key 未削除・新 key 有効化の過渡期はできる限り短く、理想は 30 分以内。ウィンドウ内は両 key とも有効で、攻撃面が倍増します。BiabaEdge はローテーション作業を週末の深夜低ピーク時間帯に配置し、戦略停止と連動することを推奨します。

90 日周期の具体的カレンダー

A:90 日を四半期4ポイントに割り当て、例えば 3 月 15 日、6 月 15 日、9 月 15 日、12 月 15 日にセット、カレンダーに繰り返しリマインドを設定し、3日前に予約時間を確保すること。習慣化すればローテーション自体は 20 分程度で終わり、「何か変だ」と感じてから緊急ローテーションする場合よりずっと楽です。

漏洩後の 10 分緊急フロー

key が漏洩したと確認できた場合(異常注文の検出、未認可 IP からの呼び出し、GitHub への誤 push など)、必ず 10 分以内に緊急5ステップを完走してください。1分遅れれば損失が桁違いに膨らむ可能性があります。

緊急5ステップ

  1. 直ちに Binance API 管理ページで漏洩 key のステータスを削除に変更——これが最優先アクションで、他のどのアクションよりも急ぐこと
  2. 直ちに戦略機で稼働中の全戦略を停止し、残留副作用を防止
  3. 直ちに Binance アカウントのログインパスワードと資金パスワードを変更し、2FA seed を再生成
  4. ホワイトリストアドレス一覧を確認、見覚えのないアドレスを直ちに削除
  5. 直近 24 時間のアカウント異動を確認し、明細をエクスポート保管

漏洩ソースの追跡

A:漏洩の最頻出3ソースは、git リポジトリ、共有コードスニペット、侵害された戦略機です。git リポジトリの調査方法は git log -p | grep -i api で履歴 commit を逆引き。コードスニペットは直近誰に送ったかを思い出す。戦略機侵害の場合は auth.log、bash_history、known_hosts などを確認。ソースを特定後、key の無効化に加えてソースの穴埋めもしないと、新 key が同じ轍を踏みます。

GitHub 誤コミット時の対処

状況 対処アクション
公開リポジトリに push 済み 即座に key 無効化、その後リポジトリレベルで清掃を検討
非公開リポジトリに push 済み それでも即座に無効化、非公開=安全ではない
未 push、ローカルで commit 済み git reset HEAD~ で commit を取り消し
CI 環境変数漏洩 key 無効化、環境変数を再設定、CI ログの保持を確認

「git 履歴から削除」は「key の無効化」を代替できません——GitHub のミラーや fork が既にその commit を複製している可能性があり、元リポジトリを消しても複製済みコピーは止められません。BiabaEdge は key 無効化が唯一の有効な損失停止手段であることを強調します。

Postman セルフテストフロー

新 key を作成したら必ずインタフェースセルフテストを行い、権限チェックと IP ホワイトリストの実際の効果を検証してください。Postman は最も直感的なセルフテストツールで、1つの collection で主要エンドポイントを全てカバーできます。

セルフテスト collection の必テストエンドポイント

  1. GET /api/v3/account でアカウント照会テスト(読み取り権限)
  2. GET /api/v3/openOrders で指値注文照会テスト(読み取り権限)
  3. POST /api/v3/order/test で発注署名テスト(取引権限、テストエンドポイントで実発注はしない)
  4. POST /sapi/v1/capital/withdraw/apply で出金インタフェーステスト(出金権限、少額でテスト)
  5. GET /sapi/v1/asset/assetDetail で資産明細テスト
  6. GET /sapi/v1/sub-account/list でサブアカウント一覧テスト

権限チェックのセルフテスト重点アクション

A:読み取り key で発注インタフェースを叩くと -2015 権限不足が返るはず——もし成功したなら権限チェックが間違っています。取引 key で出金インタフェースを叩くと -2015 が返るはず。ホワイトリスト外 IP からいずれかのインタフェースを叩くと -2015 が返るはず。3つのネガティブ検証を全てクリアして初めて本番投入可能。このステップこそが「最小化のつもり」を「実測で最小化を検証」に変える鍵です。

署名フィールドのよくある落とし穴

Postman で Binance API を呼ぶには header に X-MBX-APIKEY を追加し、パラメータ末尾に signature を追加、署名アルゴリズムは HMAC-SHA256。timestamp フィールドとローカル時刻の差は recvWindow(デフォルト 5000ms)を超えられません。戦略機の時刻が NTP 同期されていないと、-1021 timestamp 無効エラーが継続的に返ります。BiabaEdge は戦略機に chronyd または ntpd を導入してミリ秒精度で同期することを推奨します。

よくある質問

問:3本の key は面倒すぎる、1本だけでは駄目か

A:可能ですが、1本の key に全権限を持たせると、1度の漏洩が全損失につながります。BiabaEdge が観測した実ユーザーの実測では、1本 key のユーザーの漏洩後平均損失は3本 key のユーザーの8倍超でした。事前に 15 分かけて権限を分離すれば、その後半年は安心できます。

問:IP ホワイトリストに 0.0.0.0/0 または空を入れるとどうなるか

A:0.0.0.0/0 または空は「IP 制限なし」と同義——Binance の管理画面はこの入力を許可しますが、強く推奨しません。IP ホワイトリストを外すことは、攻撃面を「戦略機の侵害」から「key の漏洩で全ネット利用可能」に拡大することです。BiabaEdge は時間をかけて固定出口 IP を1つ用意することを推奨し、手間を惜しんで全ネット開放するのは NG です。

問:key ローテーション時にアプリを停止する必要があるか

A:ローテーションは両 key 共存の過渡ウィンドウを保持すべき——戦略機に新 key の設定項を追加し、少量のトラフィックをカナリアで切り替え、15 分観察して異常なければ全量切替し、最後に旧 key を削除。これでアプリは停止不要です。アーキテクチャがホット切替をサポートしない場合は、週末深夜の低トラフィック時間帯に窓を作れば損失最小化できます。

問:Binance API はサブアカウント key に対応しているか

A:対応しています。メインアカウントは複数のサブアカウントを作成可能で、各サブアカウントは独立した API key セットを持ちます——これは天然の隔離構造です。BiabaEdge は大口資金ユーザーには資産を複数サブアカウントに分割し、各サブアカウントで1つの戦略のみを走らせ、問題発生時の影響範囲をサブアカウントレベルに限定することを推奨します。

問:漏洩後 key を無効化した後、既に発注済みの指値注文はキャンセルすべきか

A:直ちに全キャンセルすべきです。攻撃者が key 入手時の攻撃は既に発生済みでも、あなたの指値が約定した後、攻撃者が他の脆弱性経由で約定結果に影響を与える可能性が残ります。BiabaEdge は緊急対応の第6ステップ(5ステップ以外の追加アクション)として、未約定注文を全キャンセルし資産ステータスを「静止」にした上でゆっくり調査することを推奨します。

問:Postman セルフテストで本番環境検証を代替できるか

A:できません。Postman はインタフェース層の検証で、本番環境にはネットワーク、並行、時刻同期、メッセージキューなどの要因があります。BiabaEdge は Postman を通過したら、新 key を本番の 5% トラフィックにカナリア投入して 24 時間稼働させ、ログに異常がなければ全量切替することを推奨します。このカナリアステップは多くのユーザーが省略しがちで、省略すると timestamp ドリフト、レート制限閾値などの本番でのみ露呈する問題を踏みます。

問:API key の権限チェックは後から変更できるか

A:可能です。Binance API 管理ページで編集をタップすれば、権限チェックをいつでも増減でき、key の再作成は不要。ただし権限変更のたびに1度セキュリティ再確認(2FA 要求)が発動し、変更後は Postman セルフテストを再実行して新権限の有効化を確認する必要があります。BiabaEdge は権限調整と 90 日ローテーションを別日に分けることを推奨します。同一操作内で2変数を同時に動かすのは避けるべきです。

最後に

API key 管理は「一見退屈だが、実は最も事故が起きる」構成項目です。権限最小化、IP ホワイトリスト、90 日ローテーション、Postman セルフテスト、10 分緊急対応の5つを積み重ねれば、API 層の損失確率を非常に低く抑えられます。BiabaEdge が今回実測でカバーした「3本 key + 単機戦略」アーキテクチャは唯一のモデルではありませんが、「最小暴露面 + 迅速な損失停止」の中核思想を捉えており、多くのクオンツユーザーの出発点テンプレートとして使えます。

key の作成や調整が必要な方は Binance公式サイト から API 管理に入ってください。アプリ側の新規追加アラートは Binance公式アプリ から。入口に疑問がある方はまず ダウンロードページ とサイト内真偽識別記事 を確認してください。

リスクに関する注意:本記事は API key 管理手法のみを論じるもので、投資アドバイスを構成するものではありません。暗号資産の価格変動は激しいため、ご自身のリスク許容度に応じて判断してください。API 自動取引は戦略、時刻、ネットワークなど複数要因が関わり、いずれかの失敗が資金損失を招く可能性があります。必ずテストネットまたは少額アカウントで検証してから実施してください。BiabaEdge は Binance 社と資本関係、代理関係、提携関係を持たない独立サードパーティサイトです。

本記事の公開日:2026-07-10、次回の再検証予定:2026-10-10