Obxecto Digest

Obxecto resumo de información

Podes usar o obxecto Digest deste xeito:

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'));

No código anterior crypto.createHash()créase mediante o método un obxecto de operación de resumo SHA-512. update()Os datos que se van resumir pódense engadir gradualmente a través do método e digest()o resultado do resumo pódese obter mediante o método.

relación de herdanza

propiedades dos membros

size

Enteiro, consulta o número de bytes de resumo do algoritmo de resumo de información actual

1
readonly Integer Digest.size;

función de membro

update

Actualizar a información do resumo binario

1
Digest Digest.update(Buffer data);

Parámetros de chamada:

• data:Buffer, bloque de datos binarios

Resultados de devolución:

• Digest, devolve o propio obxecto de resumo de información

---

Actualizar a información do resumo da cadea

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

Parámetros de chamada:

• data: String, string data
• codec: String, especifica o formato de codificación, os valores permitidos son: "buffer", "hex", "base32", "base58", "base64", "utf8" ouiconvConxuntos de caracteres admitidos polo módulo

Resultados de devolución:

• Digest, devolve o propio obxecto de resumo de información

---

digest

Calcula e devolve o resumo

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

Parámetros de chamada:

• codec: String, especifica o formato de codificación, os valores permitidos son: "buffer", "hex", "base32", "base58", "base64", "utf8" ouiconvConxuntos de caracteres admitidos polo módulo

Resultados de devolución:

• Value, devolve unha representación resumida da codificación especificada

---

sign

Asina e devolve o resumo

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

Parámetros de chamada:

• key:PKey, clave privada asinada
• opts: Obxecto, especifique as opcións de sinatura

Resultados de devolución:

• Buffer, devolve os datos asinados

opts admite os seguintes parámetros:

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

Verifica que as sinaturas sexan coherentes

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

Parámetros de chamada:

• key:PKey, a clave pública para verificar a sinatura
• sign:Buffer, especifique a sinatura que se quere verificar
• opts: Obxecto, especifique as opcións de verificación

Resultados de devolución:

• Boolean, devolve o resultado verificado

opts admite os seguintes parámetros:

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

Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.

1
String Digest.toString();

Resultados de devolución:

• String, devolve a representación en cadea do obxecto

---

toJSON

Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.

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

Parámetros de chamada:

• key: Cadena, non usada

Resultados de devolución:

• Value, devolve un valor que contén JSON serializable