1 | // Copyright 2015 Joyent, Inc.
|
---|
2 |
|
---|
3 | var assert = require('assert-plus');
|
---|
4 | var crypto = require('crypto');
|
---|
5 | var sshpk = require('sshpk');
|
---|
6 | var utils = require('./utils');
|
---|
7 |
|
---|
8 | var HASH_ALGOS = utils.HASH_ALGOS;
|
---|
9 | var PK_ALGOS = utils.PK_ALGOS;
|
---|
10 | var InvalidAlgorithmError = utils.InvalidAlgorithmError;
|
---|
11 | var HttpSignatureError = utils.HttpSignatureError;
|
---|
12 | var validateAlgorithm = utils.validateAlgorithm;
|
---|
13 |
|
---|
14 | ///--- Exported API
|
---|
15 |
|
---|
16 | module.exports = {
|
---|
17 | /**
|
---|
18 | * Verify RSA/DSA signature against public key. You are expected to pass in
|
---|
19 | * an object that was returned from `parse()`.
|
---|
20 | *
|
---|
21 | * @param {Object} parsedSignature the object you got from `parse`.
|
---|
22 | * @param {String} pubkey RSA/DSA private key PEM.
|
---|
23 | * @return {Boolean} true if valid, false otherwise.
|
---|
24 | * @throws {TypeError} if you pass in bad arguments.
|
---|
25 | * @throws {InvalidAlgorithmError}
|
---|
26 | */
|
---|
27 | verifySignature: function verifySignature(parsedSignature, pubkey) {
|
---|
28 | assert.object(parsedSignature, 'parsedSignature');
|
---|
29 | if (typeof (pubkey) === 'string' || Buffer.isBuffer(pubkey))
|
---|
30 | pubkey = sshpk.parseKey(pubkey);
|
---|
31 | assert.ok(sshpk.Key.isKey(pubkey, [1, 1]), 'pubkey must be a sshpk.Key');
|
---|
32 |
|
---|
33 | var alg = validateAlgorithm(parsedSignature.algorithm);
|
---|
34 | if (alg[0] === 'hmac' || alg[0] !== pubkey.type)
|
---|
35 | return (false);
|
---|
36 |
|
---|
37 | var v = pubkey.createVerify(alg[1]);
|
---|
38 | v.update(parsedSignature.signingString);
|
---|
39 | return (v.verify(parsedSignature.params.signature, 'base64'));
|
---|
40 | },
|
---|
41 |
|
---|
42 | /**
|
---|
43 | * Verify HMAC against shared secret. You are expected to pass in an object
|
---|
44 | * that was returned from `parse()`.
|
---|
45 | *
|
---|
46 | * @param {Object} parsedSignature the object you got from `parse`.
|
---|
47 | * @param {String} secret HMAC shared secret.
|
---|
48 | * @return {Boolean} true if valid, false otherwise.
|
---|
49 | * @throws {TypeError} if you pass in bad arguments.
|
---|
50 | * @throws {InvalidAlgorithmError}
|
---|
51 | */
|
---|
52 | verifyHMAC: function verifyHMAC(parsedSignature, secret) {
|
---|
53 | assert.object(parsedSignature, 'parsedHMAC');
|
---|
54 | assert.string(secret, 'secret');
|
---|
55 |
|
---|
56 | var alg = validateAlgorithm(parsedSignature.algorithm);
|
---|
57 | if (alg[0] !== 'hmac')
|
---|
58 | return (false);
|
---|
59 |
|
---|
60 | var hashAlg = alg[1].toUpperCase();
|
---|
61 |
|
---|
62 | var hmac = crypto.createHmac(hashAlg, secret);
|
---|
63 | hmac.update(parsedSignature.signingString);
|
---|
64 |
|
---|
65 | /*
|
---|
66 | * Now double-hash to avoid leaking timing information - there's
|
---|
67 | * no easy constant-time compare in JS, so we use this approach
|
---|
68 | * instead. See for more info:
|
---|
69 | * https://www.isecpartners.com/blog/2011/february/double-hmac-
|
---|
70 | * verification.aspx
|
---|
71 | */
|
---|
72 | var h1 = crypto.createHmac(hashAlg, secret);
|
---|
73 | h1.update(hmac.digest());
|
---|
74 | h1 = h1.digest();
|
---|
75 | var h2 = crypto.createHmac(hashAlg, secret);
|
---|
76 | h2.update(new Buffer(parsedSignature.params.signature, 'base64'));
|
---|
77 | h2 = h2.digest();
|
---|
78 |
|
---|
79 | /* Node 0.8 returns strings from .digest(). */
|
---|
80 | if (typeof (h1) === 'string')
|
---|
81 | return (h1 === h2);
|
---|
82 | /* And node 0.10 lacks the .equals() method on Buffers. */
|
---|
83 | if (Buffer.isBuffer(h1) && !h1.equals)
|
---|
84 | return (h1.toString('binary') === h2.toString('binary'));
|
---|
85 |
|
---|
86 | return (h1.equals(h2));
|
---|
87 | }
|
---|
88 | };
|
---|