ALTER CREDENTIALSTORE

Utilice este comando para crear alias de almacén de credenciales que contengan credenciales de base de datos que incluyan el nombre de usuario y la contraseña con los detalles de conexión. Posteriormente, los alias del almacén de credenciales se pueden utilizar para establecer conexiones a base de datos dentro del despliegue.

Consulte Agregar y Modificar Credenciales de Base de Datos para configurar las conexiones de bases de datos desde la interfaz web MA.

El uso de un almacén de credenciales no está soportado para las plataformas NonStop.

Sintaxis

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

Agrega el usuario especificado al alias del almacén de credenciales. Si no se utiliza la opción ALIAS, el alias utiliza por defecto el nombre de userid. Si no se proporciona la opción DOMAIN, el dominio toma por defecto el dominio OracleGoldenGate. Para las bases de Datos de Oracle multiinquilino con diferentes usuarios para la CDB y la PDB, debe especificar @tns_service_name al agregar un usuario de base de Datos al almacén del credenciales.

userid@dbhost:dbport/dbname[;connection_options]

Para las bases de datos que soportan cadenas de conexión como la base de datos Oracle, MySQL, SQL Server, PostgreSQL y Db2, agrega la información de usuario y conexión especificada a un alias de almacén de credenciales. La información, de la cadena de conexión debe incluir el nombre del servidor de base de datos, el puerto de base de datos y el nombre de base de datos. A continuación se indican las opciones de conexión adicionales (por base de datos) que están disponibles para agregarlas a la cadena de conexión:

La opción ALIAS es necesaria al crear un alias con detalles de conexión a la base de datos

El formato de conexión necesario es el siguiente:

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

Por ejemplo:

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

userid @ odbc-dsn

Para las bases de datos que soportan las conexiones DSN a través de ODBC, incluida la serie Db2 for i, Db2 LUW, Db2 z/OS, SQL Server y PostgreSQL, agrega la información de la conexión DNS al almacén de credenciales. Los detalles de conexión DSN deben existir en el sistema, por ejemplo, en un archivo odbc.ini para Linux o como un DSN de sistemas creados en Windows utilizando el cliente de 64 bits de orígenes del dato ODBC.

La opción ALIAS es necesaria al crear un alias con un DSN.

El formato de conexión necesario es el siguiente:

userid@odbc-dsn

Por ejemplo:

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

DELETE USER alias

Elimina la credencial del alias especificado. Si no se proporciona la opción ALIAS, el nombre de alias predeterminado es el de userid. Si no se proporciona la opción DOMAIN, el almacén de credenciales toma por defecto el dominio OracleGoldenGate.

Por ejemplo:

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

Sustituye el usuario de un alias proporcionado o se puede utilizar para cambiar la contraseña de un usuario existente. Si no se proporciona la opción ALIAS, el nombre de alias se define por defecto en el de userid. Si no se proporciona la opción DOMAIN, el almacén de credenciales toma por defecto el dominio OracleGoldenGate.

A menos que Se utilice la opción PASSWORD, el comando solicita que introduzca una contraseña para el usuario especificado. Al cambiar la contraseña para un usuario que incluya el valor completo del userid actual; de lo contrario, este comando sustituirá al usuario con el nuevo valor proporcionado.

En el siguiente ejemplo se muestra cómo cambiar la contraseña de un usuario existente ggadmin@sourcedsn, alias SourceMSSQLConnection.

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

En el ejemplo se muestra cómo cambiar el usuario ggadmin del alias pdbeast a un nuevo usuario que, a continuación, solicita la contraseña.

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

Especifica un alias para el nombre de usuario. Utilice esta opción si no desea que el nombre de usuario esté en un archivo de parámetros o un comando. Si no se utiliza el valor ALIAS, el alias se utiliza por defecto de nombre de USER, el cual se debe utilizar en el archivo de parámetros y en el que se requiera una conexión. Puede crear varias entradas para un usuario, cada una con un alias diferente mediante el uso de la opción ADD USER con ALIAS.

DOMAIN domain

Guarda el alias de credencial bajo el nombre de dominio proporcionado.

El dominio por defecto es OracleGoldenGate. Al seleccionar nombre de dominio únicos, se puede utilizar el mismo alias en varias instalaciones de Oracle GoldenGate que utilicen el mismo almacén de credenciales. Por ejemplo, es posible que los administradores del sistema 1 no deseen que el sistema 2 tenga acceso a las mismas credenciales que se utilizan en el sistema 1. Estas credenciales se pueden almacenar como ALIAS pdbeast, por ejemplo, en DOMAIN system1, mientras que se puede almacenar un juego diferente de credenciales para ALIAS en pdbeast en DOMAIN system2.

