ALTER CREDENTIALSTORE

Utilisez cette commande pour créer des alias de banque d'informations d'identification qui contiennent des informations d'identification de base de données incluant le nom utilisateur et le mot de passe avec les détails de connexion. Les alias de banque d'informations d'identification peuvent ensuite être utilisés pour établir des connexions de base de données au sein du déploiement.

Reportez-vous à Ajout et modification d'informations d'identification de base de donnée pour configurer les connexions de base de donnée à partir de l'API Web MA.

L'utilisation d'une banque d'informations d'identification n'est pas prise en charge pour les plates-formes NonStop.

Syntaxe

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

Ajoute l'utilisateur indiqué à l'alias de banque d'informations d'identification. Si l'option ALIAS n'est pas utilisée, l'alias par défaut est celui de userid. Si l'option DOMAIN n'est pas fournie, le domaine est par défaut le domaine OracleGoldenGate. Pour des bases de_données Oracle colocatives dont les utilisateurs de base de_données Conteneur et de base de_données pluggable sont différents, vous devez indiquer @tns_service_name lors de l'ajout d'un utilisateur de base de_données à la banque d'informations d'identification.

userid@dbhost:dbport/dbname[;connection_options]

Pour les bases de données qui prennent en charge des chaînes de connexion telles que la base de données Oracle, MySQL, SQL Server, PostgreSQL et Db2, ajoute les informations de connexion et d'utilisateur indiquées à un alias de banque d'informations d'identification. Les informations de chaîne de connexion doivent inclure le nom de serveur, le port et le nom de la base de données. Voici les autres options de connexion (par base de données) disponibles pour l'ajout de la chaîne de connexion :

L'option ALIAS est requise lors de la création d'un alias avec les détails de connexion à la base de données

Le format de connexion requis est le suivant :

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

Exemple :

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

userid @ odbc-dsn

Pour les bases de données qui prennent en charge les connexions DSN sur ODBC, notamment DB2 for iSeries, DB2 LUW, DB2 z/OS, SQL Server et PostgreSQL, ajoute les informations de connexion DSN à la banque d'informations d'identification. Les détails de connexion DSN doivent exister sur le système, par exemple dans un fichier odbc.ini pour Linux ou sous forme d'un DSN système créé sous Windows à l'aide du client 64 bits des sources des données ODBC.

L'option ALIAS est requise lors de la création d'un alias avec un DSN.

Le format de connexion requis est le suivant :

userid@odbc-dsn

Exemple :

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

DELETE USER alias

Enlève les informations d'identification de l'alias indiqué. Si l'option ALIAS n'est pas fournie, le nom d'alias est par défaut celui de userid. Si l'option DOMAIN n'est pas fournie, la banque d'informations d'identification utilise par défaut le domaine OracleGoldenGate.

Exemple :

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

Remplace l'utilisateur d'un alias donné ou peut servir à modifier le mot de passe d'un utilisateur existant. Si l'option ALIAS n'est pas fournie, le nom d'alias est par défaut celui de userid. Si l'option DOMAIN n'est pas fournie, la banque d'informations d'identification utilise par défaut le domaine OracleGoldenGate.

A moins que l'option PASSWORD ne soit utilisée, la commande invite l'utilisateur indiqué à saisir un mot du passe. Lorsque Vous changez un mot de passe utilisateur associé à des informations de connexion de la base de données, Vous devez inclure la valeur complète de l'ID utilisateur (userid) en cours. Dans un cas contraire, la commande remplace l'utilisateur par la nouvelle valeur fournie.

L'exemple suivant montre comment modifier le mot de passe d'un utilisateur existant ggadmin@sourcedsn, alias SourceMSSQLConnection.

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

L'exemple montre comment remplacer l'utilisateur ggadmin de l'alias pdbeast par un nouvel utilisateur, qui vous invite ensuite à saisir le mot de passe.

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

Indique un alias pour le nom utilisateur. Utilisez cette option si vous ne voulez pas que le nom utilisateur apparaisse dans un fichier de paramètres ou une commande. Si l'option ALIAS n'est pas fournie, l'alias par défaut correspond au nom USER, qui doit être employé dans les fichiers de paramètres et les commandes pour lesquelles une connexion est requise. Vous pouvez créer plusieurs entrées pour un nouvel utilisateur, avec un alias différent, en utilisant l'option ADD USER avec ALIAS.

DOMAIN domain

Enregistre l'alias d'informations d'identification sous le nom de domaine indiqué.

Le domaine par défaut est OracleGoldenGate. Le choix de noms de domaine uniques permet à un même alias d'être utilisé par différentes installations Oracle GoldenGate employant la même banque d'informations d'identification. Imaginons que les administrateurs d'un système 1 ne veulent pas qu'un système 2 accède aux informations d'identification utilisées par le système 1. Ces informations d'identification peuvent être stockées sous ALIAS pdbeast, par exemple, sous DOMAIN system1, tandis qu'un autre ensemble d'informations d'identification peut être stocké pour ALIAS sous DOMAIN system2.

