ALTER CREDENTIALSTORE

Use este comando para criar aliases de armazenamento de credenciais que contenham credenciais de banco de dados que incluam nome de usuário e senha com os detalhes da conexão. Os aliases de armazenamento de credenciais podem então ser usados para estabelecer conexões de banco de dados dentro da implantação.

Consulte Adicionar e Alterar Credenciais do Banco de Dados para configurar as conexões de banco de Dados na interface Web do MA.

O uso de um armazenamento de credenciais não é suportado nas plataformas NonStop.

Sintaxe

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

Adiciona o usuário especificado ao alias de armazenamento de credenciais. Se a opção ALIAS não for usada, o nome do alias assumirá como padrão o da opção userid. Se a opção DOMAIN não for fornecida, o domínio assumirá como padrão o domínio OracleGoldenGate. Para bancos de dados do Oracle multitenant com diferentes usuários para o CDB e o PDB, você precisa especificar @tns_service_name ao adicionar um usuário do banco de dados ao armazenamento da credencial.

userid@dbhost:dbport/dbname[;connection_options]

Para bancos de dados que suportam strings de conexão, como banco de dados Oracle, MySQL, SQL Server, PostgreSQL e Db2, adiciona as informações de usuário e conexão especificadas a um alias de armazenamento de credenciais. As informações da string de conexão devem incluir o nome do servidor de banco de dados, a porta do banco de dados e o nome do banco de dados. A seguir estão as opções de conexão adicionais (por banco de dados) que estão disponíveis para adicionar à string de conexão:

A opção ALIAS é obrigatória ao criar um alias com detalhes de conexão do banco de dados

O formato de conexão obrigatório é:

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

Por exemplo:

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

userid @ odbc-dsn

Para bancos de dados que suportam conexões DSN no ODBC, incluindo a Série Db2 for i, Db2 LUW, Db2 z/OS, SQL Server e PostgreSQL, adiciona as informações de conexão DSN ao armazenamento de credenciais. Os detalhes da conexão DSN devem existir no sistema, como em um arquivo odbc.ini para Linux ou como um DSN do Sistema criado em Windows usando o cliente 64 bits de fontes de dados ODBC.

A opção ALIAS é necessária ao criar um alias com um DSN.

O formato de conexão obrigatório é:

userid@odbc-dsn

Por exemplo:

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

DELETE USER alias

Remove a credencial do alias especificado. Se a opção ALIAS não for fornecida, o nome do alias assumirá como padrão o nome do userid. Se a opção DOMAIN não for fornecida, o armazenamento de credenciais assumirá como padrão o domínio OracleGoldenGate.

Por exemplo:

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

Substitui o usuário de um determinado alias ou pode ser usado para alterar a senha de um usuário existente. Se a opção ALIAS não for fornecida, o nome do alias assumirá como padrão o nome do userid. Se a opção DOMAIN não for fornecida, o armazenamento de credenciais assumirá como padrão o domínio OracleGoldenGate.

A menos que a opção PASSWORD seja usada, o comando solicitará que você informe uma senha para o usuário especificado. Ao alterar a senha de um usuário que inclui informações de conexão com o banco de Dados, você deverá incluir o valor completo do userid atual; caso contrário, esse comando substituirá o usuário com o novo valor fornecido.

O exemplo a seguir mostra como alterar a senha de um usuário existente ggadmin@sourcedsn, alias SourceMSSQLConnection.

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

O exemplo mostra como alterar o usuário ggadmin do alias pdbeast para um novo usuário, que, em seguida, solicita a senha.

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

Especifica um alias para o nome do usuário. Use essa opção se você não quiser que o nome do usuário esteja em um arquivo de parâmetros ou comando. Se ALIAS não for fornecido, o alias assumirá como padrão o nome USER, que deverá ser usado em arquivos de parâmetro e comandos em que um log-in é necessário. Você pode criar várias entradas para um usuário, cada uma com um alias diferente, usando a opção ADD USER com ALIAS.

DOMAIN domain

Salva o alias da credencial com o nome do domínio fornecido.

O domínio padrão é OracleGoldenGate. Por meio da escolha de nomes de domínio exclusivos, o mesmo alias pode ser usado por diversas instalações do Oracle GoldenGate que usam o mesmo armazenamento de credenciais. Por exemplo, os administradores do sistema 1 podem não querer que o sistema 2 tenha acesso às mesmas credenciais usadas no sistema 1. Essas credenciais podem ser armazenadas como ALIAS pdbeast, por exemplo, em DOMAIN system1, enquanto outro conjunto de credenciais pode ser armazenado para ALIAS pdbeast em DOMAIN system2.

