env-keystore

Creates KeyStore and TrustStore from environment variables

License

License

MIT
Categories

Categories

KeY Data Data Formats Formal Verification Heroku Container PaaS Providers
GroupId

GroupId

com.heroku.sdk
ArtifactId

ArtifactId

env-keystore
Last Version

Last Version

1.1.6
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/heroku/env-keystore
Source Code Management

Source Code Management

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

Download env-keystore

How to add to project

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

Dependencies

compile (1)

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

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>
</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!"))
  )
);
com.heroku.sdk

Heroku

Versions

Version
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0