ALTER CREDENTIALSTORE

Mit diesem Befehl können Sie Zugangsdatenspeicher-Aliasnamen erstellen, die Datenbankzugangsdaten enthalten, die Benutzername und Kennwort mit den Verbindungsdetails enthalten. Mit den Zugangsdatenspeicher-Aliasnamen können Datenbankverbindungen innerhalb des Deployments hergestellt werden.

Informationen zum Konfigurieren der Datenbankverbindungen über die MA-Weboberfläche finden sie unter Datenbankzugangsdaten hinzufügen und ändern.

Die Verwendung eines Zugangsdatenspeichers wird von den NonStop-Plattformen nicht unterstützt.

Syntax

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

Fügt den angegebenen Benutzer zum Zugangsdatenspeicher-Alias hinzu. Wenn Sie die Option ALIAS nicht verwenden, wird standardmäßig der Aliasname als userid verwendet. Wenn die Option DOMAIN nicht angegeben wird, wird standardmäßig die Domain OracleGoldenGate verwendet. Bei mehrmandantenfähigen Oracle-Datenbanken mit unterschiedlichen Benutzern für die CDB und die PDB müssen Sie @tns_service_name angeben, wenn Sie einen Datenbankbenutzer zum Zugangsdatenspeicher hinzufügen.

userid@dbhost:dbport/dbname[;connection_options]

Bei Datenbanken, die Verbindungszeichenfolgen unterstützen, wie Oracle-Datenbank, MySQL, SQL Server, PostgreSQL und Db2, werden die angegebenen Benutzer- und Verbindungsinformationen zu einem Zugangsdatenspeicheralias hinzugefügt. Verbindungszeichenfolgen-Informationen müssen den Namen des Datenbankservers, Datenbankport und Datenbanknamen enthalten. Die folgenden zusätzlichen Verbindungsoptionen (pro Datenbank) können zur Verbindungszeichenfolge hinzugefügt werden:

Die Option ALIAS ist erforderlich, wenn ein Alias mit Datenbankverbindungsdetails erstellt wird

Das erforderliche Verbindungsformat ist:

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

Beispiel:

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

userid @ odbc-dsn

Bei Datenbanken, die DSN-Verbindungen über ODBC unterstützen, einschließlich Db2 for i Series, Db2 LUW, Db2 z/OS, SQL Server und PostgreSQL, werden die DSN-Verbindungsinformationen zum Zugangsdatenspeicher hinzugefügt. Die DSN-Verbindungsdetails müssen auf dem System vorhanden sein, wie z.B. in einer Datei odbc.ini für Linux oder als System-DSN, die unter Windows mit dem 64-Bit-Client der ODBC-Datenquellen erstellt wurde.

Die Option ALIAS ist erforderlich, wenn ein Alias mit einem DSN erstellt wird.

Das erforderliche Verbindungsformat ist:

userid@odbc-dsn

Beispiel:

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

DELETE USER alias

Entfernt die Zugangsdaten des angegebenen Alias. Wenn die Option ALIAS nicht angegeben wird, wird standardmäßig der Aliasname der userid verwendet. Wenn die Option DOMAIN nicht angegeben wird, wird standardmäßig die Domain OracleGoldenGate als Zugangsdatenspeicher verwendet.

Beispiel:

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

Ersetzt den Benutzer eines angegebenen Alias oder kann zum Ändern des Kennworts eines vorhandenen Benutzers verwendet werden. Wenn die Option ALIAS nicht angegeben wird, wird standardmäßig der Aliasname der userid verwendet. Wenn die Option DOMAIN nicht angegeben wird, wird standardmäßig die Domain OracleGoldenGate als Zugangsdatenspeicher verwendet.

Wenn die Option PASSWORD nicht verwendet wird, werden Sie zur Eingabe eines Kennworts für den angegebenen Benutzer aufgefordert. Wenn Sie das Kennwort für einen Benutzer ändern, der Datenbank-Verbindungsinformationen enthält, müssen Sie den vollständigen Wert der aktuellen userid angeben. Andernfalls wird durch diesen Befehl der Benutzer mit dem angegebenen neuen Wert ersetzt.

Das folgende Beispiel zeigt, wie Sie das Kennwort eines vorhandenen Benutzers ggadmin@sourcedsn (Alias SourceMSSQLConnection) ändern.

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

