Crypto: getRandomValues() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
Crypto.getRandomValues() メソッドは、暗号強度の強い乱数値を取得します。
引数で与えた配列は、すべて乱数で（暗号学的な意味でランダムに）埋められます。
十分な性能を保証するために、実装は真に乱数発生器を使用しているのではないものの、十分なエントロピーを有するシード値を用いた擬似乱数発生器を使用しています。 擬似乱数発生器アルゴリズム (PRNG) は、ユーザーエージェントによって異なる可能性がありますが、暗号化の目的には適しています。
getRandomValues() は Crypto インターフェイスで保護されたコンテキスト外から使用することができる唯一のメンバーです。
構文
getRandomValues(typedArray)
引数
typedArray-
整数値ベースの
TypedArrayです。Int8Array,Uint8Array,Uint8ClampedArray,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64Array,BigUint64Arrayの何れかです（ただしFloat32ArrayやFloat64Arrayではありません）。 配列内のすべての要素は乱数で上書きされます。
返値
typedArray と同じ配列が渡されますが、その内容は新しく生成された乱数で置き換えられます。
typedArray はその場で変更され、コピーは行われないことに注意してください。
例外
QuotaExceededErrorDOMException-
typedArrayのbyteLengthが 65,536 バイトを超えた場合に発生します。
使用上の注意
getRandomValues() を暗号鍵を生成するために使用しないでください。代わりに generateKey() メソッドを使用してください。
これにはいくつかの理由があります。例えば、 getRandomValues() が保護されたコンテキストで動作することが保証されていないことなどです。
ウェブ暗号仕様書では、エントロピーの最小値は規定されていません。
その代わり、ユーザーエージェントは乱数を生成する際に、ユーザーエージェント自身に組み込まれた、よく定義された効率的な擬似乱数発生器を用いて、可能な限り最高のエントロピーを提供することが求められています。例えば、プラットフォーム固有の乱数関数、 Unix の /dev/urandom デバイス、または他のランダムまたは擬似乱数データのソースなど、外部の擬似乱数ソースから取得したシード値が用いられます。
例
const array = new Uint32Array(10);
self.crypto.getRandomValues(array);
console.log("Your lucky numbers:");
for (const num of array) {
console.log(num);
}
仕様書
| 仕様書 |
|---|
| Web Cryptography Level 2 # Crypto-method-getRandomValues |
ブラウザーの互換性
関連情報
- ウェブ暗号 API
Cryptoオブジェクトを取得するcrypto。Math.random暗号学的に安全ではない乱数値。