ALTER CREDENTIALSTORE

使用此命令可建立證明資料存放區別名，其中包含內含連線詳細資訊之使用者名稱和密碼的資料庫證明資料。接著可使用證明資料存放區別名在部署內建立資料庫連線。

請參閱新增和更改資料庫證明資料，以設定 MA Web 介面的資料庫連線。

NonStop 平台不支援使用證明資料存放區。

語法

ALTER CREDENTIALSTORE ADD USER {userid | userid@dbhost:dbport/dbname[;connection_options]|| userid@odbc-dsn}
[DELETE USER alias]
[REPLACE USER alias]
[ALIAS alias]
[Domain domain]
[PASSWORD password | NOPASSWORD]
[KERBEROS]
[PLUGIN]

ADD USER {userid|userid@dbhost:dbport/dbname[;connection_options]|userid@odbc-dsn}

userid

將指定的使用者新增至證明資料存放區別名。若未使用 ALIAS 選項，別名預設為 userid 的別名。如果未提供 DOMAIN 選項，則網域會預設為 OracleGoldenGate 網域。對於具有 CDB 和 PDB 之不同使用者的多租用戶 Oracle 資料庫，當您將資料庫使用者新增至證明資料存放區時，您需要指定 @tns_service_name。

userid@dbhost:dbport/dbname[;connection_options]

對於支援 Oracle 資料庫、MySQL、SQL Server、PostgreSQL 和 Db2 等連線字串的資料庫，可將指定的使用者和連線資訊新增至證明資料存放區別名。連線字串資訊應包括資料庫伺服器名稱、資料庫連接埠及資料庫名稱。下列是可新增至連線字串的其他連線選項 (每個資料庫)：

建立含有資料庫連線詳細資訊的別名時，需要 ALIAS 選項

必要的連線格式為：

userid@databasehost:databaseport/databasename;option1;option2;option3

舉例而言：

ALTER CREDENTIALSTORE ADD USER ggadmin@server_west:1434/sourcedb
PASSWORD ***** ALIAS SourceMSSQLConnection

userid @ odbc-dsn

對於支援透過 ODBC 進行 DSN 連線的資料庫 (包括 Db2 for i 系列、Db2 LUW、Db2 z/OS、SQL Server 及 PostgreSQL)，可將 DSN 連線資訊新增至證明資料存放區。系統上必須有 DSN 連線詳細資料，例如 Linux 的 odbc.ini 檔案或 ODBC 資料來源 64 位元用戶端在 Windows 下建立的系統 DSN。

使用 DSN 建立別名時，需要 ALIAS 選項。

必要的連線格式為：

userid@odbc-dsn

舉例而言：

ALTER CREDENTIALSTORE ADD USER ggadmin@sourcedsn
PASSWORD ***** ALIAS SourceMSSQLConnection

DELETE USER alias

移除指定別名的證明資料。如果未提供 ALIAS 選項，別名名稱會預設為 userid 的別名。如果未提供 DOMAIN 選項，證明資料存放區會預設為 OracleGoldenGate 網域。

舉例而言：

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

取代指定別名的使用者，也可用來變更現有使用者的密碼。如果未提供 ALIAS 選項，則別名名稱會預設為 userid 的別名。如果未提供 DOMAIN 選項，則證明資料存放區會預設為 OracleGoldenGate 網域。

除非使用 PASSWORD 選項，否則命令會提示輸入指定之使用者的密碼。變更包含資料庫連線資訊之使用者的密碼時，您必須包括目前 userid 的完整值，否則此命令會以提供的新值取代使用者。

下列範例顯示如何變更現有使用者 ggadmin@sourcedsn (別名 SourceMSSQLConnection) 的密碼。

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

此範例顯示如何將 pdbeast 別名的使用者 ggadmin 變更為新使用者，然後提示輸入密碼。

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

