Contact Us
Help Center Home > VaultOne > VaultOne: Export a Connector Backup File

VaultOne: Export a Connector Backup File

VaultOne Connectors generate daily backup files (.bkp) after any changes made in your vault. These files are stored by the connector and can be crucial for recovering data in cases of connection unavailability. This guide explains how to export these backup files and convert them into a readable .json format.

Important: The converted .json file contains sensitive information, including passwords and resources. It is strongly advised to keep this file in a secure location and handle it with extreme care to prevent unauthorized access.

Prerequisites

To perform this process, you will need:

  • Access to your machine where the VaultOne Connector is installed
  • Root access to the machine
  • A decryption key. Instructions on how to generate and use this key can be found in the related article: "Password Backup."

Accessing the Connector’s Backup Directory

First, you need to access the VaultOne connector's environment and navigate to the backup directory.

  1. Access the machine that you installed your Connector.
  2. Execute the following command to access the vo-sync container as root:

docker exec -ti vo-sync bash

  1. Navigate to the backup directory:

cd backup

  1. List the .bkp files to see available backups:

Converting the .bkp File to .json

Once inside the backup directory, select the desired .bkp file and convert it.

  1. Choose the .bkp file you wish to convert.
  2. Execute the following command, replacing "FILE-NAME.BKP" with the actual name of your backup file and "CHOOSE-FILE-NAME.JSON" with your desired name for the JSON output file:

base64 -d /backup/"FILE-NAME.BKP" | openssl enc -d -aes-256-cbc -out "CHOOSE-FILE-NAME.JSON"

Note: After executing this command, you will be prompted to enter the decryption key. Provide the key obtained as per the "Password Backup" article.

Exporting the .json File to Your Host Machine

Finally, you will export the converted .json file from the connector's environment to your local machine's home directory.

  1. Exit the connector's environment: exit
  2. Execute the appropriate copy command:

docker cp vo-sync:/backup/"FILE-NAME.JSON" ./ (Replace "FILE-NAME.JSON" with the name you chose in Step 2.)

Once exported, the .json file will be in your current directory on the host machine. You can then view its contents using a JSON formatter website, like jsonformatter.curiousconcept.com or any text editor.

Back to Top

List IconIn this Article

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case