인증서 및 Oracle Wallet을 사용하여 UTL_HTTP 액세스 구성

루트 및 클라이언트 인증서를 단일 디렉터리에 넣은 다음 이 디렉터리로 변경합니다.

.p12 클라이언트 인증서를 Java KeyStore로 변환합니다.

다음 예에서는 client_certificate.p12라는 클라이언트 인증서를 client_keystore.jks라는 Java KeyStore로 변환합니다. 그러면 KeyStore가 Oracle Wallet에 포함됩니다. KeyStore 암호는 P12PASSWORD입니다.

orapki wallet pkcs12_to_jks -wallet ./client_certificate.p12 -jksKeyStoreLoc ./client_keystore.jks -jksKeyStorepwd P12PASSWORD

인증서 디렉터리와 다른 Oracle Wallet용 디렉터리를 생성합니다.

다음 예에서는 /tmp/wallet 디렉터리를 생성합니다.

mkdir -p /tmp/wallet

wallet 디렉터리에 Oracle Wallet을 생성합니다.

다음 예에서는 Oracle Wallet 암호를 이전 단계에서 Java KeyStore에서 사용한 것과 동일한 암호인 P12PASSWORD로 설정합니다. 동일한 암호를 사용하면 편리하지만 필수는 아닙니다. -auto_login 파라미터가 자동 로그인 기능을 켜므로 액세스할 때마다 암호를 지정할 필요가 없습니다.

orapki wallet create -wallet /tmp/wallet -pwd P12PASSWORD -auto_login

Oracle Wallet에 Java KeyStore를 추가합니다.

다음 예에서는 /tmp/wallet이라는 Oracle Wallet에 KeyStore client_keystore.jks를 추가합니다. 이 예에서는 Java KeyStore와 Oracle Wallet에 대해 동일한 암호를 지정합니다.

orapki wallet jks_to_pkcs12 -wallet /tmp/wallet -pwd P12PASSWORD -keystore ./client_keystore.jks -jkspwd P12PASSWORD

대상 웹 사이트의 루트 인증서를 Oracle Wallet에 추가합니다.

다음 예에서는 Root_CA.cer이라는 인증서를 추가합니다.

orapki wallet add -wallet /tmp/wallet -trusted_cert -cert ./Root_CA.cer -pwd P12PASSWORD

중간 인증서를 추가합니다.

다음 예에서는 Intermediate.cer이라는 인증서를 추가합니다. 모든 중간 인증서를 로드하는 데 필요한 만큼 이 단계를 반복합니다.

orapki wallet add -wallet /tmp/wallet -trusted_cert -cert ./Intermediate.cer -pwd P12PASSWORD

새로 생성된 Oracle Wallet에 필요한 인증서가 있는지 확인합니다.

orapki wallet display -wallet /tmp/wallet -pwd P12PASSWORD

Oracle과 Amazon S3 통합을 위한 사전 조건을 만족시키고 S3_INTEGRATION 옵션을 Oracle DB 인스턴스에 추가하십시오. 옵션의 IAM 역할에 사용 중인 Amazon S3 버킷에 대한 액세스 권한이 있어야 합니다.

자세한 내용은 Amazon S3 통합 섹션을 참조하세요.

DB 인스턴스에 마스터 사용자로 로그인한 다음 Oracle Wallet을 보관할 Oracle 디렉터리를 생성합니다.

다음 예에서는 WALLET_DIR이라는 Oracle 디렉터리를 생성합니다.

EXEC rdsadmin.rdsadmin_util.create_directory('WALLET_DIR');

자세한 내용은 메인 데이터 스토리지 공간에서 디렉터리 생성 및 삭제 섹션을 참조하세요.

Amazon S3 버킷에 Oracle Wallet을 업로드합니다.

지원되는 업로드 기술을 사용할 수 있습니다.

Oracle Wallet을 다시 업로드하는 경우 기존 Wallet을 삭제합니다. 그렇지 않은 경우 다음 단계로 건너뜁니다.

다음 예에서는 cwallet.sso라는 기존 Wallet을 제거합니다.

EXEC UTL_FILE.FREMOVE ('WALLET_DIR','cwallet.sso');

Amazon S3 버킷에서 Oracle DB 인스턴스로 Oracle Wallet을 다운로드합니다.

다음 예에서는 my_s3_bucket이라는 Amazon S3 버킷에서 WALLET_DIR이라는 DB 인스턴스 디렉터리로 cwallet.sso라는 Wallet을 다운로드합니다.

SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
      p_bucket_name    =>  'my_s3_bucket', 
      p_s3_prefix      =>  'cwallet.sso', 
      p_directory_name =>  'WALLET_DIR') 
   AS TASK_ID FROM DUAL;

