オブジェクトBlsKey

楕円曲線暗号化アルゴリズムオブジェクト

BlsKey オブジェクトは、BLS キーを表すために fibjs で使用されるオブジェクトです。これを使用して、BLS キーを構築、インポート、エクスポート、および操作できます。 BLSキーは、認証やデータ署名によく使われる公開鍵暗号方式で、セキュリティを確保しながら実行速度が速いという特徴があります。

BlsKey オブジェクトは、さまざまなキー形式からキーをロードするためのさまざまなコンストラクターメソッドを提供します。また、toString()、clone()、name、publicKey() などのいくつかのパブリックプロパティとメソッド、および from() などのいくつかの静的メソッドも提供します。これらのメソッドを使用して、BlsKey オブジェクトを操作できます。

さらに、BlsKey オブジェクトには isPrivate() や toJSON(key = "") などのメンバー属性があり、キーが秘密キーであるかどうかをクエリしたり、オブジェクトの JSON 形式表現をエクスポートしたりするために使用できます。

BlsKey オブジェクトは、BLS キーを簡単に管理し、認証やデータ署名などのセキュリティ要件を実装するための、柔軟で強力な API のセットを提供します。

以下では、簡単な例を使用して、署名と検証に BlsKey オブジェクトを使用する方法を示します。

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

// create a private key
var privateKey = new crypto.BlsKey({
    'kty': 'EC',
    'crv': 'BLS12-381-G1',
    'x': 'TPk62yDxSISkoSBRPYkpO%tJmm0tZd4tJeLuCKVFv4UmBPfOQ2aDWrCifANam2wj',
    'd': 'zE-pf24p-l0IT_lMcrX0gStTcsx_k1f7DnJmrN8V7ZU',
});

// sign a message
var message = '这是一条需要签名的消息';
var signature = privateKey.sign(message);

// verify the signature
var publicKey = privateKey.publicKey;
var verify = publicKey.verify(message, signature);

console.log('verification result:', verify);

相続関係

コンストラクタ

BlsKey

JSON 形式のキーから BlsKey を構築する

1
new BlsKey(Object jsonKey);

呼び出しパラメータ:

jsonKey：JSON形式のオブジェクト、キー

jsonKey の形式は、次の 2 種類の秘密キーをサポートします。

1
2
3
4
5
6{
    "kty": "EC",
    "crv": "BLS12381_G1",
    "x": "tCgCNuUYQotPEsrljWi-lIRIPpzhqsnJV1NPnE7je6glUb-FJm9IYkuv2hbHw22i",
    "d": "TXNvJBBG3h23H5hFJcnRZmYd_j1TqpwtJOllYGU3yyw"
}

BLS 公開キー:

1
2
3
4
5{
    "kty": "EC",
    "crv": "BLS12381_G1",
    "x": "tCgCNuUYQotPEsrljWi-lIRIPpzhqsnJV1NPnE7je6glUb-FJm9IYkuv2hbHw22i"
}

静的関数

aggregateSignature

一連の署名を 1 つの署名に結合する

1
static Buffer BlsKey.aggregateSignature(Array sigs);

呼び出しパラメータ:

sigs: 配列、マージされる署名のセット

返される結果:

Buffer、マージされた単一の署名を返します。

aggregatePublicKey

一連の公開キーを 1 つの公開キーにマージする

1
static BlsKey BlsKey.aggregatePublicKey(Array keys);

呼び出しパラメータ:

keys: 配列、マージされる公開鍵のセット

返される結果:

BlsKey、マージされた単一の公開キーを返します。

recover

回復可能な署名から公開キーを回復します。secp256k1 のみをサポートします

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

呼び出しパラメータ:

data:Buffer、署名の元のデータ
sig:Buffer、回復可能な署名

返される結果:

ECKey、公開キーを含むオブジェクトを返します。

from

DER 形式でキーをロードする

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

呼び出しパラメータ:

DerKey:Buffer, DER 形式のキー
password: 文字列、復号化パスワード

返される結果:

PKey、キーを含むオブジェクトを返します。

PEM 形式でキーをロードする

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

呼び出しパラメータ:

pemKey: PEM 形式の文字列、キー
password: 文字列、復号化パスワード

返される結果:

