Skip to content
Official Angular webclient for the CTemplar secure (end-to-end encrypted) email service.
TypeScript HTML CSS JavaScript
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Oct 24, 2019
dist Release v1.2.12 Nov 14, 2019
docs/images DEV-467 update documentation images Dec 14, 2018
e2e Angular rebuild and port Mar 27, 2018
src
.gitignore DAS-467 add release version v1.1.10 with checksum Dec 13, 2018
.travis.yml Add travis ci file Sep 14, 2018
LICENCE Add license file Aug 7, 2018
README.md DEV-1010 Update Readme Sep 6, 2019
angular.json DEV-1110 Add CNAME for github pages deployment Oct 25, 2019
karma.conf.js DEV-525 upgrade to Angular 7 :: Update core dependencies Jan 31, 2019
package-lock.json
package.json fix build issue Nov 8, 2019
protractor.conf.js Initial commit Dec 20, 2017
tsconfig.json DEV-633 Fix Quill editor issues due to migration Jun 8, 2019
tslint.json Update to angular version 8 Jun 8, 2019
webpack.config.js DEV-525 fix keyboard, crypto and translation issues Feb 1, 2019

README.md

CTemplar

Build Status

Official Angular cross-platform client for the CTemplar secure email service.

Prerequisites

This project was generated with Angular CLI version 1.7.3 and upgraded to 8.3.3.

  • Node (v12.4.0 or higher)
  • Angular CLI
    npm install -g @angular/cli@8.3.3
    

Installation

npm install

Usage

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Protractor.

Security

CTemplar uses bcrypt.js and OpenPGP.js for hashing and encryption.

Hash Password

CTemplar hashes every password before sending it to server for authentication or sign-up purposes. A unique salt is created from user's Username which is then used to hash the password using bcrypt.hashSync(password, salt) method.

Encryption

CTemplar encrypts and decrypts contents of every email using user's public/private key pair which is generated during sign up process.

  • Public/Private Key pair is generated by openpgp.generateKey method using user's plain password as passphrase.
    const options = {
      userIds: [{ name: username, email: 'username@ctemplar.com' }],
      numBits: 4096,
      passphrase: password
    };
    openpgp.generateKey(options);
    
  • Mail contents are encrypted by openpgp.encrypt method using receiver's Public Key.
    const options = {
        data: content,
        publicKeys: openpgp.key.readArmored(publicKey).keys
    };
    openpgp.encrypt(options);
    
  • Mail contents are decrypted by openpgp.decrypt method using user's Private Key.
    let decryptedPrivateKey = openpgp.key.readArmored(privateKey).keys[0];
    decryptedPrivateKey.decrypt(passphrase);
    
    const options = {
        message: openpgp.message.readArmored(encryptedContent),
        privateKeys: [decryptedPrivateKey]
    };
    openpgp.decrypt(options);
    

Transparent build code

We host our build code publicly on github and we also provide the details on how to match checksum of code on github and the one we serve on our website. Find the details of build and how to calculate checksum here : https://github.com/CTemplar/webclient/tree/master/dist

Contribution

This project is still in early phase so bug reports via Issues and Pull Requests are welcome.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.

License

Apache License 2.0

You can’t perform that action at this time.