Objeto Ed25519Clave

Objeto de criptografía de curva elíptica

El siguiente ejemplo demuestra el uso de Ed25519Key:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
const crypto = require('crypto');

// generate a ed25519 key
const key = crypto.generateKey('ed25519');

// output key in PEM format
console.log('PrivateKey:', key.pem());
console.log('PublicKey:', key.publicKey.pem());

// sign a message
const message = 'Hello, World!';
const sig = key.sign(message);
console.log('Sig:', sig.hex());

// verify the signature
const verifyResult = key.verify(message, sig);
console.log('Verify Result:', verifyResult);

relación de herencia

función estática

recover

recuperar la clave pública de la firma recuperable, solo se admite secp256k1

1
2
static ECKey Ed25519Key.recover(Buffer data,
    Buffer sig) async;

Parámetros de llamada:

data:Buffer, los datos originales de la firma
sig:Buffer, la firma recuperable

resultado devuelto:

ECKey, devuelve un objeto que contiene la clave pública

from

Cargar una clave en formato DER

1
2
static PKey Ed25519Key.from(Buffer DerKey,
    String password = "");

Parámetros de llamada:

DerKey:Buffer, la clave en formato DER
password: Cadena, contraseña descifrada

resultado devuelto:

PKey, devuelve un objeto que contiene la clave

Cargar una clave en formato PEM

1
2
static PKey Ed25519Key.from(String pemKey,
    String password = "");

Parámetros de llamada:

pemKey: Cadena, clave en formato PEM
password: Cadena, contraseña descifrada

resultado devuelto:

PKey, devuelve un objeto que contiene la clave

Cargue una clave en formato JSON

1
static PKey Ed25519Key.from(Object jsonKey);

Parámetros de llamada:

jsonKey: Objeto, clave en formato JSON

resultado devuelto:

PKey, devuelve un objeto que contiene la clave

El formato de jsonKey admite los siguientes cuatro tipos de clave privada RSA:

1
2
3
4
5
6
7
8
9
10
11{
    "kty": "RSA",
    "n": "0m5lvKpWqy9JS7tV2HIPqHCYHLquSuxIC3F8strIQLJKO3rZmTT96KTnhsOfBO7Y1bI7mnT0PB3_vcHd9ekWMEoZJQw7MuB8KeM_Wn54-elJr5DNLk5bMppSGxX7ZnumiXGG51_X3Yp-_EbGtDG80GxXXix7Mucyo7K25uE0uW8=",
    "e": "AQAB",
    "d": "agN2O9NxMHL1MTMi75WfL9Pxvl-KWXKqZSF6mjzAsF9iKI8euyHIXYFepzU8kual1RsjDhCnzvWqFvZplW8lXqrHf_P-rS_9Y4gBUw6pjnI_DnFIRwWHRvrUHHSCfWOdTCIKdOTkgLZuGFuhEY3RMIW0WSYejjLtftwy0RVxAzk=",
    "p": "6a4G1qmfwWmn1biigN7IVFlkbLf9oVe6g7rOmHxI-hn1GRxKDSVuAUrmR1IhuAnca9M0y7SD-7TUs6wjOxWxaw==",
    "q": "5ofkxFKdPBD0CQHMb9q13AMHUVe0rJ-hSjqqIBrmqApUOneyAcMV76M0QyIQnI2p3POa4Qu_7XChDwRVl7LlDQ==",
    "dp": "2mXGiGwCHl8j-FBWuID-1C6z-BRB3MBEVoeKPOOzxOPruatB3mWEGXsqG7A8SWgV9URxTI2K6P3J6Z7RUpBkvw==",
    "dq": "oagn5vfb5NQqnOpS9xkSsD67cfIj821ZSFlNFYhnuOzNVda7z_qCtnHm4zDPH0lEFXoKYMfBhfqWJpaugttjPQ==",
    "qi": "dqEQgxNmOVFrF4s776hTqeC6oEDila8EvpVb2F2ZvwAOLjCQ66OiAZK1BiYGHqUy0NeqNmtlsLSuBEZQZvqZwg=="
}