指定使用者名稱的別名。如果您不想在參數檔或命令中顯示使用者名稱，請使用此選項。如果未提供 ALIAS，別名預設為 USER 名稱，則必須在需要登入的參數檔與命令中使用。您可以將 ADD USER 選項與 ALIAS 搭配使用，為使用者建立多個項目，每個項目都有不同的別名。

DOMAIN domain

以提供的網域名稱儲存證明資料別名。

預設網域為 OracleGoldenGate。選擇唯一網域名稱，多個使用相同證明資料存放區的 Oracle GoldenGate 安裝就能使用同一個別名。例如，系統 1 的管理員可能不想讓系統 2 存取用於系統 1 的相同證明資料。這些證明資料可以儲存為 ALIAS pdbeast (例如，在 DOMAIN system1 下)，而 DOMAIN system2 下的 ALIAS pdbeast 可以儲存一組不同的證明資料。

NOPASSWORD | PASSWORD password

使用 PASSWORD 選項指定使用者的密碼。使用此選項會顯示 (非混淆編碼) 密碼。如果省略此選項，此命令就會提示輸入密碼，且在輸入密碼時進行混淆編碼 (基於更高安全性建議使用)。

Oracle GoldenGate 26ai 支援的密碼長度上限為 1024 個位元組。

使用外部驗證時，NOPASSWORD 選項是 PASSWORD 選項的替代選項，因為外部驗證 (例如使用 Kerberos 認證或 IDCS) 不需要密碼。設定 NOPASSWORD 選項之後，即可使用 DBLOGIN 命令存取資料庫而不使用密碼。

從 26ai 開始，您可以使用關鍵字來表示資料庫連線的不同證明資料類型，而不是使用 NOPASSWORD 選項。NOPASSWORD 以外的可用證明資料類型為：

Kerberos 認證：您可以使用 KERBEROS 關鍵字，如下列語法所示：

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
外掛程式型驗證：您可以搭配或不使用外掛程式密碼來使用 PLUGIN 關鍵字，如下列語法所示：

ALTER CREDENTIALSTORE ADD USER <username>/@<tns_alias> ALIAS <alias> PLUGIN

ALTER CREDENTIALSTORE ADD USER <username>/@<tns_alias> ALIAS <alias> PLUGIN [SECRET <secret>]

對於使用 PLUGIN SECRET 建立的 PLUGIN 證明資料，GoldenGate 也會將儲存的外掛程式加密密碼當作描述資料項目傳送給 PLUGIN 回呼。

仍支援新增 Plugin 證明資料的現有格式。如果您使用現有的格式，「管理從屬端」將不會傳送證明資料類型。
Microsoft EntraID 的 OAuth 認證：新增 Entra ID 證明資料的語法使用 OAUTHSECRET 作為命令中的關鍵字。它會將提供的字串標示為 Microsoft Entra ID 從屬端加密密碼。對於 Entra ID USERIDALIAS (例如 ggwest-entra)，證明資料存放區只會保存從屬端加密密碼，如下列語法所示：

更改證明資料存放區新增使用者 /@ 別名 OAUTHSECRET

下表說明這些命令如何根據使用的語法設定證明資料的類型。

另請參閱 Oracle GoldenGate 的參數與函數參照中的 USERIDALIAS 參數。

安全組態的連線值

這些是可新增至證明資料別名 (包括 SSL 屬性) 的選擇性連線字串設定值。它們必須指定為以分號區隔的屬性清單，例如 option1=value1;option2=value2;option3=value3，其中選項為資料庫特定特性及其允許的值。

以下是可以新增至證明資料別名 (包括 SSL 屬性) 的其他連線字串選項清單。

注意：Oracle GoldenGate Microservices Architecture 支援 SSL 連線，方法是將某些 SSL 參數設定為環境變數。不過，此組態會將 Extract 和 Replicat 處理作業限制為僅使用為部署定義的 SSL 環境變數進行連線，無法使用其他 SSL 或非 SSL 連線。不過，證明資料存放區別名也提供相當的彈性，可設定具有不同 SSL 或非 SSL 參數的證明資料，用於相同部署內的不同資料庫連線。

