ALTER CREDENTIALSTORE

Utilizzare questo comando per creare alias dell'area di memorizzazione delle credenziali contenenti le credenziali del database che includono nome utente e password con i dettagli di connessione. Questi alias possono essere in seguito utilizzati per stabilire connessioni ai database nella distribuzione.

Per configurare le connessioni al database dall'interfaccia Web MA, vedere Aggiungi e modifica credenziali database.

L'uso dell'area di memorizzazione delle credenziali non è supportato per le piattaforme NonStop.

Sintassi

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

Aggiunge l'utente specificato all'alias dell'area di memorizzazione delle credenziali. Se l'opzione ALIAS viene omessa, come alias verrà utilizzato automaticamente il nome userid. Se l'opzione DOMAIN non viene fornita, per impostazione predefinita il dominio è OracleGoldenGate. Per il database Oracle multi-tenant con utenti diversi per il CDB e il PDB, è necessario specificare @tns_service_name quando ci si aggiunge un utente di database all'area di memorizzazione delle credenziali.

userid@dbhost:dbport/dbname[;connection_options]

Per i database che supportano stringhe di connessione quali database Oracle, MySQL, SQL Server, PostgreSQL e Db2, aggiunge le informazioni specificate su utente e connessione a un alias dell'area di memorizzazione delle credenziali. Le informazioni sulla stringa di connessione devono includere il nome del database server, la porta del database e il nome del database. Di seguito sono riportate le opzioni di connessione aggiuntive (per singolo database) disponibili per aggiungere la stringa di connessione.

L'opzione ALIAS è obbligatoria quando si crea un alias con i dettagli di connessione al database

Il formato di connessione richiesto è il seguente:

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

Ad esempio:

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

userid @ odbc-dsn

Per i database che supportano le connessioni DSN su ODBC, inclusi Db2 per i Series, Db2 LUW, Db2 z/OS, SQL Server, e PostgreSQL, questo comando aggiunge le informazioni sulla connessione DSN all'area di memorizzazione delle credenziali. I dettagli della connessione DSN devono esistere nel sistema, ad esempio in un file odbc.ini per Linux o come DSN di sistemi creati in Windows utilizzando il client a a 64 bit di origini dati ODBC.

L'opzione ALIAS è obbligatoria quando si crea un alias con un DSN.

Il formato di connessione richiesto è il seguente:

userid@odbc-dsn

Ad esempio:

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

DELETE USER alias

Rimuove la credenziale dell'alias specificato. Se l'opzione ALIAS non viene fornita, il nome alias viene impostato automaticamente su quello di userid. Se l'opzione DOMAIN non viene fornita, per impostazione predefinita l'area di memorizzazione delle credenziali viene utilizzata il dominio OracleGoldenGate.

Ad esempio:

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

Sostituisce l'utente di un determinato alias oppure può essere utilizzato per modificare la password di un utente esistente. Se l'opzione ALIAS non viene fornita, il nome alias viene impostato automaticamente su quello di userid. Se l'opzione DOMAIN non viene fornita, per impostazione predefinita l'area di memorizzazione delle credenziali viene utilizzata il dominio OracleGoldenGate.

Il comando richiede di immettere una password per l'utente specificato, salvo nel caso in cui sia stata utilizzata l'opzione PASSWORD. Quando si modifica la password di un utente che include informazioni sulle connessioni al database, è necessario includere il valore completo del userid corrente, altrimenti questo comando sostituirà l'utente con il nuovo valore fornito.

L'esempio seguente mostra come modificare la password di un utente esistente ggadmin@sourcedsn, alias SourceMSSQLConnection.

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

L'esempio mostra come modificare l'utente ggadmin dell'alias pdbeast in un nuovo utente, che richiede quindi la password.

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

Specifica un alias per il nome utente. Utilizzare questa opzione se non si desidera che il nome utente venga inserito in un file di parametri o nel comando. Quando non viene fornito ALIAS, come alias viene usato automaticamente il nome USER, che dovrà essere utilizzato nei file dei parametro e Nei comandi in cui è richiesto il login. Utilizzando l'opzione ADD USER con ALIAS, è possibile creare più voci per lo stesso utente, ognuna con un alias diverso.

DOMAIN domain

Salva l'alias delle credenziali nel nome dominio specificato.

