Create a ticket
Sign in Sign up
Locker support Locker support

No results found.

Home Locker Secrets Manager Guideline: Remove leaked secrets from source code
Vietnamese English
Guideline: Remove leaked secrets from source code

Version 01

Storing sensitive data directly in source code (secrets hardcoding) is a security vulnerability. If the source code is accidentally exposed or through server file-read attacks, these secrets can be collected by attackers, leading to unauthorized access to related systems.

Therefore, it is crucial to avoid this insecure storage method during software development. Below are the steps to safely detect and remove secrets from your project's source code using Locker Secrets Manager.


Installing Locker CLI

For Windows

Start-Process powershell -Verb runAs
New-Item -Path "$HOME\.locker" -ItemType Directory -Force
Invoke-WebRequest -Uri " " -OutFile "$HOME\.locker\locker.exe"
$oldPath = [System.Environment]::GetEnvironmentVariable("Path", [System.EnvironmentVariableTarget]::Machine)
$newPath = "$oldPath;$HOME\.locker"
[System.Environment]::SetEnvironmentVariable("Path", $newPath, [System.EnvironmentVariableTarget]::Machine)

For Linux

mkdir -p ~/.locker
wget -O ~/.locker/locker
chmod +x ~/.locker/locker
sudo ln -sf ~/.locker/locker /usr/local/bin/locker

For macOS


mkdir -p ~/.locker
wget -O ~/.locker/locker
chmod +x ~/.locker/locker
sudo ln -sf ~/.locker/locker /usr/local/bin/locker


mkdir -p ~/.locker
wget -O ~/.locker/locker
chmod +x ~/.locker/locker
sudo ln -sf ~/.locker/locker /usr/local/bin/locker

Detecting secrets in the project

Use the scan command below:

locker scan --source <path-to-source-code>

You will obtain results as shown below, including:

  • Path to the file containing secrets
  • Found secret value
  • Line number containing the secret
  • Type of secret
  • Commit hash
Notion image

Implementing secure secret storage

Following the scan results, it is essential to adopt a more secure method of storing secrets, rather than hardcoding them.

Setting up your project with Locker Secrets

  • Create a Locker Secrets account here if you don't have one.
  • Create a new project corresponding to the one containing your secrets.
  • Generate an Access Key within the project; this key pair will be used with the Locker SDK in subsequent steps.

Handling secrets stored in source code

For a small number of hardcoded secrets, you can manually update them using the following steps:

  • Add the hardcoded secrets to your newly created Locker Secrets project via the web interface.
  • Install the Secrets SDK for your programming language here.
  • Initialize the SDK Config object using the Access Key and Secret Access Key generated earlier.
  • Manually locate the hardcoded secrets in your source code and replace them with calls to the SDK to retrieve the securely stored secrets.
Note: The automatic secrets update feature is currently being developed and will be available in future versions.

Example with Python

Suppose you have a file with hardcoded secrets as follows:

# ...
  "database": {
    "host": "",
    "port": 3306,
    "username": "my_database",
    "password": "Ol1PPgsG4htlBb0q7THJP7nWyBJXbAJg"
  "request": {
    "access_key_id": "ak29NASAs",
    "secret_token": "qHg34VAGQZwCkUy4UjZQAsCVeH6TvsJg"

# ...

The Locker CLI has detected hardcoded secrets in the lines mentioned

"password": "Ol1PPgsG4htlBb0q7THJP7nWyBJXbAJg"
"secret_token": "qHg34VAGQZwCkUy4UjZQAsCVeH6TvsJg"

Create the corresponding secrets in your Locker Project via the web interface.


Install the Locker Secret SDK and replace the hardcoded secrets with SDK usage.



Store your previously generated Locker Access Key pair as environment variables.






Command Prompt


Proceed to declare and initialize the Locker Secret Manager object.

import os
from locker import Locker

client = Locker(

Replace the hardcoded values by using the SDK to call variables at the locations where your secrets are exposed.

from secret_management import client
# ...
  "database": {
    "host": "",
    "port": 3306,
    "username": "my_database",
    "password": client.get("DATABASE_PASSWORD"),
  "request": {
    "access_key_id": "ak29NASAs",
    "secret_token": client.get("REQUEST_SECRET_TOKEN")
# ...

For secrets stored in environment variable files

  • Assess the necessity of the environment variable file for your project. If unnecessary, proceed to delete this file.
  • If your project requires secrets from the environment variable file, configure Locker with the generated Access Key pair using the command:
locker configuration --access-key-id {access key id} --secret-access-key {secret access key}
  • Save the secret to the Locker Secret Vault using the command locker secret create:
locker secret create --key {secret key} --value {secret value} --description {secret description (optional)} --environment {secret environment (if the secret is associated with a specific environment)}
  • Use the command locker secret run to execute the project with the saved secrets:
locker secret run --environment dev --command your_command

The locker run command will inject the secrets from a specified environment (previously stored on Locker Secret) as environment variables into your program execution command.

  • Remove the secrets stored in your environment variable file.

For secrets stored in configuration files

This feature is currently under development by the team and will be rolled out to users in the shortest time possible.

Removing secrets from the Git repository

Unlike typical file organization on computers, Git is a software with a version-based file storage and complex data organization mechanism. Therefore, if you delete or change the content of a file, it simply removes and changes it in the current version, while the content still exists in previous versions and can be accessed through git commit.

For sensitive and confidential data, complete removal requires deleting all related git commit history of the file containing that data. There are 2 main methods for this:

  • BFG Repo-Cleaner (short for BFG) is a tool used to rewrite commit history with similar functionality to git filter-branch but much faster, up to 10-720 times.

The following guide will perform with BFG


  • To run BFG, you need to have Java installed on your computer. Please download and install Java corresponding to your operating system, if Java is not installed already.

Using BFG to remove secrets

  • Before running BFG, create a backup for your project to prevent data loss in case of errors.
  • Clone the repository to your machine using the --mirror flag. This will give us the full git index and metadata of the project without needing actual data.
    • git clone --mirror
  • Remove the file containing secrets throughout the commit history.
    • java -jar bfg.jar <file_name> some-big-repo.git
  • Clear the repository's trash.
    • cd some-big-repo.git
      git reflog expire --expire=now --all && git gc --prune=now --aggressive
Was this page helpful?
Join Our Community