---+ APPXIO Data Encryption _Effective with Release 5.0.0, the APPX Utility includes an option to encrypt APPXIO data files._ %TOC% ---++ Overview Release 5.0.0 or higher of the APPX Utility allows APPXIO data files to be optionally encrypted. Encrypting data files can provide an added layer of security for sensitive data. If an encrypted file is opened by any program other than APPX, the encrypted data is unintelligible. This means that backup copies of encrypted files on tape or disk are also secure since they cannot be deciphered without the appropriate software and encryption keys. If an encrypted data file is moved to another APPX server, it cannot be deciphered unless the APPX server is configured with the appropriate encryption keys and meets other necessary criteria. ---++ How to Enable APPXIO File Encryption The APPXIO file encryption feature is easily enabled by [[#How_to_Set_or_Change_the_System][entering a passphrase]] into the Encryption Passphrase field of the System Parameter Record in APPX System Administration. Setting the system Encryption Passphrase enables the APPXIO file encryption feature but does not actually cause any files to be encrypted. To enable encryption of individual files, you must also enter an encryption key into the file specifications for each of the individual files that are to be encrypted or you must enter an encryption key into the FMS group specifications for each group of files that are to be encrypted. Finally, after entering a system Encryption Passphrase and entering the appropriate encryption key(s), you must create the files that are to be encrypted. If the files already exist, they must be Initialized or Scratched and then Created. If existing files are to be encrypted, the data must be exported before entering the encryption keys and then imported. So, the three steps required to enable encryption of APPXIO data files are: 1 Enter a system Encryption Passphrase 1 Enter the appropriate encryption keys 1 Create/Initialize the files that are to be encrypted ---+++ How to Set or Change the System Encryption Passphrase The system Encryption Passphrase can be set or changed from the System Parameter maintenance screen: <blockquote style="MARGIN-RIGHT: 0px" dir="ltr">System Administration --> System Setup --> System Parameters </blockquote> <img width="670" alt="SystemParameters5.0.0.PNG" src="%ATTACHURL%/SystemParameters5.0.0.PNG" height="593"> To set the system Encryption Passphrase, you must click on the "Change" button next to the Encryption Passphrase field. You will then be presented with the following form which will allow you to set the system Encryption Passphrase. <img width="670" alt="Set-ChangePassphrase5.0.0.PNG" src="%ATTACHURL%/Set-ChangePassphrase5.0.0.PNG" height="593"> <font color="#ff0000"> __If no data files have actually been encrypted, the system Encryption Passphrase may be safely changed. However, if any data files have been encrypted, you must follow the steps outlined below to change the system Encryption Passphrase. If you do not follow these steps, any previously encrypted data files will no longer be accessible by the system.__ </font> <strong><em><font color="#ff0000"></font></em></strong> 1 <div style="MARGIN-RIGHT: 0px">Make sure that no users are accessing the system Do not attempt to change the system Encryption Passphrase while other users are accessing the system.</div> 1 <div style="MARGIN-RIGHT: 0px">Export all of the encrypted APPXIO data files in all APPX databases. The Export utility on the Database Management menu should be used to export the encrypted APPXIO data files.</div> 1 <div>Use the System Parameters maintenance process in System Administration to change the system Encryption Passphrase. The Set/Change Passphrase screen includes a report that can be run to obtain a list of all FMS groups and files which have been encrypted. Use this list to verify that you have exported all of the encrypted files.</div> 1 <div>Change all of the encryption keys that have been entered for individual files and for FMS groups.</div> 1 <div>Import all of the APPXIO data files that you exported in step 1. Be sure to specify the "Replace" option for the data import.</div> ---+++ How to Enter an Encryption Key For a File The encryption key for a specific file is entered in Database Management. <blockquote style="MARGIN-RIGHT: 0px" dir="ltr">Database Management --> File Specifications --> File Attributes</blockquote> The same encryption key value can be entered for each file or each file can have its own unique encryption key. An easy way to ensure that each file has a unique encryption key is to use the Random Key button to automatically generate a random key for the file. If you choose to enter an encryption key, you should choose "strong" key values just as you would for a password. This means that your key should not be a common name or word, should include a mixture of letters, numbers, and special characters, and should be more than a few characters in length. <img width="670" alt="FileEncryptionKey.PNG" src="%ATTACHURL%/FileEncryptionKey.PNG" height="593"> ---+++ How to Enter an Encryption Key for a FMS group The encryption key for a FMS group is entered in System Administration. <blockquote style="MARGIN-RIGHT: 0px" dir="ltr">System Administration --> Configuration --> File System Groups --> FMS Group Attributes</blockquote> The same encryption key value can be entered for each FMS Group or each FMS Group can have its own unique encryption key. An easy way to ensure that each FMS Group has a unique encryption key is to use the Random Key button to automatically generate a random key for the FMS Group. If you choose to enter an encryption key, you should choose "strong" key values just as you would for a password. This means that your key should not be a common name or word, should include a mixture of letters, numbers, and special characters, and should be more than a few characters in length. <img width="670" alt="FMSGroupEncryptionKey.PNG" src="%ATTACHURL%/FMSGroupEncryptionKey.PNG" height="593"></img> ---+++ How to Create A New Encrypted File The following steps must be followed to encrypt a new file. 1 <div class="TML">Add the file to the data dictionary in your APPX Application.</div> 1 <div class="TML"> </div> ---+++ How to Encrypt an Existing File The following steps must be followed to encrypt an existing APPXIO file: 1 Export the APPXIO data file 1 Assign an FMS group that has encryption specified to the If the file already exists in an unencrypted state, you should first export the data. To encrypt a file, you must first enter a passphrase in your system admin parameter record. Then, you must enter encryption keys in the file specification for the file that you wish to encrypt or define an FMS group with encryption keys and assign the FMS group to the file that you wish to encrypt. Then you can create the file or, if the file already exists, you can import the data that you previously exported. If you import, be sure to specify the replace option so that the old file will be scratched and recreated as an encrypted file. ---++ How to Disable APPXIO File Encryption ---++ Sharing of Encrypted Files Encrypted files are secure. If you copy them to another APPX system you will not be able to read them unless you use the same encryption keys that were used on the system that created the file and the same passphrase. ---++ Recovery of Corrupted Encrypted Files Encrypted files which have become corrupted may be recovered by using the "recover" option of the APPX Utility engine. The recovery process for encrypted files is the same as the recovery process for non-encrypted files. <blockquote style="MARGIN-RIGHT: 0px" dir="ltr">appx -recover [ -c ] old_file new_file [ del_rec_file ]</blockquote> For additional information on the use of the recover option, you can run: <blockquote style="MARGIN-RIGHT: 0px" dir="ltr">appx -recover</blockquote> ---++ Recovery of Undecipherable Encrypted Files You should keep a record of the system Encryption Passphrase and the Encryption Keys that have been entered in a secure location that can be accessed in the event that you need to reenter the information. Once entered, the Encryption Passphrase and the Encryption Keys should not be needed again unless you find yourself in a situation where your System Administration files have become corrupted or lost and you cannot restore them from a backup. You might also need this information to set up an additional APPX server that needs to be able to access encrypted data files that were created on another APPX server. You will not be able to access your encrypted data files unless you are able to reenter the exact System Passphrase and the exact Encryption Keys that were used to create and process the encrypted data files. In the unlikely event that you to find yourself in the situation where your encrypted files cannot be accessed because you are unable to correctly enter the necessary System Passphrase and Encryption Keys, you should contact APPX Software, Inc. for assistance with recovering the encrypted data. ---++ Limitations: 1 <div class="TML">One-record APPXIO files cannot be encrypted.</div> 1 <div class="TML">Fixed length consecutive APPXIO files cannot be encrypted. Variable length consecutive APPXIO files may be encrypted.</div> ---++ Issues: 1 <div class="TML">Need to verify that the encrypted passphase and the encrypted keys are being correctly stored in the file header.</div> 1 <div class="TML">Default values can be corrupted in the encryption type field causing the engine to fail to encrypt the data.</div> ---++ Suggested Behavior: 1 If data is encrypted, a warning should be presented to the user prior to generating a new encryption key, or changing the System Parameter Pass Phrase. This could help prevent unintended data loss. 1 When importing data into an newly encrypted state, we should either delete the PORTDATA or warn the user that the PORTDATA is unencrypted. 1 When exported from an encrypted state to an unencrypted state, we should warn the user that the exported data is unencrypted. 1 System Parameter Passphrase contents should not be displayed. Use asterisk instead. ---++ Comments: _Read what other users have said about this page or add your own comments._ --- %COMMENT% -- AlKalter - 04 Apr 2008 </img></img></img>
This topic: Main
>
WebHome
>
APPX500Features
>
APPXIODataEncryption
Topic revision: r8 - 2008-09-22 - SteveFrizzell
Copyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki?
Send feedback