정방향 프록시는 부하 분산과 같은 작업을 위해 인터넷으로 나가는 트래픽을 관리하는 데 도움이 됩니다. Tableau Server 및 Tableau Desktop에서 정방향 프록시를 구성하여 OAuth 인증을 사용할 수 있습니다.

정방향 프록시를 통해 Tableau Desktop에 연결

다음 단계를 완료하여 Windows LAN 설정에서 프록시 서버를 구성합니다.

  1. LAN 설정 대화 상자를 엽니다.
  2. 팁: Windows 시작 메뉴에서 인터넷 옵션을 검색하여 이 대화 상자를 빠르게 시작할 수 있습니다.

  3. 인터넷 속성 대화 상자에서 연결 탭을 선택합니다.
  4. LAN 설정을 선택합니다.
  5. 프록시 서버에서 LAN에 프록시 서버 사용을 선택합니다.
  6. 프록시 서버 주소를 입력합니다.
  7. 서버 포트를 입력합니다.
  8. 로컬 주소에 프록시 서버 사용 안 함을 선택합니다.

참고: Tableau Server의 프록시 구성의 단계를 이미 수행했고 프록시를 통한 OAuth 요청이 작동하지 않는 경우 옵션 2를 선택합니다.

구성 옵션 1: 시스템 환경 변수 사용

시스템 전체 환경 변수를 편집하고 HTTP_PROXYHTTPS_PROXY를 프록시로 설정하여 OAuth 인증을 사용할 수 있습니다.

  1. Windows 컴퓨터 검색 상자에 고급 시스템 설정을 입력합니다.
  2. Enter 키를 눌러 시스템 속성 상자를 엽니다.
  3. 고급 탭에서 환경 변수를 선택합니다.
  4. 시스템 변수 필드를 스크롤합니다.
    • 필드에 https_proxy 또는 http_proxy가 있는 경우 값이 이전 단계에서 구성한 프록시 서버 주소와 충돌하지 않는지 확인합니다.
    • 설정되어 있지 않으면 이전 단계에서 구성한 프록시 서버 주소와 일치하는 값으로 설정합니다.
  5. Tableau Desktop을 다시 시작합니다.
  6. OAuth 커넥터에 대한 연결을 시도하고 예상대로 작동하는지 확인합니다.

참고: OAuth 클라이언트를 비워둘 수 없음 또는 SSLHandshake 예외 또는 연결 거부됨 예외가 표시되면 옵션 2로 계속합니다.

구성 옵션 2: Java net.properties 프록시 설정 구성

  1. 파일 디렉터리에서 Tableau Desktop을 실행하는 데 사용하는 Java 버전을 찾습니다.
    • Mac 예: /Applications/Tableau <Version>/Plugins/jre
    • Windows 예: C:/Program Files/Tableau/Tableau <Version>/bin/jre
  2. Java 위치 디렉터리에서 conf 폴더를 선택합니다. 디렉터리가 없는 경우 만듭니다.
  3. conf 폴더에서 net.properties 파일을 찾고 에디터에서 엽니다. 이 파일이 없는 경우 동일한 이름으로 만듭니다.
  4. 참고: 이 파일에 대한 쓰기 권한이 없는 경우 시스템 파일 설정을 사용하여 사용하도록 설정합니다.

  5. 다음 값을 수정하거나 만듭니다.
    • http.proxyPort=<your proxy port>
    • http.proxyHost=<your proxy host address>
    • https.proxyPort=<your proxy port>
    • https.proxyHost=<your proxy host address>

    경고: 호스트만 포함해야 합니다. 프록시 주소가 http://myproxy:8888인 경우 http.proxyHost=myproxy를 설정해야 합니다.

  6. Tableau Desktop을 다시 시작하고 OAuth를 통한 연결을 시도합니다.

OAuth 권한 부여가 필요한 프록시를 통해 연결

