使用歷程檔加密的外掛程式服務

瞭解設定用於加密之第三方 Plugin 服務的先決條件、需求和步驟，以及在 Oracle GoldenGate 中建立加密設定檔，以允許使用已設定之 Plugin 進行歷程檔加密。

注意： Plugin Service 只適用於 Linux 平台。

設定外掛程式服務並建立外掛程式

若要設定並建置加密設定檔 Plugin 服務，請在 cURL 提示執行下列步驟：

在服務管理程式中啟用 Plugin 服務：

OGG_ADMIN_PASSWORD="oggadmin-A1"
curl -svu "oggadmin:${OGG_ADMIN_PASSWORD}" http://127.0.0.1:9011/services/v2/deployments/ServiceManager/services/pluginsrvr -XPOST --data '{"$schema":"ogg:service", "config":"external", "enabled":true, "critical":true, "status":"running"}'

使用 Encryption-Minimal 外掛程式建立加密外掛程式：
```
cd $OGG_HOME/src/PluginExamples/Encryption-Minimal
```
在 Encryption-Minimal.c. Replace getManifest() 函數中新增變數名稱，如下列語法所示：
```
const char *  getManifest()
{  return "{ "$schema": "ogg:plugin", "version": "23.7", "variables": [ "GOOGLE_APPLICATION_CREDENTIALS", "KMS_KEY_ID", "SECRET_MANAGER_SECRET_NAME", "CRYPTOGRAPHIC_ENDPOINT", "ENCRYPTION_KEY" ] }"; }
```
在此步驟中新增的變數會儲存如何存取協力廠商工具的必要資訊。它們會在後續的步驟中顯示，需要建立此外掛程式的範本時。

您必須為選擇的第三方加密 / 解密端點設定 encrypt 和 decrypt 函數，才能呼叫任何第三方加密 / 解密工具。
建立 Encryption-Minimal Plugin：
```
make && cp libEncryption-Minimal.so <OGG_deployment_home>/ServiceManager/var/lib/plugins/libEncryption-OCIVault.so
```
注意：複製至「服務管理程式」之 var/lib/plugins 目錄的外掛程式程式庫檔案名稱，會顯示在「服務管理程式」Web 介面中作為建立樣板的外掛程式名稱。

在服務管理程式中建立 Plugin 樣板

登入 Service Manager 並執行下列步驟，以建立加密設定檔的外掛程式範本：1。移至「部署」，選取部署名稱，然後按一下外掛程式。

If the plugin name is not visible under the **Plugin Profiles** table, click the Refresh button. The Service Manager scans all the library files under `SM_HOME/var/lib/plugins` and refreshes the list.

加密設定檔的服務管理程式 Plugin 設定檔已停用。

建立任何可用 Plugin 的樣板 (如果未建立樣板)：

建立 Plugin 樣板之後，就會在「Plugin 服務」頁面顯示綠色核取標記。

已使用綠色勾選標記建立 Plugin 樣板。

從管理服務建立 Plugin 加密設定檔

移至「管理服務」頁面，建立加密設定檔並將其套用至特定的擷取、Replicat 或分送路徑處理作業：1。移至「加密，設定檔」頁面。「外掛程式範本」有新的表格，其資料欄名稱與「服務管理程式」中為每個變數定義的名稱相符。

顯示在「加密設定檔」頁面上的加密設定檔 Plugin 樣板。

新增加密設定檔，輸入值，然後按一下送出。
建立 Extract，Replicat，Distribution Path 並選取加密設定檔 Plugin 服務作為您的加密設定檔。