ObjectECKey

La classe ECKey està en marxacryptoImplementat al mòdul, podeu utilitzar aquesta classe per generar parells de claus ECDSA, missatges de signatura i verificació, etc.

Aquí teniu un exemple:

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 aquest exemple, primer generem un objecte ECKey secp256k1 i després imprimim les claus públiques i privades generades. A continuació, vam signar el missatge "Hola, fibjs!" i vam imprimir el resultat de la signatura, i finalment vam verificar la signatura utilitzant el mateix objecte clau i vam imprimir el resultat de la verificació.

relació hereditària

Constructor

ECKey

Construeix ECKey a partir d'una clau en format DER

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

Paràmetres de trucada:

DerKey:Buffer, la clau en format DER
password: cadena, contrasenya desxifrada

Construeix ECKey a partir de clau en format PEM

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

Paràmetres de trucada:

pemKey: Cadena, clau en format PEM
password: cadena, contrasenya desxifrada

Construeix ECKey a partir de la clau en format JSON

1
new ECKey(Object jsonKey);

Paràmetres de trucada:

jsonKey: Objecte, clau en format JSON

El format de jsonKey admet els dos tipus següents, clau 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"
}

Clau pública EC:

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

funció estàtica

recover

recuperar la clau pública de la signatura recuperable, només és compatible amb secp256k1

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

Paràmetres de trucada:

data:Buffer, les dades originals de la signatura
sig:Buffer, la signatura recuperable

resultat de retorn:

ECKey, retorna un objecte que conté la clau pública

from

Carregueu una clau en format DER

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

Paràmetres de trucada:

DerKey:Buffer, la clau en format DER
password: cadena, contrasenya desxifrada

resultat de retorn:

PKey, retorna un objecte que conté la clau

Carregueu una clau en format PEM

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

Paràmetres de trucada:

pemKey: Cadena, clau en format PEM
password: cadena, contrasenya desxifrada

resultat de retorn:

PKey, retorna un objecte que conté la clau

Carregueu una clau en format JSON

1
static PKey ECKey.from(Object jsonKey);

Paràmetres de trucada:

jsonKey: Objecte, clau en format JSON

resultat de retorn:

PKey, retorna un objecte que conté la clau

El format de jsonKey admet els quatre tipus següents, clau 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=="
}

Clau pública RSA:

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

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

Clau pública EC:

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

atribut de membre

curve

Cadena, retorna el nom de la corba el·líptica de l'algorisme actual

1
readonly String ECKey.curve;

name

Cadena, retorna el nom de l'algorisme actual

1
readonly String ECKey.name;

keySize

Enter, retorna la longitud actual de la contrasenya de l'algorisme en bits

1readonly Integer ECKey.keySize;

alg

String, retorna i estableix l'algoritme de signatura de l'objecte actual

1
String ECKey.alg;

publicKey

PKey, retorna la clau pública de la clau actual

1readonly PKey ECKey.publicKey;

resultat de retorn:

la clau pública de la clau actual

funció de membre

computeSecret

Calcula un secret compartit de corba el·líptica Diffie-Hellman (ECDH) mitjançant l'algoritme actual

1
Buffer ECKey.computeSecret(ECKey publicKey) async;

Paràmetres de trucada:

publicKey: ECKey, especifiqueu la clau pública de l'altra part

resultat de retorn:

Buffer, retorna el secret compartit calculat

isPrivate

Consulta si la clau actual és una clau privada

1
Boolean ECKey.isPrivate();

resultat de retorn:

Boolean, si True significa clau privada

clone

copiar la clau actual

1PKey ECKey.clone();

resultat de retorn:

PKey, l'objecte de còpia de la clau actual

pem

Retorna la codificació en format PEM de la clau actual

1
String ECKey.pem();

resultat de retorn:

String, la codificació en format PEM de la clau actual

der

Retorna la codificació en format DER de la clau actual

1Buffer ECKey.der();

resultat de retorn:

Buffer, la codificació en format DER de la clau actual

json

Retorna la codificació del format jwt de la clau actual

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

Paràmetres de trucada:

opts: Objecte, especifica les opcions d'exportació

resultat de retorn:

Object, la codificació en format jwt de la clau actual

opts admet els paràmetres següents:

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

Les corbes que admeten la compressió són: secp192r1, secp192k1, secp256r1, secp256k1, brainpoolP256r1, secp384r1, brainpoolP384r1, brainpoolP512r1, secp521r1, sm2

equals

Compareu si dues claus públiques/privades són iguals

1
Boolean ECKey.equals(PKey key);

Paràmetres de trucada:

key:PKey, especifiqueu la clau pública/privada de l'altra part

resultat de retorn:

Boolean, retorna true si és el mateix

encrypt

Xifra les dades utilitzant la clau pública criptogràfica de l'algoritme actual

1
Buffer ECKey.encrypt(Buffer data) async;

Paràmetres de trucada:

data:Buffer, especifica les dades que s'han de xifrar

resultat de retorn:

Buffer, retorna les dades xifrades

decrypt

Desxifra les dades mitjançant la clau privada criptogràfica de l'algoritme actual

1
Buffer ECKey.decrypt(Buffer data) async;

Paràmetres de trucada:

data:Buffer, especifica les dades que s'han de desxifrar

resultat de retorn:

Buffer, retorna les dades desxifrades

sign

Signeu les dades amb la clau privada criptogràfica actual de l'algoritme

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

Paràmetres de trucada:

data:Buffer, especifica les dades a signar
opts: Objecte, especifica opcions de signatura

resultat de retorn:

Buffer, retorna les dades signades

opts admet els paràmetres següents:

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

Verifiqueu les dades mitjançant la clau pública criptogràfica de l'algoritme actual

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

Paràmetres de trucada:

data:Buffer, especificant les dades a validar
sign:Buffer, especificant la signatura a verificar
opts: Objecte, especifica les opcions d'autenticació

resultat de retorn:

Boolean, retorna el resultat verificat

opts admet els paràmetres següents:

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

Retorna la representació de cadena de l'objecte, generalment retorna "[Native Object]", l'objecte es pot reimplementar segons les seves pròpies característiques

1
String ECKey.toString();

resultat de retorn:

String, retorna una representació de cadena de l'objecte

toJSON

Retorna la representació en format JSON de l'objecte, generalment retorna una col·lecció de propietats llegibles definides per l'objecte

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

Paràmetres de trucada:

key: Corda, no utilitzada

resultat de retorn:

Value, que retorna un valor serialitzable per JSON

guia de desenvolupament

Mòdul bàsic

objecte incorporat

mòdul comunitari

ObjectECKey

relació hereditària

Constructor

ECKey

funció estàtica

recover

from

atribut de membre

curve

name

keySize

alg

publicKey

funció de membre

computeSecret

isPrivate

clone

pem

der

json

equals

encrypt

decrypt

sign

verify

toString

toJSON