The Tor Browser / file comparison
comparison: services/crypto/component/nsISyncJPAKE.idl
services/crypto/component/nsISyncJPAKE.idl
- branch
- TOR_BUG_3246
- changeset 5
- 4ab42b5ab56c
equal
deleted
inserted
replaced
| -1:000000000000 | 0:051e3fd07e11 |
|---|---|
| 1 /* This Source Code Form is subject to the terms of the Mozilla Public | |
| 2 * License, v. 2.0. If a copy of the MPL was not distributed with this | |
| 3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ | |
| 4 | |
| 5 #include "nsISupports.idl" | |
| 6 | |
| 7 [scriptable, uuid(5ab02a98-5122-4b90-93cd-f259c4b42e3a)] | |
| 8 interface nsISyncJPAKE : nsISupports | |
| 9 { | |
| 10 /** | |
| 11 * Perform first round of the JPAKE exchange. | |
| 12 * | |
| 13 * @param aSignerID | |
| 14 * String identifying the signer. | |
| 15 * @param aGX1 | |
| 16 * Schnorr signature value g^x1, in hex representation. | |
| 17 * @param aGV1 | |
| 18 * Schnorr signature value g^v1 (v1 is a random value), in hex | |
| 19 * representation. | |
| 20 * @param aR1 | |
| 21 * Schnorr signature value r1 = v1 - x1 * h, in hex representation. | |
| 22 * @param aGX2 | |
| 23 * Schnorr signature value g^x2, in hex representation. | |
| 24 * @param aGV2 | |
| 25 * Schnorr signature value g^v2 (v2 is a random value), in hex | |
| 26 * representation. | |
| 27 * @param aR2 | |
| 28 * Schnorr signature value r2 = v2 - x2 * h, in hex representation. | |
| 29 */ | |
| 30 void round1(in ACString aSignerID, | |
| 31 out ACString aGX1, | |
| 32 out ACString aGV1, | |
| 33 out ACString aR1, | |
| 34 out ACString aGX2, | |
| 35 out ACString aGV2, | |
| 36 out ACString aR2); | |
| 37 | |
| 38 /** | |
| 39 * Perform second round of the JPAKE exchange. | |
| 40 * | |
| 41 * @param aPeerID | |
| 42 * String identifying the peer. | |
| 43 * @param aPIN | |
| 44 * String containing the weak secret (PIN). | |
| 45 * @param aGX3 | |
| 46 * Schnorr signature value g^x3, in hex representation. | |
| 47 * @param aGV3 | |
| 48 * Schnorr signature value g^v3 (v3 is a random value), in hex | |
| 49 * representation. | |
| 50 * @param aR3 | |
| 51 * Schnorr signature value r3 = v3 - x3 * h, in hex representation. | |
| 52 * @param aGX4 | |
| 53 * Schnorr signature value g^x4, in hex representation. | |
| 54 * @param aGV4 | |
| 55 * Schnorr signature value g^v4 (v4 is a random value), in hex | |
| 56 * representation. | |
| 57 * @param aR4 | |
| 58 * Schnorr signature value r4 = v4 - x4 * h, in hex representation. | |
| 59 * @param aA | |
| 60 * Schnorr signature value A, in hex representation. | |
| 61 * @param aGVA | |
| 62 * Schnorr signature value g^va (va is a random value), in hex | |
| 63 * representation. | |
| 64 * @param aRA | |
| 65 * Schnorr signature value ra = va - xa * h, in hex representation. | |
| 66 */ | |
| 67 void round2(in ACString aPeerID, | |
| 68 in ACString aPIN, | |
| 69 in ACString aGX3, | |
| 70 in ACString aGV3, | |
| 71 in ACString aR3, | |
| 72 in ACString aGX4, | |
| 73 in ACString aGV4, | |
| 74 in ACString aR4, | |
| 75 out ACString aA, | |
| 76 out ACString aGVA, | |
| 77 out ACString aRA); | |
| 78 | |
| 79 /** | |
| 80 * Perform the final step of the JPAKE exchange. This will compute | |
| 81 * the key and expand the key to two keys, an AES256 encryption key | |
| 82 * and a 256 bit HMAC key. It returns a key confirmation value | |
| 83 * (SHA256d of the key) and the encryption and HMAC keys. | |
| 84 * | |
| 85 * @param aB | |
| 86 * Schnorr signature value B, in hex representation. | |
| 87 * @param aGVB | |
| 88 * Schnorr signature value g^vb (vb is a random value), in hex | |
| 89 * representation. | |
| 90 * @param aRB | |
| 91 * Schnorr signature value rb = vb - xb * h, in hex representation. | |
| 92 * @param aAES256Key | |
| 93 * The AES 256 encryption key, in base64 representation. | |
| 94 * @param aHMAC256Key | |
| 95 * The 256 bit HMAC key, in base64 representation. | |
| 96 */ | |
| 97 void final(in ACString aB, | |
| 98 in ACString aGVB, | |
| 99 in ACString aRB, | |
| 100 in ACString aHkdfInfo, | |
| 101 out ACString aAES256Key, | |
| 102 out ACString aHMAC256Key); | |
| 103 }; |