NOPASSWORD | PASSWORD password

Especifique a senha do usuário usando a opção PASSWORD. A senha é refletida (não obscurecida) quando essa opção é usada. Se essa opção for omitida, o comando solicitará a senha, que é obscurecida conforme é digitada (recomendado como mais seguro).

O Oracle GoldenGate 26ai suporta um máximo de 1024 bytes de senha.

A opção NOPASSWORD é a alternativa à opção PASSWORD ao usar a autenticação externa porque a senha não é necessária para autenticação externa, como o uso da autenticação Kerberos ou do IDCS. Após a definição da opção NOPASSWORD, o comando DBLOGIN poderá ser usado para acessar o banco de dados sem uma senha.

A partir do 26ai, você pode usar palavras-chave para denotar diferentes tipos de credenciais para conexões de banco de dados, em vez de usar a opção NOPASSWORD. Os tipos de credencial disponíveis diferentes de NOPASSWORD são:

Autenticação Kerberos: é possível usar a palavra-chave KERBEROS, conforme mostrado na seguinte sintaxe:

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
Autenticação baseada em plug-in: Você pode usar a palavra-chave PLUGIN com ou sem o segredo do plug-in, conforme mostrado na seguinte sintaxe:

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

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

Para credenciais de Plug-in criadas com PLUGIN SECRET , o GoldenGate também passa o segredo do plug-in armazenado para o callback do plug-in como um item de metadados.

O formato existente para adicionar uma credencial de Plug-in ainda é suportado. Se você usar o formato existente, o Admin Client não passará o tipo de credencial.
Autenticação OAuth para Microsoft EntraID: A sintaxe para adicionar uma credencial de ID de Entra usa OAUTHSECRET como palavra-chave no comando. Ele marca a string fornecida como um segredo de cliente do ID do Microsoft Entra. Para um ID de Entra USERIDALIAS, como ggwest-entra, o armazenamento de Credenciais só persiste no segredo do cliente, conforme mostrado na seguinte sintaxe:

ALTERAR ARMAZENAMENTO DE CREDENCIAIS ADICIONAR USUÁRIO /@ ALIAS OAUTHSECRET

Veja uma tabela para descrever como esses comandos definem o tipo de uma credencial dependendo da sintaxe usada.

Consulte também o parâmetro USERIDALIAS no Parameters and Functions Reference for Oracle GoldenGate.

Valores de Conexão para Configuração de Segurança

Estas são definições de string de conexão opcionais que podem ser adicionadas a um alias de credencial, incluindo os atributos SSL. Eles devem ser especificados como lista de atributos separada por ponto-e-vírgula, por exemplo, option1=value1;option2=value2;option3=value3, em que as opções são as propriedades específicas do banco de dados, juntamente com seus valores permitidos.

Veja a seguir uma lista de opções adicionais de string de conexão que podem ser adicionadas a um alias de credencial, incluindo os atributos SSL.

Observação: A Arquitetura de Microsserviços do Oracle GoldenGate suporta conexões SSL configurando determinados parâmetros SSL como variáveis de ambiente. Todavia, essa configuração limita os processos Extract e Replicat a estabelecer conexão usando apenas as variáveis de ambiente SSL definidas para uma implantação, e nenhuma outra conexão é possível, seja SSL ou não. Entretanto, um alias de armazenamento de credenciais oferece a flexibilidade de configurar as credenciais com parâmetros distintos, sejam SSL ou não, para conexões de bancos de dados diferentes dentro da mesma implantação.

sslCA: Somente para MySQL e PostgreSQL. O certificado usado para verificar a autenticidade dos certificados SSL no formato PEM.
sslCert: Para MySQL e PostgreSQL. O arquivo de Certificado SSL do cliente no formato PEM.
sslCrl: Para MySQL. O nome do arquivo que contém lista de revogação de certificação no formato PEM.
sslKey: Para MySQL e PostgreSQL. O arquivo de chave privada do cliente no formato PEM.
sslMode: Para MySQL e PostgreSQL. Os valores do parâmetro sslMode só são especificados em letras maiúsculas. As opções do sslMode para MySQL são VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED. As opções do sslMode para PostgreSQL são VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER.

