tylersouthwick / cerberus-java-client

Java Client for Cerberus

Cerberus Client

This is a Java based client library for Cerberus that is built on top of Nike's Cerberus client.

This library acts as a wrapper around the Nike developed Cerberus client by configuring the client to be Cerberus compatible.

To learn more about Cerberus, please see the Cerberus website.

Quickstart for Cerberus Java Client

1. Add the Cerberus client dependency to your build (e.g. Maven, Gradle).
2. Access secrets from Cerberus using Java.

    String cerberusUrl = "https://cerberus.example.com";
    String region = "us-west-2";
    CerberusClient cerberusClient = DefaultCerberusClientFactory.getClient(cerberusUrl, region);
    Map<String,String> secrets = cerberusClient.read("/app/my-sdb-name").getData();

Check out "Working with AWS Credentials" for more information on how the AWS SDK for Java loads credentials.

Development

Run Integration Tests

First, make sure the following environment variables are set before running the Java Client integration tests:

    export CERBERUS_ADDR=https://example.cerberus.com
    export TEST_REGION=us-west-2

Then, make sure AWS credentials have been obtained. One method is by running gimme-aws-creds:

    gimme-aws-creds

Next, in the project directory run:

    ./gradlew integration

License

Cerberus client is released under the Apache License, Version 2.0.