Binance APIキー権限ロックダウン|Biabafoxクイックリファレンス
BiabafoxがBinance APIキーの5種類の権限(読み取り/現物/先物/レバレッジ/出金)を整理し、IPホワイトリスト早見表+高リスクシナリオ回避+鍵漏洩時の6ステップ応急対応フローを提示します。
APIキーはアカウント内で最も漏洩しやすく、最も回収しにくい認証情報です。結論から言うと、Binance APIキーのセキュリティ原則は一言で済みます。「読み取りだけで済むなら取引権限を絶対に付与しない、単一IPで済むなら全ネットワークアクセスを絶対に許可しない、明確に必要かつリスクを理解している場合を除き出金権限には絶対にチェックを入れない」。BiabafoxはBinance APIの5大権限、IPホワイトリスト機構、7つの高リスクシナリオ、6ステップの漏洩応急フローを1本のクイックリファレンスにまとめ、30分で再現可能なAPIセキュリティ運用規範を築けるようにしています。
まだAPIキーを持っていない場合は、まずBinance公式サイトで本人確認と2FAを完了するか、ダウンロードページのBinance公式アプリでセキュリティ設定を一通り済ませてください。本記事はこれらの前提が完了していることを想定しています。
対象シーンと読者像
- 適用シーン:クオンツ取引、データ分析、相場ダッシュボード、取引所間アービトラージ、マーケットメイキング
- 難易度:中〜高(権限モデル、IPセグメント、署名メカニズムを含む)
- 所要時間:単鍵作成+権限設計15分、応急演練30分
- 対象者:クオンツユーザー、開発者、機関API接続、相場ツール制作者
- 機材:固定IPの安定サーバー1台+管理用PC1台
- ネットワーク:API側は固定パブリックIP、管理側はBinance公式サイトへの正常アクセス
- リスクレベル:高(漏洩すると全資産を失う可能性あり)
- コスト:0
- 代替手段:Web/アプリでの手動操作のみ(安全だが自動化不可)
- よくあるミス:権限を一括で全付与、IPホワイトリストなし、secretをコードリポジトリに直書き
- 検証方法:読み取り専用鍵で発注を試みてエラーになる、IP限定鍵を他IPから叩いてエラーになる
5類の権限早見表
BiabafoxはBinance実際のオプションに沿って権限を5類に分類しています。弱い順から強い順に並べます。
| 権限 | 何ができるか | 漏洩時の損失上限 | 有効化推奨シーン | 併用推奨 |
|---|---|---|---|---|
| 読み取り | 相場・残高・K線の閲覧 | プライバシー漏洩 | データ分析、相場ボード | IPなしでも可 |
| 現物取引 | 発注・キャンセル・約定 | 低流動性コインへの悪意ある両替 | 現物クオンツ | 必ずIPホワイトリスト |
| レバレッジ取引 | 借入・返済・レバレッジ発注 | 強制ロスカット誘発 | レバレッジ戦略 | 必ずIPホワイトリスト |
| 先物取引 | USDT建/コイン建先物発注 | リスク管理なしのフル建玉爆損 | 先物クオンツ | 必ずIPホワイトリスト+リスク管理 |
| 出金 | ホワイトリストアドレスへの直接出金 | 全資産流出 | ごく限られた委託シーン | 強制IP+ホワイトリストロック |
A:Biabafoxが繰り返し強調するのは、99%のクオンツユーザーは出金権限を必要とせず、この項目を空欄にすれば資産リスクの90%以上を削れるということです。secretが漏洩しても攻撃者はアカウント内で発注を乱発するのが精一杯で、資金を持ち出せません。これがAPIセキュリティの第一原則です。
権限組み合わせの3段階
用途別に見た3つの典型的な鍵構成。
- 読み取り専用鍵:「読み取り」のみチェック、IPホワイトリストなしでも利用可能。相場ボード、残高表示に適する
- 取引鍵:「読み取り+現物/先物」をチェック、必ず固定IPにバインド。クオンツボット向け
- 出金鍵:ボットがBinanceからコールドウォレットへ自動転送する場合にのみ作成、強制IP+強制出金ホワイトリストロック
IPホワイトリスト早見表
IPホワイトリストはAPIセキュリティの第2の鍵で、権限ロックと同等に重要です。
| IP設定 | 有効なAPI権限 | 有効期限 |
|---|---|---|
| IP未設定 | 「読み取り」のみ利用可 | 90日で自動失効 |
| 単一IP設定 | 全権限 | 長期有効 |
| 複数IP設定(カンマ区切り) | 全権限 | 長期有効 |
| IPセグメント設定 | 非対応 | なし |
| IPv6設定 | 対応 | 長期有効 |
主要な運用シーン対照
| 配置場所 | 推奨IP設定 | 備考 |
|---|---|---|
| Alibaba Cloud/Tencent Cloudの独立パブリックIP | 単一固定IP | 最推奨 |
| AWS EIP | 単一固定IP | 最推奨 |
| Cloudflare Workers | 出口プロキシで固定化 | 中継が必要 |
| 家庭の動的IP | DDNS+毎日更新 | 本番非推奨 |
| モバイル回線 | 完全非推奨 | IPが数分ごとに変わる |
A:Biabafoxの助言:取引権限付きのAPIキーは、固定IPのない環境に絶対に配置しないこと。読み取りだけの一時テストならすぐ使ってすぐ削除する。安いからと家のPPPoE回線で動かすくらいなら、固定IPのあるサーバーに乗せ換えてから本番投入してください。
90日失効メカニズム
Binanceは2023年から、IP制限なしの鍵に対して90日の強制有効期限を課しています。
- 初回作成後90日で自動的に無効化(読み取り権限も無効)
- 期限7日前からメール通知
- 更新時は再度2FA認証が必要
- IPホワイトリストを設定すると期限なし(推奨)
7つの高リスクシナリオ回避
Biabafoxがコミュニティで振り返ったAPI漏洩事例のうち、最も頻発する7類型。
| シナリオ | 危険度 | 修復方法 |
|---|---|---|
| secretをGitリポジトリに直接コミット | 極高 | 即時に鍵削除+環境変数注入へ |
| コード共有のスクリーンショットでAPI鍵が露出 | 高 | 即時に鍵削除+履歴メッセージ確認 |
| Discord/Telegram公開グループでログ貼付 | 高 | ログのマスク処理+即時に鍵削除 |
| 同一鍵を複数戦略で共有 | 中 | 戦略1つに鍵1本、追跡が容易 |
| IPホワイトリストなしで「任意IP可」に | 極高 | 即座にIP追加または鍵削除 |
| 通常のクオンツで出金権限にチェック | 極高 | 即座に出金権限を解除 |
| 取引鍵をパスワードマネージャーの「備考」欄に | 中 | 暗号化ノートに移動+定期ローテーション |
secret保管の3つの鉄則
- 絶対にコードリポジトリに入れない(
.gitignoreだけでは不十分、git-secretsでスキャン) - 本番環境は環境変数または鍵管理サービス(KMS、Vault)を使用
- ローカル開発は
.envファイル、.envは絶対にpushしない
漏洩応急6ステップ
secretの漏洩が疑われたら、Biabafoxは以下の順序で5分以内に処置することを推奨します。
| ステップ | 操作 | 時間予算 |
|---|---|---|
| 1 | Binance公式サイトにログイン → API管理 → 疑わしい鍵を即座に無効化 | 30秒 |
| 2 | アカウントパスワード変更+全セッション強制ログアウト | 1分 |
| 3 | 直近24時間の発注・振替・出金記録を確認 | 2分 |
| 4 | サブアカウントと先物アカウントに異常がないか確認 | 1分 |
| 5 | 異常注文があればBinanceサポートに連絡してアカウント凍結 | 手動 |
| 6 | 漏洩経路を振り返り強化(IPホワイトリスト、権限縮小) | 事後 |
A:Biabafoxが繰り返し強調するのは、処置順序は「まず鍵を無効化してから調査」であり、逆にしないこと。攻撃者はリアルタイムで操作している可能性があり、30秒迷えばそのぶん悪意ある注文が積み重なります。
事後振り返りで必ず確認する4点
- Gitコミット履歴(
git log --all -p | grep -i api) - クラウドドライブ/メール添付で「key」「secret」を検索
- チームコラボツール(Slack、Notion)の履歴
- ローカルのシェル履歴、IDEクリップボードキャッシュ
よくある質問
Q1:読み取り専用鍵でもプライバシー漏洩はありますか?
A:あります。読み取り鍵は残高、注文履歴、振替履歴を取得でき、これらはフィッシャーにとって価値のあるデータです。Biabafoxの推奨:読み取り専用鍵にもIPホワイトリストを付与してください。
Q2:BinanceはHMAC-SHA256以外の署名方式に対応していますか?
A:対応しています。2024年以降、BinanceはEd25519署名を導入しており、鍵長が短く、検証が高速で、耐量子性もあります。Biabafoxの見解:新規鍵はEd25519を優先すべき、特に高頻度クオンツ用途では推奨です。
Q3:サブアカウントで独立にAPIキーを発行できますか?
A:可能です。サブアカウントAPIはメインアカウントから独立し、権限もサブアカウント単位で細分化できます。Biabafoxの強い推奨:戦略資金をサブアカウントに隔離することで、鍵が漏洩してもサブアカウント残高内に損失が限定されます。
Q4:APIキーが不正利用されているかをどう検知しますか?
A:BinanceはAPI呼び出しログを提供しており、直近30日の各鍵の呼び出し元IP、頻度、異常エラーを確認できます。週に1回の点検を推奨します。呼び出し元IPが自分のサーバー以外なら即座に無効化してください。
Q5:API出金権限とアカウントの出金ホワイトリストはどんな関係ですか?
A:積み重ねの関係です。API出金権限はアカウントレベルの出金ホワイトリスト内のアドレスへの出金のみを許可します。したがってAPIに出金権限を付与しても、攻撃者はホワイトリストアドレスにしか出金できず自由に動かせません。これが二重ロックの古典的な組み合わせです。
Q6:家に固定IPがないと、クオンツは全くできませんか?
A:そうではありません。3つの選択肢があります。(1)月額5〜10ドルのVPSを借りて固定IPを利用、(2)Cloudflare Tunnelで全リクエストを固定出口経由に、(3)DDNS+Binance APIでIPホワイトリストを定期更新(BinanceはAPI経由でIPホワイトリスト変更に対応、ただし別の管理用鍵が必要)。Biabafoxは方案1を推奨、最も手間がかかりません。
Q7:1アカウントで何本のAPIキーを作成できますか?
A:一般アカウントで30本、機関アカウントはさらに多く作成可能です。Biabafoxの助言:戦略ごと、チームメンバーごと、用途ごとに1本、監査と廃棄がしやすくなります。使い終わったら即座に削除し、「将来使うかも」で残さないこと。
Q8:漏洩後の悪意ある発注は取り戻せますか?
A:通常、価格損失は取り戻せません。IOC注文で市場価格を下回る成交や大量売り浴びせなどの異常行動であれば、Binanceは30日以内なら申請対応してくれますが、最終的な返還可否は注文が「悪意ある操縦」の定義を満たすかに依存します。Biabafoxが見てきた事例では成功と失敗が半々で、最も確実なのは事前防止です。
リスク注意事項
APIキーが悪用されると、損失は通常数分以内に確定し、手動での口座乗っ取り攻撃より速く、隠密に進行します。Biabafoxの強い推奨:取引権限付きの鍵はすべて固定IPにバインドし、出金権限のチェックを回避、30日ごとに点検し、90日ごとにsecretをローテーションすること。暗号資産投資自体に価格変動リスクがあり、クオンツ戦略もプログラムのバグで損失を生む可能性があります。本記事は「鍵のセキュリティ」に絞った内容で、戦略の損益には触れません。APIキー管理はBinance公式サイトまたはBinance公式アプリの正規入口から行ってください。
内部リンク:入口選択の全体像はダウンロードページ。API管理をアプリで行うかWebで行うか迷う場合は、PCとWeb版の早見比較を先に読んでから決めてください。
本ドキュメントは2026-07-10公開、次回再検証は2026-10-10予定。