sslCA：僅適用於 MySQL 和 PostgreSQL。用來驗證 PEM 格式之 SSL 憑證真實性的憑證。
sslCert：MySQL 和 PostgreSQL。用戶端的 SSL 憑證檔案為 PEM 格式。
sslCrl：MySQL。包含認證撤銷清單 (PEM 格式) 的檔案名稱。
sslKey：MySQL 和 PostgreSQL。PEM 格式的從屬端私密金鑰檔案。
sslMode：MySQL 和 PostgreSQL。sslMode 參數值僅以大寫指定。MySQL 的 sslMode 選項為 VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED。PostgreSQL 的 sslMode 選項為 VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER。

對於 sslMode=VERIFY_IDENTITY，必須提供 sslPath、sslCa、sslCert 及 sslKey。對於 sslMode=VERIFY_CA，必須提供 sslPath 和 sslCa。
sslPath：僅適用於 MySQL。包含 PEM 格式之信任 SSL 憑證授權機構 (CA) 憑證檔案的目錄路徑。

範例

Oracle

此範例會新增名為 ggadmin 的使用者，但會省略 PASSWORD 規格，因此命令會提示您輸入可插拔資料庫的密碼，pdbeast。

ALTER CREDENTIALSTORE ADD USER ggadmin
Password: ********

此範例會將使用者 ggadmin 加到此密碼 tiger，並將別名指定為 pdbeast。

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

此範例會將使用者 ggadmin 加到 OracleGoldenGate 網域底下。

ALTER CREDENTIALSTORE ADD USER ggadmin@dbnorth ALIAS pdbeast DOMAIN OracleGoldenGate
Password: ********

此範例使用簡易連線命名方法新增使用者 ggadmin。

ALTER CREDENTIALSTORE ADD USER ggadmin@dbnorth:1521/dbservice_north
ALIAS pdbnorth

此範例會發出兩個 ALTER CREDENTIALSTORE 命令，每個命令會新增一個 ggadmin 項目，但具有不同的別名。

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast ALIAS pdbeast
Password: ********
ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest ALIAS pdbwest
Password: ********

此範例顯示使用 KERBEROS 關鍵字進行 Kerberos 認證的 ALTER CREDENTIALSTORE 指令。

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

此範例顯示使用 PLUGIN 關鍵字進行外掛程式型驗證的 ALTER CREDENTIALSTORE 命令。

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

此範例使用 PLUGIN SECRET 關鍵字：

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN SECRET abc ALIAS ggwest;

以下範例顯示使用 OAUTH 關鍵字來新增 Microsoft EntraID 的憑證。

ALTER CREDENTIALSTORE ADD USER /@dbwest ALIAS ggwest OAUTHSECRET XkE8Q~rWlDiIl4bKAsWoER8m7hNrX_KBvG_bgdhT

以下顯示 DELETE USER 選項與 ALIAS 選項搭配運作的方式。

下列命令會刪除 ALIAS 與使用者名稱相同的 user1 項目。

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

下列命令會刪除與別名 pdbeast 相關聯之使用者 ggadmin 的項目。

ALTER CREDENTIALSTORE DELETE USER ggadmin ALIAS pdbeast
Alias: pdbeast
Userid: ggadmin

此範例將 SQL*Net 連線字串用作使用者值。在此情況下，會省略 PASSWORD 選項。發出命令的人員會被提示輸入隱藏的密碼。

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

此範例會在「管理從屬端」中建立使用者 ID 為 ggadmin 且別名為 pdbeast 的網域名稱 Oracle GoldenGate。

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

下列範例使用 BEQ-Bequeath Protocol 轉接器時，使用連線限定字元連線。如需使用 BEQ-Bequeath Protocol 轉接器建立安全連線的詳細資訊，請參閱設定安全資料庫連線。

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

下列範例 (Admin Client) 會新增名為 ggadmin 的使用者，但具有外部認證，因此會使用 NOPASSWORD 選項。

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

