ALTER CREDENTIALSTORE

이 명령을 사용하여 접속 세부정보와 함께 사용자 이름 및 비밀번호를 포함하는 데이터베이스 인증서를 포함하는 인증서 저장소 별칭을 생성합니다. 그런 다음 인증서 저장소 별칭을 사용하여 배치 내에 데이터베이스 접속을 설정할 수 있습니다.

MA 웹 인터페이스에서 데이터베이스 접속을 구성하려면 데이터베이스 인증서 추가 및 변경을 참조하십시오.

NonStop 플랫폼의 경우 인증서 저장소 사용이 지원되지 않습니다.

구문

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

지정된 사용자를 인증서 저장소 별칭에 추가합니다. ALIAS 옵션이 사용되지 않을 경우 별칭 이름은 기본적으로 userid의 별칭 이름으로 설정됩니다. DOMAIN 옵션이 제공되지 않은 경우 도메인은 기본적으로 OracleGoldenGate 도메인으로 설정됩니다. CDB 및 PDB에 대한 사용자가 다른 다중 테넌트 CDB 및 PDB 데이터베이스의 경우 인증서 저장소에 데이터베이스 사용자를 추가할 때 @tns_service_name을 지정해야 합니다.

userid@dbhost:dbport/dbname[;connection_options]

Oracle 데이터베이스, MySQL, SQL Server, PostgreSQL 및 Db2와 같은 연결 문자열을 지원하는 데이터베이스의 경우 지정된 사용자 및 연결 정보를 인증서 저장소 별칭에 추가합니다. 접속 문자열 정보에는 데이터베이스 서버 이름, 데이터베이스 포트 및 데이터베이스 이름이 포함되어야 합니다. 접속 문자열에 추가할 수 있는 다른 접속 옵션(데이터베이스당)은 다음과 같습니다.

데이터베이스 접속 세부정보로 별칭을 생성할 때는 ALIAS 옵션이 필요합니다.

필요한 접속 형식은 다음과 같습니다.

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

예:

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

userid @ odbc-dsn

Db2 for i Series, Db2 LUW, Db2 z/OS, SQL Server 및 PostgreSQL을 포함하여 ODBC를 통한 DSN 접속을 지원하는 데이터베이스의 경우 DSN 접속 정보를 인증서 저장소에 추가합니다. DSN 접속 세부정보는 시스템에 존재해야 합니다. 예를 들면, Linux의 odbc.ini 파일에 존재하고 ODBC 데이터 소스 64비트 클라이언트를 사용하여 Windows에 생성된 시스템 DSN으로 존재해야 함.

DSN으로 별칭을 생성할 때는 ALIAS 옵션이 필요합니다.

필요한 접속 형식은 다음과 같습니다.

userid@odbc-dsn

예:

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

DELETE USER alias

지정된 별칭의 인증서를 제거합니다. ALIAS 옵션이 제공되지 않은 경우 별칭 이름은 기본적으로 userid의 별칭 이름으로 설정됩니다. DOMAIN 옵션이 제공되지 않은 경우 인증서 저장소는 기본적으로 OracleGoldenGate 도메인으로 설정됩니다.

예:

ALTER CREDENTIALSTORE DELETE USER src_alias

REPLACE USER userid

지정된 별칭의 사용자를 바꾸거나 기존 사용자의 비밀번호를 변경하는 데 사용될 수 있습니다. ALIAS 옵션이 제공되지 않은 경우 별칭 이름은 기본적으로 userid의 별칭 이름으로 설정됩니다. DOMAIN 옵션이 제공되지 않은 경우 인증서 저장소는 기본적으로 OracleGoldenGate 도메인으로 설정됩니다.

PASSWORD 옵션이 사용되지 않을 경우 명령은 지정된 사용자의 비밀번호를 입력하도록 프롬프트를 표시됩니다. 데이터베이스 접속 정보가 포함된 사용자의 비밀번호를 변경할 때는 현재 userid의 전체 값을 포함해야 합니다. 그렇지 않으면 이 명령은 사용자를 제공된 새 값으로 바꿉니다.