Das Beispiel zeigt, wie Sie den Benutzer ggadmin des Alias pdbeast in einen neuen Benutzer ändern, der dann zur Eingabe des Kennworts aufgefordert wird.

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

Gibt einen Alias für den Benutzernamen an. Verwenden Sie diese Option, wenn der Benutzername nicht in eine Parameterdatei oder einen Befehl aufgenommen werden soll. Wenn ALIAS nicht angegeben wird, wird standardmäßig der USER-Name als Alias verwendet. Er muss dann in Parameterdateien und Befehlen verwendet werden, bei denen eine Anmeldung erforderlich ist. Sie können mehrere Einträge für einen Benutzer (jeweils mit einem anderen Alias) erstellen, wobei Sie die Option ADD USER mit ALIAS verwenden.

DOMAIN domain

Speichert den Zugangsdatenalias unter dem angegebenen Domainnamen.

Die Standarddomain lautet OracleGoldenGate. Durch die Auswahl von eindeutigen Domainnamen kann derselbe Alias von mehreren Oracle GoldenGate-Installationen verwendet werden, die denselben Zugangsdatenspeicher nutzen. Beispiel: Die Administratoren von System 1 möchten verhindern, dass System 2 Zugriff auf dieselben Zugangsdaten hat, die in System 1 verwendet werden. Diese Zugangsdaten können als ALIAS pdbeast unter DOMAIN system1 gespeichert werden, während ein anderes Zugangsdatenset für ALIAS unter DOMAIN system2 gespeichert werden kann.

NOPASSWORD | PASSWORD password

Geben Sie das Kennwort des Benutzers mit der Option PASSWORD an. Bei Verwendung dieser Option wird das Kennwort wiedergegeben (also nicht obfuskiert). Wenn Sie diese Option auslassen, werden Sie zur Eingabe des Kennworts aufgefordert und dieses dabei obfuskiert (als Methode mit höherer Sicherheit empfohlen).

Oracle GoldenGate 26ai unterstützt eine maximale Kennwortlänge von 1024 Byte.

Die Option "NOPASSWORD" ist die Alternative zur Option PASSWORD bei Verwendung einer externen Authentifizierung, da das Kennwort für keine externe Authentifizierung wie die Kerberos-Authentifizierung oder IDCS erforderlich ist. Nachdem die Option NOPASSWORD festgelegt wurde, können Sie mit dem Befehl DBLOGIN ohne Kennwort auf die Datenbank zugreifen.

Ab 26ai können Sie Schlüsselwörter verwenden, um verschiedene Typen von Zugangsdaten für Datenbankverbindungen anzugeben, anstatt die Option NOPASSWORD zu verwenden. Folgende Zugangsdaten sind außer NOPASSWORD verfügbar:

Kerberos-Authentifizierung: Sie können das Schlüsselwort KERBEROS verwenden, wie in der folgenden Syntax dargestellt:

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
Plug-in-basierte Authentifizierung: Sie können das Schlüsselwort PLUGIN mit oder ohne das Plug-in Secret verwenden, wie in der folgenden Syntax dargestellt:

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

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

Bei Plug-in-Zugangsdaten, die mit PLUGIN SECRET erstellt wurden, übergibt GoldenGate das gespeicherte Plug-in SECRET auch als Metadatenelement an den Plug-in-Callback.

Das vorhandene Format zum Hinzufügen von Plug-in-Zugangsdaten wird weiterhin unterstützt. Wenn Sie das vorhandene Format verwenden, wird der Zugangsdatentyp von Admin Client nicht übergeben.
OAuth-Authentifizierung für Microsoft EntraID: Die Syntax zum Hinzufügen von Entra-ID-Zugangsdaten verwendet OAUTHSECRET als Schlüsselwort im Befehl. Die angegebene Zeichenfolge wird als Microsoft Entra ID-Client Secret markiert. Bei einer Entra-ID USERIDALIAS, wie ggwest-entra, persistiert der Zugangsdatenspeicher nur das Client Secret, wie in der folgenden Syntax dargestellt:

ZUGANGSDATENSPEICHER ÄNDERN: BENUTZER/@-ALIAS OAUTHSECRET HINZUFÜGEN