(선택 사항) 암호로 보호된 Oracle Wallet을 다운로드합니다.

Wallet을 사용할 때마다 암호를 요구하려는 경우에만 이 Wallet을 다운로드합니다. 다음 예에서는 암호로 보호된 Wallet ewallet.p12를 다운로드합니다.

SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
      p_bucket_name    =>  'my_s3_bucket', 
      p_s3_prefix      =>  'ewallet.p12', 
      p_directory_name =>  'WALLET_DIR') 
   AS TASK_ID FROM DUAL;

DB 태스크의 상태를 확인합니다.

다음 예에서 dbtask-1234567890123-4567.log를 이전 단계에서 반환된 태스크 ID로 대체합니다.

SELECT TEXT FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1234567890123-4567.log'));

Oracle Wallet을 저장하는 데 사용하는 디렉터리의 내용을 확인합니다.

SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'WALLET_DIR'));

자세한 내용은 DB 인스턴스 디렉터리의 파일 목록 표시 섹션을 참조하세요.

RDS for Oracle DB 인스턴스에 마스터 사용자로 로그인합니다.

기존 데이터베이스 사용자를 구성하지 않으려는 경우 새 사용자를 생성합니다. 그렇지 않은 경우 다음 단계로 건너뜁니다.

다음 예에서는 my-user라는 데이터베이스 사용자를 생성합니다.

CREATE USER my-user IDENTIFIED BY my-user-pwd;
GRANT CONNECT TO my-user;

데이터베이스 사용자에게 Oracle Wallet이 포함된 디렉터리에 대한 권한을 부여합니다.

다음 예에서는 사용자 my-user 에게 디렉터리 WALLET_DIR에 대한 읽기 액세스 권한을 부여합니다.

GRANT READ ON DIRECTORY WALLET_DIR TO my-user;

데이터베이스 사용자에게 UTL_HTTP 패키지를 사용할 수 있는 권한을 부여합니다.

다음 PL/SQL 프로그램에서는 사용자 my-user에게 UTL_HTTP 액세스 권한을 부여합니다.

BEGIN 
  rdsadmin.rdsadmin_util.grant_sys_object('UTL_HTTP', UPPER('my-user')); 
  END;
/

데이터베이스 사용자에게 UTL_FILE 패키지를 사용할 수 있는 권한을 부여합니다.

다음 PL/SQL 프로그램에서는 사용자 my-user에게 UTL_FILE 액세스 권한을 부여합니다.

BEGIN 
  rdsadmin.rdsadmin_util.grant_sys_object('UTL_FILE', UPPER('my-user')); 
  END;
/

RDS for Oracle DB 인스턴스에 마스터 사용자로 로그인합니다.

보안 포트에 사용자 및 대상 웹 사이트에 대한 ACE(Host Access Control Entry)를 생성합니다.

다음 예에서는 보안 포트 443에서 secret.encrypted-website.com에 액세스하도록 my-user를 구성합니다.

BEGIN
  DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
    host       => 'secret.encrypted-website.com', 
    lower_port => 443,
    upper_port => 443,
    ace        => xs$ace_type(privilege_list => xs$name_list('http'),
                              principal_name => 'my-user',
                              principal_type => xs_acl.ptype_db)); 
                           -- If the program unit results in PLS-00201, set
                           -- the principal_type parameter to 2 as follows:
                           -- principal_type => 2));
END;
/

principal_type => 2));

자세한 내용은 Oracle Database 설명서의 Configuring Access Control for External Network Services(외부 네트워크 서비스에 대한 액세스 제어 구성)를 참조하세요.

(선택 사항) 표준 포트에서 사용자 및 대상 웹 사이트에 대한 ACE를 만듭니다.

일부 웹 페이지가 보안 포트(443) 대신 표준 웹 서버 포트(80)에서 제공되는 경우 표준 포트를 사용해야 할 수 있습니다.

BEGIN
  DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
    host       => 'secret.encrypted-website.com', 
    lower_port => 80,
    upper_port => 80,
    ace        => xs$ace_type(privilege_list => xs$name_list('http'),
                              principal_name => 'my-user',
                              principal_type => xs_acl.ptype_db)); 
                           -- If the program unit results in PLS-00201, set
                           -- the principal_type parameter to 2 as follows:
                           -- principal_type => 2));
END;
/

액세스 제어 항목이 있는지 확인합니다.

SET LINESIZE 150
COLUMN HOST FORMAT A40
COLUMN ACL FORMAT A50

SELECT HOST, LOWER_PORT, UPPER_PORT, ACL
  FROM DBA_NETWORK_ACLS
ORDER BY HOST;

