オブジェクトダイジェスト

情報要約オブジェクト

Digest オブジェクトは次のように使用できます。

1
2
3
4
5
6
7
8
9
10
11
12
13
const crypto = require('crypto');
// create a SHA-512 digest object
const digest = crypto.createHash('sha512');
// update digest with data
digest.update('hello');
digest.update('world');
// get digest result
const result = digest.digest();
console.log(result);

// output result in hex and base64
console.log(result.toString('hex'));
console.log(result.toString('base64'));

上記のコードでは、crypto.createHash()メソッドを使用してSHA-512ダイジェスト操作オブジェクトを作成し、update()このメソッドにより集計対象のデータを徐々に追加し、digest()集計結果を取得することができます。

相続関係

メンバーのプロパティ

size

整数、現在の情報ダイジェスト アルゴリズムのダイジェスト バイト数を問い合わせる

1
readonly Integer Digest.size;

メンバー関数

update

バイナリダイジェスト情報を更新する

1
Digest Digest.update(Buffer data);

呼び出しパラメータ:

• data:Buffer、バイナリデータブロック

返される結果:

• Digest、情報概要オブジェクト自体を返します。

---

文字列の概要情報を更新します

1
2
Digest Digest.update(String data,
    String codec = "utf8");

呼び出しパラメータ:

• data：文字列、文字列データ
• codec: 文字列、エンコード形式を指定します。許可される値は次のとおりです: "buffer"、"hex"、"base32"、"base58"、"base64"、"utf8"、またはiconvモジュールがサポートする文字セット

返される結果:

• Digest、情報概要オブジェクト自体を返します。

---

digest

概要を計算して返す

1
Value Digest.digest(String codec = "buffer");

呼び出しパラメータ:

• codec: 文字列、エンコード形式を指定します。許可される値は次のとおりです: "buffer"、"hex"、"base32"、"base58"、"base64"、"utf8"、またはiconvモジュールがサポートする文字セット

返される結果:

• Value、指定されたエンコーディングの概要表現を返します。

---

sign

概要に署名して返送

1
2
Buffer Digest.sign(PKey key,
    Object opts = {}) async;

呼び出しパラメータ:

• key:PKey、署名付き秘密鍵
• opts: オブジェクト、署名オプションを指定します

返される結果:

• Buffer、署名されたデータを返します

opts は次のパラメータをサポートしています。

1
2
3
4
5
6
7
8
9
10
{
    alg: 0 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
}

---

verify

署名が一貫していることを確認する

1
2
3
Boolean Digest.verify(PKey key,
    Buffer sign,
    Object opts = {}) async;

呼び出しパラメータ:

• key:PKey、署名を検証するための公開キー
• sign:Buffer、検証する署名を指定します
• opts: オブジェクト、検証オプションを指定します

返される結果:

• Boolean、検証された結果を返します

opts は次のパラメータをサポートしています。

1
2
3
4
5
6
7
8
9
10
{
    alg: 0 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
}

---

toString

オブジェクトの文字列表現を返します。通常、「[Native Object]」が返されます。オブジェクトは、独自の特性に従って再実装できます。

1
String Digest.toString();

返される結果:

• String、オブジェクトの文字列表現を返します。

---

toJSON

オブジェクトの JSON 形式表現を返します。通常は、オブジェクトによって定義された読み取り可能なプロパティのコレクションを返します。

1
Value Digest.toJSON(String key = "");

呼び出しパラメータ:

• key: 文字列、使用されません

返される結果:

• Value、シリアル化可能な JSON を含む値を返します