Clave pública RSA:

1
2
3
4
5{
    "kty": "RSA",
    "n": "0m5lvKpWqy9JS7tV2HIPqHCYHLquSuxIC3F8strIQLJKO3rZmTT96KTnhsOfBO7Y1bI7mnT0PB3_vcHd9ekWMEoZJQw7MuB8KeM_Wn54-elJr5DNLk5bMppSGxX7ZnumiXGG51_X3Yp-_EbGtDG80GxXXix7Mucyo7K25uE0uW8=",
    "e": "AQAB"
}

Clave privada CE:

1
2
3
4
5
6
7{
    "kty": "EC",
    "crv": "P-521",
    "x": "ATfNNFuuvlGxrTGoXgyfSAGgRNNDnO3rN3k74urKJdVS14RYhdnSwm91Bm-F1l-T1XKlAY2yRnzG9w1Ukvo8c0wL",
    "y": "ASBHqrruB6kdkEUB3vlW3-UIkk4HtKdUeTwN-7m3j2rgZvYR1ffRAapDvWqKGiBjomqWafxokBkbDI0c95f6f4XU",
    "d": "AfkIbUHXfW41njdpoKuqqKludcoLJS8D_oMEwkj-GVaXFNKccIoF5iKGu2c69kNDjo83R_7wyGlfRczsklkik1ST"
}

Clave pública CE:

1
2
3
4
5
6{
    "kty": "EC",
    "crv": "P-521",
    "x": "ATfNNFuuvlGxrTGoXgyfSAGgRNNDnO3rN3k74urKJdVS14RYhdnSwm91Bm-F1l-T1XKlAY2yRnzG9w1Ukvo8c0wL",
    "y": "ASBHqrruB6kdkEUB3vlW3-UIkk4HtKdUeTwN-7m3j2rgZvYR1ffRAapDvWqKGiBjomqWafxokBkbDI0c95f6f4XU"
}

atributo de miembro

curve

String, devuelve el nombre de la curva elíptica del algoritmo actual

1
readonly String Ed25519Key.curve;

name

Cadena, devuelve el nombre del algoritmo actual

1
readonly String Ed25519Key.name;

keySize

Entero, devuelve la longitud de la contraseña del algoritmo actual en bits

1readonly Integer Ed25519Key.keySize;

alg

String, devuelve y establece el algoritmo de firma del objeto actual

1
String Ed25519Key.alg;

publicKey

PKey, devuelve la clave pública de la clave actual

1readonly PKey Ed25519Key.publicKey;

resultado devuelto:

la clave pública de la clave actual

función miembro

toX25519

Convierta el par de claves pública-privada X25519 del objeto actual, solo se admite Ed25519

1
ECKey Ed25519Key.toX25519() async;

resultado devuelto:

ECKey, devuelve el objeto de clave pública X25519 correspondiente

computeSecret

Calcula un secreto compartido de curva elíptica Diffie-Hellman (ECDH) usando el algoritmo actual

1
Buffer Ed25519Key.computeSecret(ECKey publicKey) async;

Parámetros de llamada:

publicKey:ECKey, especificando la clave pública de la contraparte

resultado devuelto:

Buffer, devuelve el secreto compartido calculado

isPrivate

Consultar si la clave actual es una clave privada

1
Boolean Ed25519Key.isPrivate();

resultado devuelto:

Boolean, si es Verdadero significa clave privada

clone

copiar la clave actual

1PKey Ed25519Key.clone();

resultado devuelto:

PKey, el objeto de copia de la clave actual

pem

Devuelve la codificación en formato PEM de la clave actual

1
String Ed25519Key.pem();

resultado devuelto:

String, la codificación de formato PEM de la clave actual

der

Devuelve la codificación en formato DER de la clave actual

1Buffer Ed25519Key.der();

