Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This topic article explains how to encrypt data using the in-place data transformation, which is also known as dataxform.  

At a high level, you will:  

  • Shut down the database software

  • Place a transformation policy in the directory

  • Implement

    encryption 

    encryption

  • Remove the transformation policy

  • Add the operational

    policy 

    policy

  • Restart the database software

     
Note

During this process, the database software will shut down, which means access to the files in the database will be prevented.

Note

Armor recommends that you use the Copy Method for encryption because this method:

  • Reduces the amount of time spent setting the customized Dataxform policy on the GuardPoints on the DSM

  • Prevents any user error when you enter the text command to rekey the data

  • Ensures that the encrypted files are accessible before you remove the non-encrypted / original files


Prerequisites Prerequisites

...

Before you begin, you must have:  

  • General understanding of the Vormetric product

  • Strong understanding of how to create GuardPoints in DSM

  • Strong

    undrestanding

    understanding of how to create policies in DSM

  • A production key available to use


Encrypt with Data Transform

...

  1. Log into your DSM as a Security Administrator.

  2. In the top menu bar,

...

  1. click Policies.

...

...

  1. Click Add Online Policies.

...

...

  1. For Name,

...

  1. enter DataXform_Policy.

...

  1. (Optional)

...

  1. For Description,

...

  1. enter In Place Data Transformation Policy.

...

...

  1. Under Security Rules,

...

  1. click Add.

...



  1. Image ModifiedImage Modified

    1. Next

...

    1. to Action,

...

    1. click Select.

...

    1. At the bottom of the table, next to

...

    1. the kep_op

...

    1. entry, mark the box.

...

...

    1. Click Select Actions. This step will populate

...

    1. the Action

...

    1. field with key_op.

      Image Modified

  1. Locate

...

  1. the Effect

...

  1. field.

...

...

    1. Click Select.

...

    1. Mark the box

...

    1. for Apply Key

...

    1. and Audit.

...

    1. Click Select Effect.

...



    1. Image Modified

    2. This will populate

...

    1. the Effect

...

    1. field.

...

...

    1. Click Ok

...

    1. to add the rule to the policy.

...



    1. Image Modified

  1. In

...

  1. the Add Online Policy

...

  1. screen,

...

  1. click Add

...

  1. to add a second rule.

...



  1. Image Modified

    1. This action will take you to

...

    1. the Add Security Rule

...

    1. screen.

...

    1. Next

...

    1. to Effect,

...

    1. click Select.

...

    1. Mark the box

...

    1. for Deny

...

    1. and Audit.

...

...

    1. Click Select Effect.

...

...

    1. Click Ok.

      Image Modified

  1. Under

...

  1. Key Section Rules,

...

  1. click Add.

...

    1. This action will take you to

...

    1. the Add Key Rule

...

    1. screen.

...


    1. Image Modified

    2. Next

...

    1. to Key,

...

    1. click Select.

...

    1. Mark the box

...

    1. for clear_key.

...

...

    1. Click Select Key.

...



    1. Image Modified

    2. In

...

    1. the Add Key Rule

...

    1. screen,

...

    1. click Ok.

...



    1. Image Modified

  1. Locate

...

  1. the Data Transformation Rules

...

  1. section.

...

...

    1. Click Add.

...

    1. Next

...

    1. to Key,

...

    1. click Select.

...



    1. Image Modified

    2. Mark the box for the production key.

...

...

    1. Click Select Key. This action will populate

...

    1. the Key

...

    1. field.

...



    1. Image Modified

...


    1. Click Ok. This action will display two rules.

      Image Modified
      Image Modified

  1. In the top menu bar,

...

  1. click Hosts.

...

...

  1. Under Host Name, select the host you want to encrypt.

...

    • Verify that no services or users are trying to access the intended GuardPoint. You can accomplish this by shutting down the database service, and then confirming that there are no users in the working directory.

...

  1. Click

...

  1. the Guard FS

...

  1. tab.

...



  1. Image Modified

  2. Click

...

  1. the Guard

...

  1. button.

...



  1. Image Modified

  2. In

...

  1. the Guard File System

...

  1. screen, click

...

  1. the Policy

...

  1. drop-down menu.

...

...

    1. Select DataXform_Policy.

...


    1. Image Modified

    2. Do not modify

...

    1. the Type

...

    1. field. This field should

...

    1. display Directory (Auto Guard).

...



    1. Image Modified

...


    1. Click Browse.

...



    1. Image Modified

  1. In the window that appears, expand the folder directory.

...


  1. Image Modified

  2. Locate and select the desired path that you want to protect.