NOPASSWORD | PASSWORD password

Especifique la contraseña del usuario mediante la opción PASSWORD. La contraseña aparece en la pantallas (no se ofusca) cuando se utiliza esta opción. Si se omite esta opción, el comando solicita la contraseña, la cual se ofusca a medida que se escribe (recomendado, ya que es más seguro).

Oracle GoldenGate 26ai soporta una longitud de contraseña máxima de 1024 bytes.

Esta opción NOPASSWORD es la alternativa a la opción PASSWORD al utilizar una autenticación externa, ya que no es necesaria la contraseña para la autenticación externa, como puede ser el uso de autenticación Kerberos o IDCS. Una vez definida la opción NOPASSWORD, se puede utilizar el comando DBLOGIN para acceder a la base de datos sin una contraseña.

A partir de 26ai, puede utilizar palabras clave para indicar diferentes tipos de credenciales para las conexiones de base de datos, en lugar de utilizar la opción NOPASSWORD. Los tipos de credenciales disponibles que no sean NOPASSWORD son:

Autenticación de Kerberos: puede utilizar la palabra clave KERBEROS, como se muestra en la siguiente sintaxis:

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
Autenticación basada en plugin: puede utilizar la palabra clave PLUGIN con o sin el secreto de plugin, como se muestra en la siguiente sintaxis:

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

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

Para las credenciales de PLUGIN creadas con PLUGIN SECRET , GoldenGate también transfiere el secreto de PLUGIN almacenado a la devolución de llamada de PLUGIN como elemento de metadatos.

El formato existente para agregar una credencial de plugin sigue siendo compatible. Si utiliza el formato existente, el cliente de administración no transferirá el tipo de credencial.
Autenticación OAuth para Microsoft EntraID: la sintaxis para agregar una credencial de ID adicional utiliza OAUTHSECRET como palabra clave en el comando. Marca la cadena proporcionada como secreto de cliente de Microsoft Entra ID. Para un ID de Entra USERIDALIAS, como ggwest-entra, el almacén de credenciales solo mantiene el secreto de cliente, como se muestra en la siguiente sintaxis:

MODIFICAR ALMACÉN DE CREDENCIALES AGREGAR USUARIO /@ ALIAS OAUTHSECRET

A continuación, se muestra una tabla para describir cómo estos comandos definen el tipo de credencial en función de la sintaxis utilizada.

Consulte también el parámetro USERIDALIAS en la Referencia de parámetros y funciones para Oracle GoldenGate.

Valores de conexión para configuración de seguridad

Estos son valores de cadena de conexión opcionales que se pueden agregar a un alias de credencial, incluidos los atributos SSL. Se deben especificar como lista de atributos separados por punto y coma, por ejemplo, option1=value1;option2=value2;option3=value3, donde las opciones son las propiedades específicas de la base de datos junto con sus valores permitidos.

A continuación, se muestra una lista de opciones de cadena de conexión adicionales que se pueden agregar a un alias de credencial, incluidos los atributos SSL.

Nota: la arquitectura de microservicios de Oracle GoldenGate soporta conexiones SSL mediante la configuración de determinados parámetros SSL como variables de entorno. Sin embargo, esta configuración limita el proceso del Extract y el Replicat para conectarse usando solo las variables de entorno SSL definidas para un despliegue y no permite ninguna otra conexión SSl o no SSL. No obstante, un alias de almacén de credenciales también ofrece flexibilidad para configurar las credenciales con parámetros SSL o no SSL diferentes para conexiones a base de datos diferentes dentro del mismo despliegue.

sslCA: solo para MySQL y PostgreSQL. Certificado utilizado para verificar la autenticidad de los certificados SSL en formato PEM.
sslCert: para MySQL y PostgreSQL. El archivo de certificado SSL del cliente en formato PEM.
sslCrl: para MySQL. Nombre del archivo que contiene listas para revocar certificados en formato PEM.
sslKey: para MySQL y PostgreSQL. El archivo de clave privada del cliente en formato PEM.
sslMode: para MySQL y PostgreSQL. Los valores del parámetro sslMode se especifican solo en mayúsculas. Las opciones sslMode para MySQL son VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED. Las opciones sslMode para PostgreSQL son VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER.

Para sslMode=VERIFY_IDENTITY, es obligatorio proporcionar sslPath, sslCa, sslCert y sslKey. Para sslMode=VERIFY_CA, es obligatorio proporcionar sslPath y sslCa.
sslPath: solo para MySQL. La ruta del directorio que contiene archivos de certificado de autoridad de certificación (CA) ssl de confianza en formato PEM.