Il dominio predefinito è OracleGoldenGate. Se si scelgono nomi di dominio univoci, lo stesso alias può essere utilizzato da più installazioni Oracle GoldenGate che utilizzano la stessa area di memorizzazione delle credenziali. Si supponga, ad esempio, che gli amministratori di system 1 non desiderino che system 2 abbia accesso alle stesse credenziali utilizzate in system 1. Those credentials can be stored as ALIAS pdbeast, for example, under DOMAIN system1, while a different set of credentials can be stored for ALIAS pdbeast under DOMAIN system2.

NOPASSWORD | PASSWORD password

Specificare la password dell'utente utilizzando l'opzione PASSWORD. Quando si utilizza questa opzione, la password viene visualizzata (non offuscata). Se l'opzione viene omessa, il comando chiede di fornire la password, che verrà offuscata mentre la si digita (scelta consigliata in quanto più sicura).

Oracle GoldenGate 26ai supporta una lunghezza massima della password pari a 1024 byte.

L'opzione NOPASSWORD può essere usata in alternativa all'opzione PASSWORD quando ci si usa l'autenticazione esterna, poiché la password non è necessaria per l'autenticazione esterna, ad esempio autenticazione Kerberos o IDCS. Dopo aver impostato l'opzione NOPASSWORD, è possibile utilizzare il comando DBLOGIN per accedere al database senza password.

A partire da 26ai, è possibile utilizzare parole chiave per indicare diversi tipi di credenziali per le connessioni al database, invece di utilizzare l'opzione NOPASSWORD. I tipi di credenziali disponibili diversi da NOPASSWORD sono:

Autenticazione Kerberos: è possibile utilizzare la parola chiave KERBEROS, come mostrato nella sintassi seguente:

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
Autenticazione basata su plugin: È possibile utilizzare la parola chiave PLUGIN con o senza il segreto del plugin, come mostrato nella seguente sintassi:

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

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

Per le credenziali PLUGIN create con PLUGIN SECRET , GoldenGate passa anche il segreto PLUGIN memorizzato al callback del PLUGIN come elemento di metadati.

Il formato esistente per aggiungere una credenziale plugin è ancora supportato. Se si utilizza il formato esistente, il client di amministrazione non passerà il tipo di credenziale.
OAuth Authentication for Microsoft EntraID: la sintassi per aggiungere una credenziale Entra ID utilizza OAUTHSECRET come parola chiave nel comando. Contrassegna la stringa fornita come segreto client Microsoft Entra ID. Per un ID Entra USERIDALIAS, ad esempio ggwest-entra, l'area di memorizzazione delle credenziali persiste solo il segreto client, come mostrato nella sintassi seguente:

ALTER CREDENTIALTORE ADD USER /@ ALIAS OAUTHSECRET

Di seguito è riportata una tabella che descrive il modo in cui questi comandi impostano il tipo di credenziale in base alla sintassi utilizzata.

Vedere anche il parametro USERIDALIAS in Riferimento parametri e funzioni per Oracle GoldenGate.

Valori di connessione per la configurazione di sicurezza

Si tratta di impostazioni di stringa di connessione facoltative che possono essere aggiunte a un alias di credenziale, inclusi gli attributi SSL. Devono essere specificati come lista separata da punti e virgola di attributi, ad esempio option1=value1;option2=value2;option3=value3, in cui le opzioni sono le proprietà specifiche del database insieme ai relativi valori consentiti.

Di seguito è riportata una lista di opzioni di stringa di connessione aggiuntive che possono essere aggiunte a un alias di credenziale, inclusi gli attributi SSL.

Nota: l'architettura dei microservizi Oracle GoldenGate supporta le connessioni SSL configurando determinati parametri SSL come variabili di ambiente. Tuttavia, in questa configurazione i processi Extract e Replicat possono eseguire la connessione esclusivamente tramite le variabili di ambiente SSL definite per una distribuzione e non sono possibili altre connessioni SSL o non SSL. Un alias dell'area di memorizzazione delle credenziali offre anche la flessibilità di configurare le credenziali con diversi parametri SSL o non SSL per diverse connessioni al database nella stessa distribuzione.

sslCA: solo per MySQL e PostgreSQL. Certificato utilizzato per verificare l'autenticità dei certificati SSL in formato PEM.
sslCert: per MySQL e PostgreSQL. Il file di certificato SSL del client in formato PEM.
sslCrl: per MySQL. Nome del file contenente gli elenchi di revoca delle certificazioni in formato PEM.
sslKey: per MySQL e PostgreSQL. File di chiave privata del client in formato PEM.
sslMode: per MySQL e PostgreSQL. I valori dei parametri sslMode sono specificati solo in maiuscolo. Le opzioni sslMode per MySQL sono VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED. Le opzioni sslMode per PostgreSQL sono VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER.

