Virgil E3Kit Flutter (Alpha)

Introduction | Features | Installation | Usage Examples | Samples | License | Docs | Support

Introduction

Virgil Security provides the E3Kit which simplifies work with Virgil Cloud and presents an easy-to-use API for adding a security layer to any application. In a few simple steps you can add end-to-end encryption with multidevice and group channels support.

The E3Kit allows developers to get up and running with Virgil API quickly and add full end-to-end security to their existing digital solutions to become HIPAA and GDPR compliant and more.

Features

• Strong end-to-end encryption with authorization
• One-to-one and group encryption
• Files and stream encryption*
• Recovery features for secret keys
• Strong secret keys storage, integration with Keychain
• Integration with any CPaaS providers like Nexmo, Firebase, Twilio, PubNub, etc.
• Public keys cache features*
• Access encrypted data from multiple user devices
• Easy setup and integration into new or existing projects
• One-to-one channel with perfect forward secrecy using the Double Ratchet algorithm*

* not available in the Flutter implementation yet.

About the Flutter implementation

Virgil E3Kit for Flutter is a wrapper of E3Kit for Swift/Objective-C and E3Kit for Android done via Platform Channels. Click the links to see details about the underlying implementations.

Installation

In the pubspec.yaml of your flutter project, add the following dependency:

dependencies:
  ...
  e3kit:
    git:
      url: git://github.com/cardoso/virgil-e3kit-flutter.git

PS: Flutter seems to create the iOS project with deployment target 8. Change it to 9. After that, you can run pod install in the iOS folder.

In your library add the following import:

import 'package:e3kit/e3kit.dart';

For help getting started with Flutter, view the online documentation.

Usage Examples

Register user

Use the following lines of code to authenticate user.

import 'package:e3kit/e3kit.dart';

// initialize E3Kit
final eThree = await EThree.init(identity, tokenCallback);
    
await eThree.register();

Encrypt & decrypt

Virgil E3Kit lets you use a user's Private Key and their Card to sign, then encrypt text.

import 'package:e3kit/e3kit.dart';

// TODO: init and register user (see Register User)

// prepare a message
final messageToEncrypt = "Hello, Alice and Den!"

// Search user's Cards to encrypt for
final users = await eThree.findUsers(['Alice', 'Den']);
final encryptedMessage = await eThree.encrypt(messageToEncrypt, users);

Decrypt and verify the signed & encrypted data using sender's public key and receiver's private key:

import 'package:e3kit/e3kit.dart';

// TODO: init and register user (see Register User)

// Find user
final users = await eThree.findUsers([bobUID]);
    
// Decrypt text and verify if it was really written by Bob
final originText = await eThree.decrypt(encryptedText, users[bobUID]);

Multidevice support

In order to enable multidevice support you need to backup Private Key. It will be encrypted with BrainKey generated from password and sent to Virgil Cloud.

await eThree.backupPrivateKey(userPassword)

After the private key is backed up you can use restorePrivateKey to load and decrypt the Private Key from Virgil Cloud.

await eThree.restorePrivateKey(userPassword)

Samples

You can find the sample application here:

Sample type
Basic Sample

You can run and study the demo to see how to initialize the SDK, register users and encrypt messages using E3Kit.

License

This library is released under the 3-clause BSD License.

Support

Our developer support team is here to help you. Find out more information on our Help Center.

You can find us on Twitter or send us email [email protected].

Also, get extra help from our support team on Slack.