Objeto ECKey

La clase ECKey está encryptoImplementado en el módulo, puede usar esta clase para generar pares de claves ECDSA, mensajes de firma y verificación, etc.

Aquí hay un ejemplo:

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

// generate a secp256k1 key
const key = crypto.generateKey("secp256k1");
console.log("Private key:", key.pem());
console.log("Public key:", key.publicKey.pem());

const message = "Hello, fibjs!";
// sign a message
const sig = key.sign(message);
console.log("Signature:", sig.hex());

// very the signature
const verify = key.verify(message, sig);
console.log("Verify result:", verify);

En este ejemplo, primero generamos un objeto ECKey secp256k1 y luego imprimimos las claves públicas y privadas generadas. Luego, firmamos el mensaje "¡Hola, fibjs!" e imprimimos el resultado de la firma, y finalmente verificamos la firma usando el mismo objeto clave e imprimimos el resultado de la verificación.

relación de herencia

Constructor

ECKey

Construir ECKey a partir de una clave en formato DER

1
2
new ECKey(Buffer DerKey,
    String password = "");

Parámetros de llamada:

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

Construir ECKey a partir de clave en formato PEM

1
2
new ECKey(String pemKey,
    String password = "");

Parámetros de llamada:

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

Construya ECKey a partir de la clave en formato JSON

1
new ECKey(Object jsonKey);

Parámetros de llamada:

jsonKey: Objeto, clave en formato JSON

El formato de jsonKey admite los dos tipos siguientes, clave privada EC:

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"
}

función estática

recover

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

1
2
static ECKey ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.curve;

name

Cadena, devuelve el nombre del algoritmo actual

1
readonly String ECKey.name;

keySize

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

1readonly Integer ECKey.keySize;

alg

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

1
String ECKey.alg;

publicKey

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

1readonly PKey ECKey.publicKey;

resultado devuelto:

la clave pública de la clave actual

función miembro

computeSecret

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

1
Buffer ECKey.computeSecret(ECKey publicKey) async;

Parámetros de llamada:

publicKey: ECKey, especifique la clave pública de la otra parte

resultado devuelto:

Buffer, devuelve el secreto compartido calculado

isPrivate

Consultar si la clave actual es una clave privada

1
Boolean ECKey.isPrivate();

resultado devuelto:

Boolean, si es Verdadero significa clave privada

clone

copiar la clave actual

1PKey ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey.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 ECKey

relación de herencia

Constructor

ECKey

función estática

recover

from

atributo de miembro

curve

name

keySize

alg

publicKey

función miembro

computeSecret

isPrivate

clone

pem

der

json

equals

encrypt

decrypt

sign

verify

toString

toJSON