【Node.js24.x】Object::createSecretKey()メソッドの使い方
createSecretKeyメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
createSecretKeyメソッドは、与えられた秘密鍵の表現からKeyObjectを生成するメソッドです。これはNode.jsのcryptoモジュールの一部であり、共通鍵暗号方式で使われる秘密鍵を、暗号操作に適したKeyObject形式に変換します。
鍵データはBuffer、TypedArray、DataView、または文字列として指定可能です。文字列の場合は、そのデータのエンコーディング（例: 'utf8'、'hex'、'base64'）をオプションで指定できます。このメソッドで生成されるKeyObjectは、データの暗号化・復号、またはHMAC（ハッシュベースメッセージ認証コード）生成といった認証処理で、鍵を安全かつ一貫して利用できます。
KeyObjectとして鍵を管理することは、生の鍵データを直接扱う場合に比べて、鍵の誤用や情報漏洩のリスクを低減し、セキュリティ向上に貢献します。秘密鍵は極めて機密性の高い情報であるため、このメソッドを適切に活用し、堅牢な暗号化システムの設計に役立ててください。
構文(syntax)
1import { createSecretKey } from 'node:crypto'; 2 3const keyMaterial = Buffer.from('0123456789abcdef0123456789abcdef', 'hex'); 4const secretKeyObject = createSecretKey(keyMaterial);
引数(parameters)
key
- key: Buffer | TypedArray | DataView | string | KeyObject: 生成する秘密鍵の元となるデータ。Buffer、TypedArray、DataView、文字列、または既存のKeyObjectを指定できます。
戻り値(return)
KeyObject
createSecretKeyメソッドは、指定されたキーマテリアルとアルゴリズムから、秘密鍵を表すKeyObjectを生成して返します。