Delinea / Thycotic Secret Server Import
Automatic migration of your Delinea (Thycotic) Secret Server vault
Secret Server Import
This document outlines the process for automatically and seamlessly migrating Secret Server (Delinea/Thycotic) data into Keeper which includes private folders, shared folders, permissions, file attachments, TOTP codes. This process utilizes the Secret Server API to automate the process.
Note: A basic import capability is available on the Keeper Web Vault and Desktop App which supports Thycotic XML format. Visit the vault Settings > Import > Thycotic screen. The XML format does not include attachments or permissions. Therefore, we recommend using the automated method as described in this document.
Make sure Webservices are enabled
In Secret Server admin settings, ensure Webservices are enabled
Admin -> Configuration -> Edit -> Enable Webservices
Secret Server Configuration
In Secret Server admin settings, ensure that "Session Timeout for Webservices" is set to a high enough value, since large vaults will take time to process. For example, 59 minutes.
Step 1. Download Team and Shared Folder Structure
In Keeper Commander, the Keeper/Thycotic Administrator will run the following:
Prior to running the above code snippet, make sure to:
Verify the base Thycotic URL in your browser
The Username is in the correct format:
If it's a AD user, the format is
DOMAIN\username
otherwiseusername
Executing the above code snippet will perform the following 3 functions:
Download all Shared Folder information
Download Team Membership
Download Shared Folder permissions
This step downloads a file locally called "shared_folder_membership.json" which contains the team and shared folder structure.
Keeper does not yet support folders within shared folders that have different permissions than the parent.
download-membership
command provides an option --sub-folder
to control how these folders are imported.
--sub-folder=ignore
preserves folder structure. Folder permissions are ignored.
--sub-folder=flatten
folder will be moved to the root folder of the Keeper vault as its own shared folder.
Step 2. Import Shared Folders
Before importing records, we will first create the shared folder structure on the Keeper side. Run the below command:
Step 3. Export TOTP Codes
The TOTP codes stored in Thycotic/Delinea Secret Server can only be retrieved by manually downloading a CSV file. The admin of Secret Server needs to go to Secret Server > Export Secrets and select the following options:
Export Type: Export All
Export Folder Path: Checked
Export TOTP Settings: Checked
Export Format: CSV
Export the file and save it to your home folder, or the folder where Keeper Commander is running. The file will be called "secrets-export.csv" by default.
Step 4. Import the Secret Server Vault
In Keeper Commander, the Keeper/Thycotic Administrator will run the following command to perform the import of data using the Secret Server API:
This command will take several minutes (or more) to complete, depending on the number of vault records and users. A large Secret Server instance could take 20 minutes or more.
Commander will attempt to build the same folder structure as Secret Server in the admin's Keeper vault.
Commander will also look for the file "secrets-export.csv" in the user's home folder or current Commander folder, for the purpose of importing TOTP codes.
Note 1: This command will import and populate regular folders, shared folders and records within the folders. This will NOT import the private folders of other users within Secret Server. This step will only import the information available to the admin.
Note 2: If a Shared Folder is found within another shared folder with different permission, the shared folder will be moved to the root folder (since Keeper does not support subfolder permissions).
Step 5. Apply Membership Permissions
In Keeper Commander, the Keeper/Thycotic Administrator will run the following:
This will read the file called "shared_folder_membership.json" from Step 1 and apply the shared folder permissions for any users and team which exist in the Keeper enterprise environment. This command is safe to run over and over again, and it will not generate duplicates.
Explanation: When users are invited/created through SSO or your invitation process, their public keys are created. Therefore, Keeper cannot apply membership until the users exist.
For this reason, the Keeper Admin needs to run the "apply-membership" command on a daily basis, hourly, or on demand, when users are created in Keeper.
Step 6. End-Users are invited to Keeper
The Keeper Admin will invite users through one of the following methods:
Just-in-time provisioning through SSO login
Invite through the Admin Console
SCIM
When the user registers to create their vault, they will generate a public/private key pair. At this point, they will be able to receive shared folders, as outlined in the next step.
Receiving Shared Folders
The next time that the Admin runs the apply-membership
command, any new Keeper users will receive access to their Shared Folders.
Due to the number of steps, we recommend performing a pilot test with a few users before rolling out to the entire organization.
If you have any questions please email commander@keepersecurity.com.
Last updated