Qlik 데이터 게이트웨이 - 직접 액세스 설정

마지막 업데이트: 2026. 9. 30.

Qlik 데이터 게이트웨이 - 직접 액세스을(를) Windows 서버 또는 컨테이너화된 환경에서 설정할 수 있습니다.성공적인 설정을 위해 특정 설정 워크플로에 대한 사전 요구 사항, 설치 지침, 제한 사항 및 고려 사항을 숙지하고 있는지 확인하십시오.

워크플로 설정

다음 워크플로 중 하나를 선택합니다.

시스템 전제 조건

소프트웨어 요구 사항

설정 방법에 따라 다음 중 하나를 참조하세요:

Windows서버소프트웨어 전제 조건:
컨테이너화: 소프트웨어 요구 사항

공통 요구사항

이러한 요구 사항은 Windows 서버 및 컨테이너화된 설치 모두에 적용됩니다.

필수 포트 및 프로토콜

다음 섹션에 필요한 포트가 나열되어 있습니다.

아웃바운드 포트

<tenant-id>.<region>.qlikcloud.com에 대한 아웃바운드 통신을 위해 HTTPS/TCP-443을 열어야 합니다.

내부 포트

다음은 내부 데이터 게이트웨이 프로세스에서 통신에 사용되는 포트 목록입니다.이러한 포트 중 하나라도 다른 응용 프로그램에서 사용 중인 경우 다른 응용 프로그램을 재구성하거나 제거합니다.

일반 포트

5050(커넥터 에이전트 REST API)
9027(DCAAS REST API)

ODBC 포트

3005(ODBC 커넥터 REST API)
50260(ODBC 커넥터 gRPC)

SAP 포트

3015(SAP BW 커넥터 REST API)
50270(SAP BW 커넥터 gRPC)
3025(SAP SQL 커넥터 REST API)
50280(SAP SQL 커넥터 gRPC)
3035(SAP ODP 커넥터 REST API)
50290(SAP ODP 커넥터 gRPC)
3035(SAP 패키지 커넥터 REST API)
50290(SAP 패키지 커넥터 gRPC)

REST 포트

3055(REST 커넥터 REST API)
50310(REST 커넥터 gRPC)

파일 포트

3045(파일 커넥터 REST API)
50300(파일 커넥터 gRPC)

WSS 프로토콜

HTTPS 외에도 직접 액세스 게이트웨이는 WSS(WebSocket 보안) 프로토콜도 사용합니다. 따라서 방화벽과 프록시 서버(사용하려는 경우)가 아웃바운드 WSS 연결을 허용하도록 설정되어 있는지 확인합니다.

권장 하드웨어

설정 방법에 따라 다음 중 하나를 참조하세요:

Windows서버권장 하드웨어:
컨테이너화: 권장 하드웨어

시스템 암호화(Windows 서버 설치에만 해당)

시스템 암호화:을(를) 참조하십시오.

설치 Qlik 데이터 게이트웨이 - 직접 액세스

1단계: Qlik 데이터 게이트웨이 - 직접 액세스 다운로드

설정 방법에 따라 다음 중 하나를 참조하세요:

Windows서버1단계: 다운로드 Qlik 데이터 게이트웨이 - 직접 액세스:
컨테이너화: 1단계: 다운로드 Qlik 데이터 게이트웨이 - 직접 액세스

2단계: 설치 또는 배포하다 직접 액세스 게이트웨이

설정 방법에 따라 다음 중 하나를 참조하세요:

Windows서버2단계: 데이터 소스를 보호하는 방화벽 뒤에 있는 서버에 직접 액세스 게이트웨이 설치:
컨테이너화: 2단계: Docker Compose 파일을 실행하여 배포 시작

3단계: 직접 액세스 게이트웨이 설정

