CipherDB Developer's Guide - Java

In this guide we will quickly cover how you can integrate CipherDB into your Java application.

Adding the Crypteron Agent via Maven

The first step in securing your data is adding the dependency for CipherDB to the pom.xml in your Maven project:

<dependency>
  <groupId>com.crypteron</groupId>
  <artifactId>cipherdb-agent-hibernate5</artifactId>
  <version>2016.8.1.1</version>
</dependency>

Make sure to check back for new versions often since each new release gets even better!

Adding the App Secret to your application

After adding the dependency, let’s take a look at the changes to our persistence.xml. The first of these changes is the “appSecret,” which secures all communications with our API. Add the following property to your src/main/resources/META-INF/persistence.xml:

<persistence-unit>
  <properties>
  ...
    <property name="crypteron.appSecret" value=Replace_this_with_app_secret_from_https://my.crypteron.com />
  ...
  </properties>
</persistence-unit

To retrieve the app secret, go to my.crypteron.com and login to your account.

Crypteron Java - Login

Once logged in, select the application you previously created and select the “Show” button next to “App Secret” to display the app secret. Next, copy the app secret to your clipboard and replace the placeholder value in the persistence.xml and save the changes.

Crypteron Java - AppSecret

Secure your data model

The final step in securing your data in your Java application will be to tell CipherDB which data to secure. In the event entity, simply add “@Secure” to any attribute to apply encryption. Finally, run the Maven Build for a clean install. Now, if you take a look at your database file in your filesystem, the attributes to which you added “@Secure” are now totally encrypted and appear as useless strings of data.

Crypteron Java - Secure Data Model

Congratulations!

You've just secured your Java Application with CipherDB, bringing high-end data security to your entire application in minutes without spending months and years building and maintaining custom code. Feel free to contact us via support if you have any additional questions.

Recent blog posts

Migrating existing live data into Crypteron

You’re already live in production. And you have sensitive in the clear. Read this article to see how Crypteron can help.

Encryption, Entity Framework and Projections

Projections in Entity Framework live outside the entity lifecycle. Read more to learn how your can use Crypteron to secure such data.

PCI DSS and key rotations simplified

PCI compliance requires data encryption keys to be changed frequently. Here is how you can do it easily.

Your data-center is not secure and what you can do about it

There is no secure perimeter anymore. Neither in your corporate network nor in your data center. Fight a winning battle armed with self-protecting data rather than a losing one trying to protecting the infrastructure.

Introducing the Crypteron Startup Innovators Program

Qualifying startups get up to 50% off all plans. Tell us how you’re changing the world and the our Startup Innovators Program will support your journey.

6 encryption mistakes that lead to data breaches

If encryption is so unbreakable, why do businesses and governments keep getting hacked? Six common encryption mistakes that lead to data breaches.

Announcing the new Crypteron Community Edition

Starting today you can now sign up for the Crypteron Community Edition for free with no performance limitations.

Data breach response – One click to save your business

Get breathing room – when you need it the most. Respond to a data breach with a single click.

Why We Need Proper Data-At-Rest Encryption: 191M U.S. Voters’ Data Exposed

Adding security at the application level is a large step forward in protecting data from the constant threat of data breaches

How to encrypt large files

CipherStor is blazingly fast! Here we show how to use it within your data-flow pipeline to maintain high performance when encrypting large files.