PKey、キーを含むオブジェクトを返します。

JSON形式でキーをロードします

1
static PKey BlsKey.from(Object jsonKey);

呼び出しパラメータ:

jsonKey：JSON形式のオブジェクト、キー

返される結果:

PKey、キーを含むオブジェクトを返します。

jsonKey の形式は、次の 4 種類の 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=="
}

RSA 公開キー:

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

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

EC 公開キー:

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

メンバーのプロパティ

bbs_suite

文字列、BBS 署名付き暗号スイート、デフォルトは Bls12381Sha256、Bls12381Shake256 に変更可能、BLS12-381-G2 曲線のみサポート

1
String BlsKey.bbs_suite;

curve

文字列。現在のアルゴリズムの楕円曲線名を返します。

1
readonly String BlsKey.curve;

name

文字列、現在のアルゴリズム名を返します

1
readonly String BlsKey.name;

keySize

整数。現在のアルゴリズムのパスワードの長さをビット単位で返します。

1readonly Integer BlsKey.keySize;

alg

文字列。現在のオブジェクト署名アルゴリズムを返し、設定します。

1
readonly String BlsKey.alg;

publicKey

PKey、現在のキーの公開キーを返します。

1readonly PKey BlsKey.publicKey;

返される結果:

現在の鍵の公開鍵

メンバー関数

bbsSign

現在の秘密キーを使用して一連のメッセージに署名します。BLS12-381-G2 曲線のみをサポートします。

1
2
Buffer BlsKey.bbsSign(Array messages,
    Object opts = {}) async;

呼び出しパラメータ:

messages: 配列、署名されるメッセージ配列を指定します
opts: オブジェクト、署名オプションを指定します

返される結果:

Buffer、署名されたメッセージを返します

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

1
2
3{
    header: Buffer | string // specified header for signature, default is empty
}

bbsVerify

現在の公開キーを使用して署名を検証します。BLS12-381-G2 曲線のみをサポートします

1
2
3
Boolean BlsKey.bbsVerify(Array messages,
    Buffer sig,
    Object opts = {}) async;

呼び出しパラメータ:

messages: 配列、完全なメッセージ配列を指定します
sig:Buffer、検証する署名を指定します
opts: オブジェクト、検証オプションを指定します

返される結果:

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

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

1
2
3{
    header: Buffer | string // specified header for signature, default is empty
}

proofGen

現在の公開キーと署名を使用して証明書を生成します。BLS12-381-G2 曲線のみをサポートします

1
2
3
4Buffer BlsKey.proofGen(Buffer sig,
    Array messages,
    Array idx,
    Object opts = {}) async;

呼び出しパラメータ:

sig:Buffer、証明書の生成時に使用される署名を指定します。
messages: 配列、完全なメッセージ配列を指定します
idx: 配列。プルーフの生成時に使用されるメッセージインデックスを指定します。インデックスは 1 に基づいています。
opts: オブジェクト、証明オプションを指定します

返される結果:

Buffer、生成されたプルーフを返します

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

1
2
3
4{
    header: Buffer | string, // specified header for signature, default is empty
    proof_header: Buffer | string // specified header for proof, default is empty
}

proofVerify

現在の公開キーを使用して証明書を検証し、BLS12-381-G2 曲線のみをサポートします

1
2
3
4
Boolean BlsKey.proofVerify(Array messages,
    Array idx,
    Buffer proof,
    Object opts = {}) async;

呼び出しパラメータ:

messages: 配列。インデックスに基づいてフィルタリングされたメッセージの配列を指定します。
idx: 配列、証明で使用されるメッセージインデックスを指定します。インデックスは 1 に基づいています。
proof:Buffer、生成されたプルーフを指定します
opts: オブジェクト、証明オプションを指定します

返される結果:

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

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

1
2
3
4{
    header: Buffer | string, // specified header for signature, default is empty
    proof_header: Buffer | string // specified header for proof, default is empty
}

computeSecret

現在のアルゴリズムを使用して楕円曲線 Diffie-Hellman (ECDH) 共有キーを計算します。

1
Buffer BlsKey.computeSecret(ECKey publicKey) async;

呼び出しパラメータ:

publicKey:ECKey、相手の公開鍵を指定します

