- Oracle GoldenGate Security Guide
- Encrypting Data with the ENCKEYS Method
- Setting Up the Data Encryption
C.1 Setting Up the Data Encryption
- Generate an encryption key and store it in the
ENCKEYSfile, see Populating an ENCKEYS File with Encryption Keys. Make certain to copy the finishedENCKEYSfile to the Oracle GoldenGate installation directory on any intermediary systems and all target systems. - In the following parameter files, add the following:
-
To encrypt trail data: In the parameter file of the primary Extract group and the data pump, add an
ENCRYPTTRAILparameter before any parameter that specifies a trail or file that you want to be encrypted. Parameters that specify trails or files areEXTTRAIL,RMTTRAIL,EXTFILE, andRMTFILE. The syntax is one of the following:ENCRYPTTRAIL {AES128 | AES192 | AES256 | BLOWFISH}ENCRYPTTRAIL AES192, KEYNAME keyname -
To encrypt data across TCP/IP: In the
RMTHOSTOPTIONSparameter in the parameter file of the data pump (or the primary Extract, if no pump is being used), add theENCRYPToption with theKEYWORDclause. The syntax is one of the following:RMTHOSTOPTIONS
host, MGRPORTport, ENCRYPT {AES128 | AES192 | AES256 | BLOWFISH} KEYNAMEkeynameRMTHOSTOPTIONS ENCRYPT {AES128 | AES192 | AES256 | BLOWFISH} KEYNAMEkeyname
Where:
-
RMTHOSTOPTIONSis used for passive Extract, see Populating an ENCKEYS File with Encryption Keys. -
ENCRYPTTRAILwithout options uses AES 128 as the default for all database types except the DB2 for i, DB2 z/OS, and NonStop platforms, whereBLOWFISHis the default. -
AES128encrypts with the AES 128 encryption algorithm. Not supported for iDB2 for i, DB2 z/OS, and NonStop platforms. -
AES192encrypts with AES 192 encryption algorithm. Not supported for DB2 for i, DB2 z/OS, and NonStop platforms. -
AES256encrypts with AES 256 encryption algorithm. Not supported for iSeries, z/OS, and NonStop platforms. -
BLOWFISHuses Blowfish encryption with a 64-bit block size and a variable-length key size from 32-bits to 128-bits. Use AES if supported for the platform. UseBLOWFISHfor backward compatibility with earlier Oracle GoldenGate versions, and for DB2 for I and DB2 z/OS. AES is not supported on those platforms. -
KEYNAMEkeynamespecifies the logical look-up name of an encryption key in theENCKEYSfile. Not an option ofENCRYPTTRAIL.Note:
RMTHOSTis used unless the Extract is in a passive configuration.
-
- If using a static Collector with data encrypted over TCP/IP, append the following parameters in the Collector startup string:
-KEYNAME
keyname-ENCRYPTalgorithmThe specified key name and algorithm must match those specified with the
KEYNAMEandENCRYPToptions ofRMTHOST.