ADD ENCRYPTIONPROFILE

ADD ENCRYPTIONPROFILEを使用すると、Oracle GoldenGateを使用するOracle Key Vaultの暗号化プロファイルを追加できます。

暗号化プロファイルを使用して、外部キー管理サービス(KMS)からマスター・キーを取得します。Oracle Key Vault (OKV)とOracle Cloud Infrastructure Keys Management Service (OCIKMS)の間で選択できます。

明示的に定義された暗号化プロファイルがない場合は、ローカル・ウォレットがデフォルト・プロファイルとして使用されます。

詳細は、暗号化プロファイルとは?を参照してください。

構文

ADD ENCRYPTIONPROFILE encryption-profile-name
                 ( OKV
                   ( OKVPATH dir-path
                     [ KEYNAMEATTRIBUTE key-name-attribute ]
                     [ KEYVERSIONATTRIBUTE key-version-attribute ]
                     [ OKVVERSION okv-version ]
                     MASTERKEY
                     [ NAME ] masterkey-name
                     [ VERSION masterkey-version ]
                     [ TTL ttl ] )
                   | OCIKMS
                    ( ENDPOINT endpoint
                      TENANCY tenancy-ocid
                      USER user-ocid
                      APIKEY api-key-file
                      FINGERPRINT fingerprint
                      KEY key-ocid ) )
                   [ DEFAULT ]

OKVオプション: OKVPATH

Oracle Key Vaultクライアントがインストールされているディレクトリを指定します。

KEYNAMEATTRIBUTE

マスター・キー名を指定するためにOracle Key Vaultサーバーで使用されるカスタム属性

KEYVERSIONATTRIBUTE

マスター・キー・バージョンを指定するためにOracle Key Vaultサーバーで使用されるカスタム属性。

OKVVERSION okv-version

指定可能な値が18.1および21.4のOracle Key Vault (OKV)バージョン。

MASTERKEY [NAME]

マスター・キーの名前。この値は、Oracle GoldenGateのKMSパラメータのキー名と一致している必要があり、レプリケーションが開始した後は変更できません。

MASTERKEY [VERSION]

マスター・キーのバージョン。これは、数値である必要があります。

OCI KMS

Endpoint

OCI KMS Vaultの暗号化エンドポイントを指定します。

Tenancy

テナンシのOCIDを指定します。

User

ユーザーのOCIDを指定します。

APIKEY

OCI API署名キーを含むファイルへのパスを指定します。キーはこのファイルから読み取られ、Oracle GoldenGateに送信されます。ある時点でOCI API KEYの変更が必要になった場合は、ALTER ENCRYPTIONPROFILEコマンドを使用できます。

KEY

OCI KMS Vaultに格納されているキーに属するキーOCIDを指定します。このキーは、Oracle GoldenGateで暗号化(証跡暗号化)に使用されます。

Fingerprint

API署名キーのハッシュ(MD5)。

DEFAULT

現在の暗号化プロファイルを指定します。DEFAULT YESに設定すると、暗号化プロファイルは、現在の暗号化プロファイルに設定されます。DEFAULT NOを設定すると、暗号化プロファイルが削除されます。明示的に定義された現在の暗号化プロファイルがない場合(以前、現在の値をDEFAULT NOとして設定)、暗黙的にデフォルトの・プロファイルがLocalWalletになります。ノート: KeyNameとKeyVersionの値が重複するキーをアップロードしないでください。起動時、再起動またはロールオーバーの時点で、Oracle GoldenGateのプロセスが最大のKeyVersion値を取得します。