NOPASSWORD | PASSWORD password

Indiquez le mot de passe de l'utilisateur en utilisant l'option PASSWORD. Le mot de passe est affiché (non brouillé) lorsque cette option est employée. Si cette option est omise, la commande invite à entrer le mot de passe qui est brouillé au fur et à mesure de sa saisie (recommandé pour plus de sécurité).

Oracle GoldenGate 26ai prend en charge un mot de passe maximal de 1024 octets.

L'option NOPASSWORD est l'alternative à l'option PASSWORD lors de l'utilisation de l' authentification externe car ce mot de passe n'est pas requis en tant que recours à l'authentification externe telle que Kerberos ou IDCS. Une fois l'option NOPASSWORD définie, la commande DBLOGIN peut être utilisée pour accéder à la base de données sans mot de passe.

A partir de la version 26ai, vous pouvez utiliser des mots-clés pour indiquer différents types d'informations d'identification pour les connexions de base de données, au lieu d'utiliser l'option NOPASSWORD. Les types d'informations d'identification disponibles autres que NOPASSWORD sont les suivants :

Authentification Kerberos : vous pouvez utiliser le mot-clé KERBEROS, comme indiqué dans la syntaxe suivante :

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
Authentification basée sur un module d'extension : vous pouvez utiliser le mot-clé PLUGIN avec ou sans la clé secrète du module d'extension, comme indiqué dans la syntaxe suivante :

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

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

Pour les informations d'identification de module d'extension créées avec PLUGIN SECRET , GoldenGate transmet également la clé secrète de module d'extension stockée au callback de module d'extension en tant qu'élément de métadonnées.

Le format existant pour ajouter des informations d'identification de module d'extension est toujours pris en charge. Si vous utilisez le format existant, le client d'administration ne transmet pas le type d'informations d'identification.
Authentification OAuth pour Microsoft EntraID : la syntaxe permettant d'ajouter des informations d'identification Entra ID utilise OAUTHSECRET en tant que mot-clé dans la commande. Il marque la chaîne fournie comme une clé secrète client Microsoft Entra ID. Pour un ID d'entrée USERIDALIAS tel que ggwest-entra, la banque d'informations d'identification conserve uniquement la clé secrète client, comme indiqué dans la syntaxe suivante :

MODIFICATION DU FICHIER D'INFORMATIONS D'IDENTIFICATION AJOUTER UN UTILISATEUR /@ ALIAS OAUTHSECRET

Le tableau ci-dessous décrit comment ces commandes définissent le type d'informations d'identification en fonction de la syntaxe utilisée.

Reportez-vous également au paramètre USERIDALIAS dans la référence des paramètres et des fonctions pour Oracle GoldenGate.

Valeurs de connexion pour la configuration de la sécurité

Il s'agit de paramètres de chaîne de connexion facultatifs qui peuvent être ajoutés à un alias d'informations d'identification, y compris les attributs SSL. Ils doivent être indiqués sous forme de liste d'attributs séparés par des points-virgules, par exemple, option1=value1;option2=value2;option3=value3, où les options sont les propriétés propres à la base de données avec leurs valeurs autorisées.

Vous trouverez ci-dessous la liste des options de chaîne de connexion supplémentaires qui peuvent être ajoutées à un alias d'informations d'identification, y compris les attributs SSL.

Remarque : l'architecture des microservices Oracle GoldenGate prend en charge les connexions SSL en configurant certains paramètres SSL en tant que variables d'environnement. Toutefois, avec cette configuration, le processus d'extraction et de réplication ne peut se connecter qu'avec les variables d'environnement SSL définies pour un déploiement. Aucune autre connexion SSL ou non SSL n'est possible. Cependant, un alias de banque d'informations d'identification permet également de configurer les informations d'identification avec divers paramètres SSL ou non SSL pour différentes connexions de base de données au sein du même déploiement.

sslCA : pour MySQL et PostgreSQL uniquement. Certificat utilisé pour vérifier l'authenticité des certificats SSL au format PEM.
sslCert : pour MySQL et PostgreSQL. Le fichier de certificat SSL du client au format PEM.
sslCrl : pour MySQL. Nom du fichier contenant les listes de certificats révoqués au format PEM.
sslKey : pour MySQL et PostgreSQL. Fichier de clés privées du client au format PEM.
sslMode : pour MySQL et PostgreSQL. Les valeurs de paramètre sslMode sont indiquées en majuscules uniquement. Les options sslMode pour MySQL sont VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED. Les options sslMode pour PostgreSQL sont VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER.