In der folgenden Tabelle wird beschrieben, wie diese Befehle den Typ eines Berechtigungsnachweises abhängig von der verwendeten Syntax festlegen.

Siehe auch den Parameter USERIDALIAS in der Referenz zu Parametern und Funktionen für Oracle GoldenGate.

Verbindungswerte für Sicherheitskonfiguration

Dies sind optionale Verbindungszeichenfolgeneinstellungen, die einem Zugangsdatenalias einschließlich der SSL-Attribute hinzugefügt werden können. Sie müssen als durch Semikolon getrennte Liste von Attributen angegeben werden, z.B. option1=value1;option2=value2;option3=value3, wobei die Optionen die datenbankspezifischen Eigenschaften sowie die zulässigen Werte sind.

Im Folgenden finden Sie eine Liste der zusätzlichen Verbindungszeichenfolgenoptionen, die einem Zugangsdatenalias hinzugefügt werden können, einschließlich der SSL-Attribute.

Hinweis: Die Oracle GoldenGate-Microservices-Architektur unterstützt SSL-Verbindungen, indem bestimmte SSL-Parameter als Umgebungsvariablen konfiguriert werden. Diese Konfiguration schränkt jedoch den Extract- und Replicat-Prozess so ein, dass die Verbindung nur die definierten SSL-Umgebungsvariablen für ein Deployment verwendet und keine anderen SSL- oder Nicht-SSL-Verbindungen möglich sind. Ein Zugangsdatenspeicher-Alias bietet jedoch auch die Flexibilität, die Zugangsdaten mit unterschiedlichen SSL- oder Nicht-SSL-Parametern für verschiedene Datenbankverbindungen innerhalb desselben Deployments zu konfigurieren.

sslCA: Nur für MySQL und PostgreSQL. Das Zertifikat, mit dem die Authentizität der SSL-Zertifikate im PEM-Format geprüft wird.
sslCert: Für MySQL und PostgreSQL. Die SSL-Zertifikatsdatei des Clients im PEM-Format.
sslCrl: Für MySQL. Der Name der Datei mit Zertifizierungswiderruflisten im PEM-Format.
sslKey: Für MySQL und PostgreSQL. Die Private-Key-Datei des Clients im PEM-Format.
sslMode: Für MySQL und PostgreSQL. Die Parameterwerte für sslMode werden nur in Großbuchstaben angegeben. Die sslMode-Optionen für MySQL sind VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED. Die sslMode-Optionen für PostgreSQL sind VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER.

Für sslMode=VERIFY_IDENTITY sind die Angabe von sslPath, sslCa, sslCert und sslKey obligatorisch. Für sslMode=VERIFY_CA müssen Sie sslPath und sslCa angeben.
sslPath: Nur für MySQL. Der Pfad des Verzeichnisses, das vertrauenswürdige ssl Certificate Authority-(CA-)Zertifikatdateien im PEM-Format enthält.

Beispiele

Oracle

Mit diesem Beispiel wird der Benutzer ggadmin ohne Angabe von PASSWORD hinzugefügt. Daher fordert der Befehl zur Angabe des Kennworts der integrierbaren Datenbank, pdbeast, auf.

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

In diesem Beispiel wird der Benutzer ggadmin mit diesem Kennwort tiger und dem Alias pdbeast hinzugefügt.

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

In diesem Beispiel wird der Benutzer ggadmin unter der Domain OracleGoldenGate hinzugefügt.

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

In diesem Beispiel wird der Benutzer ggadmin mit der Easy Connect-Benennungsmethode hinzugefügt.

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

In diesem Beispiel werden zwei ALTER CREDENTIALSTORE-Befehle ausgegeben, von denen jeder einen ggadmin-Eintrag mit einem anderen Alias hinzufügen kann.

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

Dieses Beispiel zeigt den Befehl ALTER CREDENTIALSTORE für die Kerberos-Authentifizierung mit dem Schlüsselwort KERBEROS.

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

In diesem Beispiel wird der Befehl ALTER CREDENTIALSTORE für die Plug-in-basierte Authentifizierung mit dem Schlüsselwort PLUGIN gezeigt.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

In diesem Beispiel wird das Schlüsselwort PLUGIN SECRET verwendet:

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