다음 예에서는 기존 사용자 ggadmin@sourcedsn, 별칭 SourceMSSQLConnection의 비밀번호를 변경하는 방법을 보여줍니다.

ALTER CREDENTIALSTORE REPLACE USER ggadmin@sourcedsn PASSWORD newpassword
ALIAS SourceMSSQLConnection

예제에서는 pdbeast 별칭의 사용자 ggadmin를 새 사용자로 변경한 다음 암호를 묻는 메시지를 표시합니다.

ALTER CREDENTIALSTORE REPLACE USER ggadmin ALIAS pdbeast DOMAIN Production

ALIAS alias

사용자 이름에 대한 별칭을 지정합니다. 사용자 이름이 매개변수 파일 또는 명령에 표시되지 않도록 하려면 이 옵션을 사용합니다. ALIAS가 제공되지 않을 경우 USER 이름이 별칭 기본값으로 설정됩니다. 이 별명은 로그인이 필요한 매개변수 파일과 명령에 사용되어야 합니다. ALIAS와 함께 ADD USER 옵션을 사용하여 별칭이 다른 각 사용자에 대해 여러 항목을 생성할 수 있습니다.

DOMAIN domain

제공된 도메인 이름 아래에 인증서 별칭을 저장합니다.

기본 도메인은 OracleGoldenGate입니다. 고유한 도메인 이름을 선택하면 동일한 인증서 저장소를 사용하는 여러 Oracle GoldenGate 설치에서 동일한 별칭을 사용할 수 있습니다. 예를 들어, 시스템 1의 관리자는 시스템 1에서 사용되는 동일한 인증서에 시스템 2가 액세스하지 않도록 할 수 있습니다. 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

PASSWORD 옵션을 사용하여 사용자 암호를 지정합니다. 이 옵션이 사용되면 비밀번호가 에코됩니다(난독화되지 않음). 이 옵션이 생략되면 명령은 입력 시 난독화되는 비밀번호를 묻는 프롬프트를 표시합니다(보다 안전한 것으로 권장됨).

Oracle GoldenGate 26ai에서 지원하는 최대 비밀번호 길이는 1024바이트입니다.

Kerberos 인증이나 IDCS를 사용하는 등 외부 인증에는 비밀번호가 필요하지 않으므로 NOPASSWORD 옵션은 외부 인증을 사용할 때 PASSWORD 옵션을 대체합니다. NOPASSWORD 옵션을 설정한 후 DBLOGIN 명령을 사용하여 비밀번호 없이 데이터베이스에 액세스할 수 있습니다.

26ai부터는 NOPASSWORD 옵션을 사용하는 대신 키워드를 사용하여 데이터베이스 접속에 대해 다양한 유형의 인증서를 나타낼 수 있습니다. NOPASSWORD 이외의 사용 가능한 인증서 유형은 다음과 같습니다.

Kerberos 인증: 다음 구문에 표시된 대로 KERBEROS 키워드를 사용할 수 있습니다.

ALTER CREDENTIALSTORE ADD USER /@<tns_alias> ALIAS <alias> KERBEROS
플러그인 기반 인증: 다음 구문과 같이 플러그인 암호를 사용하거나 사용하지 않고 PLUGIN 키워드를 사용할 수 있습니다.

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

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

PLUGIN SECRET로 생성된 플러그인 인증서의 경우 , GoldenGate는 저장된 플러그인 암호를 플러그인 콜백에 메타데이터 항목으로 전달합니다.

플러그인 인증서를 추가할 기존 형식은 계속 지원됩니다. 기존 형식을 사용하는 경우 관리 클라이언트는 인증서 유형을 전달하지 않습니다.
Microsoft EntraID에 대한 OAuth 인증: Entra ID 자격 증명을 추가하는 구문은 OAUTHSECRET를 명령의 키워드로 사용합니다. 제공된 문자열을 Microsoft Entra ID 클라이언트 암호로 표시합니다. Entra ID USERIDALIAS(예: ggwest-entra)의 경우 인증서 저장소는 다음 구문에 표시된 대로 클라이언트 암호만 지속합니다.