Pour sslMode=VERIFY_IDENTITY, il est obligatoire de fournir sslPath, sslCa, sslCert et sslKey. Pour sslMode=VERIFY_CA, il est obligatoire de fournir sslPath et sslCa.
sslPath : pour MySQL uniquement. Chemin du répertoire contenant les fichiers de certificats SSL sécurisés au format PEM.

Exemples

Oracle

Cet exemple ajoute un utilisateur nommé ggadmin mais omet la spécification PASSWORD. La commande demande donc le Mot de passe de la base de données pluggable pdbeast.

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

Cet exemple ajoute l'utilisateur ggadmin avec le mot de passe tiger et spécifie l'alias pdbeast.

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

Cet exemple ajoute l'utilisateur ggadmin sous le domaine OracleGoldenGate.

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

Cet exemple ajoute l'utilisateur ggadmin à l'aide de la méthode de résolution de noms Easy Connect.

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

Cet exemple émet deux commandes ALTER CREDENTIALSTORE, chacune d'elles ajoutant une entrée ggadmin, mais avec un alias différent.

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

Cet exemple montre la commande ALTER CREDENTIALSTORE pour l'authentification Kerberos à l'aide du mot-clé KERBEROS.

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

Cet exemple présente la commande ALTER CREDENTIALSTORE pour l'authentification basée sur un module d'extension à l'aide du mot-clé PLUGIN.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

Cet exemple utilise le mot-clé PLUGIN SECRET :

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

L'exemple suivant illustre l'utilisation du mot-clé OAUTH pour ajouter des informations d'identification avec Microsoft EntraID.

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

L'exemple suivant illustre l'option DELETE USER utilisée avec et sans l'option ALIAS.

La commande suivante supprime l'entrée user1 dont la valeurALIAS est identique au nom utilisateur.

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

La commande suivante supprime l'entrée de l'utilisateur ggadmin associée à l'alias pdbeast.

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

Cet exemple emploie une chaîne de connexion SQL*Net comme valeur d'utilisateur. Dans ce cas, l'option PASSWORD est omise. La personne émettant la commande est invitée à saisir le mot de passe qui est masqué.

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

Cet exemple crée un domaine nommé Oracle GoldenGate avec l'ID utilisateur ggadmin et l'alias pdbeast dans le client d'administration.

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

L'exemple suivant établit une connexion à l'aide d'un qualificatif de la connexion si un adaptateur BEQ-Bequeath Protocol est employé : Pour plus d'informations sur l'établissement d'une connexion sécurisée à l'aide d'un adaptateur BEQ-Bequeath Protocol, reportez-vous à Configuration d'une connexion de base de données sécurisée.

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

L'exemple suivant (client d'administration) ajoute un utilisateur nommé ggadmin mais avec l'authentification externe, et utilise donc l'option NOPASSWORD.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

En exécutant la commande INFO CREDENTIALSTORE, vous pouvez vérifier l'utilisateur ajouté à la banque d'informations d'identification.

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

Une fois que vous avez mis à jour la banque d'informations d'identification pour utiliser l'option NOPASSWORD, vous pouvez utiliser la commande DBLOGIN avec l'authentification Kerberos pour la base de données.

DBLOGIN USERIDALIAS pdbeast

MySQL

Voici quelques exemples de création d'informations d'identification dans le client d'administration pour MySQL.

Cet exemple ajoute des informations d'identification de base de données sans attribut SSL dans la chaîne de connexion.

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

Cet exemple ajoute des détails de connexion à la base de données dans la banque d'informations d'identification avec des attributs SSL ajoutés dans la chaîne de connexion.

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

L'exemple suivant ajoute des détails de connexion à la base de données dans la banque d'informations d'identification à l'aide du DSN.

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

L'exemple suivant ajoute des détails de connexion à la base de données dans la banque d'informations d'identification à l'aide de la connexion basée sur DSNless.

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

PostgreSQL

L'exemple suivant ajoute des détails de connexion à la base de données dans la banque d'informations d'identification avec des attributs SSL ajoutés dans la chaîne de connexion.

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

L'exemple suivant ajoute des détails de connexion à la base de données dans la banque d'informations d'identification à l'aide du DSN.

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

L'exemple suivant ajoute des détails de connexion à la base de données dans la banque d'informations d'identification à l'aide de la connexion basée sur DSNless.

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

Sybase

Voici quelques exemples de création d'informations d'identification dans le client d'administration pour Sybase.

L'exemple suivant affiche une connexion basée sur un hôte et un port sans attribut supplémentaire à la base de données Sybase.

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

L'exemple suivant affiche une connexion basée sur l'hôte et le port à la base de données Sybase avec des attributs supplémentaires et SSL activé.

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 pour i et DB2 pour z/OS

L'exemple suivant ajoute les détails de connexion à la base de données dans la banque d'informations d'identification à l'aide du DSN.

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

L'exemple suivant ajoute des détails de connexion à la base de données dans la banque d'informations d'identification à l'aide de la connexion basée sur DSNless.

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