데이터베이스 사용자에게 UTL_HTTP 패키지를 사용할 수 있는 권한을 부여합니다.

다음 PL/SQL 프로그램에서는 사용자 my-user에게 UTL_HTTP 액세스 권한을 부여합니다.

BEGIN 
  rdsadmin.rdsadmin_util.grant_sys_object('UTL_HTTP', UPPER('my-user')); 
  END;
/

관련 액세스 제어 목록이 있는지 확인합니다.

SET LINESIZE 150
COLUMN ACL FORMAT A50
COLUMN PRINCIPAL FORMAT A20
COLUMN PRIVILEGE FORMAT A10

SELECT ACL, PRINCIPAL, PRIVILEGE, IS_GRANT,
       TO_CHAR(START_DATE, 'DD-MON-YYYY') AS START_DATE,
       TO_CHAR(END_DATE, 'DD-MON-YYYY') AS END_DATE
  FROM DBA_NETWORK_ACL_PRIVILEGES
ORDER BY ACL, PRINCIPAL, PRIVILEGE;

데이터베이스 사용자에게 클라이언트 인증에 인증서를 사용하고 연결에 Oracle Wallet을 사용할 수 있는 권한을 부여합니다.

DECLARE
  l_wallet_path all_directories.directory_path%type;
BEGIN
  SELECT DIRECTORY_PATH 
    INTO l_wallet_path 
    FROM ALL_DIRECTORIES
   WHERE UPPER(DIRECTORY_NAME)='WALLET_DIR';
  DBMS_NETWORK_ACL_ADMIN.APPEND_WALLET_ACE(
    wallet_path => 'file:/' || l_wallet_path,
    ace         =>  xs$ace_type(privilege_list => xs$name_list('use_client_certificates'),
                                principal_name => 'my-user',
                                principal_type => xs_acl.ptype_db));
END;
/

UTL_HTTP 권한이 있는 데이터베이스 사용자로 RDS for Oracle DB 인스턴스에 로그인합니다.

대상 웹 사이트에 대한 연결이 호스트 주소를 확인할 수 있는지 확인합니다.

다음 예에서는 secret.encrypted-website.com에서 호스트 주소를 가져옵니다.

SELECT UTL_INADDR.GET_HOST_ADDRESS(host => 'secret.encrypted-website.com')
  FROM DUAL;

실패한 연결을 테스트합니다.

UTL_HTTP는 인증서가 있는 Oracle Wallet의 위치를 요구하기 때문에 다음 쿼리는 실패합니다.

SELECT UTL_HTTP.REQUEST('secret.encrypted-website.com') FROM DUAL;

UTL_HTTP.SET_WALLET을 사용하고 DUAL에서 선택하여 웹 사이트 액세스를 테스트합니다.

DECLARE
  l_wallet_path all_directories.directory_path%type;
BEGIN
  SELECT DIRECTORY_PATH
    INTO l_wallet_path 
    FROM ALL_DIRECTORIES
   WHERE UPPER(DIRECTORY_NAME)='WALLET_DIR';
  UTL_HTTP.SET_WALLET('file:/' || l_wallet_path);
END;
/

SELECT UTL_HTTP.REQUEST('secret.encrypted-website.com') FROM DUAL;

(선택 사항) 쿼리를 변수에 저장하고 EXECUTE IMMEDIATE를 사용하여 웹 사이트 액세스를 테스트합니다.

DECLARE
  l_wallet_path all_directories.directory_path%type;
  v_webpage_sql VARCHAR2(1000);
  v_results     VARCHAR2(32767);
BEGIN
  SELECT DIRECTORY_PATH
    INTO l_wallet_path 
    FROM ALL_DIRECTORIES
   WHERE UPPER(DIRECTORY_NAME)='WALLET_DIR';
  v_webpage_sql := 'SELECT UTL_HTTP.REQUEST(''secret.encrypted-website.com'', '''', ''file:/' ||l_wallet_path||''') FROM DUAL';
  DBMS_OUTPUT.PUT_LINE(v_webpage_sql);
  EXECUTE IMMEDIATE v_webpage_sql INTO v_results;
  DBMS_OUTPUT.PUT_LINE(v_results);
END;
/

(선택 사항) Oracle Wallet 디렉터리의 파일 시스템 위치를 찾습니다.

SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'WALLET_DIR'));

이전 명령의 출력을 사용하여 HTTP 요청을 만듭니다. 예를 들어 디렉터리가 rdsdbdata/userdirs/01인 경우 다음 쿼리를 실행합니다.

SELECT UTL_HTTP.REQUEST('https://secret.encrypted-website.com/', '', 'file://rdsdbdata/userdirs/01') 
FROM   DUAL;