arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Windows Credential Manager

Store and Retrieve Secrets from the Windows Credential Manager

hashtag
Overview

Windows Credential Manager is a native Windows utility that stores sensitive information, such as passwords and secrets, and allows applications to securely access it.

Keeper provides a utility, the Windows Credential Utility, that interacts with native windows APIs to store and retrieve secrets from the Windows Credential Manager. It can be used by any integration, plugin, or code base to store and retrieve credentials, secrets, and passwords in the Windows Credential Manager simply and natively.

The code base for the Windows Credential Utility can be found here:

The binary needed to use the above utility can be found here:

To use the Windows Credential Utility, you can either

  • deploy the pre-built binary from the

  • or import it into your code base.

Both use cases are covered below.

hashtag
Usage - Executable

hashtag
Downloading the Executable

Download the latest version executable from the and optionally add it to PATH to get started.

hashtag
Using the Executable

The executable supports two commands:

  1. set

  2. get

Both commands require an application name (i.e. the name of the credential in / to be stored in the Windows Credential Manager) as the first argument.

hashtag
set

set requires a second argument of the secret to be stored. This can be either a:

  1. BASE64 string

  2. JSON string

  3. Path to an existing JSON file

When the secret is saved to Windows Credential Manager it is first encoded into a BASE64 format (if not already a BASE64 string). This standardizes the format for both consistent storage and to make it easier to consume by Keeper integrations and products.

hashtag
get

get returns the stored BASE64 encoded config to stdout and exits with a 0 exit code. The requesting integration can capture the output for consumption. Any errors encountered retrieving the config will return an non-zero exit code and write to stderr.

hashtag
Example

releases pagearrow-up-right
releases pagearrow-up-right
# Save a secret
wcu set APPNAME eyJ1c2VybmFtZSI6ICJnb2xsdW0iLCAicGFzc3dvcmQiOiAiTXlQcmVjaW91cyJ9
# or
wcu set APPNAME config.json

# Retrieve a secret
wcu get APPNAME
GitHub - Keeper-Security/windows-credential-utility: A utility for natively interacting with Windows Credential ManagerGitHubchevron-right
Logo
Releases · Keeper-Security/windows-credential-utilityGitHubchevron-right
Logo