conceal

Conceal

Conceal is a command-line utility that eases the interaction between developer and OSX Keychain Access. It is the open-source companion to Summon as every secret added using this tool into Keychain is added using Summon-compliant formatting.

Table of Contents

• Requirements
• Installation
  • Homebrew (MacOS)
  • Manual
• Usage
  • Add a secret
  • List Summon secrets
  • Remove a secret
  • Display Help
  • Display Version
• Maintainer
• Contributions
• License

Requirements

• MacOS

Installation

Homebrew (MacOS)

brew tap infamousjoeg/tap
brew install conceal

Manual

1. Download the latest release available at GitHub Releases.
2. Move the conceal executable file to a directory in your PATH. (I use ~/bin.)
3. In Terminal, run the following command to make sure it's in your PATH:
   $ conceal -v

Usage

Add a secret

$ conceal dockerhub/token

or

$ conceal -a dockerhub/token

To add a secret to Keychain, call conceal and use the -a argument to pass the account name to add. You will be immediately prompted to provide a secret value in a secure manner.

List Summon secrets

$ conceal -l

To list all secrets associated with Summon in Keychain, call conceal and use the -l argument to list all accounts present.

To filter the list further, pipe to grep like this $ conceal -l | grep dockerhub/.

Remove a secret

$ conceal -a dockerhub/token -r

To remove a secret that was added for Summon, call conceal and use the -a argument to pass the account name to remove. The additional -r argument tells conceal to remove the secret instead of add.

Display Help

$ conceal

To display the help message, just call conceal with no arguments.

Display Version

$ conceal -v

To display the current version, call conceal with the -v argument.

Maintainer

@infamousjoeg

Contributions

Pull Requests are currently being accepted. Please read and follow the guidelines laid out in CONTRIBUTING.md.

License

Apache 2.0