프록시 설정 구성에 대한 단계별 가이드

아티클
05/06/2024

작업 환경에서 Microsoft 온-프레미스 데이터 게이트웨이가 서비스에 연결하기 위해 프록시 서버를 통과하도록 요구하는 경우 프록시 설정을 구성하려면 아래 단계를 수행합니다.

프록시 설정 구성

프록시 정의 요소를 만듭니다. .NET 구성 파일에 대한 프록시 요소의 구성에 대해 자세히 알아보려면 defaultProxy 요소(네트워크 설정)를 참조하세요.

다음 예제에서는 포트 8888에서 IP 주소가 192.168.0.1인 특정 프록시를 통해 모든 요청을 라우팅합니다.
```
<defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>
```
온-프레미스 데이터 게이트웨이(예: *C:\Program Files\온-프레미스 데이터 게이트웨이*)에 대한 설치 폴더를 찾습니다.
게이트웨이, 즉 EnterpriseGatewayConfigurator.exe.config를 구성하는 구성 화면에 사용되는 첫 번째 파일을 엽니다.
defaultProxy 요소를 찾아 위의 1단계에서 만든 프록시 구성으로 바꾼 다음 변경 내용을 파일에 저장합니다.
게이트웨이를 사용하여 클라우드 서비스와 상호 작용하고 요청을 처리하는 실제 Windows 서비스에 사용되는 두 번째 파일, 즉 Microsoft.PowerBI.EnterpriseGateway.exe.config 를 열고 4단계를 반복합니다.
게이트웨이가 데이터 원본(일반적으로 클라우드 데이터 원본)에 연결하는 데 사용되는 세 번째 구성 파일의 경우 설치 폴더에서 하위 폴더 m 을 연 다음 파일 Microsoft.Mashup.Container.NetFX45.exe.config를 엽니다. 4단계를 반복하여 프록시 구성을 이 파일에 삽입합니다.

파일이 기본 상태인 경우 다음 예제와 같이 프록시 정의와 함께 태그를 추가 system.net 해야 합니다.
```
<system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>
```
온-프레미스 데이터 게이트웨이 애플리케이션을 열고 서비스 설정 탭으로 이동하고 지금 다시 시작을 선택하여 게이트웨이 서비스를 다시 시작하고 새 프록시 설정을 적용합니다.

일관된 프록시 구성 확인

2022년 9월 버전 이상을 실행하고 있는지 확인합니다.
온-프레미스 데이터 게이트웨이 애플리케이션을 엽니다.
진단 탭으로 이동합니다.
네트워크 포트 테스트 아래에 새로운 테스트 시작을 선택합니다.
네트워크 포트 테스트가 완료되면 마지막으로 완료된 테스트 결과 열기를 선택합니다.
세 가지 필수 구성 파일 Proxy configuration : Proxy settings match for all Gateway process configurations. 에서 프록시 구성이 일관되면 메시지가 표시됩니다.

그렇지 않으면 프록시 구성이 일치하지 않으면 다음 정보가 표시됩니다.

Proxy configuration : Proxy settings are not consistent. Please ensure that the proxy configuration matches across the files listed below:
C:\Program Files\On-premises data gateway\EnterpriseGatewayConfigurator.exe.config
C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config
C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config
Review <https://docs.microsoft.com/data-integration/gateway/service-gateway-proxy>  for additional information about configuring proxies for the Gateway.

온-프레미스 데이터 게이트웨이(개인 모드)에서 프록시 구성 일관성 확인을 실행하는 경우 다음 구성 파일이 확인됩니다.

%LocalAppData%\Microsoft\온-프레미스 데이터 게이트웨이(개인 모드)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\온-프레미스 데이터 게이트웨이(개인 모드)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\온-프레미스 데이터 게이트웨이(개인 모드)\m\Microsoft.Mashup.Container.NetFX45.exe.config

일관되지 않거나 누락된 프록시 구성 동작

프록시 정의가 누락되었거나 일관성이 없는 경우 온-프레미스 데이터 게이트웨이에서 다른 동작을 경험할 수 있습니다. 다음은 몇 가지 예입니다.

의미 체계 모델 또는 데이터 흐름 새로 고침 실패, 오류 메시지 예제: Error: Unable to connect to the remote server.
온-프레미스 데이터 게이트웨이를 시작하는 동안 로그인하지 못하거나, 로그인 프롬프트가 표시되지만 해당 콘텐츠를 표시할 수 없거나, 오류 메시지 페이지가 표시됩니다.
네트워크 포트 테스트 결과는 서버에 연결하는 데 실패를 보고합니다.

다음 단계

방화벽 정보

다음을 통해 공유

프록시 설정 구성에 대한 단계별 가이드