...

  1. In the image below, the sample GuardPoint is: C:\Program Files\Microsoft SQL Server\MSSQL11.MSSQLSERVER\MSSQL\Log\

    1. Select the desired GuardPoint.

...

    1. Click Ok.

...


    1. Image Modified

  1. The GuardPoint you selected will populate

...

  1. the Path

...

  1. field.

...

    1. Confirm the intended path.

...

...

    1. Click Ok.

...



    1. Image Modified

...


  1. Under Status, click the refresh button for the newly created GuardPoint.

...

    1. You may need refresh several times.

...



    1. Image Modified

  1. Confirm the status turns green.

...



  1. Image Modified

  2. On the Windows server where you are going to apply the GuardPoint, right-click on the PowerShell icon, and then

...

  1. select Run

...

  1. as Administrator.

...


  1. Image Modified

  2. Before you can run the encryption command, you must change into the directory where the Vormetric dataXform utility is located (C:\Program Files\).

...

  1. Change the directory path where the utility is

...

  1. located (C:\Program Files\Vometric\DataSecurityExpert\agent\vmd\bin).

...

    • The utility has a feature that allows you to scan the indended GuardPoint before you run the DataXform command, which can be useful to verify that the GuardPoint can be encrypted and also to offer an estimate on how long the encryption configuration will take.

...

    • The DataXform data command function is:

...

    • .\dataxform

...

    • ••--deep_scan

...

    • ••--gp <guard point path>

...


...

  1. When you are in the DataXform utility path, you can run the DataXform command with various added arguments. The standard command is:

...

  1. .\dataxform --rekey --

...

  1. gp <directory path>

    1. You can add the

...

    1. .\dataxform --rekey

...

    1. flag to read data with the clear key and write back in with the production key (encrypting the data in place).

    2. You can

...

    1. add --print_state

...

    1. to retrieve a printout of how many files are going to be encrypted and periodic updates of how much data has been encrypted so far.

...

      1. The command would

...

      1. be .\dataxform --

...

      1. rekey --print_stat --gp <directory path>

    1. You can add the

...

    1. --cleanup_on_success

...

    1. flag to clean up the temporary files created during the DataXform process and are not necessarily needed in the future.

...

      1. The command would be:

...

      1. .\dataxform --

...

      1. rekey --print_stat

...

      1. --cleanup_on_success

...

      1. —gp <direcotry path>

    1. You can add

...

    1. the --preserve_modified_

...

    1. time flag to preserve the current time stamp of the files being encrypted, instead of changing the time stamp to when DataXform ran.

...

      1. The command would be:

...

      1. .\dataxform

...

      1. ••--rekey

...

      1. ••--print_stat --cleanup_on_success --preserve_modified_time

...

      1. --gp <directory>

  1. After you enter the command,

...

  1. press Enter.

...

    • If successful, you will see a text output similar to the screenshot below.

...

    • If unsuccessful, make sure there are two dashes before each flag and that the words are spelled correctly.

...

  1. Assuming your data is already backed up, then

...

  1. press y

...

  1. to continue.

...

  1. To remove the data transformation status files created earlier,

...

  1. press y, and then

...

  1. press Enter.

...



  1. Image Modified

  2. Return to the DSM console, and mark the box for the GuardPoint that contains the DataXform policy.

...

    1. If you are logged out of the DSM console, after you login, click

...

    1. the Hosts

...

    1. tab, select the desired Host Name, and then

...

    1. click Guard FS.

  1. Mark the box next

...

  1. to DataXForm_Policy.

  2. Select

...

  1. the Unguard button.

...



  1. Image Modified

...


  1. Click OK.

...



  1. Image Modified

  2. Click

...

  1. the Refresh

...

  1. button.

...



  1. Image Modified

  2. You may need to click Refresh several times before the GuardPoint disappears.

...

    1. When the GuardPoint disappears,

...

    1. click Guard.

...

    1. In the pop-up window, in

...

    1. the Policy

...

    1. drop-down menu, select your operational policy in learn mode. (In the screenshots below, the example

...

    1. is R1_Testing_VMW12.

...

    1. Expand the directory to the path, and then highlight the path you previously encrypted. (In the screenshots below, the example

...

    1. is C:\Program Files\Microsoft SQL Server\MSSQL11.MSSQLSERVER\MSSQ\Log.

...

    1. Click Ok.

      Image Modified

  1. Click

...

  1. the Refresh

...

  1. button.

...

    1. You may need to

...

    1. click Refresh

...

    1. several times before the GuardPoint turns green.

...



    1. Image Modified

...


    1. Image Modified

  1. Restart your database.

...



  1. Image Modified

...


Topics Discussed

Table of Contents
maxLevel3
minLevel3