온-프레미스 데이터 게이트웨이에 대한 프록시 설정 구성

작업 환경에서는 프록시를 통해 인터넷에 액세스해야 할 수 있습니다. 이 요구 사항으로 인해 Microsoft 온-프레미스 데이터 게이트웨이가 서비스에 연결되지 못할 수 있습니다.

superuser.com 다음 게시물에서는 네트워크에 프록시가 있는지 확인하는 방법을 설명합니다. 사용 중인 프록시 서버를 어떻게 알 수 있나요? (SuperUser.com).

대부분의 게이트웨이 구성 설정은 온-프레미스 데이터 게이트웨이 앱을 사용하여 변경할 수 있지만 프록시 정보는 .NET 구성 파일 내에서 구성됩니다. 사용 중인 게이트웨이에 따라 위치와 파일 이름이 다릅니다.

온-프레미스 데이터 게이트웨이에서 프록시를 사용하는 것과 관련된 4개의 구성 파일이 있습니다. 다음 두 가지 기본 구성 파일이 게이트웨이 및 해당 구성 프로세스에 적용됩니다.

• 첫 번째 파일은 실제로 게이트웨이를 구성하는 구성 화면용입니다. 게이트웨이를 구성하는 데 문제가 있는 경우 다음 파일을 확인합니다. C:\Program Files\On-premises data gateway\enterprisegatewayconfigurator.exe.config. 온-프레미스 데이터 게이트웨이(개인 모드)에서 해당 파일이 %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config.
• 두 번째 파일은 게이트웨이를 사용하여 클라우드 서비스와 상호 작용하는 실제 Windows 서비스용입니다. 이 파일은 요청을 처리합니다. C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. 온-프레미스 데이터 게이트웨이(개인 모드)에서 해당 파일이 %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config.

프록시 구성을 변경하려는 경우 두 파일 모두에서 프록시 구성이 정확히 같도록 이러한 파일을 편집해야 합니다.

게이트웨이가 프록시를 통해 클라우드 데이터 원본에 연결하려면 세 번째 구성 파일을 편집해야 합니다.

• C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config

온-프레미스 데이터 게이트웨이(개인 모드)에서 해당 파일이 %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config.

게이트웨이가 프록시를 통해 Fabric Pipelines 서비스에 연결하려면 네 번째 구성 파일을 편집해야 합니다. 2025년 2월 버전(3000.258) 이후 구성 파일의 이름이 다음과 같이 변경됩니다.

• C:\Program Files\On-premises data gateway\FabricIntegrationRuntime\5.0\Shared\FabricPipelineworker.exe.config

이전 버전을 사용하는 경우 구성 파일은 다음과 같습니다.

• C:\Program Files\On-premises data gateway\FabricIntegrationRuntime\5.0\Shared\Fabricworker.exe.config

다음 섹션에서는 이러한 파일을 편집하는 방법을 설명합니다.

프록시 설정 구성

다음 샘플에서는 두 주 구성 파일 모두에서 찾은 기본 프록시 구성을 보여 있습니다.

<system.net>
    <defaultProxy useDefaultCredentials="true" />
</system.net>

기본 구성은 Windows 인증에서 작동합니다. 프록시에서 다른 형태의 인증을 사용하는 경우 설정을 변경해야 합니다. 확실하지 않은 경우 네트워크 관리자에게 문의하세요.

기본 프록시 인증은 권장하지 않습니다. 기본 프록시 인증을 사용하면 프록시 인증 오류가 발생하여 게이트웨이가 제대로 구성되지 않을 수 있습니다. 더 강력한 프록시 인증 메커니즘을 사용하여 해결합니다.

기본 자격 증명을 사용하는 것 외에도 프록시 서버 설정을 더 자세히 정의하는 요소를 추가할 <proxy> 수 있습니다. 예를 들어 bypassonlocal 매개 변수를 false로 설정하여 온-프레미스 데이터 게이트웨이가 로컬 리소스에 대해서도 항상 프록시를 사용하도록 지정할 수 있습니다. 이 설정은 프록시 로그 파일의 게이트웨이에서 시작된 모든 HTTPS 요청을 추적하기 위해 상황을 해결하는 데 도움이 될 수 있습니다. 다음 샘플 구성에서는 모든 요청이 IP 주소가 192.168.1.10인 특정 프록시를 통과해야 한다고 지정합니다.

<system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.1.10:3128"  
            bypassonlocal="false"  
            usesystemdefault="false"
        />  
    </defaultProxy>
</system.net>

게이트웨이가 게이트웨이를 통해 클라우드 데이터 원본에 연결하려면 Microsoft.Mashup.Container.NetFX45.exe.config 파일도 편집해야 합니다.

파일에서 <configurations> 섹션을 확장하여 다음 내용을 포함시키고, 프록시 정보로 proxyaddress 속성을 업데이트합니다. 다음 예제에서는 IP 주소가 192.168.1.10인 특정 프록시를 통해 모든 클라우드 요청을 라우팅합니다.

<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true" enabled="true">
        <proxy proxyaddress="http://192.168.1.10:3128" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

프록시가 모든 인터넷 통신의 요구 사항인 경우, 특히 네트워크가 안전하고 잠긴 회사 사용의 경우 이 세 번째 파일을 구성해야 할 수 있습니다. 게이트웨이 통신에 프록시가 필요한 경우 컨테이너의 인터넷 트래픽에도 필요할 수 있습니다. 이 경우 컨테이너가 외부(인터넷) 쿼리를 만들 때까지 게이트웨이가 성공적으로 작동하는 것처럼 보일 수 있습니다. 이 문제는 온-프레미스 데이터의 결과 쿼리를 Azure Data Lake Storage에 푸시하려는 데이터 흐름에 특히 적용됩니다. 그러나 게이트웨이 쿼리가 온-프레미스 의미 체계 모델을 인터넷 바인딩된 의미 체계 모델과 병합하는 경우에도 적용됩니다.

.NET 구성 파일의 프록시 요소 구성에 대해 자세히 알아보려면 defaultProxy 요소(네트워크 설정)로 이동합니다.

출력 대상에 대한 게이트웨이 구성

또한 게이트웨이를 출력 대상과 함께 사용하려면 대상 데이터 원본에 도달하기 위해 방화벽 또는 프록시를 통과할 수 있도록 게이트웨이를 구성해야 할 수 있습니다. 프록시 서버를 사용하는 경우, 이 패스스루에서는 적절한 대상에 대한 URL 목록화를 활성화해야 할 수 있습니다. 예를 들어, LakeHouse의 경우 *.datawarehouse.pbidedicated.windows.net, Data Lake의 경우 *.dfs.core.windows.net 등을 사용할 수 있습니다.

게이트웨이 서비스 계정을 도메인 사용자로 변경

앞에서 설명한 대로 기본 자격 증명을 사용하도록 프록시 설정을 구성할 때 프록시에 대한 인증 문제가 발생할 수 있습니다. 이 상황은 기본 서비스 계정이 인증된 도메인 사용자가 아닌 서비스 SID일 때 발생합니다. 조직의 프록시가 요청을 인증하기 위해 도메인 계정이 필요한 경우 게이트웨이의 서비스 계정을 도메인 서비스 계정으로 변경할 수 있습니다. 이 변경을 통해 프록시를 사용하여 적절한 인증을 수행할 수 있습니다. 게이트웨이 서비스 계정을 변경하는 방법에 대한 자세한 내용은 온-프레미스 데이터 게이트웨이 서비스 계정 변경으로 이동합니다.

관련 콘텐츠

• 프록시 설정 구성에 대한 단계별 가이드
• 방화벽 정보