PowerShell Plugin
Utilize PowerShell's Secret Management module to access secrets with the Keeper Secrets Manager PowerShell Plugin
Last updated
Was this helpful?
Utilize PowerShell's Secret Management module to access secrets with the Keeper Secrets Manager PowerShell Plugin
Last updated
Was this helpful?
Retrieve secrets from the Keeper Vault to use in PowerShell
Integrate Keeper vault with PowerShell Secrets Manager
Update secret values in the Keeper Vault from PowerShell
Get files from the Keeper vault
This page documents the Secrets Manager PowerShell integration. In order to utilize this integration, you will need:
Secrets Manager requires PowerShell version 6 or greater. Microsoft distributes PowerShell version 6+ as a separate application from versions 5 and earlier.
PowerShell Version 6.0 or later
Secrets Manager addon enabled for your Keeper account
Membership in a Role with the Secrets Manager enforcement policy enabled
The Keeper Secrets Manager PowerShell plugin utilizes Microsoft PowerShell's Secret Management module to inject secrets from the Keeper Vault into your PowerShell scripts.
The Keeper Secrets Manager extension can be easily configured added as a secret vault into new or existing PowerShell Secret Management workflows.
Keeper Secrets Manager uses the Microsoft.PowerShell.SecretManagement module to manage secrets in PowerShell.
Install using PowerShell:
Install the Keeper Secrets Manager PowerShell extension from the PowerShell Gallery.
The Keeper Secrets Manager PowerShell plugin will need a secret management extension to store the plugin configuration locally to your machine.
Register a secret vault for the previously installed secret management extension, so that the Keeper Secrets Manager plugin configuration can be stored.
The name of this vault will be used to register the Keeper extension. We used LocalStore
in this example.
The Secret Management extension that you use for local storage may ask you to create a password for securely accessing the local vault.
Depending on your system settings, you may need to allow PowerShell to trust external modules. To do this, run the command:
set-executionpolicy remotesigned
Register the Keeper Secrets Manager Vault using the local vault registered above to save your credentials, and a one time token to connect to Keeper.
Replace 'XXX' below with a one time token.
Alternatively you can use already generated config - replace 'XXX' below with a base64 encoded config.
Set the Keeper vault you just added as the default secret storage. This will tell the PowerShell SecretsManagement module to use your Keeper vault when getting and setting secrets.
This step is optional, but if you choose not to do it, you may receive secrets from your default vault if they have the same name, and you will need to add -Vault <keeper vault name>
(e.g. -Vault keeper
) to Get-Secret, Set-Secret
commands
The Keeper Secrets Manager PowerShell Plugin is now ready to be used
Find descriptions and examples of the most common usage of the Keeper Secrets Manager PowerShell plugin below.
Starting with version 16.6.6 Get/Set
commands allow use of \
as and escape character for dots in title. Use escape character only if there's dot in title, and escape both .
and \
(ex. \.
, \\
)
Run the following PowerShell command to see a list of secrets from Keeper
Use the name set for your Keeper secrets vault, in the examples above we use Keeper
.
The secrets shown are any records shared with the Secrets Manager Application. The Name column displays each record's UID and title.
Get information and values of a single secret
Wrap the record name in quotation marks when there is a space in it.
Update the value of a single secret field
Use dot notation to specify a file attached to a secret in the Keeper vault. Then pass that file to the Set-Content
command to download it.
The specified file will be downloaded to the path location given to Set-Content
For a complete list of Keeper Secrets Manager features see the
See for installation details
See for installation details
Keeper Secrets Manager access (See the for more details)
A Keeper with secrets shared to it
See the for instructions on creating an Application
For more information about PowerShell Secret Management, see the on their GitHub page.
See for other installation options
See the for more installation options, or find the source code in .
Keeper recommends or
Find the Keeper Secrets Manager PowerShell Plugin source code in the .
For more information about PowerShell Secret Management commands, see the on their GitHub page.
Utilize to identify a field to access. Note that you do not need the 'keeper://' prefix.