執行 INFO CREDENTIALSTORE 命令，您可以檢查新增使用者至證明資料存放區：

INFO CREDENTIALSTORE
Default domain: OracleGoldenGate
  Alias: pdbeast
  Userid: @ggadmin

將證明資料儲存庫更新為使用 NOPASSWORD 選項之後，您就可以使用 DBLOGIN 命令來進行資料庫的 Kerberos 認證。

DBLOGIN USERIDALIAS pdbeast

MySQL

以下是一些在 MySQL 的管理從屬端中建立證明資料的範例。

此範例會在連線字串中新增沒有 SSL 屬性的資料庫證明資料。

ALTER CREDENTIALSTORE ADD USER ggadmin@mysqlsrvr.myorg.com/my_db
PASSWORD:******  ALIAS pdbeast

此範例會在證明資料存放區中新增資料庫連線詳細資訊，並在連線字串中新增 SSL 屬性。

ALTER CREDENTIALSTORE ADD USER ggadmin1@192.168.254.2:3306/atssrc;
sslMode=VERIFY_IDENTITY;sslPath=/var/lib/mysql/data;
sslCert=client-cert.pem;sslCa=ca.pem;sslKey=client-key.pem
PASSWORD ****** ALIAS pdbeast

SQL Server

下列範例會使用 DSN 在證明資料存放區中新增資料庫連線詳細資訊。

ALTER CREDENTIALSTORE ADD USER ggadmin@mydsn PASSWORD *****
ALIAS pdbeast

下列範例會使用以 DSNless 為基礎的連線，在證明資料存放區中新增資料庫連線詳細資訊。

ALTER CREDENTIALSTORE ADD USER ggadmin@100.70.96.45:10043/qadb;Encrypt=NO;
TrustServerCertificate=YES PASSWORD***** ALIAS pdbwest

PostgreSQL

下列範例會在證明資料存放區中新增資料庫連線詳細資訊，並在連線字串中新增 SSL 屬性。

ALTER CREDENTIALSTORE ADD USER ggadmin@abc.com:7432/mydb;sslmode=disable;
sslCa=/u01/ogg/certs/root.pem  PASSWORD ***** ALIAS pdbeast

下列範例會使用 DSN 在證明資料存放區中新增資料庫連線詳細資訊。

ALTER CREDENTIALSTORE ADD USER ggadmin@mydsn PASSWORD *****
ALIAS pdbeast

下列範例會使用以 DSNless 為基礎的連線，在證明資料存放區中新增資料庫連線詳細資訊。

ALTER CREDENTIALSTORE ADD USER ggadmin@100.70.96.45:10043/qadb PASSWORD***** ALIAS pdbwest

Sybase

以下是一些在 Sybase 管理用戶端中建立憑證的範例。

下列範例顯示主機和連接埠型連線，而 Sybase 資料庫沒有其他屬性。

ALTER CREDENTIALSTORE ADD USER ggadmin@sybdb.myorg.com:5055/qadb PASSWORD****
ALIAS pdbeast

下列範例顯示以主機和連接埠為基礎的 Sybase 資料庫連線，並啟用其他屬性和 SSL。

ALTER CREDENTIALSTORE ADD USER ggadmin@sybdb.myorg.com:5055/qadb;OGG_USE_SSL;
CS_OPT_CHARSET=UTF-8;CS_LOGIN_TIMEOUT=10 PASSWORD**** ALIAS pdbeast

i 的 DB2 和 z/OS 的 DB2

下列範例會使用 DSN 在證明資料存放區中新增資料庫連線詳細資訊。

ALTER CREDENTIALSTORE ADD USER ggadmin@mydsn PASSWORD *****
ALIAS pdbeast

下列範例會使用以 DSNless 為基礎的連線，在證明資料存放區中新增資料庫連線詳細資訊。

ALTER CREDENTIALSTORE ADD USER ggadmin@100.70.96.45:10043/qadb PASSWORD***** ALIAS pdbwest