https://github.com/JustinGrote/SecretManagement.KeePass

https://github.com/JustinGrote/SecretManagement.KeePass

Last synced: 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/JustinGrote/SecretManagement.KeePass
• Owner: JustinGrote
• License: mit
• Created: 2020-09-22T22:21:04.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-08-14T14:11:58.000Z (6 months ago)
• Last Synced: 2024-11-12T01:19:34.627Z (3 months ago)
• Language: PowerShell
• Size: 2.51 MB
• Stars: 116
• Watchers: 9
• Forks: 24
• Open Issues: 17
• Metadata Files:
  • Readme: README.MD
  • License: LICENSE

Awesome Lists containing this project

• awesome-keepass - KeePass Secret Management Extension for PowerShell - An (Clients / Extensions clients)

README

        
# KeePass Secret Management Extension

## Actions

[![Actions][]][ActionsLink]

## Summary

This is a simple proof-of-concept using a modified version of PoshKeePass to allow for cross platform usage.

![KeePass SecretManagement Demo](./images/KeePassSecretManagementDemo.gif)

## Quick Start

1. Create a keepass database with a master password, Keyfile or both.

1. `Install-Module SecretManagement.KeePass`

1. Run the following command:

    ```powershell

    Register-SecretVault -Name 'testVault' -ModuleName 'SecretManagement.Keepass' -VaultParameters @{

        Path = "path/to/my/vault.kdbx"

        UseMasterPassword = $true

        KeyPath= "path/to/my/keyfile.key"

    }

    ```

1. (optional) Use Test-SecretVault to validate your connection to the vault

    ```powershell

    Test-SecretVault -Name 'testVault'

    ```

2. Get the secret data using Get-Secret

    ```powershell

    Get-Secret -Name 'My secret entry 1' -Vault 'testVault'

    ```

## Known Limitations

[Actions]: https://github.com/JustinGrote/SecretManagement.KeePass/workflows/Test/badge.svg?branch=main

[ActionsLink]: https://github.com/JustinGrote/SecretManagement.KeePass/workflows