Ejemplos

Oracle

En este ejemplo se agrega un usuario denominado ggadmin, pero omite la especificación PASSWORD, por lo que el comando solicita una contraseña de la base de datos de conexión, pdbeast.

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

En este ejemplo se agrega el usuario ggadmin con esta contraseña tiger y se especifica el alias como pdbeast.

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

En este ejemplo se agrega el usuario ggadmin bajo el dominio de OracleGoldenGate.

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

En este ejemplo, se agrega el usuario ggadmin mediante el método de nomenclatura de conexión sencilla.

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

En este ejemplo se emiten dos comandos ALTER CREDENTIALSTORE, cada una de las cuales agrega una entrada ggadmin, pero con un alias diferente.

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

En este ejemplo se muestra el comando ALTER CREDENTIALSTORE para la autenticación de Kerberos mediante la palabra clave KERBEROS.

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

En este ejemplo se muestra el comando ALTER CREDENTIALSTORE para la autenticación basada en plugin mediante la palabra clave PLUGIN.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

En este ejemplo se utiliza la palabra clave PLUGIN SECRET:

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

En el siguiente ejemplo se muestra el uso de la palabra clave OAUTH para agregar credenciales con Microsoft EntraID.

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

The following shows how the DELETE USER option works with and without the ALIAS option.

El siguiente comando suprime la entrada user1 para la cual el ALIAS es el mismo que el nombre de usuario.

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

El siguiente comando suprime la entrada del usuario ggadmin que está asociada al alias pdbeast.

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

En este ejemplo se utiliza una cadena de conexión de SQL*Net como valor de usuario. En este caso, se omite la opción PASSWORD. A la persona que emite el comando se le solicita la contraseña, la cual está oculta.

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

En este ejemplo se crea un nombre Oracle GoldenGate con un identificador de usuario ggadmin y un alias pdbeast en el cliente de administración.

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

En el siguiente ejemplo se realiza la conexión mediante un cualificador de conexiones si se utiliza un adaptador BEQ-Bequeath Protocol. Para obtener más información sobre cómo establecer una conexión segura mediante un adaptador BEQ-Bequeath Protocol, consulte Configuración de una conexión de base de datos segura.

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

En el siguiente ejemplo (cliente de administración) se agrega un usuario denominado ggadmin pero con autenticación externa, por tanto, utiliza la opción NOPASSWORD.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

Ejecutando el comando INFO CREDENTIALSTORE, puede comprobar la adición de usuario en el almacén de credenciales:

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

Después de actualizar el Almacén de Credenciales para utilizar la opción NOPASSWORD, puede usar el comando DBLOGIN con el autenticación Kerberos para la base de datos.

DBLOGIN USERIDALIAS pdbeast

MySQL

A continuación se muestran algunos ejemplos para crear credenciales en el cliente de administración para MySQL.

En este ejemplo, se agregan credenciales de base de datos sin atributo SSL en la cadena de conexión.

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

En este ejemplo, se agregan detalles de conexión de base de datos en el almacén de credenciales con atributos SSL agregados en la cadena de conexión.

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

En el siguiente ejemplo, se agregan detalles de conexión de base de datos en el almacén de credenciales mediante el DSN.

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

En el siguiente ejemplo se agregan detalles de conexión de base de datos en el almacén de credenciales mediante la conexión basada en DSNless.

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

PostgreSQL

En el siguiente ejemplo, se agregan detalles de conexión de base de datos en el almacén de credenciales con atributos SSL agregados en la cadena de conexión.

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

En el siguiente ejemplo, se agregan detalles de conexión de base de datos en el almacén de credenciales mediante el DSN.

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

En el siguiente ejemplo se agregan detalles de conexión de base de datos en el almacén de credenciales mediante la conexión basada en DSNless.

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

Sybase

A continuación se muestran algunos ejemplos para crear credenciales en el cliente de administración para Sybase.

En el siguiente ejemplo, se muestra una conexión basada en host y puerto sin atributos adicionales a la base de datos Sybase.

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

En el siguiente ejemplo, se muestra una conexión basada en host y puerto a la base de datos Sybase con atributos adicionales y SSL activado.

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 para i y DB2 para z/OS

En el siguiente ejemplo, se agregan detalles de conexión de base de datos en el almacén de credenciales mediante el DSN.

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

En el siguiente ejemplo se agregan detalles de conexión de base de datos en el almacén de credenciales mediante la conexión basada en DSNless.

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