使用 require(‘crypto‘)
来调用该模块。
crypto模块提供在HTTPS或HTTP连接中封装安全凭证的方法。
它提供OpenSSL中的一系列哈希方法,包括hmac、cipher、decipher、签名和验证等方法的封装。
示例:
var ciphers = crypto.getCiphers();
console.log(ciphers); // [‘AES-128-CBC‘, ‘AES-128-CBC-HMAC-SHA1‘, ...]
示例:
var hashes = crypto.getHashes();
console.log(hashes); // [‘sha‘, ‘sha1‘, ‘sha1WithRSAEncryption‘, ...]
pfx
: 一个字符串或者buffer对象,代表经PFX或者PKCS12编码产生的私钥、证书以及CA证书key
: 一个字符串,代表经PEM编码产生的私钥passphrase
: 私钥或者pfx的密码cert
: 一个字符串,代表经PEM编码产生的证书ca
: 一个字符串或者字符串数组,表示可信任的经PEM编码产生的CA证书列表crl
: 一个字符串或者字符串数组,表示经PEM编码产生的CRL(证书吊销列表 Certificate Revocation List)ciphers
: 一个字符串,表示需要使用或者排除的加密算法 可以在http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT 查看更多关于加密算法格式的资料。ca
,node.js会使用http://mxr.mozilla.org/mozilla/source/security/nss/lib/ckfw/builtins/certdata.txt提供的公共可信任的CA列表。
algorithm
取决与平台上所安装的
OpenSSL 版本所支持的算法。比如‘sha1‘
、‘md5‘
、‘sha256‘
、‘sha512‘
等等。在最近的发行版本中,openssl
list-message-digest-algorithms
会显示可用的摘要算法。
示例:这段程序会计算出一个文件的
sha1 摘要值。
var filename = process.argv[2];
var crypto = require(‘crypto‘);
var fs = require(‘fs‘);
var shasum = crypto.createHash(‘sha1‘);
var s = fs.ReadStream(filename);
s.on(‘data‘, function(d) {
shasum.update(d);
});
s.on(‘end‘, function() {
var d = shasum.digest(‘hex‘);
console.log(d + ‘ ‘ + filename);
});
它是一个既可读又可写的流。所写入的数据会被用作计算哈希。当流的可写端终止后,使用 read()
方法来获取计算得的哈希摘要。同时也支持旧有的 update
和 digest
方法。
通过 crypto.createHash
返回。
input_encoding
指定编码为‘utf8‘
、‘ascii‘
或者 ‘binary‘
。如果没有指定编码,将作为二进制数据(buffer)处理。因为它是流式数据,所以可以使用不同的数据调用很多次。
encoding
可以是‘hex‘
、‘binary‘
或者‘base64‘
,如果没有指定,会返回一个buffer对象。注意:hash
对象在 digest()
方法被调用后将不可用。
它是一个既可读又可写的流(stream)。写入的数据会被用于计算hmac。写入终止后,可以使用read()
方法获取计算后的摘要值。之前版本的update
和digest
方法仍然支持。
algorithm
在OpenSSL支持的算法列表中被抛弃了——见上方createHash部分。key
是hmac算法用到的密钥。
由crypto.createHmac
返回。
encoding
可以是‘hex‘
、‘binary‘
或者‘base64‘
,如果没有指定,会返回一个buffer对象。注意: hmac
对象在调用digest()
之后就不再可用了。
algorithm
算法是依赖OpenSSL库的,
例如: ‘aes192‘
算法等。在最近发布的版本,
执行命令 openssl list-cipher-algorithms
就会显示出所有可用的加密算法,password
是用来派生key和IV的,它必须是一个‘binary‘
2进制格式的字符串或者是一个buffer。
它是一个既可读又可写的流。所写入的数据会被用作计算哈希。当流的可写端终止后,使用 read()
方法来获取计算得的哈希摘要。同时也支持旧有的 update
和 digest
方法。
algorithm
算法和createCipher()
方法的参数相同. key
密钥是一个被算法使用的原始密钥,iv
是一个初始化向量。
key
密钥和iv
向量必须是‘binary‘
2进制格式的字符串或buffers。
这个类由 crypto.createCipher
和 crypto.createCipheriv
返回。
Cipher加密对象是 streams,他是具有
readable 可读和 writable 可写的。写入的纯文本数据是用来在可读流一侧加密数据的。 以前版本的update
和final
方法也还是支持的。
data
参数更新cipher加密对象,
它的编码input_encoding
必须是下列给定编码的 ‘utf8‘
, ‘ascii‘
or‘binary‘
中一种。如果没有编码参数,那么打他参数必须是一个buffer。参数 output_encoding
输出编码指定了加密数据的输出格式,可以是‘binary‘
, ‘base64‘
或者‘hex‘
,如果没有提供这个参数,buffer将会返回。
返回加密内容,并且Returns
the enciphered contents, 用新数据作为流的话,它可以被调用多次。
output_encoding
为‘binary‘
, ‘base64‘
或 ‘hex‘
中的任意一个。
如果没有提供编码格式,则返回一个buffer对象。注意:
调用final()
函数后cipher
对象不能被使用。
auto_padding
是false,
那么整个输入数据的长度必须是加密器的块大小的整倍数,否则final
会失败。这对非标准的填充很有用,例如使用0x0
而不是PKCS的填充。这个函数必须在cipher.final
之前调用。
根据给定的算法和密钥,创建并返回一个解密器对象。这是上述createCipher()的一个镜像。
根据给定的算法,密钥和初始化向量,创建并返回一个解密器对象。这是上述createCipheriv()的一个镜像。
由crypto.createDecipher
和crypto.createDecipheriv
返回。
解密器对象是可读写的流对象。用被写入的加密数据生成可读的平文数据。解码器对象也支持The
legacy update
和 final
函数。
data
来更新解密器,其中data
以‘binary‘
, ‘base64‘
或 ‘hex‘
进行编码。如果没有指明编码方式,则默认data
是一个buffer对象。output_decoding
指明了用以下哪种编码方式返回解密后的平文:‘binary‘
, ‘ascii‘
或 ‘utf8‘
。如果没有指明编码方式,则返回一个buffer对象。
output_encoding
为‘binary‘
, ‘ascii‘
或 ‘utf8‘
中的任意一个。如果没有指明编码方式,则返回一个buffer对象。注意:
调用final()
函数后不能使用decipher
对象。
decipher.final
对数据进行检查和移除。这只有在输入数据的长度是加密器块大小的整倍数时才有效。这个函数必须在将数据流传递给decipher.update
之前调用。
openssl
list-public-key-algorithms
会列出可用的签名算法,例如‘RSA-SHA256‘
。
由crypto.createSign
返回。
Sign对象是可写的流对象。被写入的数据用来生成数字签名。当所有的数据都被写入后,sign
函数会返回数字签名。Sign对象也支持The
legacy update
函数。
data
来更新sign对象。新数据是以流的形式时可调用多次。
private_key
是一个包含了签名私钥的字符串,而该私钥是用PEM编码的。返回一个数字签名,该签名的格式可以是‘binary‘
, ‘hex‘
或 ‘base64‘
.
如果没有指明编码方式,则返回一个buffer对象。
注意:调用sign()
后不能使用sign
对象。
由 crypto.createVerify
返回。
验证器对象是可写的流对象.
被写入的数据会被用来验证提供的数字签名。在所有的数据被写入后,如果提供的数字签名有效,verify
函数会返回真。验证器对象也支持
The legacy update
函数。
object
和signature
来验证被签名的数据。 object
是一个字符串,这个字符串包含了一个被PEM编码的对象,这个对象可以是RSA公钥,DSA公钥或者X.509
证书。 signature
是之前计算出来的数字签名,其中的signature_format
可以是‘binary‘
, ‘hex‘
或 ‘base64‘
.
如果没有指明编码方式,那么默认是一个buffer对象。根据数字签名对于数据和公钥的有效性,返回true或false。
注意:
调用verify()
函数后不能使用verifier
对象。
创建一个迪菲-赫尔曼密钥交换(Diffie-Hellman key exchange)对象,并根据给定的位长度生成一个质数。所用的生成器是2。
2
。编码方式可以是‘binary‘
, ‘hex‘
或 ‘base64‘
。如果没有指明编码方式,则默认是一个buffer对象。
由crypto.createDiffieHellman
返回。
‘binary‘
, ‘hex‘
或 ‘base64‘
.
如果没有指明编码方式,则返回一个buffer对象。
other_public_key
作为第三方公钥来计算共享秘密,并返回这个共享秘密。参数中的密钥会以input_encoding
编码方式来解读,而共享密钥则会用output_encoding
进行编码。编码方式可以是‘binary‘
,‘hex‘
或 ‘base64‘
。如果没有提供输入的编码方式,则默认为一个buffer对象。如果没有指明输出的编码方式,则返回一个buffer对象。
‘binary‘
, ‘hex‘
或‘base64‘
。如果没有指明编码方式,则返回一个buffer对象。
‘binary‘
, ‘hex‘
或‘base64‘
。如果没有指明编码方式,则返回一个buffer对象。
‘binary‘
, ‘hex‘
或‘base64‘
。
如果没有指明编码方式,则返回一个buffer对象。
‘binary‘
, ‘hex‘
或‘base64‘
。如果没有指明编码方式,则返回一个buffer对象。
‘binary‘
, ‘hex‘
或 ‘base64‘
。如果没有指明编码方式,则返回一个buffer对象。
‘binary‘
, ‘hex‘
或 ‘base64‘
。如果没有指明编码方式,则返回一个buffer对象。
‘modp1‘
,‘modp2‘
, ‘modp5‘
(在RFC
2412中定义) 和 ‘modp14‘
, ‘modp15‘
, ‘modp16‘
, ‘modp17‘
, ‘modp18‘
(在 RFC
3526中定义)。返回的对象模仿了上述 crypto.createDiffieHellman()方法所创建的对象的接口,但不会晕允许密钥交换
(例如像 diffieHellman.setPublicKey()那样)。执行这套流程的好处是双方不需要事先生成或交换组余数,节省了处理和通信时间。示例(获取一个共享秘密):
var crypto = require(‘crypto‘);
var alice = crypto.getDiffieHellman(‘modp5‘);
var bob = crypto.getDiffieHellman(‘modp5‘);
alice.generateKeys();
bob.generateKeys();
var alice_secret = alice.computeSecret(bob.getPublicKey(), null, ‘hex‘);
var bob_secret = bob.computeSecret(alice.getPublicKey(), null, ‘hex‘);
/* alice_secret and bob_secret should be the same */
console.log(alice_secret == bob_secret);
(err,
derivedKey)
。
// async
crypto.randomBytes(256, function(ex, buf) {
if (ex) throw ex;
console.log(‘Have %d bytes of random data: %s‘, buf.length, buf);
});
// sync
try {
var buf = crypto.randomBytes(256);
console.log(‘Have %d bytes of random data: %s‘, buf.length, buf);
} catch (ex) {
// handle error
// most likely, entropy sources are drained
}
注意:
将抛出错误或调用回调有错误,如果没有足够的积累了熵产生强加密的数据。换句话说,crypto.randombytes没有回调不会阻止即使所有的熵源排放。
用法与 crypto.randomBytes
一模一样。
‘buffer‘
,所以默认使用Buffer对象。这是为了让crypto模块与默认‘binary‘
为编码方式的遗留程序更容易兼容。要注意,新的程序会期待buffer对象,所以使用这个时请只作为暂时的手段。
因为这样,与流有关的类中并没有其它Node类的典型函数,而且很多函数接受和返回默认的二进制编码的字符串,而不是Buffer对象。在最近的修改中,这些函数都被改成默认使用Buffer对象。
这对于某些(但不是全部)使用场景来讲是重大的改变。
例如,如果你现在使用Sign类的默认参数,然后在没有检查数据的情况下,将结果传递给Verify类,那么程序会照常工作。在以前,你会拿到一个二进制字符串,然后它传递给Verify对象;而现在,你会得到一个Buffer对象,然后把它传递给Verify对象。
但是,如果你以前是使用那些在Buffer对象上不能正常工作的字符串数据,或者以默认编码方式将二进制数据传递给加密函数的话,那你就要开始提供编码方式参数来指明你想使用的编码方式了。如果想准换回旧的风格默认使用二进制字符串,那么你需要把crypto.DEFAULT_ENCODING
字段设为‘binary‘。但请注意,因为新的程序很可能会期望buffer对象,所以仅将此当做临时手段。
原文地址:http://blog.csdn.net/livialiu1234/article/details/40053163