https://github.com/square/keywhiz

A system for distributing and managing secrets
https://github.com/square/keywhiz

crypto enterprise-software keywhiz manage-secrets secret-distribution secret-management secrets secrets-management

Last synced: about 1 month ago
JSON representation

A system for distributing and managing secrets

• Host: GitHub
• URL: https://github.com/square/keywhiz
• Owner: square
• License: apache-2.0
• Archived: true
• Created: 2015-03-25T13:31:39.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2023-09-18T18:01:03.000Z (about 1 year ago)
• Last Synced: 2024-09-21T15:50:30.406Z (about 1 month ago)
• Topics: crypto, enterprise-software, keywhiz, manage-secrets, secret-distribution, secret-management, secrets, secrets-management
• Language: Java
• Homepage: https://square.github.io/keywhiz/
• Size: 5.68 MB
• Stars: 2,618
• Watchers: 60
• Forks: 218
• Open Issues: 46
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

• awesome - keywhiz - A system for distributing and managing secrets (Java)
• awesome-repositories - square/keywhiz - A system for distributing and managing secrets (Java)
• awesome-java-security - Keywhiz - System for distributing and managing secrets. (Cryptography)

README

        
# Deprecated

**As of 9/18/23 this project is now deprecated and no longer maintained; we recommend using HashiCorp Vault as a more robust and actively supported alternative.**

# Keywhiz

[![license](https://img.shields.io/badge/license-apache_2.0-red.svg?style=flat)](https://raw.githubusercontent.com/square/keywhiz/master/LICENSE)

[![maven](https://img.shields.io/maven-central/v/com.squareup.keywhiz/keywhiz-server.svg)](https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.squareup.keywhiz%22)

[![build](https://img.shields.io/travis/square/keywhiz/master.svg?style=flat)](https://travis-ci.org/square/keywhiz)

Keywhiz is a system for distributing and managing secrets.

For more information, see the [website][1].

Our [Protecting infrastructure secrets with Keywhiz][2] blog post is worth

reading, as it provides some useful context.

## Develop

Keywhiz requires Java 11 and MySQL 5.7 or higher.

See [CONTRIBUTING](CONTRIBUTING.md) for details on submitting patches.

Build Keywhiz:

    mvn install

Run Keywhiz:

    java -jar server/target/keywhiz-server-*-shaded.jar [COMMAND] [OPTIONS]

Useful commands to get started are `migrate`, `add-user` and `server`. Use with

`--help` for a list of all available commands. Use with `[COMMAND] --help` to

get help on a particular command.

For example, to run Keywhiz with a mysql database in development mode:

    SERVER_JAR="server/target/keywhiz-server-*-shaded.jar"

    KEYWHIZ_CONFIG="server/target/classes/keywhiz-development.yaml"

    # Initialize dev database

    java -jar $SERVER_JAR migrate $KEYWHIZ_CONFIG

    # Add an administrative user

    java -jar $SERVER_JAR add-user $KEYWHIZ_CONFIG

    # Run server

    java -jar $SERVER_JAR server $KEYWHIZ_CONFIG

To connect to a running Keywhiz instance, you will need to use the CLI.

An example helper shell script that wraps the keywhiz-cli and sets some default parameters:

    #!/bin/sh

    # Set the path to a compiled, shaded keywhiz-cli JAR file

    KEYWHIZ_CLI_JAR="/path/to/keywhiz-cli-shaded.jar"

    KEYWHIZ_SERVER_URL="https://$(hostname):4444"

    # Use these flags if you want to specify a non-standard CA trust store.

    # Alternatively, in development and testing specify the --devTrustStore 

    # flag to use the default truststore (DO NOT use this in production, as

    # the truststore is checked into Keywhiz' code).

    TRUSTSTORE="-Djavax.net.ssl.trustStore=/path/to/ca-bundle.jceks"

    TRUSTTYPE="-Djavax.net.ssl.trustStoreType=JCEKS"

    java "$TRUSTSTORE" "$TRUSTTYPE" -jar "$KEYWHIZ_CLI_JAR" -U "$KEYWHIZ_SERVER_URL" "$@"

Keywhiz uses [jOOQ](http://www.jooq.org/) to talk to its database.

If you made changes to the database model and want to regenerate sources:

    mvn install -pl model/ -Pgenerate-jooq-sources

We recommend [IntelliJ IDEA](https://www.jetbrains.com/idea/) for development.

## IntelliJ IDEA

To enable auto-completion, code navigation, etc., open the `keywhiz` repository in IDEA, 

right click `pom.xml` in the repository root, and select "Add as Maven Project".

## Clients & API

Square also maintains a Keywhiz client implementation called [Keysync](https://github.com/square/keysync).

## Docker

We ship a [Dockerfile](Dockerfile) for building a Docker container for Keywhiz.

Please see the Dockerfile for extra instructions.

## License

Keywhiz is under the Apache 2.0 license. See the [LICENSE](LICENSE) file for details.

[1]: https://square.github.io/keywhiz

[2]: https://developer.squareup.com/blog/protecting-infrastructure-secrets-with-keywhiz