이 단계에는 Qlik Cloud 테넌트 URL 설정, 선택적으로 프록시 서버 설정, 등록 키 생성이 포함됩니다.아래 3단계에서 관리 활동 센터의 데이터 게이트웨이 설정에 키를 복사해야 합니다.키는 직접 액세스 게이트웨이와 Qlik Cloud 테넌트 간에 인증된 연결을 설정하는 데 사용됩니다.

Qlik 익명 테넌트(스웨덴 지역)에 연결하는 것은 지원되지 않습니다.

직접 액세스 게이트웨이 1.7.16부터 캐나다 지역이 지원됩니다.게이트웨이 설치 파일을 배포할 때 관리 활동 센터에서 배포하는 동안 캐나다 지역을 선택합니다.

Direct Access gateway 머신에서 설치 워크플로에 따라 다음 중 하나를 수행합니다:

Windows 서버: 관리자 권한으로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더로 변경합니다(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent).
컨테이너화됨: direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.

그런 다음 아래 설명대로 계속합니다.

Qlik Cloud 테넌트 설정

연결할 Qlik Cloud 테넌트를 설정합니다.프록시 서버를 통해 테넌트에 연결하려면 아래와 같이 명령에 관련 매개 변수를 추가합니다.

프록시 서버 없이 Qlik Cloud 테넌트를 설정하는 명령:

Windows 서버 설치
- 구문:connectoragent qcs set_config --tenant_url your-qlik-cloud-tenant-url
- 예: connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com
컨테이너화된 설치
- 구문:dotnet ConnectorAgent.dll qcs set_config --tenant_url your-qlik-cloud-tenant-url
- 예: dotnet ConnectorAgent.dll qcs set_config --tenant_url mytenant.us.qlikcloud.com

프록시 서버를 사용하여 Qlik Cloud 테넌트를 설정하기 위한 명령:

Windows 서버 설치
- 구문:connectoragent qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url http://host:port --proxy_username username --proxy_password password
- 예: connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@
컨테이너화된 설치
- 구문:dotnet ConnectorAgent.dll qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url http://host:port --proxy_username username --proxy_password password
- 예: dotnet ConnectorAgent.dll qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

프록시 제한 사항에 대한 자세한 내용은 프록시 서버를 통해 Qlik Cloud에 연결을 참조하십시오.

CA 번들 설정

CA 번들은 Qlik Cloud 테넌트의 ID를 인증하여 신뢰할 수 있는 연결을 보장합니다.

누가 CA 번들을 설정해야 합니까?

CA 번들은 다음과 같은 경우에만 설정해야 합니다.

Qlik Cloud 정부 고객
프록시 역할을 하고 인터넷에서 받은 인증서 정보를 자체 CA 루트 인증서로 바꾸는 보안 어플라이언스를 사용하는 Qlik Cloud 상용 고객

어떤 번들을 사용해야 합니까?

고객은 다음과 같이 Qlik CA 번들을 사용하거나 자체 CA 번들을 가져와야 합니다.

Qlik에서 CA 번들을 제공합니다: 표준 환경을 사용하는 Qlik Cloud 정부 고객이 사용해야 합니다.표준 환경은 프록시 역할을 하는 보안 어플라이언스가 없고 인터넷에서 받은 인증서 정보를 자체 CA 루트 인증서로 바꾸는 환경입니다.

기본 직접 액세스 게이트웨이 설치에서 CA 번들 파일은 다음 위치에서 찾을 수 있습니다.
- Windows 서버 설치: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg_ca_bundle.pem
- 컨테이너화된 설치: /usr/share/Qlik/Gateway/ssl/qcg_ca_bundle.pem
정보 메모CA 번들 파일의 이름을 바꿀 수 있지만 확장자가 .pem이어야 합니다(예: qlikcerts.pem).그런 다음 아래에 설명된 명령을 실행합니다.
고객 자체 CA 번들 사용: 고객 환경에서 프록시 역할을 하며 인터넷에서 수신한 인증서 정보를 자체 CA 루트 인증서로 대체하는 보안 어플라이언스를 사용하는 경우에 사용해야 합니다.해당 인증서가 자체 서명된 경우 CA 번들을 설정하는 명령어 외에도 CA 번들을 허용하는 명령어도 실행해야 합니다.두 명령 모두 아래에 설명되어 있습니다.이는 Qlik Cloud 정부 고객과 Qlik Cloud 상업 고객 모두에게 동일하게 적용됩니다.

