バイナンスでのAPIリクエスト送信時に利用するEd25519キーペアの生成方法

2023-07-11 10:48に発行済

バイナンスでは、Ed25519キーを使用した署名済みAPIリクエストの作成に対応しています。Ed25519キーペアを生成し、バイナンスで公開鍵を登録するだけでご利用いただけます。

Ed25519 APIキーとは?

Ed25519 APIキーは、非対称暗号を用いてバイナンスAPIへのリクエストを認証します。RSAの APIキーと同様、Ed25519も非対称暗号方式です。キーペアの生成し、公開鍵をバイナンスとの共有いただき、秘密鍵の使用により、リクエストに署名できます。

他のAPIキータイプの代わりにEd25519方式が勧められる理由とは?

Ed25519のデジタル署名方式は、3072ビットRSAキーに匹敵する高いセキュリティを提供します。一方で、署名サイズが極めて小さく、計算速度が高いことが特徴となっています。

APIキータイプ

署名サイズ

署名処理時間

HMAC-SHA-256

64バイト

0.00ミリ秒

Ed25519

88バイト

0.03ミリ秒

RSA(2048ビット)

344バイト

0.55ミリ秒

RSA(4096ビット)

684バイト

3.42ミリ秒

HMAC-SHA256方式は署名サイズの小さく、動作も高速でございますが、、バイナンスAPIにおきましては、一般的にEd25519キーの方がより優れたパフォーマンスを発揮いたします。そのため、Ed25519キーへの切り替えを推奨いたします。

Ed25519キーペアを生成するには?

1. 非対称キージェネレーターの公式ウェブサイトにアクセスし、最新版のジェネレーターをダウンロードおよびインストールします。

注意事項:「.CHECKSUM」ファイルは、ジェネレーターパッケージの完全性を検証するために使用します。両方のファイルを同一のディレクトリにダウンロードします。詳細は、こちらからご覧ください。

image

2. アプリケーションを起動し、以下の操作を実行します。

  • キータイプの指定:生成するキーの種類を指定します。Ed25519、RSA 2048ビット、RSA 4096ビットからお選びいただけます。なお、デフォルトではEd25519が選択されております。
image
  • キーペアの生成:新しいEd25519の秘密鍵および公開鍵のペアを作成いたします。また、既存のEd25519秘密鍵をテキストボックスに貼り付けると、アプリケーションにより関連性のあるEd25519公開鍵が自動的に生成されます。
  • キーペアをコピー / 保存:Ed25519キーをコピーするか、キーをPrivate_key.txtファイルまたはPublic_key.txtファイルに保存します。ファイル拡張子はデフォルトで「.txt」となっておりますが、他の形式へのカスタマイズも可能です。なお、秘密鍵は第三者に開示しないでください。

バイナンスでEd25519キーを登録するには?

1. バイナンスアカウントにログインし、[プロフィール] - [アカウント] - [API管理] にアクセスします。[APIを作成]をクリックします。

image

2.[自己生成]を指定し、[次へ]をクリックします。

image

3. 非対称キージェネレーターで生成したEd25519公開鍵をコピーし、ボックス内にペーストして登録します。

image

4. APIキーの名前を入力します。[次へ]をクリックして2要素認証を完了します。

image

署名済みAPIリクエストの送信方法は?

署名済みAPIリクエストを送信するには、APIドキュメントの手順の通り操作してください。詳細は、SIGNED Endpoint securityの下にある[SIGNED Endpoint Example for POST /api/v3/order - Ed25519 Keys]にアクセスしてご覧ください。