Para o sslMode=VERIFY_IDENTITY, é obrigatório fornecer sslPath, sslCa, sslCert e sslKey. Para sslMode=VERIFY_CA, é obrigatório fornecer sslPath e sslCa.
sslPath: Somente para MySQL. O caminho do diretório que contém arquivos de certificado da Autoridade de Certificação (CA) ssl confiáveis no formato PEM.

Exemplos

Oracle

Este exemplo adiciona um usuário chamado ggadmin, mas omite a especificação PASSWORD, de modo que o comando solicita uma senha do banco de dados plugável, pdbeast.

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

Este exemplo adiciona o usuário ggadmin com esta senha tiger e especifica o alias como pdbeast.

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

Este exemplo adiciona o usuário ggadmin no domínio do OracleGoldenGate.

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

Este exemplo adiciona o usuário ggadmin usando o Método de Nomeação Easy Connect.

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

Este exemplo emite dois comandos ALTER CREDENTIALSTORE, um dos quais adiciona uma entrada ggadmin, mas com um alias diferente.

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

Este exemplo mostra o comando ALTER CREDENTIALSTORE para autenticação Kerberos usando a palavra-chave KERBEROS.

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

Este exemplo mostra o comando ALTER CREDENTIALSTORE para autenticação baseada em Plug-in usando a palavra-chave PLUGIN.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

Este exemplo usa a palavra-chave PLUGIN SECRET:

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

O exemplo a seguir mostra o uso da palavra-chave OAUTH para adicionar credenciais com o Microsoft EntraID.

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

A seguir mostra como a opção DELETE USER funciona com e sem a opção ALIAS.

O seguinte comando exclui a entrada user1 cuja ALIAS é igual ao nome de usuário.

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

O comando seguinte exclui a entrada do usuário ggadmin que está associada ao alias pdbeast.

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

Este exemplo usa uma string de conexão do SQL*Net como valor do usuário. Nesse caso, a opção PASSWORD é omitida. A pessoa que está emitindo o comando é solicitada a informar a senha, que é ocultada.

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

Este exemplo cria um nome de domínio Oracle GoldenGate com ID do usuário ggadmin e alias como pdbeast no Cliente Admin.

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

O exemplo a seguir se conecta usando um qualificador de conexão se estiver usando um adaptador BEQ-Bequeath Protocol. Para obter mais informações sobre como estabelecer uma conexão segura usando um adaptador BEQ-Bequeath Protocol, consulte Configurar Conexão de Banco de Dados Segura

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

O exemplo a seguir (Cliente Admin) adiciona um usuário chamado ggadmin, mas com autenticação externa e, portanto, usa a opção NOPASSWORD.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

Executando o comando INFO CREDENTIALSTORE, você pode verificar o usuário de adição ao armazenamento de credenciais:

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

Depois de atualizar o armazenamento de credenciais para usar a opção NOPASSWORD, você poderá usar o comando DBLOGIN com a autenticação do Kerberos para seu banco.

DBLOGIN USERIDALIAS pdbeast

MySQL

Veja a seguir alguns exemplos para criar a credencial no Admin Client para MySQL.

Este exemplo adiciona credenciais de banco de dados sem atributo SSL na string de conexão.

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

Este exemplo adiciona detalhes de conexão do banco de dados no armazenamento de credenciais com atributos SSL adicionados na string de conexão.

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

O exemplo a seguir adiciona detalhes de conexão do banco de dados no armazenamento de credenciais usando o DSN.

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

O exemplo a seguir adiciona detalhes da conexão do banco de dados no armazenamento de credenciais usando a conexão baseada em DSNless.

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

PostgreSQL

O exemplo a seguir adiciona detalhes de conexão do banco de dados no armazenamento de credenciais com atributos SSL adicionados na string de conexão.

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

O exemplo a seguir adiciona detalhes de conexão do banco de dados no armazenamento de credenciais usando o DSN.

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

O exemplo a seguir adiciona detalhes da conexão do banco de dados no armazenamento de credenciais usando a conexão baseada em DSNless.

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

Sybase

A seguir estão alguns exemplos para criar credenciais no Admin Client para Sybase.

O exemplo a seguir exibe uma conexão baseada em host e porta sem atributos adicionais ao banco de dados Sybase.

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

O exemplo a seguir exibe uma conexão baseada em host e porta com o banco de dados Sybase com atributos adicionais e SSL ativado.

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

O exemplo a seguir adiciona detalhes de conexão do banco de dados no armazenamento de credenciais usando o DSN.

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

O exemplo a seguir adiciona detalhes da conexão do banco de dados no armazenamento de credenciais usando a conexão baseada em DSNless.

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