CA 번들 설정 명령

다음 명령을 실행하여 CA 인증서 번들을 설정합니다.

구문 (Windows 서버 설치):

connectoragent qcs set_config --ca_bundle_path path-to-ca-bundle-file

구문 (컨테이너화된 설치):

dotnet ConnectorAgent.dll qcs set_config --ca_bundle_path path-to-ca-bundle-file

예(Windows 서버 설치):

connectoragent qcs qcs set_config --ca_bundle_path c:\ca\cacerts.pem

예시(컨테이너화된 설치):

dotnet ConnectorAgent.dll qcs set_config --ca_bundle_path c:\ca\cacerts.pem

CA 번들 허용 명령

일부 환경에서는 프록시 역할을 하는 보안 어플라이언스를 사용하고 인터넷에서 받은 인증서 정보를 자체 CA 루트 인증서로 바꿉니다.. 이 명령은 보안 어플라이언스 자체가 자체 서명된 인증서를 사용하는 경우에만 실행해야 합니다.이러한 경우 다음 명령을 실행하지 않으면 CA 번들을 신뢰할 수 없습니다.

Windows 서버 설치:

connectoragent qcs set_config --ca_bundle_allow_invalid_certs true
컨테이너화된 설치:

dotnet ConnectorAgent.dll qcs set_config --ca_bundle_allow_invalid_certs true

환경에서 이러한 보안 어플라이언스를 사용하고 있는지 확실하지 않은 경우 IT 관리자에게 문의하십시오.

등록 키 생성 및 표시

키는 직접 액세스 게이트웨이와 Qlik Cloud 테넌트 간에 인증된 연결을 설정하는 데 사용됩니다.

등록 키 생성 명령

Windows 서버 설치:

connectoragent qcs generate_keys
컨테이너화된 설치:

dotnet ConnectorAgent.dll qcs generate_keys

등록 키 표시 명령

dotnet ConnectorAgent.dll qcs get_registration

Windows 서버 설치:

connectoragent qcs get_registration
컨테이너화된 설치:

dotnet ConnectorAgent.dll qcs get_registration

키가 표시됩니다.

위의 예와 같이 전체 키를 복사합니다.다음 단계에서는 관리 활동 센터에 붙여넣어야 합니다.

4단계: 데이터 게이트웨이 등록

다음 단계는 데이터 게이트웨이를 등록하는 것입니다. 이 작업은 관리 활동 센터를 통하거나 명령줄에서 수행할 수 있습니다.

옵션 1: 관리 활동 센터를 통해

직접 액세스 게이트웨이를 등록하면 안전한 게이트웨이-테넌트 통신을 위해 ID 공급자 (멀티 클라우드) 항목이 관리 활동 센터에 자동으로 생성됩니다.ID 공급자 설명에는 게이트웨이 ID(발급자 gateway_id)가 포함되어 있어, 관리 활동 센터의 데이터 게이트웨이 섹션에서 연결된 게이트웨이를 쉽게 찾을 수 있습니다.게이트웨이 ID 공급자를 삭제하면 게이트웨이가 연결 해제되므로, 게이트웨이가 더 이상 필요하지 않다고 확신하는 경우에만 이 작업을 수행해야 합니다.ID 공급자를 실수로 삭제한 경우, 직접 액세스 게이트웨이를 다시 시작하면 항목이 복원되고 게이트웨이가 다시 연결됩니다.

관리 활동 센터에서 데이터 게이트웨이를 선택합니다.

기존의 모든 데이터 게이트웨이는 각 게이트웨이에 대한 기본 정보를 보여 주는 테이블에 나열됩니다.
만들기 도구 모음 버튼을 클릭합니다.

