オブジェクト組み込みオブジェクト

オブジェクトPKey

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

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

1
var k = new crypto.PKey();

継承

コンストラクタ

PKey

PKeyコンストラクタ

1
new PKey();

DER形式のキーからPKeyを構築します

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

呼び出しパラメータ:

  • DerKeyBuffer 、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

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

1
readonly Integer PKey.keySize;

publicKey

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

1
readonly 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 、秘密鍵の場合はTrue

clone

現在のキーをコピー

1
PKey PKey.clone();

結果を返す:

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

importKey

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

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

呼び出しパラメータ:

  • DerKeyBuffer 、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形式のエンコーディングを返します

1
Buffer PKey.exportDer();

結果を返す:

  • 現在のキーのDER形式のエンコーディングであるBuffer

exportJson

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

1
Object PKey.exportJson();

結果を返す:

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

encrypt

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

1
Buffer PKey.encrypt(Buffer data) async;

呼び出しパラメータ:

  • dataBuffer 、暗号化するデータを指定

結果を返す:

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

decrypt

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

1
Buffer PKey.decrypt(Buffer data) async;

呼び出しパラメータ:

  • dataBuffer 、復号化するデータを指定

結果を返す:

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

sign

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

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

呼び出しパラメータ:

  • dataBuffer 、署名するデータを指定
  • 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;

呼び出しパラメータ:

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

結果を返す:

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

toString

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

1
String PKey.toString();

結果を返す:

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

toJSON

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

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

呼び出しパラメータ:

  • key :文字列、未使用

結果を返す:

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