ADD ENCRYPTIONPROFILE

使用 ADD ENCRYPTIONPROFILE 可以为使用 Oracle GoldenGate 的 Oracle Key Vault 添加加密概要文件。

加密概要文件用于从外部密钥管理服务 (Key Management Service, KMS) 检索主密钥。您可以在 Oracle Key Vault (OKV) 与 Oracle Cloud Infrastructure 密钥管理服务 (Oracle Cloud Infrastructure Key Management Service, OCIKMS) 之间进行选择。

如果没有明确定义的加密概要文件，则使用本地 Wallet 作为默认概要文件。

要了解更多信息，请参见 What is an Encryption Profile？。

语法

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

Oracle Key Vault (OKV) 版本，可能的值为 18.1 和 21.4。

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 值。