Qlik 데이터 게이트웨이 - 직접 액세스용 AWS PrivateLink 구성
마지막 업데이트: 2026. 10. 9.이 항목에서는 AWS 네트워크의 프라이빗 연결을 통해 Amazon Web Services(AWS) VPC의 직접 액세스 게이트웨이을(를) Qlik Cloud에 연결하는 AWS PrivateLink 워크플로에 대해 설명합니다.
Qlik에서는 다음 항목을 제공하지 않습니다:
-
고객의 AWS 콘솔, VPC 또는 PrivateLink 설정에 대한 모든 구성 지원. Qlik에서는 AWS 컨설팅을 제공하지 않습니다.
-
설정이 정상적으로 작동하는 것으로 확인된 후 문제가 발생하여 기술적 문제가 일어나는 경우, Qlik 지원팀은 연동이 예상대로 작동하지 않은 원인을 파악하기 위해 고객 구성을 조사하지만, 고객 측 AWS 설정을 문제 해결하거나 구성을 지원하지는 않습니다.
고객의 AWS 측 설정에 대한 참조 문서는 상황 파악을 위해 지원 팀과 공유되지만, 지원 범위는 고객 측의 Direct Access Gateway 운영으로 한정됩니다.
패턴 이해하기
이 패턴은 VPC 내의 AWS 인터페이스 VPC 엔드포인트를 사용하여 Qlik Cloud AWS 엔드포인트 서비스에 연결합니다.직접 액세스 게이트웨이은(는) 사용자의 VPC에서 실행됩니다.Route 53 프라이빗 DNS는 VPC에서 서비스 이름을 확인할 수 있으며, 트래픽은 퍼블릭 인터넷을 거치지 않고 AWS 백본에 유지됩니다.
- Qlik은 Qlik Cloud 엔드포인트 서비스를 제공하고 운영합니다.
- 사용자의 AWS 계정에서 인터페이스 VPC 엔드포인트, 프라이빗 DNS 및 네트워크 제어를 생성하고 운영합니다.
- VPC에 직접 액세스 게이트웨이을(를) 설치 및 운영하고 데이터 소스에 대한 연결을 사용 가능한 상태로 유지합니다.
범위 확인
- 이 패턴은 AWS와 직접 액세스 게이트웨이에서 Qlik Cloud(으)로의 연결에 적용됩니다.
- Azure 프라이빗 연결은 이 문서의 범위를 벗어납니다.
- 구현 전에 요청된 테넌트 및 AWS 리전에 대한 가용성을 확인해야 합니다.
환경 준비하기
구현하기 전에 AWS 및 Qlik Cloud 관리자와 협의하십시오.테넌트 및 AWS 리전에 대해 다음 사항을 확인하십시오:
- 직접 액세스 게이트웨이이(가) EC2 인스턴스에 설치되어 있고 인스턴스가 실행 중입니다.
- VPC 엔드포인트를 생성하고 보안 그룹을 수정할 수 있는 권한이 있는 AWS 콘솔 액세스 권한이 있습니다.
- Qlik이(가) 테넌트 및 리전에 대한 PrivateLink 사용 가능 여부를 확인하고 정확한 리전 서비스 이름과 온보딩 요구 사항을 제공했습니다.
- Qlik 지원에 문의하여 엔드포인트 ID를 제공하고 엔드포인트 서비스 수락을 요청할 수 있습니다.
워크플로 구성
AWS 및 Qlik Cloud 관리자와 함께 다음을 수행하십시오:
- EC2 인스턴스에서 직접 액세스 게이트웨이이(가) 실행되는 VPC를 확인합니다.
- AWS 콘솔에서 VPC > PrivateLink 및 Lattice > 엔드포인트로 이동한 다음 엔드포인트 생성을 클릭합니다.
- 엔드포인트 서비스 옵션을 선택하고 테넌트에 대해 확인된 정확한 Qlik 리전 서비스 이름을 입력합니다.
- Qlik 지원 팀에 문의하여 AWS 계정 ID 및 연결이 시작되어야 하는 AWS 리전을 공유하세요.Qlik 지원팀에서 Qlik이(가) 귀하의 AWS 계정 ID를 추가했음을 확인할 때까지 기다리십시오.
- EC2 인스턴스용으로 식별된 VPC를 선택합니다.Qlik이(가) 엔드포인트를 수락할 때까지 프라이빗 DNS 이름 활성화를 선택 해제된 상태로 둡니다.
- EC2 인스턴스의 가용 영역과 일치하는 서브넷을 선택합니다.
- 포트
443에 인바운드 HTTPS가 설정된 보안 그룹을 할당합니다.소스를 보안 그룹 자체로 설정하십시오. 서브넷이나 개방된 IP 범위를 소스로 사용하지 마십시오. -
엔드포인트 생성을 클릭합니다.
-
엔드포인트 생성 페이지에서:
-
엔드포인트의 Name 태그를 입력합니다(예: dag-privatelink-test ).
-
유형에서 NLB 및 GWLB를 사용하는 엔드포인트 서비스를 선택합니다.
-
-
서비스 설정 아래에서:
-
해당 리전에 대해 Qlik에서 제공한 서비스 이름(예: com.amazonaws.vpce.us-east-1.vpce-svc-0afc69d0635aef748)을 입력합니다.리전별 서비스 이름 목록은 리전별 서비스 이름(VPC ID) 목록을(를) 참조하세요.
-
서비스 확인을 클릭합니다.녹색 "Service name verified" 확인 배너가 표시되어야 합니다.
-
-
VPC를 선택하세요:
-
네트워크 설정에서 VPC 드롭다운을 클릭하고 EC2 인스턴스의 VPC ID(예: vpc-0abc1234def56789a)와 일치하는 VPC를 선택합니다.
-
-
- Qlik에서 엔드포인트를 수락한 후 프라이빗 DNS를 활성화합니다.이를 활성화하기 전에 VPC에 DNS 호스트 이름 활성화 및 DNS 지원 활성화가 활성화되어 있는지 확인하십시오.
-
배포 방법에 따라 다음 중 하나를 실행하여 게이트웨이에서 프라이빗 연결을 활성화합니다:
-
Windows 서버 설치:
connectoragent qcs set_config --private_connection true --tenant_url https://<tenantName>.<region>.qlikcloud.com
(<tenantName> 및 <region>을(를) Qlik에서 확인한 테넌트 값으로 바꿉니다.)
-
컨테이너화된 설치:
dotnet ConnectorAgent.dll qcs set_config --private_connection true --tenant_url https://<tenantName>.<region>.qlikcloud.com
(<tenantName> 및 <region>을(를) Qlik에서 확인한 테넌트 값으로 바꿉니다.)
-
- DAG 연결을 통해 로드 스크립트를 실행하고 엔드포인트 서비스 모니터링을 통해 트래픽을 확인합니다.
검증 및 문제 해결
먼저 문제가 AWS 엔드포인트 경로에 있는지 또는 직접 액세스 게이트웨이 애플리케이션 연결에 있는지 확인하십시오.AWS 관리자에게 문의하여 엔드포인트 상태, 프라이빗 DNS 확인, 라우팅 및 보안 제어를 확인하십시오.직접 액세스 게이트웨이 관리자와 함께 게이트웨이 서비스 상태 및 로그를 확인하십시오.게이트웨이별 문제 해결 방법은 Qlik 데이터 게이트웨이 - 직접 액세스 구성 및 문제 해결을(를) 참조하세요.
PrivateLink 연결 자체만으로는 모든 Qlik Cloud 허용 목록 요구 사항을 정의하지 않습니다.일반적인 허용 목록 지침은 도메인 및 IP 주소 허용 목록을(를) 참조하세요.
리전별 서비스 이름(VPC ID) 목록
이 섹션에서는 각 리전에 해당하는 서비스 이름을 나열합니다.워크플로 구성에 설명된 대로 AWS PrivateLink 설정을 구성할 때 서비스 이름이 필요합니다.
| Region | Service name | Availability zones |
|---|---|---|
| us-east-1 | com.amazonaws.vpce.us-east-1.vpce-svc-00a485f00a94df90d |
|
| eu-west-3 | com.amazonaws.vpce.eu-west-3.vpce-svc-0f914c285c80d92c1 |
|
| ap-southeast-2 | com.amazonaws.vpce.ap-southeast-2.vpce-svc-084ba78d527a91749 |
|
| eu-central-1 | com.amazonaws.vpce.eu-central-1.vpce-svc-0d184b720e97c3888 |
|
| ap-south-1 | com.amazonaws.vpce.ap-south-1.vpce-svc-0baadb0cb3dd12848 |
|
| ap-southeast-1 | com.amazonaws.vpce.ap-southeast-1.vpce-svc-0f808f9f48d12a6bf |
|
| ap-northeast-1 | com.amazonaws.vpce.ap-northeast-1.vpce-svc-0291b1c14bd3353ce |
|
| eu-west-1 | com.amazonaws.vpce.eu-west-1.vpce-svc-0a1084ab9a085760a |
|
| eu-west-2 | com.amazonaws.vpce.eu-west-2.vpce-svc-0b29ae1d28b35237c |
|
| eu-north-1 | com.amazonaws.vpce.eu-north-1.vpce-svc-095b4ac47699f0ef5 |
|
| il-central-1 | com.amazonaws.vpce.il-central-1.vpce-svc-0d3e2075d594af3df |
|
| sa-east-1 | com.amazonaws.vpce.sa-east-1.vpce-svc-01916a7fa8fd86bfd |
|