返される結果:

Buffer、計算された共有秘密キーを返します。

isPrivate

現在のキーが秘密キーであるかどうかを問い合わせます

1
Boolean BlsKey.isPrivate();

返される結果:

Boolean、 True であり、秘密キーを表します

clone

現在のキーをコピーする

1PKey BlsKey.clone();

返される結果:

PKey、現在のキーのコピーオブジェクト

pem

現在のキーの PEM 形式エンコーディングを返します。

1
String BlsKey.pem();

返される結果:

String、現在のキーの PEM 形式エンコーディング

der

現在のキーの DER 形式エンコーディングを返します。

1Buffer BlsKey.der();

返される結果:

Buffer、現在のキーの DER 形式エンコーディング

json

現在のキーの jwt 形式のエンコーディングを返します。

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

呼び出しパラメータ:

opts: オブジェクト、エクスポートオプションを指定します

返される結果:

Object、現在のキーの jwt 形式エンコーディング

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

1
2
3{
    compress: false // specify whether to output public key in compressed form
}

圧縮をサポートするカーブは次のとおりです: secp192r1、secp192k1、secp256r1、secp256k1、brainpoolP256r1、secp384r1、brainpoolP384r1、brainpoolP512r1、secp521r1、sm2

equals

2 つの公開キーと秘密キーを比較して、それらが同じかどうかを確認します

1
Boolean BlsKey.equals(object key);

呼び出しパラメータ:

key:object、相手の公開鍵/秘密鍵を指定します。

返される結果:

Boolean、同じ場合は true を返します

encrypt

現在のアルゴリズム暗号公開キーを使用してデータを暗号化する

1
Buffer BlsKey.encrypt(Buffer data) async;

呼び出しパラメータ:

data:Buffer、暗号化するデータを指定します

返される結果:

Buffer、暗号化されたデータを返します

decrypt

現在のアルゴリズムのパスワード秘密キーを使用してデータを復号化する

1
Buffer BlsKey.decrypt(Buffer data) async;

呼び出しパラメータ:

data:Buffer、復号化するデータを指定します

返される結果:

Buffer、復号化されたデータを返します

sign

現在のアルゴリズムの暗号化秘密キーを使用してデータに署名する

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

呼び出しパラメータ:

data:Bufferアルゴリズムが RSA の場合、入力パラメータは alg で指定されたアルゴリズムで実行される必要があります。hash
opts: オブジェクト、署名オプションを指定します

返される結果:

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

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

1
2
3
4
5{
    alg: 0, // specify the hash algorithm for signing, only valid for RSA, default is 0. Supported algorithms: 0=NONE,1=MD5,2=SHA1,3=SHA224,4=SHA256,5=SHA384,6=SHA512,7=RIPEMD160
    format: "der", // specify the signature format, default is der, supported formats: der, raw
    recoverable: false // specify whether to return a recoverable signature, only valid for secp256k1
}

verify

現在のアルゴリズムの暗号化公開キーを使用してデータを検証する

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

呼び出しパラメータ:

data:Buffer、検証するデータを指定します
sign:Buffer、検証する署名を指定します
opts: オブジェクト、検証オプションを指定します

返される結果:

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

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

1
2
3
4{
    alg: 0, // specify the hash algorithm for signing, only valid for RSA, default is 0. Supported algorithms: 0=NONE,1=MD5,2=SHA1,3=SHA224,4=SHA256,5=SHA384,6=SHA512,7=RIPEMD160
    format: "der" // specify the signature format, default is der, supported formats: der, raw
}

toString

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

1
String BlsKey.toString();

返される結果:

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

toJSON

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

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

呼び出しパラメータ:

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

返される結果:

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

開発ガイド

基本モジュール

組み込みオブジェクト

コミュニティモジュール

オブジェクトBlsKey

相続関係

コンストラクタ

BlsKey

静的関数

aggregateSignature

aggregatePublicKey

recover

from

メンバーのプロパティ

bbs_suite

curve

name

keySize

alg

publicKey

メンバー関数

bbsSign

bbsVerify

proofGen

proofVerify

computeSecret

isPrivate

clone

pem

der

json

equals

encrypt

decrypt

sign

verify

toString

toJSON