env-keystore

Creates KeyStore and TrustStore from environment variables

License

License

MIT
Categories

Categories

KeY Data Data Formats Formal Verification
GroupId

GroupId

com.github.jkutner
ArtifactId

ArtifactId

env-keystore
Last Version

Last Version

0.1.3
Release Date

Release Date

Type

Type

jar
Description

Description

env-keystore
Creates KeyStore and TrustStore from environment variables
Project URL

Project URL

https://github.com/jkutner/env-keystore
Source Code Management

Source Code Management

https://github.com/jkutner/env-keystore

Download env-keystore

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.jkutner/env-keystore/ -->
<dependency>
    <groupId>com.github.jkutner</groupId>
    <artifactId>env-keystore</artifactId>
    <version>0.1.3</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.jkutner/env-keystore/
implementation 'com.github.jkutner:env-keystore:0.1.3'
// https://jarcasting.com/artifacts/com.github.jkutner/env-keystore/
implementation ("com.github.jkutner:env-keystore:0.1.3")
'com.github.jkutner:env-keystore:jar:0.1.3'
<dependency org="com.github.jkutner" name="env-keystore" rev="0.1.3">
  <artifact name="env-keystore" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.jkutner', module='env-keystore', version='0.1.3')
)
libraryDependencies += "com.github.jkutner" % "env-keystore" % "0.1.3"
[com.github.jkutner/env-keystore "0.1.3"]

Dependencies

compile (1)

Group / Artifact Type Version
org.bouncycastle : bcpkix-jdk15on jar 1.54

Project Modules

There are no modules declared in this project.

EnvKeyStore Build Status Maven Central

A Java library to create KeyStore and TrustStore objects in memory from environment variables.

Usage

Include this library in your application as a Maven depenency:

<dependency>
  <groupId>com.heroku.sdk</groupId>
  <artifactId>env-keystore</artifactId>
  <version>1.0.0</version>
</dependency>

Creating a TrustStore

Creating a TrustStore requires that the certificate PEM be set as an environment variable. You pass that environment variable name to the EnvKeyStore.create method:

KeyStore ts = EnvKeyStore.createWithRandomPassword("TRUSTED_CERT").keyStore();

You can use the KeyStore like any other. For example, you might invoke a service with the trusted cert:

String tmfAlgorithm = TrustManagerFactory.getDefaultAlgorithm();
TrustManagerFactory tmf = TrustManagerFactory.getInstance(tmfAlgorithm);
tmf.init(ts);

SSLContext sc = SSLContext.getInstance("TLS");
sc.init(null, tmf.getTrustManagers(), new SecureRandom());
HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());

String urlStr = "https://ssl.selfsigned.xyz";
URL url = new URL(urlStr);
HttpsURLConnection con = (HttpsURLConnection)url.openConnection();
con.setDoInput(true);
con.setRequestMethod("GET");
con.getInputStream().close();

Creating a KeyStore

Creating a KeyStore requires that the key, certificate and password are all set as environment variables. You pass the environment variable names to the EnvKeyStore.create method:

KeyStore ks = EnvKeyStore.create("KEYSTORE_KEY", "KEYSTORE_CERT", "KEYSTORE_PASSWORD").keyStore();

You can use the KeyStore like any other. But you might also want to convert it to an input stream. For example, you might start a Ratpack server:

EnvKeyStore eks = EnvKeyStore.create("KEYSTORE_KEY", "KEYSTORE_CERT", "KEYSTORE_PASSWORD");

RatpackServer.start(s -> s
  .serverConfig(c -> {
    c.ssl(SSLContexts.sslContext(eks.toInputStream(), eks.password()));
  })
  .handlers(chain -> chain
    .all(ctx -> ctx.render("Hello!"))
  )
);

Versions

Version
0.1.3
0.1.2
0.1.1
0.1.0