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

timingSafeEqualメソッドは、2つのBufferまたはUint8Arrayオブジェクトに含まれるバイナリデータを、セキュリティ上の脅威を防ぎながら安全に比較するために使用されるメソッドです。このメソッドの主要な役割は、情報漏洩のリスクとなる可能性のある「タイミング攻撃」からシステムを保護しつつ、与えられた2つのデータが完全に同一であるかを正確に判定することにあります。

一般的なデータ比較処理の多くは、比較対象のデータで不一致な箇所が発見された時点で処理を中断します。このため、データがどの程度一致しているかによって、比較にかかる処理時間にわずかな差が生じることがあります。悪意のある攻撃者は、このごくわずかな処理時間の変動を注意深く観測し、その情報をもとにパスワードや暗号鍵といった機密性の高いデータを推測しようとする手法を用いることがあります。これが「タイミング攻撃」と呼ばれるものです。

timingSafeEqualメソッドは、このような巧妙な攻撃手法からシステムやアプリケーションを保護するために特別に設計されています。このメソッドは、比較対象のデータが一致するか否かにかかわらず、常に固定された一定の時間をかけて比較処理を実行する仕組みを採用しています。これにより、処理時間の差からデータに関する手がかりを得ようとする攻撃者の試みを完全に排除し、アプリケーションのセキュリティレベルを大幅に強化します。

このメソッドは、比較したい2つのBufferまたはUint8Arrayを引数として受け取ります。そして、両方のデータがバイナリレベルで完全に一致した場合にのみブール値のtrueを返し、そうでなければfalseを返します。特に注意すべき点として、比較対象となる2つのデータの長さが異なる場合は、たとえ一部が一致していても、常にfalseが返されるという特性を持っています。

したがって、ユーザーのパスワードハッシュの検証、トークンの比較、暗号化されたデータの認証タグの照合など、機密性の高いバイナリデータを扱う場面では、このtimingSafeEqualメソッドを積極的に利用することで、アプリケーションの堅牢性と安全性を飛躍的に高めることが可能です。

Copy
1import { timingSafeEqual } from 'crypto';
2
3// 比較する最初のBufferまたはTypedArrayを作成します。
4const bufferA = Buffer.from('mysecretpassword');
5
6// 比較する2番目のBufferまたはTypedArrayを作成します。
7// timingSafeEqualは、両方のバッファの長さが同じである必要があります。
8// 長さが異なる場合、RangeErrorがスローされます。
9const bufferB = Buffer.from('mysecretpassword'); // 同じ内容と長さ
10const bufferC = Buffer.from('wrongpassword');    // 異なる内容だが長さは同じと仮定 (例では異なる長さ)
11// const bufferD = Buffer.from('short');           // 長さが異なるためエラーになります
12
13// 2つのバッファを定数時間で比較します。
14// これはタイミング攻撃を防ぐために重要です。
15// 結果はブール値（trueまたはfalse）で返されます。
16const areEqual = timingSafeEqual(bufferA, bufferB);
17
18// 結果を出力します。
19console.log(areEqual); // bufferAとbufferBの内容が同じなので true と出力されます

a, b

• a: Buffer: 比較する最初のバッファ
• b: Buffer: 比較する2番目のバッファ

boolean

二つのバッファが比較された結果、等しい場合は true を、等しくない場合は false を返します。