데이터 게이트웨이 만들기 대화 상자가 열립니다.
데이터 게이트웨이의 이름을 지정합니다.
선택적으로 데이터 게이트웨이에 대한 설명을 제공합니다.
데이터 게이트웨이 유형 드롭다운 목록에서 직접 액세스를 선택합니다.
연결된 공간 드롭다운 목록에서 공간을 선택합니다.

직접 액세스 게이트웨이를 공간과 연결할 때 다음 사항에 유의해야 합니다.
- 데이터 게이트웨이는 공유 공간 또는 관리 공간에서만 만들 수 있습니다.
- 다른 공간의 데이터 게이트웨이를 사용하는 한 공간에서 데이터 연결을 만들려면 데이터 게이트웨이 공간에서 데이터를 소비할 수 있음 역할이 있어야 합니다.
- 데이터 게이트웨이를 만들려면 공간 소유자이거나 관리할 수 있음 역할이 있어야 합니다. 사용자 기반 구독의 경우, 또한 전문가 권한이 필요합니다. 자세한 내용은 사용자 권한 관리을 참조하십시오.
- 데이터 게이트웨이는 단일 공간에만 연결할 수 있습니다.
이전에 생성한 등록 키를 키 필드에 붙여넣습니다.
만들기를 클릭합니다.

데이터 게이트웨이가 데이터 게이트웨이 목록에 활성화되어 추가됩니다.

옵션 2: 명령줄을 사용한 자동 등록

관리 액티비티 센터를 사용하지 않고 명령줄에서 직접 액세스 게이트웨이을(를) 자동으로 등록할 수도 있습니다.

지침을 확인하려면 설치 워크플로에 따라 다음 중 하나를 참조하십시오:

Windows 서버 설치: 옵션 2: 명령줄을 사용한 자동 등록
컨테이너화된 설치: 옵션 2: 명령줄을 사용한 자동 등록

5단계: Direct Access gateway 서버에서 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 시작

다음으로 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 시작해야 합니다.

설정 방법에 따라 다음 중 하나를 참조하세요:

Windows 서버 설치: 5단계: Direct Access gateway 서버에서 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 시작
컨테이너화된 설치: 5단계: Direct Access gateway 서버에서 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 시작

6단계: 데이터 소스에 연결 추가

데이터 게이트웨이 목록에서 게이트웨이를 찾고 해당 상태가 "연결됨"인지 확인합니다(현재 상태를 보려면 브라우저를 새로 고쳐야 할 수도 있음).그런 다음 계속해서 데이터 소스에 대한 연결을 추가할 수 있습니다.

데이터 소스에서 데이터를 로드하는 방법에는 여러 가지가 있습니다.

사용 가능한 데이터 소스 목록에는 게이트웨이 연결을 지원하는 데이터 소스에 대한 중복 항목이 포함됩니다.게이트웨이 호환 데이터 소스는 소스 유형 뒤에 괄호 안에 표시되는 "직접 액섹스 게이트웨이를 통해"라는 구문으로 식별할 수 있습니다.

게이트웨이 호환 데이터 소스에 대한 데이터 연결 추가 대화 상자에는 사용할 게이트웨이를 선택할 수 있는 추가 직접 액세스 게이트웨이 필드가 있습니다.

일반 제한 사항 및 고려 사항

직접 액세스 게이트웨이는 단일 테넌트에만 연결할 수 있습니다.
어떤 이유로든 직접 액세스 게이트웨이 응용 프로그램을 다시 로드하는 동안 Qlik 서버가 재부팅되면 다시 로드가 실패합니다.데이터를 새로 고치려면 Qlik 응용 프로그램을 다시 로드합니다.
다시 로드 스크립트 쿼리는 500,000자를 초과할 수 없습니다.

스크립트 다시 로드에 대한 자세한 내용은 스크립트 실행를 참조하십시오.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.