【Node.js24.x】Object::hkdfSync()メソッドの使い方

hkdfSyncメソッドは、HKDF (HMAC-based Extract-and-Expand Key Derivation Function) と呼ばれる鍵導出関数を同期的に実行するメソッドです。このメソッドは、与えられた秘密情報（例：パスワードや共有鍵）から、暗号化や署名などの用途に適した、予測困難で十分な長さの安全な秘密鍵を生成するために使用されます。

セキュリティの観点から、原始的な秘密情報を直接使用するのではなく、HKDFのような鍵導出関数を通して、目的に合わせた適切な長さの鍵を導出することが強く推奨されます。Syncという名前が示す通り、このメソッドは処理が完了するまでプログラムの実行をブロックします。そのため、非常に時間のかかる鍵導出処理をメインスレッドで行う場合には、アプリケーションの応答性に影響を与える可能性があるため注意が必要です。

具体的な利用例としては、ユーザーのパスワードからファイル暗号化用の鍵を生成したり、共有された秘密情報からセッション鍵を生成したりする場面が挙げられます。導出する鍵のアルゴリズム（ハッシュ関数）、鍵の長さ、およびセキュリティを向上させるためのソルトやコンテキスト情報などを引数として指定し、目的に合った鍵を安全に導出することができます。これは、安全なアプリケーションを構築する上で、重要な暗号鍵を適切に扱うための基礎的な機能の一つです。

Copy
1const crypto = require('node:crypto');
2
3const ikm = Buffer.from('input key material');
4const salt = Buffer.from('salt value');
5const info = Buffer.from('context info');
6const keylen = 32;
7
8const derivedKey = crypto.hkdfSync('sha256', ikm, salt, info, keylen);

hash, key, salt, info, length

• hash: string: 使用するハッシュアルゴリズムの名前 (例: 'sha256', 'sha512')
• key: Buffer | string | DataView | TypedArray: 派生させるための秘密鍵
• salt: Buffer | string | DataView | TypedArray | null: 派生プロセスを強化するためのランダムな値。省略可能。
• info: Buffer | string | DataView | TypedArray | null: 派生鍵の目的を識別するためのコンテキスト情報。省略可能。
• length: number: 派生させる鍵のバイト単位の長さ

Buffer

HKDF (HMAC-based Extract-and-Expand Key Derivation Function) アルゴリズムを使用して、入力されたデータから指定された長さの鍵を同期的に生成します。生成された鍵はBufferオブジェクトとして返されます。