인증서 저장소 사용자 추가 /@ 변경 별칭 OAUTHSECRET

다음은 사용된 구문에 따라 이러한 명령이 자격 증명 유형을 설정하는 방법을 설명하는 표입니다.

Oracle GoldenGate에 대한 매개변수 및 함수 참조의 USERIDALIAS 매개변수도 참조하십시오.

보안 구성에 대한 접속 값

이러한 설정은 SSL 속성을 포함하여 인증서 별칭에 추가할 수 있는 선택적 연결 문자열 설정입니다. 세미콜론으로 구분된 속성 목록(예: option1=value1;option2=value2;option3=value3)으로 지정해야 합니다. 여기서 옵션은 허용된 값과 함께 데이터베이스별 속성입니다.

다음은 SSL 속성을 포함하여 인증서 별칭에 추가할 수 있는 추가 접속 문자열 옵션 목록입니다.

주: Oracle GoldenGate Microservices Architecture는 특정 SSL 매개변수를 환경 변수로 구성하여 SSL 연결을 지원합니다. 단, 이 구성은 배치에 대해 정의된 SSL 환경 변수만 사용하여 접속하도록 Extract 및 Replicat 프로세스를 제한하며 다른 SSL 또는 비SSL 접속은 불가능합니다. 하지만 인증서 저장소 별칭을 사용하면 동일한 배치 내에서 다양한 데이터베이스 접속에 대해 서로 다른 SSL 또는 비SSL 매개변수로 인증서를 유연하게 구성할 수 있습니다.

sslCA: MySQL 및 PostgreSQL 전용 SSL 인증서의 신뢰성을 PEM 형식으로 확인하는 데 사용되는 인증서입니다.
sslCert: MySQL 및 PostgreSQL PEM 형식의 클라이언트의 SSL 인증서 파일입니다.
sslCrl: MySQL의 경우 PEM 형식의 인증 철회 목록을 포함하는 파일 이름입니다.
sslKey: MySQL 및 PostgreSQL PEM 형식의 클라이언트 개인 키 파일입니다.
sslMode: MySQL 및 PostgreSQL sslMode 매개변수 값은 대문자로만 지정됩니다. MySQL에 대한 sslMode 옵션은 VERIFY_IDENTITY, VERIFY_CA, REQUIRED, PREFERRED입니다. PostgreSQL에 대한 sslMode 옵션은 VERIFY-FULL, VERIFY-CA, REQUIRE, PREFER입니다.

sslMode=VERIFY_IDENTITY의 경우 sslPath, sslCa, sslCert 및 sslKey를 제공해야 합니다. sslMode=VERIFY_CA의 경우 sslPath 및 sslCa를 제공해야 합니다.
sslPath: MySQL 전용입니다. PEM 형식의 신뢰할 수 있는 SSL CA(인증 기관) 인증서 파일을 포함하는 디렉토리의 경로입니다.

예제

Oracle

이 예에서는 이름이 ggadmin인 사용자를 추가하지만 PASSWORD 지정을 생략하여 명령에서 플러거블 데이터베이스의 비밀번호를 묻는 프롬프트를 표시합니다(pdbeast).

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

이 예에서는 사용자 ggadmin과 비밀번호 tiger를 추가하고 별칭을 pdbeast로 지정합니다.

ALTER CREDENTIALSTORE ADD USER ggadmin PASSWORD tiger ALIAS pdbeast

이 예에서는 도메인 OracleGoldenGate 아래에 사용자 ggadmin를 추가합니다.

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

이 예에서는 간단한 연결 이름 지정 방식을 사용하여 ggadmin 사용자를 추가합니다.

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

이 예에서는 각각 별칭이 다른 ggadmin 항목을 추가하는 두 개의 ALTER CREDENTIALSTORE 명령을 실행합니다.

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

이 예에서는 KERBEROS 키워드를 사용한 Kerberos 인증에 대한 ALTER CREDENTIALSTORE 명령을 보여줍니다.

ALTER CREDENTIALSTORE ADD USER /@dbwest KERBEROS ALIAS ggwest;

