Skip to content

Simply store secrets in OS secret stores for easy initial development security.

License

Notifications You must be signed in to change notification settings

infamousjoeg/conceal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

  • 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

Buy me a coffee

Contributions

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

License

Apache 2.0