オブジェクトPKey

非対称暗号化アルゴリズムオブジェクト

PKeyオブジェクトはcryptoモジュールに属し、次のように作成されます。

1
var k = new crypto.PKey();

継承

コンストラクタ

PKey

PKeyコンストラクター

1
new PKey();

DERフォーマットキーからPKeyを構築します

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

呼び出しパラメーター：

DerKey ： Buffer 、DERフォーマットキー
password ：文字列、パスワードの復号化

PEM形式のキーを使用してPKeyを作成します

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

呼び出しパラメーター：

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

JSON形式のキーからPKeyを作成します

1
new PKey(Object jsonKey);

呼び出しパラメーター：

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

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

メンバー属性

name

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

1
readonly String PKey.name;

keySize

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

1readonly Integer PKey.keySize;

publicKey

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

1readonly PKey PKey.publicKey;

戻り結果：

現在の鍵の公開鍵

メンバー機能

genRsaKey

RSA秘密鍵を生成する

1
PKey.genRsaKey(Integer size) async;

呼び出しパラメーター：

size ：整数、RSAキーの長さ、ビットを単位として指定

genEcKey

EC秘密鍵を生成する

1
PKey.genEcKey(String curve = "secp521r1") async;

呼び出しパラメーター：

curve ：文字列、プリセット楕円曲線を指定します。オプションの値は次のとおりです： "secp521r1"、 "brainpoolP512r1"、 "secp384r1"、 "brainpoolP384r1"、 "secp256r1"、 "secp256k1"、 "brainpoolP256r1"、 "secp224r1"、 "secp224k1" 、 "secp192r1"、 "secp192k1"

genSm2Key

SM2秘密鍵を生成する

1
PKey.genSm2Key() async;

isPrivate

現在のキーが秘密キーであるかどうかを照会します

1
Boolean PKey.isPrivate();

戻り結果：

Boolean 、真は秘密鍵を意味します

clone

現在のキーをコピーします

1PKey PKey.clone();

戻り結果：

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

importKey

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

1
2PKey.importKey(Buffer DerKey,
    String password = "");

呼び出しパラメーター：

DerKey ： Buffer 、DERフォーマットキー
password ：文字列、パスワードの復号化

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

1
2
PKey.importKey(String pemKey,
    String password = "");

呼び出しパラメーター：

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

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

1
PKey.importKey(Object jsonKey);

呼び出しパラメーター：

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

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

importFile

キーファイルをPEM / DER形式でロードします

1
2
PKey.importFile(String filename,
    String password = "");

呼び出しパラメーター：

filename ：文字列、キーファイル名
password ：文字列、パスワードの復号化

exportPem

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

1
String PKey.exportPem();

戻り結果：

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

exportDer

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

1Buffer PKey.exportDer();

戻り結果：

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

exportJson

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

1
Object PKey.exportJson();

戻り結果：

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

encrypt

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

1
Buffer PKey.encrypt(Buffer data) async;

呼び出しパラメーター：

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

戻り結果：

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

decrypt

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

1
Buffer PKey.decrypt(Buffer data) async;

呼び出しパラメーター：

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

戻り結果：

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

sign

現在のアルゴリズムのパスワード秘密鍵を使用してデータに署名する

1
2Buffer PKey.sign(Buffer data,
    Integer alg = 0) async;

呼び出しパラメーター：

data ： Buffer 、署名するデータを指定します
alg ：整数、署名するアルゴリズムを指定します。デフォルトは0です。サポートされるアルゴリズム：0 = NONE、1 = MD2,2 = MD4,3 = MD5,4 = SHA1,5 = SHA224,6 = SHA256,7 = SHA384,8 = SHA512,9 = RIPEMD160

戻り結果：

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

verify

現在のアルゴリズムパスワード公開キーを使用してデータを確認します

1
2
3
Boolean PKey.verify(Buffer data,
    Buffer sign,
    Integer alg = 0) async;

呼び出しパラメーター：

data ： Buffer 、検証するデータを指定します
sign ： Buffer 、検証する署名を指定します
alg ：整数、署名するアルゴリズムを指定します。デフォルトは0です。サポートされるアルゴリズム：0 = NONE、1 = MD2,2 = MD4,3 = MD5,4 = SHA1,5 = SHA224,6 = SHA256,7 = SHA384,8 = SHA512,9 = RIPEMD160

戻り結果：

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

toString

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

1
String PKey.toString();

戻り結果：

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

toJSON

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

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

呼び出しパラメーター：

key ：文字列、未使用

戻り結果：

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

開発ガイド

基本モジュール

組み込みオブジェクト

コミュニティモジュール

オブジェクトPKey

継承

コンストラクタ

PKey

メンバー属性

name

keySize

publicKey

メンバー機能

genRsaKey

genEcKey

genSm2Key

isPrivate

clone

importKey

importFile

exportPem

exportDer

exportJson

encrypt

decrypt

sign

verify

toString

toJSON