resultado devuelto:

Buffer, la codificación en formato DER de la clave actual

json

Devuelve la codificación de formato jwt de la clave actual

1
Object Ed25519Key.json(Object opts = {});

Parámetros de llamada:

opts: Objeto, especifica las opciones de exportación

resultado devuelto:

Object, la codificación en formato jwt de la clave actual

opts admite los siguientes parámetros:

1
2
3{
    compress: false， 指定签名以压缩方式输出公钥
}

Las curvas que soportan compresión son: secp192r1, secp192k1, secp256r1, secp256k1, brainpoolP256r1, secp384r1, brainpoolP384r1, brainpoolP512r1, secp521r1, sm2

equals

Comparar si dos claves públicas/privadas son iguales

1
Boolean Ed25519Key.equals(PKey key);

Parámetros de llamada:

key:PKey, especifique la clave pública/privada de la otra parte

resultado devuelto:

Boolean, devuelve verdadero si es lo mismo

encrypt

Cifrar datos utilizando la clave pública criptográfica del algoritmo actual

1
Buffer Ed25519Key.encrypt(Buffer data) async;

Parámetros de llamada:

data:Buffer, especifica los datos a cifrar

resultado devuelto:

Buffer, devuelve los datos cifrados

decrypt

Descifrar los datos utilizando la clave privada criptográfica del algoritmo actual

1
Buffer Ed25519Key.decrypt(Buffer data) async;

Parámetros de llamada:

data:Buffer, especifica los datos a descifrar

resultado devuelto:

Buffer, devuelve los datos descifrados

sign

Firmar datos utilizando la clave privada criptográfica del algoritmo actual

1
2Buffer Ed25519Key.sign(Buffer data,
    Object opts = {}) async;

Parámetros de llamada:

data:Buffer, especifica los datos a firmar
opts: Objeto, especifica opciones de firma

resultado devuelto:

Buffer, devuelve los datos firmados

opts admite los siguientes parámetros:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15{
    alg: 0， 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
    to: pk,
    指定验证方公钥， 仅在 ecsdsa 或 sm2 时有效
    format: "der",
    指定签名格式， 可选为 der 和 raw， 缺省为 der
    recoverable: false 指定返回可恢复签名， 仅在 secp256k1 有效
}

verify

Verifique los datos utilizando la clave pública criptográfica del algoritmo actual

1
2
3
Boolean Ed25519Key.verify(Buffer data,
    Buffer sign,
    Object opts = {}) async;

Parámetros de llamada:

data:Buffer, especificando los datos a validar
sign:Buffer, especificando la firma a verificar
opts: Objeto, especifica las opciones de autenticación

resultado devuelto:

Boolean, devuelve el resultado verificado

opts admite los siguientes parámetros:

1
2
3
4
5
6
7
8
9
10
11
12
13
14{
    alg: 0， 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
    to: pk,
    指定验证方公钥， 仅在 ecsdsa 或 sm2 时有效
    format: "der",
    指定签名格式， 可选为 der 和 raw， 缺省为 der
}

toString

Devuelve la representación de cadena del objeto, generalmente devuelve "[Objeto nativo]", el objeto se puede volver a implementar de acuerdo con sus propias características

1
String Ed25519Key.toString();

resultado devuelto:

String, devuelve una representación de cadena del objeto

toJSON

Devuelve la representación en formato JSON del objeto, generalmente devuelve una colección de propiedades legibles definidas por el objeto

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

Parámetros de llamada:

key: Cadena, no utilizada

resultado devuelto:

Value, que devuelve un valor serializable JSON

guía de desarrollo

Módulo básico

objeto incorporado

modulo comunitario

Objeto Ed25519Clave

relación de herencia

función estática

recover

from

atributo de miembro

curve

name

keySize

alg

publicKey

función miembro

toX25519

computeSecret

isPrivate

clone

pem

der

json

equals

encrypt

decrypt

sign

verify

toString

toJSON