This is an old revision of the document!

secret-tool

Store and retrieve passwords from the keyring.

Description

From man secret-tool

Each password is stored in an item. Items are uniquely identified by a set of attribute keys and values. When storing a password you must specify unique pairs of attributes names and values, and when looking up a password you provide the same attribute name and value pairs.

Install

apt

Install using apt:
```
sudo apt install libsecret-tools
```

Usage

Flags:
- --label = Mainly for GUI programs but can be used to retrieve a given secret.
- {attribute} = Used by the secret-tool for retrieving or deleting a given secret.
- {value} = Used by the secret-tool for retrieving or deleting a given secret.

Add an entry:

secret-tool store --label='My Label' {attribute} {value} {attribute2} {value2} [...]

Retrieve a password:

secret-tool lookup {attribute} {value} {attribute2} {value2} [...]

Show entries with similar key/values:

secret-tool search --all {attribute} {value} {attribute2} {value2} [...]

Delete an entry:

secret-tool clear {attribute} {value} {attribute2} {value2} [...]

Searching

Generic Formatting Example:

secret-tool search --all {attribute} {value} [...]

Search Title:
```
secret-tool search --all Title name
```
Search UserName:
```
secret-tool search --all UserName name
```

Search URL:

secret-tool search --all URL https://www.url.com

Search Notes:
```
secret-tool search --all Notes value
```

Tips

Set an alias in ~/.bash_aliases:

alias get_password1='secret-tool lookup {attribute} {value} {attribute2} {value2}'

Use in docker: https://www.marian-dan.ro/blog/storing-secrets-using-secret-tool/

Chuck Nemeth

Table of Contents