Skip to content

README.md

Latest commit

 

History

History
66 lines (47 loc) · 2.03 KB

README.md

File metadata and controls

66 lines (47 loc) · 2.03 KB

About

Simple container secret shell drivers.

The drivers implement secrets/shelldriver/shelldriver.go. See man podman-secret-create for more details.

Drivers

  • secret-tool => uses the session keyring to store container secrets for rootless containers
  • skate => uses charmbracelet/skate and gpg to store encrypted secrets locally (respects XDG standards)
  • systemd-creds => uses systemd-creds to store encrypted secrets locally backed by TPM 2.0 or host keys

Install Example:

git clone https://github.com/sabedevops/ContainerSecrets.git
cd ContainerSecrets

# For secret-tool
cp ./drivers/secret-tool.sh $HOME/.local/bin/container-secrets-driver-secret-tool.sh

# For skate
cp ./drivers/skate.sh $HOME/.local/bin/container-secrets-driver-skate.sh

# For systemd-creds
cp ./drivers/systemd-creds.sh $HOME/.local/bin/container-secrets-driver-systemd-creds.sh

Add to $XDG_CONFIG_HOME/containers/containers.conf:

Example for secret-tool

[secrets]
driver = "shell"

[secrets.opts]
list = "$HOME/.local/bin/container-secrets-driver-secret-tool.sh list"
lookup = "$HOME/.local/bin/container-secrets-driver-secret-tool.sh lookup"
store = "$HOME/.local/bin/container-secrets-driver-secret-tool.sh store"
delete = "$HOME/.local/bin/container-secrets-driver-secret-tool.sh delete"

Running with podman

# Option 1: Reading from file
printf 'mysecret' > ./secret.txt
podman secret create --driver shell 'SECRET_NAME' ./secret.txt

# Option 2: Reading from stdin
printf  'mysecret' | podman secret create --driver shell 'SECRET_NAME' -

# - OR -

echo -n 'mysecret' | podman secret create --driver shell 'SECRET_NAME' -

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines on how to add and test new drivers.