프록시에 사용자 이름 및 비밀번호로 로그인해야 하는 경우 다음 단계를 완료해야 OAuth 요청이 프록시를 통해 작동합니다.

  1. 파일 디렉터리에서 Tableau Desktop을 실행하는 데 사용하는 Java 버전을 찾습니다.
    • Mac 예: /Applications/Tableau <Version>/Plugins/jre
    • Windows 예: C:/Program Files/Tableau/Tableau <Version>/bin/jre
  2. Java 위치 디렉터리에서 conf 폴더를 선택합니다. 디렉터리가 없는 경우 만듭니다.
  3. conf 폴더에서 net.properties 파일을 찾고 에디터에서 엽니다. 이 파일이 없는 경우 동일한 이름으로 만듭니다.
  4. 참고: 이 파일에 대한 쓰기 권한이 없는 경우 시스템 파일 설정을 사용하여 사용하도록 설정합니다.

  5. 다음 값을 수정하거나 만듭니다.
    • http.proxyUser=<your proxy username>
    • http.proxyPassword=<your proxy password>
  6. Tableau Desktop을 다시 시작하고 OAuth를 통한 연결을 시도합니다.

정방향 프록시를 통해 Tableau Server에 연결

정방향 프록시 뒤에서 Tableau Server를 시작하여 인터넷 액세스를 허용할 수 있습니다. Windows LAN 설정에서 프록시 서버를 구성하여 정방향 프록시를 통해 Tableau Server에 연결할 수 있습니다.

프록시 구성

다음 단계를 완료하여 프록시 서버를 구성합니다.

  1. LAN 설정 대화 상자를 엽니다.
  2. 팁: Windows 시작 메뉴에서 인터넷 옵션을 검색하여 이 대화 상자를 빠르게 시작할 수 있습니다.

  3. 인터넷 속성 대화 상자에서 연결 탭을 선택합니다.
  4. LAN 설정을 선택합니다.
  5. 프록시 서버에서 LAN에 프록시 서버 사용을 선택합니다.
  6. 프록시 서버 주소를 입력합니다.
  7. 프록시 서버 포트를 입력합니다.
  8. 로컬 주소에 프록시 서버 사용 안 함을 선택합니다.

예외 추가

로컬 Tableau Server 클러스터 내의 모든 통신이 프록시 서버로 라우팅되지 않음을 보장하는 예외를 추가할 수 있습니다. 예외를 추가하려면 다음 단계를 완료합니다.

  1. LAN 설정 대화 상자에서 고급을 선택합니다. 이 단추는 사용자 LAN에 프록시 서버를 사용하는 옵션을 선택한 경우에만 표시됩니다.
  2. 프록시 설정 대화 상자의 예외 필드에 다음 값을 입력합니다.
    • localhost
    • 서버 호스트 이름
    • 동일한 클러스터에 있는 다른 Tableau Server 컴퓨터의 IP 주소

    참고: 세미콜론을 사용하여 항목을 구분합니다.

  3. 프록시 설정 대화 상자를 닫습니다.
  4. LAN 설정 대화 상자를 닫습니다.
  5. 인터넷 속성 대화 상자에서 확인을 선택하여 설정을 적용합니다.

참고: Tableau Server의 프록시 구성의 단계를 완료했고 프록시를 통한 OAuth 요청이 작동하지 않는 경우 옵션 2를 선택합니다.

구성 옵션 1: 시스템 환경 변수 사용

시스템 전체 환경 변수를 편집하고 HTTP_PROXY 및 HTTPS_PROXY를 프록시로 설정할 수 있습니다.

  1. Windows 컴퓨터 검색 상자에 Advanced system settings를 입력합니다.
  2. Enter 키를 눌러 시스템 속성 상자를 엽니다.
  3. 고급 탭에서 환경 변수를 선택합니다.
  4. 시스템 변수 필드를 스크롤합니다.
    • 필드에 https_proxy 또는 http_proxy가 있는 경우 값이 이전 단계에서 구성한 프록시 서버 주소와 충돌하지 않는지 확인합니다.
    • 설정되어 있지 않으면 이전 단계에서 구성한 프록시 서버 주소와 일치하는 값으로 설정합니다.
  5. Tableau Server를 다시 시작합니다.
  6. OAuth 커넥터에 대한 연결을 시도하고 예상대로 작동하는지 확인합니다.

참고: OAuth 클라이언트를 비워둘 수 없음 또는 SSLHandshake 또는 연결 거부됨 예외가 표시되면 옵션 2로 계속합니다.

