GeminiでAPIキーを生成する方法は？

2FAを有効にし、限られた権限を設定し、IPホワイトリストを使用して保護を強化することにより、Geminiで安全なAPIキーを生成します。

2025/08/07 05:52

GeminiでAPIキーを理解する

GeminiのAPIキーは、ユーザーがExchangeの取引およびアカウント管理システムとプログラムで対話できるようにする一意の識別子です。これらのキーは、取引の配置、バランスの確認、市場データの取得などの特定の機能へのアクセスを許可します。各APIキーは、リクエストを認証するためのパスワードとして機能する秘密キーとペアになります。 Geminiは、APIアクセスを使用する際にユーザーアカウントを保護するための厳格なセキュリティ対策を実装します。ユーザーは、APIキーを生成する前に、 2要素認証（2FA）を有効にして、認定された個人のみがこれらの資格情報を作成または管理できるようにする必要があります。読み取り専用アクセスや完全な取引機能など、APIキーを許可に基づいて制限できることを理解することが不可欠です。

API設定ページに移動します

APIキーの生成を開始するには、公式WebサイトからGeminiアカウントにログインします。ログインしたら、通常、プロフィールアイコンの下の右上のドロップダウンメニューにある「設定」オプションを見つけます。 [設定]メニューから、 [API]を選択します。このセクションは、すべてのAPI関連の構成の管理に専念しています。 APIパネルに初めてアクセスするのが初めての場合、API使用に関連する目的とリスクを説明するプロンプトが表示される場合があります。先に進む前に、デバイスが安全でマルウェアがないことを確認してください。 APIダッシュボードには既存のキーが表示され、新しいキーを作成するオプションが提供されます。 [新しいAPIキーを生成]ボタンをクリックして、前進します。

APIキーアクセス許可の構成

新しいAPIキーを作成するとき、Geminiはキーのアクセスレベルを定義する構成パネルを提示します。 1つ以上のアクセス許可を割り当てる必要があります。

• 残高を表示：アカウントの資金と保有物への読み取り専用アクセスを付与します。
• Criptoの送信：キーが暗号通貨の引き出しを開始できるようにします。
• 取引：鍵を交換に配置、変更、およびキャンセルすることができます。
• デポジットの作成：預金アドレスの生成を許可します。
• 資金引き出し：フィアットと暗号の撤退を許可します。

使用するために必要なアクセス許可のみを選択します。たとえば、ジェミニをポートフォリオトラッカーに接続している場合は、バランスのみを選択してください。絶対に必要でない限り、暗号を送信したり、資金を引き出したりすることを避けてください。権限を選択した後、キーのラベルを入力するように求められます。このラベルは、「トレーディングボット」や「ポートフォリオモニター」などのキーの目的を特定するのに役立ちます。記述ラベルは、後でキーを監査して取り消すことができるようにすることにより、セキュリティを改善します。

セキュリティを強化するためにIPホワイトリストを設定します

Geminiを使用すると、ユーザーはAPIキー使用量を特定のIPアドレスに制限できます。これは、 IP Whitelistingと呼ばれる機能です。これにより、リクエストが信頼できる場所に由来する場合にキーが機能することを保証することにより、重要な保護層が追加されます。 APIキー作成フォームで、 「ホワイトリストIPアドレス」フィールドを見つけます。 APIリクエストを送信する予定の静的IPアドレスを入力します。複数のIPをコンマで分離することで追加できます。パブリックIPがわからない場合は、検索エンジンで「私のIPとは何か」を検索して見つけることができます。このフィールドを空白のままにすることで、キーがあらゆるIPから動作することができ、利便性が高まりますが、セキュリティが減少します。自動トレーディングボットまたはサーバーベースのアプリケーションの場合、常に静的IPSを使用し、ホワイトリストを有効にしてください。これにより、API機能が破壊される可能性があるため、ネットワークが動的IP割り当てを使用していないことを確認してください。

APIキーを生成および保護します

アクセス許可とIP制限を構成したら、 [APIキーを生成]ボタンをクリックします。 Geminiはリクエストを処理し、新しく作成されたAPIキーとAPIの秘密を表示します。これは、両方の資格情報が表示される唯一の時間です。パスワードマネージャーや暗号化されたファイルなど、すぐに安全な場所にコピーして保存する必要があります。秘密の鍵は、失われた場合、取得できません。 APIの秘密を共有したり、デバイスのプレーンテキストに保管したりしないでください。キーが正常に作成されたことを確認するには、API管理ダッシュボードを確認してください。新しいキーは、そのラベル、作成日、および割り当てられた権限で表示されます。このインターフェイスからいつでもキーを無効または削除することができます。非アクティブ化は、そのキーで作成されたすべてのAPI呼び出しを即座にブロックします。

APIキー接続をテストします

APIキーが正しく機能するようにするには、 CurlなどのコマンドラインツールまたはPythonなどのプログラミング言語を使用して簡単なテストを実行します。これがカールを使用してアカウントの残高を取得する例です。

• 端末またはコマンドプロンプトを開きます。
• 次のコマンド構造を使用します。

   curl -H 'Content-Type: application/json' \
   -H 'X-GEMINI-APIKEY: YOUR_API_KEY' \
   -H 'X-GEMINI-PAYLOAD: BASE64_ENCODED_PAYLOAD' \
   -H 'X-GEMINI-SIGNATURE: YOUR_SIGNATURE' \
   https://api.gemini.com/v1/balances

  YOUR_API_KEY実際のキーに置き換えます。ペイロードは、リクエストの詳細とnonCEを含むJSONオブジェクトであり、 Base64がエンコードされている必要があります。署名は、HMAC-SHA384を使用してAPIシークレットを使用してペイロードに署名することにより生成されます。多くの開発者はpython-geminiなどのライブラリを使用してこのプロセスを簡素化しています。成功した応答は、バランスのJSONアレイを返します。 403エラーは、多くの場合、キー、秘密、または署名が誤っていないため、認証の障害を示します。

よくある質問

APIの秘密を失った場合、APIの秘密を再生できますか？

いいえ、ジェミニは既存のキーのAPI秘密の再生を許可しません。秘密が失われた場合、侵害されたキーを削除し、同じ権限を持つ新しいキーを生成する必要があります。作成時にAPIの秘密を安全に保管してください。

サードパーティアプリケーションでAPIキーを使用しても安全ですか？

アプリケーションが評判が良く、キーの権限が制限されている場合のみです。未検証のプラットフォームに撤退または取引権を付与することは避けてください。ツールを監視するために読み取り専用キーを使用し、可能な限りIPホワイトリストを有効にします。

GeminiでいくつのAPIキーを作成できますか？

Geminiは、アカウントごとのAPIキーの数に厳密な制限を公開していません。ただし、キーが多すぎると、管理の複雑さとセキュリティリスクが向上します。必要な場合にのみキーを作成し、明確にラベルを付けるのが最善です。

APIキーが侵害されていると思われる場合はどうすればよいですか？

すぐにGeminiアカウントにログインし、 API設定に移動し、疑わしいキーを無効にします。非アクティブ化後、必要に応じて新しいキーを生成します。不正なトランザクションのアカウントアクティビティを確認し、ホワイトリストの引き出しアドレスなどの追加のセキュリティ機能を有効にすることを検討してください。