jpake

    1.0.1 • Public • Published

    JPAKE

    This library allows 2 parties to generate a mutual secret key using a weak key that is known to each other beforehand. This provides a simple API over an implementation of Password Authenticated Key Exchange by Juggling (J-PAKE) based on elliptic curves (currently secp2561k).

    This protocol is derived from the J-PAKE paper and relevant RFC.

    Try it out here, see detailed implementation details with all the (simplified) gory math here and a companion project in golang compatible with this library here

    Install

    npm install --save jpake

    Quick Start

    <html>
    <script src="https://cdn.jsdelivr.net/gh/choonkiatlee/jpake-js/dist/jpake.js"></script>
    <!-- or use the ES6 import as: import {jpake} from 'jpake' -->
    
    <script>
    var secret = "Hello World!"
    
    // Initialise a new JPake Object
    var pakeA = new jpake.JPake(secret)
    var pakeB = new jpake.JPake(secret)
    
    // Generate the 1st message to kick off the PAKE Exchange
    const msgA1 = pakeA.GetRound1Message()
    const msgB1 = pakeB.GetRound1Message()
    
    // Round 1 exchange
    const msgA2 = pakeA.GetRound2Message(msgB1)
    const msgB2 = pakeB.GetRound2Message(msgA1)
    
    // Round 2 exchange. both A and B now have a secure shared key
    const keyA = pakeA.ComputeSharedKey(msgB2)
    const keyB = pakeB.ComputeSharedKey(msgA2)
    
    console.log ("Exchange Complete!")
    console.log (`\nAlice key: ${keyA}`)
    console.log (`Bob key: ${keyB}`)
    </script>
    </html>

    Security and Implementation notes

    This library uses native Javascript BigInts, which does not protect against timing attacks. Do not allow attackers to measure how long it takes you to create or respond to a message. We currently do not implement the final step of verifying the shared keys generated between Alice and Bob are the same. This step is optional as per the RFC specs, and we will work on adding it in the future.

    Keywords

    none

    Install

    npm i jpake

    DownloadsWeekly Downloads

    1

    Version

    1.0.1

    License

    MIT

    Unpacked Size

    300 kB

    Total Files

    12

    Last publish

    Collaborators

    • choonkiatlee