This package is only compatible with Node at this time.
npm i @squirrelchat/opaque-wasm-serveryarn add @squirrelchat/opaque-wasm-serverpnpm add @squirrelchat/opaque-wasm-server
Usage
Startup
import { Server } from '@squirrelchat/opaque-wasm-server'// Create a server// -> First timeconst server = new Server()console.log(server.getState()) // <Uint8Array ...>// ~> Save this somewhere super safe!// -> Future timesconst state = ... // Get from secure storageconst server = new Server(state)// The state MUST be stored and restored, otherwise// logging in will not work after a server restart.
Registration
const username = ... // <~ value sent by the clientconst request = ... // <~ value sent by the clienttry { const response = server.startRegistration(username, request) console.log(response) // <Uint8Array ...> // ~> send this to the client} catch (e) { console.error('Could not start registration!', e)}// ---const username = ... // <~ value sent by the clientconst record = ... // <~ value sent by the clienttry { const credentials = server.finishRegistration
Login
const username = ... // <~ value sent by the clientconst request = ... // <~ value sent by the client// A note on account enumeration:// The OPAQUE protocol protects against account enumeration// by design during authentication. To achieve this, you must// engage in the protocol even if the account does not exists.// opaque-wasm and the underlying lib does this by using a fake// random record when no record is specified.try { const { response, state } = server.startLogin(username, request, row?.credentials) console.log(state) // <Uint8Array ...> // Store this somewhere SAFE, you'll need it to finalize the login. // Do NOT send it to the client! console.log(response) // <Uint8Array ...> // ~> send this to the client} catch (e) { console.
(record)
console.log(credentials) // <Uint8Array ...>
// Store this on disk, and tada!
} catch (e) {
console.error('Could not finalize registration!', e)
}
error
(
'Could not start authentication!'
, e)
}
// ---
const authentication = ... // <~ value sent by the client