Skip to content
This repository has been archived by the owner on Jan 15, 2024. It is now read-only.

autocrypt/autocrypt-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

autocrypt-js

A minimal Node.js implementation of the Autocrypt specification, that has no dependencies.

npm Travis Test coverage

npm install autocrypt

API

var autocrypt = new Autocrypt(opts)

Options include:

  • storage: the storage to use for internal state. Must implement get and put methods. ({get(fromEmail, cb), put(fromEmail, data, cb)})
  • dir: the directory for storing the internal state.

autocrypt.processHeader(header, fromEmail, dateSent, cb)

Parse the email yourself and pass in the autocrypt header, from email, and date sent.

  • header: String of the text after Autocrypt: or an object with all parsed autocrypt headers.
  • fromEmail: String.
  • dateSent: Date object.

autocrypt.generateAutocryptHeader(fromEmail, cb)

Generate a string Autocrypt header given the email. fromEmail must reference a user that has been added with the addUser method.

autocrypt.recommendation(fromEmail, toEmail, cb)

Generate an autocrypt UI recommendation given the from email and to email. fromEmail must reference a user that has been added with the addUser method.

autocrypt.addUser(fromEmail, key, opts, cb)

Add a user to autocrypt. This should be done for all new accounts. key should be base64 encoding

  • opts:
    • prefer-encrypt: mutual or nopreference. Defaults to nopreference.

autocrypt._put(fromEmail, opts, cb)

Update a user in autocrypt.

autocrypt.getUser(fromEmail, cb)

Get a user who has been added to autocrypt. Returns an error in the callback if no user has been added with that email.

Static Methods

Autocrypt.stringify(header)

Turn an object into an Autocrypt MIME string for use in an email header.

var header = Autocrypt.stringify({
  keydata: <base64-encoded-string>,
  addr: 'myemail@myuniversity.edu',
  'prefer-encrypt': 'mutual'
})

You can also pass the Autocrypt base-64 encoded keydata directly.

var header = Autocrypt.stringify({
  keydata: 'pYEWY0RSAEER1+gQRtZECyyww67....',
  addr: 'myemail@myuniversity.edu',
  'prefer-encrypt': 'mutual'
})

A value of type=1 is automatically added to the header if not supplied, since at this time Autocrypt only supports type=1.

Autocrypt.parse(header)

Turn an Autocrypt MIME string into an object. Opposite of Autocrypt.stringify.

var data = Autocrypt.parse('type=1;addr=myemail@myuniversity.edu;prefer-encrypt=mutual;keydata=Li4u;')

License

MIT