Integration examples of encryption SDKs

Overview · Prerequisites · Start the server · Run examples · Documentation · License

Overview

Tanker is an open-source client SDK that can be embedded in any application.

It leverages powerful client-side encryption of any type of data, textual or binary, but without performance loss and assuring a seamless end-user experience. No cryptographic skills are required.

This repository features example applications using the JavaScript, iOS, and Android encryption SDKs.

Prerequisites

Setup

bash

sudo apt update -y && sudo apt upgrade -y

sudo apt install nodejs

Check your Node.js and Yarn versions, and upgrade if needed:

node -v  # >= 10   (maintained version, not eol)
yarn -v  # >= 1.0  (workspaces support)

We recommend using yarn rather than npm, as it will manage the dependencies of all the applications for you from the root of the repository.

Install the project

Clone this repository:

git clone https://github.com/TankerHQ/quickstart-examples.git

Install all dependencies at once:

cd quickstart-examples && yarn

Create a Tanker App

Use the dashboard and follow the instructions. No account yet? Contact us to get access at https://tanker.io/contact.

Since you are just testing Tanker within demo applications, feel free to enable the test mode.

Once you use Tanker in real production applications, it is imperative to create a new application without activating the test mode.

Configure

Take the JSON configuration file from the previous step and copy it under the config/ folder. Add an authToken key containing the value of the authorization token in the "API credentials" section of the dashboard.

Note that the JSON configuration file can have any name ending with the .json extension and must have the following format:

// e.g. config/app.json
{
    "appId": "...",
    "appSecret": "...",
    "authToken": "..."
}

That's all you need to start the server and applications!

Start the example server

Start the example server in a terminal with:

yarn start:server

The example server provides applications with:

• a mock auth system
• an endpoint to retrieve user tokens as needed by the Tanker SDK
• a couple of routes to upload/download user data

You may also provide the path of a config file explicitely:

yarn start:server --config <path>

Run example applications

Note: before running any of the example applications, don't forget to always start the server first!

Go to the homepage of the example server in your browser:

http://127.0.0.1:8080/

On this page, you will find all the instructions needed to run the example applications.

Documentation

For more details and to go beyond the example applications, please refer to:

• SDK implementation guide
• API reference
• Product overview

License

The Tanker iOS SDK is licensed under the Apache License, version 2.0.