이 예에서는 PLUGIN 키워드를 사용한 플러그인 기반 인증에 대한 ALTER CREDENTIALSTORE 명령을 보여줍니다.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbwest PLUGIN ALIAS ggwest;

이 예에서는 PLUGIN SECRET 키워드를 사용합니다.

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

다음 예에서는 OAUTH 키워드를 사용하여 Microsoft EntraID로 자격 증명을 추가하는 방법을 보여줍니다.

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

다음은 ALIAS 옵션 사용 여부에 따른DELETE USER 옵션의 작동 방식을 보여줍니다.

다음 명령은 ALIAS가 사용자 이름과 동일한 user1 항목을 삭제합니다.

ALTER CREDENTIALSTORE DELETE USER ggadmin
Alias: pdbeast
Userid: ggadmin

다음 명령은 별칭 pdbeast와 연관된 사용자 ggadmin에 대한 항목을 삭제합니다.

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

이 예에서는 SQL*Net 접속 문자열을 사용자 값으로 사용합니다. 이 경우 PASSWORD 옵션이 생략됩니다. 명령 실행자에게 숨겨진 비밀번호를 묻는 프롬프트가 표시됩니다.

ALTER CREDENTIALSTORE ADD USER ggadmin@pdbeast ALIAS pdbeast

이 예에서는 관리 클라이언트에서 사용자 ID가 ggadmin이고 별칭이 pdbeast인 Oracle GoldenGate라는 도메인 이름을 생성합니다.

ALTER CREDENTIALSTORE ADD USER ggadmin ALIAS pdbeast
Password:

다음 예에서는 BEQ-Bequeath Protocol 어댑터를 사용하는 경우 접속 식별자를 사용하여 연결합니다. BEQ-Bequeath Protocol 어댑터를 사용하여 보안 연결을 설정하는 방법에 대한 자세한 내용은 보안 데이터베이스 연결 구성을 참조하십시오.

ALTER CREDENTIALSTORE ADD USER ggadmin@inst1_beq

다음 예(관리 클라이언트)에서는 ggadmin이라는 사용자를 추가하지만 외부 인증을 사용하므로 NOPASSWORD 옵션을 사용합니다.

ALTER CREDENTIALSTORE ADD USER ggadmin@dbeast nopassword alias pdbeast

INFO CREDENTIALSTORE 명령을 실행하면 인증서 저장소에서 사용자 추가를 확인할 수 있습니다.

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

NOPASSWORD 옵션을 사용하도록 자격 증명 저장소를 업데이트한 후 데이터베이스에 대한 Kerberos 인증과 함께 DBLOGIN 명령을 사용할 수 있습니다.

DBLOGIN USERIDALIAS pdbeast

MySQL

다음은 MySQL에 대한 관리 클라이언트에서 인증서를 생성하는 몇 가지 예입니다.

이 예에서는 접속 문자열에 SSL 속성이 없는 데이터베이스 인증서를 추가합니다.

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

이 예에서는 접속 문자열에 SSL 속성이 추가된 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

다음 예에서는 DSN을 사용하여 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

다음 예에서는 DSNless 기반 접속을 사용하여 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

PostgreSQL

다음 예에서는 접속 문자열에 SSL 속성이 추가된 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

다음 예에서는 DSN을 사용하여 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

다음 예에서는 DSNless 기반 접속을 사용하여 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

Sybase

다음은 Sybase용 Admin Client에서 자격 증명을 만드는 몇 가지 예입니다.

다음 예에서는 Sybase 데이터베이스에 대한 추가 속성 없이 호스트 및 포트 기반 연결을 표시합니다.

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

다음 예에서는 추가 속성 및 SSL이 사용으로 설정된 Sybase 데이터베이스에 대한 호스트 및 포트 기반 연결을 표시합니다.

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

i의 경우 DB2, z/OS의 경우 DB2

다음 예에서는 DSN을 사용하여 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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

다음 예에서는 DSNless 기반 접속을 사용하여 인증서 저장소에 데이터베이스 접속 세부정보를 추가합니다.

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