Das folgende Beispiel zeigt die Verwendung des Schlüsselworts OAUTH zum Hinzufügen von Zugangsdaten mit Microsoft EntraID.

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

Die folgenden Beispiele zeigen die Funktionsweise der DELETE USER-Option mit und ohne ALIAS-Option.

Mit dem folgenden Befehl wird der Eintrag user1 gelöscht, bei dem der Eintrag ALIAS mit dem Benutzernamen identisch ist.

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

Mit dem folgenden Befehl wird der Eintrag für Benutzer ggadmin, der mit Alias pdbeast verknüpft ist, gelöscht.

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

Dieses Beispiel nutzt eine SQL*Net-Verbindungszeichenfolge als Benutzerwert. In diesem Fall wird die Option PASSWORD ausgelassen. Die Person, die den Befehl ausgibt, wird zur Eingabe des Kennworts (verdeckt) aufgefordert.

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

Mit diesem Beispiel wird der Domainname Oracle GoldenGate mit dem Benutzer-ID ggadmin und dem Alias pdbeast in Admin Client erstellt.

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

Im folgenden Beispiel wird die Anmeldung über einen Verbindungs-Qualifier bei Verwendung eines BEQ-Bequeath Protocol-Adapters hergestellt. Weitere Informationen zum Herstellen einer sicheren Verbindung mit einem BEQ-Bequeath Protocol-Adapter finden Sie unter Sichere Datenbankverbindung konfigurieren.

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

Mit dem folgenden Beispiel (Admin Client) wird die Benutzer ggadmin mit externer Authentifizierung hinzufügen, sodass die Option NOPASSWORD verwendet werden.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

Wenn Sie den Befehl INFO CREDENTIALSTORE ausführen, können Sie den hinzugefügten Benutzer im Zugangsdatenspeicher prüfen:

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

Nachdem Sie den Zugangsdatenspeicher zur Verwendung der Option NOPASSWORD aktualisiert haben, können Sie den Befehl DBLOGIN mit Kerberos-Authentifizierung für Ihre Datenbank verwenden.

DBLOGIN USERIDALIAS pdbeast

MySQL

Im Folgenden finden Sie einige Beispiele zum Erstellen von Zugangsdaten im Admin-Client für MySQL.

In diesem Beispiel werden Datenbankzugangsdaten ohne SSL-Attribut in der Verbindungszeichenfolge hinzugefügt.

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

In diesem Beispiel werden Datenbankverbindungsdetails im Zugangsdatenspeicher mit SSL-Attributen hinzugefügt, die in der Verbindungszeichenfolge hinzugefügt wurden.

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

Im folgenden Beispiel werden Datenbankverbindungsdetails mit dem DSN im Zugangsdatenspeicher hinzugefügt.

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

Im folgenden Beispiel werden mit der DSNless-basierten Verbindung Datenbankverbindungsdetails im Zugangsdatenspeicher hinzugefügt.

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

PostgreSQL

Im folgenden Beispiel werden Datenbankverbindungsdetails im Zugangsdatenspeicher mit SSL-Attributen hinzugefügt, die in der Verbindungszeichenfolge hinzugefügt wurden.

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

Im folgenden Beispiel werden Datenbankverbindungsdetails mit dem DSN im Zugangsdatenspeicher hinzugefügt.

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

Im folgenden Beispiel werden mit der DSNless-basierten Verbindung Datenbankverbindungsdetails im Zugangsdatenspeicher hinzugefügt.

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

Sybase

Im Folgenden finden Sie einige Beispiele zum Erstellen von Zugangsdaten in Admin Client für Sybase.

Im folgenden Beispiel wird eine host- und portbasierte Verbindung ohne zusätzliche Attribute zur Sybase-Datenbank angezeigt.

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

Im folgenden Beispiel wird eine host- und portbasierte Verbindung zur Sybase-Datenbank mit zusätzlichen Attributen und SSL-Aktivierung angezeigt.

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

DB2 für i und DB2 für z/OS

Im folgenden Beispiel werden Datenbankverbindungsdetails mit dem DSN im Zugangsdatenspeicher hinzugefügt.

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

Im folgenden Beispiel werden mit der DSNless-basierten Verbindung Datenbankverbindungsdetails im Zugangsdatenspeicher hinzugefügt.

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