sectool

command module

v0.0.3 Latest Latest Go to latest Published: Sep 2, 2023 License: MIT Imports: 4 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/a13labs/sectool

Links

Open Source Insights

README ¶

sectool - Secure Tool for Managing SSH Key Pairs and Secrets

sectool is a command-line tool written in Go that provides a secure and user-friendly way to manage SSH key pairs and secrets stored in a local vault. This tool is built using the Cobra CLI framework and is released under the MIT license.

Features

Manage SSH key pairs: Add, delete, list, lock, and unlock SSH key pairs.
Manage secrets: Store and retrieve key-value secrets in a local vault.
Security: Encrypts stored secrets to ensure sensitive information remains secure.
Easy-to-use: Clear and intuitive commands for effortless management of keys and secrets.
Makefile: The included Makefile simplifies building, testing, and other tasks.

Installation

Before you begin, ensure you have Go installed on your system. You can install sectool using the following steps:

Clone this repository:

git clone https://github.com/your-username/sectool.git

Navigate to the project directory:
```
cd sectool
```
Build the tool using the Makefile:
```
make build
```
You should now have the sectool binary in the project's root directory. You can move it to a directory in your system's PATH to make it accessible from anywhere.

Usage

SSH Key Pair Management

The ssh command group allows you to manage your SSH key pairs.

To add a new SSH key pair:
```
sectool ssh add <key name>
```
To delete an existing SSH key pair:
```
sectool ssh del <key name>
```
To initialize SSH key pair management:
```
sectool ssh init <master password>
```
To list existing SSH key pairs:
```
sectool ssh list
```
To lock all SSH key pairs:
```
sectool ssh lock
```
To unlock all locked SSH key pairs:
```
sectool ssh unlock
```

Secrets Vault

The vault command group allows you to manage secrets stored in the local vault.

To add a new secret:
```
sectool vault set <key> <value>
```

To retrieve a secret:

sectool vault get <key> [-export] [-quoted]

To delete a secret:
```
sectool vault del <key>
```
To list all stored secrets:
```
sectool vault list
```

Contributing

Contributions to sectool are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request. See the Contribution Guidelines for more details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Documentation ¶

Overview ¶

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.