Binance API Key IP ホワイトリスト実践:現物・先物の権限分離、CIDR マスクとクラウド関数の出口 IP
biabalab 研究所が実機検証した Binance API Key のセキュリティ設定:現物・先物・出金権限の分離、IP ホワイトリストの CIDR 記法、クラウド関数の出口 IP 取得、90 日ローテーションとアラートスクリプト。権限マトリクスとマスクサンプル表付き。
一行結論:Binance API Key のセキュリティは「シークレット × 権限 × IP ホワイトリスト」という三要素の掛け算に等しく、どれか一つが緩めば現物・先物、さらには出金までインターネットに晒されることになります。biabalab 研究所は 2026 年 6 月に 12 組の API Key に対して異なる権限組み合わせで攻撃面を計測しました。本記事はそのまま真似できる設定テンプレートとして、権限マトリクス、CIDR 記法、クラウド関数の出口 IP 取得スクリプト、漏洩時の応急止血フローを提供します。作業前に必ず Binance公式サイト にログインして現状の API 一覧を確認し、必要に応じて Binance公式アプリ の通知を有効化しておいてください。
一、なぜ API Key の漏洩はアカウントパスワードより破壊力があるのか
アカウントパスワードには 2FA、ログイン リスクコントロール、遠隔地アラートが備わっています。ところが API Key には 2FA がなく、あるのは「HMAC-SHA256 署名 + リクエストタイムスタンプ」だけです。漏洩した後の被害は次のとおりです。
- 攻撃者はミリ秒単位で発注できるため、あなたがアラートを目にした頃には既に価格を吊り上げて出口を抜けています。
- Key に「出金」権限が付いていて IP ホワイトリストが未設定であれば、攻撃者は自分のアドレスへ直接引き出せます。
- 一部の取引所(Binance も含む)は API によるアカウント間の内部振替を許可しており、攻撃面はさらに拡大します。
biabalab チームの立場は明快です。デフォルトで出金権限を付けない、デフォルトで IP ホワイトリストを有効化する、デフォルトで 90 日ごとにローテーションする。この三条件が満たせないなら API Key を使うのをやめ、ウェブ画面から手動取引をしてください。
二、権限分離マトリクス(そのまま真似可)
用途ごとに API Key は分けて作成すべきで、一本の鍵で全ての扉を開けるようなことをしてはいけません。以下のマトリクスは私たちが研究所で日常的に使っている構成です。
| 用途 | 現物取引 | 先物取引 | 振替 | 出金 | 読取 | IP ホワイトリスト | 有効期間 |
|---|---|---|---|---|---|---|---|
| 読み取り監視(Dashboard) | 不可 | 不可 | 不可 | 不可 | 可 | 必須 | 90 日 |
| グリッド現物ボット | 可 | 不可 | 不可 | 不可 | 可 | 必須 | 90 日 |
| 先物ヘッジ戦略 | 不可 | 可 | 可 | 不可 | 可 | 必須 | 30 日 |
| 資金集約 | 不可 | 不可 | 可 | 可 | 可 | 必須 + 出金アドレス制限 | 30 日 |
| 単発データ再取込 | 不可 | 不可 | 不可 | 不可 | 可 | 必須 | 使用後即削除 |
肝心なルール:どの Key も必ず IP ホワイトリストを有効化する(Binance は最大 20 個の IP または 20 個の CIDR を許可)。どの Key も「なんでもかんでも権限を有効化」してはいけません。実際に出金権限が必要なのは「資金集約」の 1 用途のみであり、それも必ずホワイトリスト アドレスの二重保護を付けます。
Binance公式サイト の API 管理ページで作成する際は権限を一つずつチェックできますので、「面倒だから」と全部チェックしないよう厳格にお願いします。
三、IP ホワイトリストの三つの書き方
Binance の API ホワイトリストは、単一 IP、カンマ区切りの複数 IP、CIDR の 3 種類の記法をサポートします。デプロイシナリオごとの適合表を掲げます。
| デプロイシナリオ | 推奨記法 | 例 | カバー数 | 備考 |
|---|---|---|---|---|
| 家庭用固定グローバル IP | 単一 IP | 203.0.113.42 | 1 | 最厳格、可用性最低 |
| 家庭用デュアル ISP | 複数 IP | 203.0.113.42,198.51.100.7 | 2 | 主副両系統 |
| 小規模データセンター /29 | CIDR /29 | 203.0.113.40/29 | 8 | 同一セグメント |
| クラウド サーバー弾性プール | CIDR /28 | 198.51.100.16/28 | 16 | オートスケーリング グループ |
| クラウド関数 NAT ゲートウェイ | 出口 IP リスト | 4〜8 個の NAT IP | 20 以下 | NAT ごとに個別登録 |
| 家庭ブロードバンド DHCP 動的 | 非推奨 | — | — | VPS + トンネル経由が安定 |
CIDR の即席換算:/32 = 1 IP、/31 = 2、/30 = 4、/29 = 8、/28 = 16、/27 = 32。Binance の単一エントリ上限は /24(256 個)で、これを超えるとエラーになりますが、実務でそこまで広いレンジは必要ありません。
3.1 家庭ブロードバンドの場合
家庭のグローバル IP は通常 ISP の DHCP 割り当てで、数日で切り替わります。biabalab チームは家庭回線から Binance API を直接叩くことを推奨せず、月額 5〜10 USD の低スペック VPS を借りて、自宅から VPS に SSH し、VPS 経由で API リクエストを送るよう勧めます。ホワイトリストには VPS の固定 IP を登録するだけで済みます。
3.2 クラウド関数の場合
クラウド関数(Tencent SCF / Alibaba FC / AWS Lambda)はデフォルトでランダムな出口 IP を使うため、直接ホワイトリスト化できません。正しい構成は以下です。
- クラウド関数の VPC に NAT ゲートウェイを一つ配置する。
- NAT ゲートウェイに 1〜4 個の Elastic IP(EIP)を割り当てる。
- これら 1〜4 個の EIP を全て Binance の API ホワイトリストに登録する。
- クラウド関数の全アウトバウンド トラフィックが NAT を経由するため、IP が固定される。
この構成の副次的なメリットは、将来クラウド関数のインスタンスが 100 まで増えてもホワイトリストに影響が出ないことです。出口 IP は NAT の数個に固定されているからです。
四、API Key 作成の完全六ステップ
- Binance にログイン → プロフィール → API 管理を開く。
- 「Create API」をクリックし、「System generated」を選ぶ(自作の弱いシークレットを避けるため)。
- 命名は「用途 + 日付」(例:spot-grid-20260707)とし、将来の一括整理に備える。
- 2FA と メール認証コードを入力。
- Key 発行後、即座に「Restrict access to trusted IPs only」を有効化しホワイトリストを設定、権限のみチェックする。
- API Key と Secret Key をパスワード マネージャー(1Password / Bitwarden / Vault)にコピーしてページを閉じる。Secret Key は一度しか表示されず、閉じた後は再確認不能なので、失念した場合は削除して再作成するしかありません。
Q:Secret Key を保存し忘れた場合は? A:削除して再作成するしかありません。開いたまま放置しないでください。Binance はセッション終了後に必ず隠します。
Q:同じ API Key を複数マシンで使ってよいか? A:技術的には可能です(全マシン IP をホワイトリストに登録すれば)が、非推奨です。1 台に問題が発生したとき、どのマシンが発注したかを特定できません。マシン 1 台につき Key 1 本を推奨します。
五、90 日ローテーションの自動化
biabalab チームのローテーション フロー:
- 毎月 1 日、API 管理ページをスキャンし、60 日を超える Key に「要ローテーション」ラベルを付ける。
- 5 日前に同じ権限の新規 Key を発行する。
- 戦略の設定でグラデーション切替:新 Key は 10% → 50% → 100% とトラフィックを引き受ける。
- 24 時間監視して異常がなければ、API 管理ページに戻り旧 Key を削除する。
- ローテーション実施を内部ログに残す。
ローテーションを怠るリスク:Key 漏洩に気付かない可能性があり、長期漏洩 = 長期監視の的になります。ローテーションは漏洩ウィンドウを強制的に更新することに等しいです。
六、アラート スクリプトの例
biabalab はミニマルな日次巡回スクリプトを推奨します(Python 擬似コード、構造説明用)。
- 毎日 09:00 に
/sapi/v1/account/apiTradingStatusを取得し、リスクスコアをチェック。 - 毎日 09:00 に
/api/v3/accountを取得し、現物残高を diff、5% を超える変動があれば通知。 - 毎日 09:00 にホワイトリスト IP 一覧を取得し、設定ファイルと突き合わせ、差分があれば即アラート。
- 毎日 09:00 に Key 作成日時をチェックし、残り寿命が 10 日未満なら通知。
アラート チャネルはメール + 企業向けメッセンジャーの二経路で構成し、単一経路の乗っ取りリスクを避けます。
七、漏洩時の止血四ステップ
- 即座に Binance公式サイト で該当 API Key を削除する(パスワード変更より優先度高い)。
- アカウントの「API 取引」マスタースイッチをオフにし、全 Key を一括無効化。
- 直近 24 時間の発注、出金、内部振替の記録を確認。
- 損失が既に発生していればカスタマーサポートに異議申立。同時に、その Key の漏洩源(GitHub コミット、メモアプリ、画面録画)を徹底的にクリーンアップする。
リスク注意:漏洩後は迷わないこと。Key の削除は無害な操作で、間違えて消しても再作成に数分しかかかりません。10 分の遅延がフル ポジション損失に直結し得ます。
八、よくある質問
Q:ホワイトリストにドメイン名を書けるか?
A:不可。Binance は IPv4 アドレスまたは IPv4 CIDR のみ受け付けます。IPv6 は現在未対応です。マシンが IPv6 出口しか持たない場合、NAT64 か VPS を経由して IPv4 に変換してください。
Q:VPS の IP が変わったら?
A:Binance にログイン → API 管理 → Key を編集 → ホワイトリスト IP を修正 → 保存。ホワイトリスト変更にはクールダウン時間は不要で、即時反映されます。出金ホワイトリストとは異なり、取引用 Key の柔軟性を保つための設計です。
Q:「読取」と「出金」を有効化して「取引」は無効化できるか?
A:可能です。Binance の権限は独立してチェック可能です。資金集約用 Key はまさにこの構成で、残高読取と出金のみ、取引はしません。
Q:API リクエストがレート リミットを超えたら Key はブロックされるか?
A:Key ではなく IP がブロックされます(418 が返る)。IP がブロックされる間は他の Key も使えません。戦略ごとに rate limit の 20% を余裕として残すことを推奨します。
九、ダウンロードと参考
新規ユーザーで口座を持っていない方は、まず登録してから設定に戻ってください。Binance公式アプリ のインストールから始めるか、私たちの ダウンロードページ でインストーラーを入手してください。アプリ側でも API Key の作成・管理が可能で、経路は「マイ → セキュリティ → API 管理」です。
関連記事:Binance 出金ホワイトリスト実践 はアカウント レイヤーのホワイトリスト機構を補足し、API IP ホワイトリストとは異なるレイヤーの二重ロックです。Binance 2FA 機種変更・アプリ移行の完全ガイド は API Key 作成前に整備すべき 2FA 基礎をカバーします。
十、設定セルフチェックリスト
| チェック項目 | 達成/未達 |
|---|---|
| 用途ごとに独立した Key | 達成 / 未達 |
| すべての Key で IP ホワイトリスト有効 | 達成 / 未達 |
| 出金権限は資金集約 Key のみ | 達成 / 未達 |
| クラウド関数は NAT で出口固定 | 達成 / 未達 |
| Secret Key はパスワード マネージャー保管、平文なし | 達成 / 未達 |
| Key 命名に用途 + 日付 | 達成 / 未達 |
| 90 日ごとにローテーション | 達成 / 未達 |
| 残高とホワイトリストの日次巡回スクリプト | 達成 / 未達 |
| 漏洩応急マニュアルをアーカイブ済み | 達成 / 未達 |
全てが「達成」であれば、あなたの API Key はコンプライアンス構成に達しています。
十一、リスク注意
API Key の権限拡大は、そのまま攻撃面の拡大に直結します。「とりあえず全部有効にして、問題が出たら閉じる」という発想は、実運用の中で必ず市場に叩きのめされます。biabalab チームが振り返った 5 件の API Key 事故のうち、4 件は出金権限を切っていなかったことが原因、1 件はホワイトリストに 0.0.0.0/0 を書いてしまったことが原因でした。6 件目にならないでください。API Key を自動生成する第三者スクリプト、Chrome 拡張、Telegram ボットの類はすべて潜在的な中間者攻撃の入り口であり、必ず Binance公式サイト で自分の手で作成してください。Binance公式アプリ の通知を活用し、API アクセスの異常を即時に把握できる体制を整えることも忘れずに。
本記事は 2026-07-01 に公開、次回再検証予定は 2026-10-01。