구성 옵션 2: Java net.properties 프록시 설정 구성

  1. 파일 디렉터리에서 Tableau Server를 실행하는 데 사용하는 Java 버전을 찾습니다.
    • Linux 예: opt/tableau/tableau_server/packages/repository*/jre
    • Windows 예: C:\Program Files\Tableau\Tableau Server\packages\repository*\jre
  2. Java 위치 디렉터리에서 conf 폴더를 선택합니다.
  3. 디렉터리가 없는 경우 만듭니다.
  4. conf 폴더에서 net.properties 파일을 찾고 에디터에서 엽니다. 이 파일이 없는 경우 동일한 이름으로 만듭니다.
  5. 참고: 이 파일에 대한 쓰기 권한이 없는 경우 시스템 파일 설정을 사용하여 사용하도록 설정합니다.

  6. 다음 값을 수정하거나 만듭니다.
    • http.proxyPort=<your proxy port>
    • http.proxyHost=<your proxy host address>
    • https.proxyPort=<your proxy port>
    • https.proxyHost=<your proxy host address>

    경고: 호스트만 포함해야 합니다. 프록시 주소가 http://myproxy:8888인 경우 http.proxyHost=myproxy를 설정해야 합니다.

    프록시 호스트 기본값은 http.nonProxyHosts =localhost|127.*|[::1]입니다. 기본값이 예외 목록과 일치하는 경우 프록시 서버를 우회한 다음 6단계로 계속합니다. 일치하지 않으면 다음 값이 있는지 확인합니다.

    • localhost
    • 동일한 클러스터에 있는 다른 Tableau Server 컴퓨터의 서버 호스트 이름과 IP 주소도 입력합니다.
    • 각 항목은 “|”로 구분됩니다.
  7. Tableau Server를 다시 시작하고 OAuth를 통한 연결을 시도합니다.

OAuth 권한 부여가 필요한 프록시를 통해 Tableau Server에 연결

프록시에 사용자 이름 및 비밀번호로 로그인해야 하는 경우 다음 단계를 완료해야 OAuth 요청이 작동합니다.

  1. 파일 디렉터리에서 Tableau Server를 실행하는 데 사용하는 Java 버전을 찾습니다.
    • Linux 예: opt/tableau/tableau_server/packages/repository*/jre
    • Windows 예: C:\Program Files\Tableau\Tableau Server\packages\repository*\jre
  2. Java 위치 디렉터리에서 conf 폴더를 선택합니다. 디렉터리가 없는 경우 만듭니다.
  3. conf 폴더에서 net.properties 파일을 찾고 에디터에서 엽니다. 이 파일이 없는 경우 동일한 이름으로 만듭니다.
  4. 참고: 이 파일에 대한 쓰기 권한이 없는 경우 시스템 파일 설정을 사용하여 사용하도록 설정합니다.

  5. 다음 값을 수정하거나 만듭니다.
    • http.proxyUser=<your proxy username>
    • http.proxyPassword=<your proxy password>
  6. Tableau Server를 다시 시작하고 OAuth를 통한 연결을 시도합니다.

SSLHandshake 오류

여전히 오류가 발생하면 SSL 인증서가 올바른 키 저장소에 배치되었는지 확인합니다.

Windows에서 키 저장소는 시스템의 Trusted Certs 저장소에 있습니다. 키 저장소는 올바르지만 여전히 오류가 발생하는 경우 인증서를 Java 키 저장소로 직접 가져옵니다. 다음 단계를 완료하여 인증서를 Java 키 저장소로 가져옵니다.

  1. 프록시의 SSL 인증서를 파일로 내보냅니다.
  2. 팁: 응용 프로그램, 유틸리티, 키 집합 액세스, 시스템, 범주, 인증서에서 인증서를 찾을 수 있습니다.

  3. Tableau를 실행하기 위해 사용하는 java 버전을 찾습니다.
  4. 터미널 명령 프롬프트를 엽니다.
  5. Tableau를 실행하기 위해 사용하는 java 버전이 포함된 디렉터리에서 다음 명령을 실행합니다.
  6. Keytool –import –trustcacerts –file /Users/tableau_user/Desktop/SSL.cer -keystore Tableau <version>/Plugins/jre/lib/security/cacerts -storepass changeit

  7. Tableau Server 또는 Tableau Desktop을 다시 시작합니다.

참고: keytool 명령을 실행할 때 FileNotFoundException(액세스가 거부됨)이 발생하는 경우 상승된 사용 권한으로 명령을 실행해 보십시오.

sudo keytool –import –trustcacerts –file /Users/tableau_user/Desktop/SSL.cer -keystore Tableau 2021.3.1/Plugins/jre/lib/security/cacerts -storepass changeit

피드백을 제공해 주셔서 감사합니다!