Per sslMode=VERIFY_IDENTITY, è obbligatorio fornire sslPath, sslCa, sslCert e sslKey. Per sslMode=VERIFY_CA, è obbligatorio fornire sslPath e sslCa.
sslPath: solo per MySQL. Percorso della directory che contiene file di certificato ssl Certificate Authority (CA) attendibili in formato PEM.

Esempi

Oracle

In questo esempio viene aggiunta un utente denominato ggadmin, ma ne viene omessa la specifica PASSWORD e pertanto il comando chiede la password per pggeast, pdbeast.

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

In questo esempio viene aggiunto l'utente ggadmin con relative password tiger e viene specificato l'alias pdbeast.

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

In questo esempio viene aggiunto l'utente ggadmin al dominio OracleGoldenGate.

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

In questo esempio viene aggiunto l'utente ggadmin utilizzando il metodo di denominazione Easy Connect.

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

In questo esempio vengono eseguite due comandi ALTER CREDENTIALSTORE, ognuno dei quali aggiunge una voce ggadmin, ma con alias diversi.

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

Questo esempio mostra il comando ALTER CREDENTIALSTORE per l'autenticazione Kerberos mediante la parola chiave KERBEROS.

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

Questo esempio mostra il comando ALTER CREDENTIALSTORE per l'autenticazione basata su plugin che utilizza la parola chiave PLUGIN.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

Questo esempio utilizza la parola chiave PLUGIN SECRET:

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

L'esempio seguente mostra l'uso della parola chiave OAUTH per aggiungere credenziali con Microsoft EntraID.

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

Di seguito viene illustrato il funzionamento dell'opzione DELETE USER con e senza l'opzione ALIAS.

Il comando seguente elimina la voce user1 in cui il valore ALIAS è uguale al nome utente.

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

Il comando seguente elimina la voce per l'utente ggadmin associata all'alias pdbeast.

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

In questo esempio viene utilizzata una stringa di connessione SQL*Net come valore utente. In questo caso, l'opzione PASSWORD viene omessa. Alla persona che esegue il comando viene chiesto di fornire la password, che è nascosta.

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

In questo esempio, viene creato un nome di dominio Oracle GoldenGate con ID utente ggadmin e alias pdbeast nel client di amministrazione.

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

L'esempio riportato di seguito stabilisce la connessione mediante un qualificatore di connessioni se viene utilizzato un adattatore BEQ-Bequeath Protocol. Per ulteriori informazioni su come stabilire una connessione sicura utilizzando un adattatore BEQ-Bequeath Protocol, vedere Configura connessione al database sicura.

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

Nell'esempio seguente (client d'amministrazione) viene aggiunta un utente denominato ggadmin, ma con autenticazione esterna e pertanto viene utilizzata l'impostazione NOPASSWORD.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

Se viene eseguito il comando INFO CREDENTIALSTORE, è possibile controllare l'aggiunta dell'utente all'archivio credenziali.

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

Dopo aver eseguito l'aggiornamento dell'area di memorizzazione delle credenziali in modo da utilizzare l'opzione NOPASSWORD, è possibile utilizzare il comando DBLOGIN con l'autenticazione Kerberos per il database inuso.

DBLOGIN USERIDALIAS pdbeast

MySQL

Di seguito sono riportati alcuni esempi di creazione delle credenziali nel client di amministrazione per MySQL.

Questo esempio aggiunge credenziali di database senza attributo SSL nella stringa di connessione.

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

Questo esempio aggiunge i dettagli di connessione al database nell'area di memorizzazione delle credenziali con gli attributi SSL aggiunti nella stringa di connessione.

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

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali mediante il DSN.

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

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali mediante la connessione basata su DSNless.

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

PostgreSQL

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali con gli attributi SSL aggiunti nella stringa di connessione.

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

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali mediante il DSN.

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

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali mediante la connessione basata su DSNless.

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

Sybase

Di seguito sono riportati alcuni esempi di creazione di credenziali in Admin Client per Sybase.

Nell'esempio seguente viene visualizzata una connessione basata su host e porta senza attributi aggiuntivi per il database Sybase.

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

Nell'esempio seguente viene visualizzata una connessione basata su host e porta al database Sybase con attributi aggiuntivi e SSL abilitato.

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 per i e DB2 per z/OS

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali mediante il DSN.

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

Nell'esempio seguente vengono aggiunti i dettagli di connessione al database nell'area di memorizzazione delle credenziali mediante la connessione basata su DSNless.

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