https://github.com/umran/tcp-sms-auth

a simple mobile device authentication scheme over ip and sms
https://github.com/umran/tcp-sms-auth

Last synced: 2 days ago
JSON representation

a simple mobile device authentication scheme over ip and sms

• Host: GitHub
• URL: https://github.com/umran/tcp-sms-auth
• Owner: umran
• License: mit
• Created: 2017-03-16T03:18:03.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-04-08T23:36:24.000Z (over 7 years ago)
• Last Synced: 2024-11-07T05:26:29.961Z (about 2 months ago)
• Language: JavaScript
• Homepage:
• Size: 61.5 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# tcp-sms-auth

A simple mobile device authentication scheme over tcp and sms originally defined at https://saltwatercynic.com/an-sms-authentication-scheme-using-elliptic-curve-diffie-hellman/

### Dependencies

This library requires the javascript port of TweetNaCl: https://github.com/dchest/tweetnacl-js

### Usage and Code Example

The following example is a test script ('tests/protocol.js') and demonstrates the steps involved in the authentication process. Although the client and server identity keys in this example are created on the fly, in an actual implementation these are supposed to be long-lived, that is to say that they must be preserved for as long as the server and client are to remain authenticated. Furthermore, the cache and storage classes included in this example are mere placeholders. In a potential implementation please make sure the storage and cache classes have the methods defined in this example.

A messaging layer, which this library does not provide, is required to actually send the messages between the server and client. This applies to both the sms and tcp layers.

```js

var primitives = require('../src/crypto_primitives')

var Cache = require('../src/cache')

var Store = require('../src/store')

var ProtocolClient = require('../src/protocol_client')

var ProtocolServer = require('../src/protocol_server')

var clientIdKeys = primitives.genSigningKeys()

var serverIdKeys = primitives.genSigningKeys()

var serverCache = new Cache()

var serverStore = new Store()

var client = new ProtocolClient(clientIdKeys)

var server = new ProtocolServer(serverIdKeys, serverCache, serverStore)

// client initiates the protocol - the only argument is the client's phone number

var initiateObject = client.initiate('7012345')

// server responds with a challenge - returns a challengeObject which contains an sms message object and an tcp message object

var challengeObject = server.challenge(initiateObject)

// client calls back with a response - the arguments are the tcp message object received from the server and the challenge code received via sms (as a hex string)

var responseObject = client.respond(challengeObject.http, challengeObject.sms.challenge)

// server terminates the protocol upon response

var terminationObject = server.terminate(responseObject)

// log all messages

console.log(initiateObject)

console.log(challengeObject)

console.log(responseObject)

console.log(terminationObject)

```