# tableau Tableau Server on Windows (server) - Full Documentation [주요 콘텐츠로 건너뛰기](#main-content) # .hyper 형식으로 추출 업그레이드 Tableau 버전 2018에서는 Tableau 추출의 이전 `.tde` 형식을 대체하는 `.hyper` 형식이 도입되었습니다. 2018년부터 `.hyper` 형식은 Tableau가 추출을 만드는 데 사용되는 표준 형식이 되었고 이제 대다수의 추출이 `.hyper` 파일입니다. 2023년 초부터 Tableau는 Tableau Cloud와 Tableau Public에서 `.tde` 형식에 대한 지원을 중단했습니다. 이러한 사용 중단에 대한 자세한 내용은 이 [Tableau 커뮤니티 게시물](https://community.tableau.com/s/feed/0D54T00001BHiGwSAL)을 참조하십시오. ## .tde 파일에 대한 지원 중단 2023년부터 Tableau 추출에 대한 `.tde` 형식이 사용 중단되었습니다. 이 형식은 2018년에 `.hyper` 형식으로 바뀌었지만 2023년 3월까지 업로드된 파일에 대해서는 계속 유효합니다. - 이 변경 사항은 2023년 3월부로 Tableau Cloud 및 Tableau Public에 적용되었습니다. - Tableau Server 버전 2023.1.0부터는 `.tde` 형식 파일 업로드가 사용되지 않도록 설정됩니다. - 2024.2는 .tde 기반 통합 문서, 데이터 원본 또는 책갈피를 지원하는 Tableau Desktop의 마지막 버전입니다. 버전 2024.3 이상에서는 .hyper 형식만 지원합니다. ## Tableau Desktop을 사용하여 .tde 추출을 수동으로 업그레이드 추출을 로컬로 관리하는 경우 Tableau Desktop을 사용하여 `.tde` 추출을 `.hyper` 추출로 수동으로 업그레이드할 수 있습니다. **참고:** 이 기능은 Tableau Desktop 버전 2024.2 이하에서만 사용할 수 있습니다. 1. Tableau Desktop에서 `.tde` 추출을 사용하는 통합 문서를 엽니다. 2. 데이터 메뉴에서 추출 데이터 원본을 선택한 다음 추출 > 업그레이드를 선택합니다. 3. 파일 > 저장을 선택합니다. 이렇게 하면 통합 문서가 저장될 뿐만 아니라 추출 업그레이드도 완료됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # '서비스 계정 사용자' 문제 해결 ['서비스 계정' 서비스 계정](https://help.tableau.com/current/server/ko-kr/runas.htm) 항목에 설명된 것과 같이 Tableau Server는 설치된 컴퓨터에 대한 관리자 권한과 같은 액세스 권한을 필요로 합니다. 따라서 '서비스 계정' 서비스 계정을 업데이트하면 해당 계정의 Tableau 컴퓨터에 대한 사용 권한이 백그라운드 프로세스를 통해 구성됩니다. 그러나 일부 복잡한 배포 시나리오의 경우 로컬 Tableau Server 컴퓨터에 대한 '서비스 계정' 서비스 계정 사용 권한을 확인하거나 수동으로 구성해야 할 수 있습니다. 이 섹션을 사용하여 배포에서 Tableau Server를 실행하는 컴퓨터에 구성된 사용 권한을 확인합니다. 이 섹션에는 '서비스 계정' 서비스 계정에 대한 사용 권한을 설정하고 보안 정책을 구성하는 방법을 설명하는 절차도 포함되어 있습니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # '서비스 계정' 서비스 계정 _'서비스 계정'_ 서비스 계정은 Tableau Server에서 리소스에 액세스할 때 사용하는("실행하는") Windows 계정입니다. 예를 들어 Tableau Server는 Tableau Server가 설치된 컴퓨터에서 파일을 읽고 씁니다. Windows의 관점에서 Tableau Server는 이 작업을 '서비스 계정' 서비스 계정으로 수행하는 것입니다. 일부 경우 Tableau Server는 데이터베이스 또는 공유 네트워크 디렉터리의 파일과 같은 외부 원본의 데이터에 액세스할 때 '서비스 계정' 서비스 계정을 사용할 수 있습니다. Tableau Server 배포를 계획할 때는 로컬 네트워크 서비스 계정(NT Authority\\Network Service)의 컨텍스트에 따라 실행되도록 구성된 기본 '서비스 계정' 서비스 계정으로 요구 사항을 충족할 수 있는지 확인해야 합니다. 그렇지 않은 경우 Active Directory 도메인의 리소스에 액세스할 수 있는 도메인 계정으로 실행되도록 '서비스 계정' 서비스 계정을 업데이트해야 합니다. **참고:** Tableau Server 버전 2023.3.x부터 '서비스 계정' 서비스 계정이 도메인 계정을 사용하도록 구성된 경우 관리자는 `tsm configuration set` 명령을 사용하여 파일 액세스에 대한 서버 허용 목록도 구성해야 합니다. 허용 목록을 사용하면 파일 기반 데이터 원본 액세스가 지정된 로컬 또는 공유 디렉터리 경로로 제한됩니다. 서버 허용 목록을 구성하는 단계와 자세한 내용은 [보안 강화 검사 목록](https://help.tableau.com/current/server/ko-kr/security_harden.htm#11-configure-a-server-allowlist-for-filebased-data-sources)을 참조하십시오. 어느 쪽을 선택하든, Tableau Server가 '서비스 계정' 서비스 계정으로 사용하는 계정의 보안 의미를 이해하는 것이 중요합니다. 특히, Tableau Server가 Windows 인증을 사용하는 다른 서버 파일 공유 또는 데이터베이스에 액세스해야 하는 경우 '서비스 계정' 서비스 계정으로 구성된 계정이 이러한 리소스에 액세스하는 데 사용됩니다. '서비스 계정' 서비스 계정으로 구성된 계정에는 로컬 Tableau Server에 대한 상승된 사용 권한도 있어야 합니다. 보안에서 일반적인 최상의 방법은 모든 사용자 계정의 범위를 필요한 최소 사용 권한으로 제한하는 것입니다. '서비스 계정' 서비스 계정을 계획할 때도 동일한 사항이 권장됩니다. 자세한 내용은 ['서비스 계정' 서비스 계정으로 데이터 액세스](https://help.tableau.com/current/server/ko-kr/runas_access.htm)를 참조하십시오. '서비스 계정' 서비스 계정에 사용하는 계정은 로컬 관리자 또는 도메인 관리자 계정의 멤버가 아니어야 합니다. 대신, '서비스 계정' 서비스 계정의 관리자가 아닌 도메인 사용자 계정을 사용하는 것이 좋습니다. 이러한 관리자 그룹의 멤버가 아닌 도메인 계정을 사용하는 것이 보안상 좋으며 특정 데이터 원본 및 폴더에 대한 액세스를 방지하는 데 도움이 될 수 있습니다. '서비스 계정' 서비스 계정을 만드는 경우 적용할 수 있는 모범 사례는 ['서비스 계정' 서비스 계정 만들기](https://help.tableau.com/current/server/ko-kr/runas_acct.htm#best)를 참조하십시오. Tableau Server 설치 중에 '서비스 계정' 서비스 계정을 설정하거나 TSM 웹 UI를 사용하여 '서비스 계정' 서비스 계정을 업데이트할 수 있습니다. '서비스 계정' 서비스 계정에 대한 사용 권한은 Tableau 서비스 관리자에 의해 설정되지만 '서비스 계정' 서비스 계정으로 사용하려는 계정이 요구 사항을 충족하는지 여부가 확실하지 않거나 '서비스 계정' 서비스 계정을 변경한 후 사용 권한 오류가 발생하는 경우 [필수적인 '서비스 계정' 서비스 계정 설정](https://help.tableau.com/current/server/ko-kr/runas_confirm.htm)을 참조하십시오. ![사용자 계정이 선택된 Tableau Server Manager 서비스 계정' 서비스 계정 구성 창입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-runas.PNG) ## 기본 '서비스 계정' 서비스 계정: 네트워크 서비스 네트워크 서비스 계정은 제한된 사용 권한으로 미리 정의된 로컬 계정으로, 모든 Windows 컴퓨터에 존재합니다. 계정이 실행되는 로컬 컴퓨터에 제한된 관리 권한으로 액세스할 수 있지만 Active Directory 기본 사용자 그룹의 멤버보다는 더 많은 리소스 액세스 권한을 가집니다. 예를 들어 네트워크 서비스 그룹은 레지스트리(이벤트 로그)에 쓸 수 있고 응용 프로그램 서비스에 대한 특별 로그온 권한을 가집니다. 기본적으로 '서비스 계정' 서비스 계정은 네트워크 서비스라고 하는 로컬 계정으로 설정됩니다. 다음에 해당하는 경우 기본 네트워크 서비스 계정을 사용하십시오. - Tableau Server에 대해 로컬 인증을 사용합니다. - 조직의 모든 사용자가 Tableau Server에 업로드하는 통합 문서에 추출된 데이터가 포함됩니다. - 단일 서버 배포에서 Tableau Server를 실행합니다. - 사용자가 Tableau Server를 통해 액세스하는 외부 데이터 원본에 Windows NT 통합 보안 또는 Kerberos가 필요하지 않습니다. 대부분의 데이터 액세스 시나리오에서 Microsoft SQL Server, MSAS, Teradata 및 Oracle 데이터베이스에 Windows NT 통합 보안이 필요합니다. 동일한 Active Directory 도메인 내의 원격 컴퓨터에 있는 리소스에 액세스할 때 네트워크 서비스 계정을 사용할 수 있지만 이러한 시나리오에서는 기본 계정을 사용하지 않는 것이 좋습니다. Tableau Server에서 환경의 데이터 원본에 연결해야 하는 경우 '서비스 계정' 서비스 계정에 대한 도메인 계정을 구성하십시오. ['서비스 계정' 서비스 계정 변경](https://help.tableau.com/current/server/ko-kr/runas_acct.htm)를 참조하십시오. ## '서비스 계정' 서비스 계정: 도메인 사용자 모든 Active Directory 시나리오의 경우 Tableau Server '서비스 계정' 서비스 계정을 도메인 사용자 계정으로 업데이트하는 것이 좋습니다. Tableau Server를 통해 액세스하는 데이터 원본에 Windows NT 통합 보안 또는 Kerberos가 필요한 경우 '서비스 계정' 서비스 계정을 도메인 사용자 계정으로 업데이트하십시오. Tableau Server를 분산 배포한 경우 '서비스 계정' 서비스 계정을 도메인 사용자 또는 Windows 작업 그룹 사용자로 업데이트할 수 있습니다. 두 경우 모두, 모든 서버 노드에 동일한 사용자 계정을 사용해야 합니다. 자세한 내용은 [분산 요구 사항](https://help.tableau.com/current/server/ko-kr/distrib_requ.htm)을 참조하십시오. 도메인 계정을 사용하도록 환경을 구성하려면 ['서비스 계정' 서비스 계정 변경](https://help.tableau.com/current/server/ko-kr/runas_acct.htm)를 참조하십시오. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # '서비스 계정' 서비스 계정 변경 환경 및 데이터 액세스 요구 사항에 따라 ‘서비스 계정’ 서비스 계정을 변경하는 것이 좋거나 변경해야 할 수 있습니다. '서비스 계정' 서비스 계정을 변경하는 두 가지 주요 시나리오가 있습니다. - 기본 서비스 계정 로컬 계정(NetworkService)을 도메인 계정으로 바꿉니다. 데이터 원본의 대부분이 Active Directory(Windows NT 통합 보안)의 컨텍스트에서 인증되는 환경을 운영 중인 경우 로컬 계정(NetworkService)이 아닌 도메인 계정을 사용하도록 '서비스 계정' 서비스 계정을 구성해야 합니다. - 기존 도메인 '서비스 계정' 서비스 계정을 다른 계정으로 변경합니다. 이 항목에서는 두 시나리오를 모두 설명하고 '서비스 계정' 서비스 계정 암호를 업데이트하는 방법을 설명합니다. '서비스 계정' 서비스 계정에 사용하는 계정은 로컬 관리자 또는 도메인 관리자 계정의 멤버가 아니어야 합니다. 대신, '서비스 계정' 서비스 계정의 관리자가 아닌 도메인 사용자 계정을 사용하는 것이 좋습니다. 이러한 관리자 그룹의 멤버가 아닌 도메인 계정을 사용하는 것이 보안상 좋으며 특정 데이터 원본 및 폴더에 대한 액세스를 방지하는 데 도움이 될 수 있습니다. '서비스 계정' 서비스 계정을 만드는 경우 적용할 수 있는 모범 사례는 ['서비스 계정' 서비스 계정 만들기](#best)를 참조하십시오. **참고:** Tableau Server 버전 2023.3.x부터 '서비스 계정' 서비스 계정이 도메인 계정을 사용하도록 구성된 경우 관리자는 `tsm configuration set` 명령을 사용하여 파일 액세스에 대한 서버 허용 목록도 구성해야 합니다. 허용 목록을 사용하면 파일 기반 데이터 원본 액세스가 지정된 로컬 또는 공유 디렉터리 경로로 제한됩니다. 서버 허용 목록을 구성하는 단계와 자세한 내용은 [보안 강화 검사 목록](https://help.tableau.com/current/server/ko-kr/security_harden.htm#11-configure-a-server-allowlist-for-filebased-data-sources)을 참조하십시오. ## 기본 서비스 계정 로컬 계정(NetworkService)을 도메인 계정으로 바꾸기 기본 NetworkService 계정을 도메인 계정으로 바꾸려면 '서비스 계정' 서비스 계정에 전용 계정을 사용하는 것이 좋습니다. 다음 단계를 수행합니다. 1. Active Directory에서 '서비스 계정' 서비스 계정 만들기 2. '서비스 계정' 서비스 계정을 사용하도록 Tableau Server 구성 ### '서비스 계정' 서비스 계정 만들기 다음 최상의 방법을 따르십시오. - '서비스 계정' 서비스 계정이 조직의 사용자를 대신하여 데이터에 액세스하는 방법을 이해하는 것이 중요합니다. 일부 경우 사용자가 실수로 자신의 사용자 계정에 명시적으로 사용 권한이 부여되지 않은 데이터에 액세스할 수 있습니다. '서비스 계정' 서비스 계정을 만들기 전에 ['서비스 계정' 서비스 계정으로 데이터 액세스](https://help.tableau.com/current/server/ko-kr/runas_access.htm)를 검토하십시오. - Active Directory에서 Tableau Server '서비스 계정' 서비스 계정에 대한 전용 계정을 만듭니다. 즉, 기존 계정을 사용하지 마십시오. 전용 계정을 사용하면 Tableau Server에 대한 사용 권한이 있는 데이터 리소스에 Tableau Server '서비스 계정' 서비스 계정만 액세스할 수 있습니다. - ‘서비스 계정’ 서비스 계정은 Active Directory의 사용자 및 그룹 멤버 자격을 쿼리하는 데 사용됩니다. 기본적으로 NetworkServices 계정과 기본 도메인 사용자에게는 Active Directory 쿼리를 위한 사용 권한이 포함됩니다. ‘서비스 계정’ 서비스 계정에 대한 읽기 또는 쿼리 사용 권한을 제한하지 마십시오. - 도메인 관리 권한이 있는 계정은 사용하지 마십시오. 특히, Active Directory에서 계정을 만들 때는 도메인 사용자 그룹에 계정을 만드십시오. 만든 계정을 Active Directory 보안 그룹에 추가하지 마십시오. 계정에 대한 사용 권한이 불필요하게 상승할 수 있습니다. - 디렉터리의 데이터 원본에 대한 사용 권한을 이 한 계정에 부여합니다. '서비스 계정' 서비스 계정으로 사용할 계정에는 해당하는 데이터 원본 및 네트워크 공유에 대한 읽기 액세스 권한만 필요합니다. - 조직의 사용자가 스마트 카드를 사용하여 인증하는 경우 '서비스 계정' 서비스 계정에 대한 스마트 카드 로그온 옵션을 사용하지 않도록 설정하십시오. - Tableau Server를 시스템 드라이브가 아닌 드라이브에 설치한 경우 '서비스 계정' 서비스 계정의 추가 사용 권한을 허용하도록 시스템 드라이브를 구성해야 합니다. 시스템 드라이브는 Windows가 설치된 드라이브입니다. 예를 들어 C:/ 드라이브에 Windows를 설치한 경우 C:/가 시스템 드라이브입니다. 다른 드라이브(D:/, E:/ 등)에 Tableau Server를 설치한 경우 시스템 드라이브에 대한 '서비스 계정' 서비스 계정의 사용 권한을 구성해야 합니다. 자세한 내용은 [](https://help.tableau.com/current/server/ko-kr/runas_confirm.htm)[필수적인 '서비스 계정' 서비스 계정 설정](https://help.tableau.com/current/server/ko-kr/runas_confirm.htm)을 참조하십시오. ### Tableau Server에서 '서비스 계정' 서비스 계정 구성 Active Directory에서 '서비스 계정' 서비스 계정을 만든 후에 해당 계정을 사용하도록 Tableau Server를 구성합니다. TSM 웹 UI를 사용하여 '서비스 계정' 서비스 계정을 처음으로 구성합니다. **'서비스 계정' 서비스 계정을 구성하려면** 1. 브라우저에서 TSM을 엽니다. https://:8850. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm)을 참조하십시오. 2. 보안 탭을 클릭한 다음 '서비스 계정' 서비스 계정 탭을 클릭합니다. 3. 사용자 계정을 선택한 다음 서비스 계정의 사용자 이름 및 비밀번호를 입력합니다. 도메인의 이름을 `domain\account` 형식으로 지정합니다. 여기서, 도메인 이름은 사용자가 상주하는 도메인의 NetBIOS 이름입니다. ![사용자 계정이 선택된 Tableau Server Manager 서비스 계정' 서비스 계정 구성 창입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-runas.PNG) 4. 저장을 클릭하여 사용자 이름 및 비밀번호를 확인합니다. 5. 작업을 마쳤으면 보류 중인 변경 내용을 클릭한 다음 변경 내용 적용 및 다시 시작을 클릭합니다. '서비스 계정' 서비스 계정을 업데이트하면 Tableau Server가 입력한 계정의 로컬 컴퓨터에 대한 사용 권한을 자동으로 구성합니다. ## 기존 도메인 '서비스 계정' 서비스 계정을 다른 계정으로 변경 기존 도메인 '서비스 계정' 서비스 계정을 다른 계정으로 변경하려면 새 계정에 사용 권한을 적용해야 합니다. 새 '서비스 계정' 서비스 계정에 사용 권한을 적용하려면 먼저 계정에 기본 NetworkService 계정을 적용하여 사용 권한을 재설정해야 합니다. 시작하기 전에 '서비스 계정' 서비스 계정으로 사용하려는 새 계정이 이전에 ['서비스 계정' 서비스 계정 만들기](#best) 섹션에서 설명한 모범 사례를 준수하는지 확인합니다. 이 절차에서는 Tableau Server 서비스를 두 번 다시 시작해야 하므로, 업무 외 시간에 이 절차를 실행하십시오. TSM 웹 인터페이스 사용 1. 브라우저에서 TSM을 엽니다. https://:8850. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm)을 참조하십시오. 2. 보안 탭을 클릭한 다음 '서비스 계정' 서비스 계정 탭을 클릭합니다. 3. 사용자 계정에서 NT Authority\\NetworkService를 선택합니다. 4. 저장을 클릭합니다. 5. 작업을 마쳤으면 보류 중인 변경 내용을 클릭한 다음 변경 내용 적용 및 다시 시작을 클릭합니다. 6. 서버가 다시 시작되면 TSM을 열고 '서비스 계정' 서비스 계정 탭으로 이동합니다. 7. 사용자 계정을 선택한 다음 서비스 계정의 사용자 이름 및 비밀번호를 입력합니다. 도메인의 이름을 `domain\account` 형식으로 지정합니다. 여기서, 도메인 이름은 사용자가 상주하는 도메인의 NetBIOS 이름입니다. ![사용자 계정이 선택된 Tableau Server Manager 서비스 계정' 서비스 계정 구성 창입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-runas.PNG) 8. 저장을 클릭하여 사용자 이름 및 비밀번호를 확인합니다. 9. 작업을 마쳤으면 보류 중인 변경 내용을 클릭한 다음 변경 내용 적용 및 다시 시작을 클릭합니다. 10. 이전 계정에 대한 사용 권한을 취소합니다. ['서비스 계정' 서비스 계정 사용 권한 취소](https://help.tableau.com/current/server/ko-kr/runas_change.htm)를 참조하십시오. TSM CLI 사용 1. '서비스 계정' 서비스 계정을 NetworkService로 재설정합니다. 다음 명령을 실행합니다. `tsm configuration set -k service.runas.username -v "NT AUTHORITY\NetworkService"` 2. 다음 명령을 실행하여 변경 사항을 저장하고 다시 시작합니다. `tsm pending-changes apply` 3. '서비스 계정' 서비스 계정을 새 계정으로 설정합니다. 다음 명령을 실행합니다. `tsm configuration set -k service.runas.username -v ` `tsm configuration set -k service.runas.password -v ""` 문자열의 특수 문자가 올바르게 처리되도록 하려면 암호를 큰따옴표로 묶어야 합니다. 저장될 암호를 보려면 다음 명령을 실행합니다. `tsm pending-changes list` Active Directory에서 암호의 유효성을 확인합니다. 유효하면 암호가 암호화되어 저장됩니다. TSM은 성공 또는 실패 사실을 보고하지 않습니다. 4. 다음 명령을 실행하여 저장하고 다시 시작합니다. `tsm pending-changes apply` 문제 해결: - 서버가 시작되었는지 확인합니다. 성능이 저하된 상태이면 잘못된 암호를 입력했을 수 있습니다. `configuration get` 명령을 실행하여 저장된 암호를 확인합니다. 이 명령은 셸에서 암호를 해독하여 표시합니다. 다음 명령을 실행합니다. `tsm configuration get -k service.runas.password` 이전 암호가 표시되면 유효한 암호를 입력하지 않았습니다. - 올바른 암호를 입력하고(3단계 참조), 다음 명령을 실행하여 저장하고 다시 시작합니다. `tsm pending-changes apply` 6. 이전 계정에 대한 사용 권한을 취소합니다. ['서비스 계정' 서비스 계정 사용 권한 취소](https://help.tableau.com/current/server/ko-kr/runas_change.htm)를 참조하십시오. ## '서비스 계정' 서비스 계정 암호 업데이트 Active Directory에서 '서비스 계정' 서비스 계정 암호가 업데이트된 경우 Tableau Server에서 암호를 업데이트해야 합니다. '서비스 계정' 서비스 계정 암호는 Tableau Server에 암호화되어 저장됩니다. 자세한 내용은 [서버 암호 관리](https://help.tableau.com/current/server/ko-kr/security_secret_storage.htm)를 참조하십시오. 분산 배포 환경에서 Tableau Server를 실행하는 경우 클러스터의 초기 노드에서만 TSM으로 암호를 업데이트하면 됩니다. TSM이 이 구성을 각 노드에 자동으로 배포합니다. TSM 웹 인터페이스 사용 1. 브라우저에서 TSM을 엽니다. https://:8850. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm)을 참조하십시오. 2. 보안 탭을 클릭한 다음 '서비스 계정' 서비스 계정 탭을 클릭합니다. 3. 사용자 계정에서 서비스 계정의 암호를 입력합니다. 4. 저장을 클릭하여 암호를 확인합니다. 5. 작업을 마쳤으면 보류 중인 변경 내용을 클릭한 다음 변경 내용 적용 및 다시 시작을 클릭합니다. TSM CLI 사용 1. 새 비밀번호를 설정합니다. 다음 명령을 실행합니다. `tsm configuration set -k service.runas.password -v ""` 문자열의 특수 문자가 올바르게 처리되도록 하려면 암호를 큰따옴표로 묶어야 합니다. 특수 문자가 올바르게 이스케이프 처리되었는지 확인하려면 다음 명령을 실행하여 저장될 암호를 표시합니다. `tsm pending-changes list` Active Directory에서 암호의 유효성을 확인합니다. 유효하면 암호가 암호화되어 저장됩니다. TSM은 성공 또는 실패 사실을 보고하지 않습니다. 2. 다음 명령을 실행하여 저장하고 다시 시작합니다. `tsm pending-changes apply` 문제 해결: - 서버가 시작되었는지 확인합니다. 성능이 저하된 상태이면 잘못된 암호를 입력했을 수 있습니다. `configuration get` 명령을 실행하여 저장된 암호를 확인합니다. 이 명령은 셸에서 암호를 해독하여 표시합니다. 다음 명령을 실행합니다. `tsm configuration get -k service.runas.password` 이전 암호가 표시되면 유효한 암호를 입력하지 않았습니다. - 올바른 암호를 입력하고(1단계 참조), 다음 명령을 실행하여 저장하고 다시 시작합니다. `tsm pending-changes apply` ### 문제 해결: Microsoft 서비스 콘솔에서 암호 업데이트 경우에 따라 '서비스 계정' 서비스 계정 암호를 업데이트한 후 서비스가 실패할 수 있습니다. 이 경우 Tableau Server 서비스 관리자 서비스의 암호를 수동으로 업데이트해야 할 수 있습니다. Microsoft 서비스 관리 콘솔에서 암호를 업데이트합니다. 분산 배포에서 Tableau Server를 실행하는 경우 클러스터의 각 노드에서 다음 절차를 수행해야 합니다. 1. Tableau Server를 중지합니다. - TSM CLI를 사용하려면 다음 명령을 실행합니다. `tsm stop` - TSM 웹 UI를 사용하려면 페이지 오른쪽 상단에서 상태 옆에 있는 드롭다운 목록을 클릭하고 Tableau Server 중지를 클릭합니다. ![Tableau Server 시작 옵션이 선택된 드롭다운 메뉴입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-stop-server.png) 2. Tableau Server를 실행 중인 Windows 컴퓨터에서 서비스 MMC 스냅인을 엽니다. 3. Tableau Server 서비스 관리자 서비스를 두 번 클릭하여 속성 페이지를 엽니다. 4. Tableau Server 서비스 관리자 속성 페이지에서 로그온 탭을 클릭한 후 서비스 계정의 암호를 입력합니다. 5. 적용을 클릭한 다음 확인을 클릭합니다. 6. 서비스 이름을 마우스 오른쪽 단추로 클릭하고 다시 시작을 클릭하여 Tableau Server 서비스 관리자를 다시 시작합니다. 7. Tableau Server를 시작합니다. - TSM CLI를 사용하려면 다음 명령을 실행합니다. `tsm start` - TSM 웹 UI를 사용하려면 페이지 오른쪽 상단에서 상태 옆에 있는 드롭다운 목록을 클릭하고 Tableau Server 시작을 클릭합니다. ## 관련 작업 '서비스 계정' 서비스 계정은 특히, 원격 데이터 액세스와 관련된 작업을 비롯하여 Tableau Server에서 수행되는 많은 작업의 중심입니다. 액세스 오류를 방지하려면 여기서 작업을 검토하고 시나리오에 해당하는 작업의 링크를 누르십시오. - Active Directory 도메인이 여러 개인 조직에서 Tableau Server를 실행하는 경우 [](https://help.tableau.com/current/server/ko-kr/runas_domain.htm)[Active Directory 배포를 위한 도메인 신뢰 요구 사항](https://help.tableau.com/current/server/ko-kr/runas_domain.htm)을 참조하십시오. - Kerberos Single Sign-On을 사용하려면 '서비스 계정' 서비스 계정과 관련된 추가 구성이 필요합니다. Tableau Server에서 Kerberos Single Sign-On을 사용하려면 [](https://help.tableau.com/current/server/ko-kr/kerberos.htm)[Kerberos](https://help.tableau.com/current/server/ko-kr/kerberos.htm)를 참조하십시오. - 가장을 사용하려면 '서비스 계정' 서비스 계정과 관련된 추가 구성이 필요합니다. Microsoft SQL Server에서 가장을 배포하고 사용하려면 [](https://help.tableau.com/current/server/ko-kr/impers_SQL.htm)[내장된 SQL 자격 증명으로 가장](https://help.tableau.com/current/server/ko-kr/impers_SQL.htm)을 참조하십시오. - 비시스템 드라이브에 Tableau Server를 설치한 경우 '서비스 계정' 서비스 계정에 대한 일부 사용 권한을 수동으로 설정해야 합니다. 자세한 내용은 [](https://help.tableau.com/current/server/ko-kr/runas_confirm.htm)[필수적인 '서비스 계정' 서비스 계정 설정](https://help.tableau.com/current/server/ko-kr/runas_confirm.htm)을 참조하십시오. - '서비스 계정' 서비스 계정을 변경한 경우 이전 계정에 대한 사용 권한을 취소하는 것이 좋습니다. ['서비스 계정' 서비스 계정 사용 권한 취소](https://help.tableau.com/current/server/ko-kr/runas_change.htm)를 참조하십시오. - 조직에서 정방향 프록시 솔루션을 사용하는 경우 Tableau Server의 로컬 LAN 설정을 '서비스 계정' 서비스 계정으로 재구성해야 할 수 있습니다. 자세한 내용은 [정방향 프록시 서버 구성](https://help.tableau.com/current/server/ko-kr/proxy.htm#Configur2)을 참조하십시오. 이 시나리오에서 '서비스 계정' 서비스 계정이 제품 키 작업을 위한 Tableau Server Administrative Controller의 로그온 계정으로 임시로 구성되어야 합니다. 자세한 내용은 [정방향 프록시에서 제품 키 작업 구성](https://help.tableau.com/current/server/ko-kr/activate_proxy.htm)을 참조하십시오. - 회사에서 Resource Monitoring Tool을 사용하는 경우 '서비스 계정' 서비스 계정을 사용하여 하드웨어 정보를 인증하고 수집할 수 있습니다. '서비스 계정' 계정을 업데이트할 때 RMT 환경에서 RMT와 Tableau Server 간의 연결을 확인합니다. 1. 관리자로 RMT에 로그인합니다. 2. Admin(관리) > Environments(환경)을 통해 환경 페이지로 이동합니다. 3. 업데이트된 환경에 대해 Edit(편집)을 클릭합니다. 4. Servers(서버) 목록에서 각 서버의 Agent Service(에이전트 서비스)가 Connected(연결됨)으로 표시되는지 확인합니다. Connected(연결됨) 상태 위로 마우스오버하면 마지막으로 수신된 하트비트 메시지의 타임스탬프가 표시됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # '서비스 계정' 서비스 계정 사용 권한 취소 Tableau Server 구성 유틸리티에서 '서비스 계정' 서비스 계정을 변경하면 이전 계정에서 사용 권한이 제거되지 않습니다. 따라서 '서비스 계정' 서비스 계정을 변경한 후 보안을 위해 이전 계정에서 수동으로 사용 권한을 취소하는 것이 좋습니다. 아래의 절차를 수행하여 이전 '서비스 계정' 서비스 계정에서 권한을 취소하십시오. '서비스 계정' 서비스 계정을 변경했고 조직에서 정방향 프록시 솔루션을 사용하는 경우 로컬 LAN 설정을 새 '서비스 계정' 서비스 계정으로 재구성해야 할 수 있습니다. 자세한 내용은 [정방향 프록시 서버 구성](https://help.tableau.com/current/server/ko-kr/proxy.htm#Configur2)을 참조하십시오. 다음 절차를 수행하려면 관리자 계정으로 Tableau Server 컴퓨터에 로그온해야 합니다. ## 폴더 사용 권한 제거 Tableau Server를 설치하는 위치에 따라 Tableau Server가 Windows 폴더의 사용 권한을 구성합니다. 폴더 사용 권한을 제거하기 전에 [폴더 사용 권한 확인](https://help.tableau.com/current/server/ko-kr/runas_confirm_read_ex.htm)을 검토하여 사용 권한을 제거해야 하는 리소스를 식별합니다. 식별한 각 리소스에 대해 다음 절차를 실행합니다. 1. 각 리소스(드라이브, 폴더, 실행 파일)에 대해 리소스를 마우스 오른쪽 단추로 클릭한 다음 **속성**을 클릭합니다. 2. 리소스 속성 페이지에서 **보안** 탭을 클릭한 다음 **편집**을 클릭하여 사용 권한을 변경합니다. 3. 사용 권한 페이지에서 이전 '서비스 계정' 서비스 계정을 선택한 다음 **제거**를 클릭합니다. 4. **확인**을 클릭합니다. ## 레지스트리 사용 권한 제거 다음 레지스트리 위치에서 이전 '서비스 계정' 서비스 계정을 제거합니다. - HKEY\_CURRENT\_USER\\Software\\Tableau - HKEY\_LOCAL\_MACHINE\\Software\\Tableau **경고**: Windows 레지스트리를 잘못 편집하면 컴퓨터가 손상될 수 있습니다. 1. Windows 실행에서 `regedit`를 입력하고 **확인**을 클릭하여 레지스트리 편집기를 엽니다. 2. 각 레지스트리 디렉터리에서 **Tableau** 폴더를 마우스 오른쪽 단추로 클릭한 다음 **사용 권한**을 클릭합니다. 3. **Tableau에 대한 사용 권한** 페이지에서 이전 '서비스 계정' 서비스 계정을 선택한 다음 **제거**를 클릭합니다. 4. **확인**을 클릭합니다. ## 보안 정책 제거 다음 보안 정책에서 이전 '서비스 계정' 서비스 계정을 제거합니다. - “서비스로 로그온” 정책 - “로컬 로그온 허용” 정책 1. **시작** > **제어판** > **관리 도구** > **로컬 보안 정책**을 선택합니다. 2. **로컬 보안 정책**에서 **로컬 정책**을 열고 **사용자 권한 할당**을 선택합니다. 3. 각 정책에 대해 다음을 수행합니다. 1. 정책을 마우스 오른쪽 단추로 클릭하고 **속성**을 선택합니다. 2. 정책 속성 페이지에서 이전 '서비스 계정' 서비스 계정을 선택한 다음 **제거**를 클릭합니다. 3. **확인**을 클릭합니다. [주요 콘텐츠로 건너뛰기](#main-content) # '서비스 계정' 서비스 계정으로 가장 '서비스 계정' 서비스 계정을 통한 가장은 가장을 수행할 때 권장되는 방법입니다. '서비스 계정' 서비스 계정은 Tableau Server를 호스팅하는 컴퓨터에서 Tableau Server 서비스를 실행할 수 있는 Active Directory 사용자 계정입니다(['서비스 계정' 서비스 계정](https://help.tableau.com/current/server/ko-kr/runas.htm) 항목 참조). 이 동일한 계정은 SQL Server의 데이터베이스 사용자 계정에 대한 IMPERSONATE 권한을 보유해야 합니다. 데이터 보안 관점에서 가장에 대해 Tableau Server '서비스 계정' 서비스 계정을 사용하면 관리자가 가장 완벽하게 관리할 수 있습니다. '서비스 계정 사용자' 계정을 사용하여 가장을 설정하려면 다음을 수행합니다. 1. 설치 중에 Tableau Server를 구성할 때 Active Directory를 ID 저장소로 선택하고 IMPERSONATE 권한이 있는 사용자를 '서비스 계정' 서비스 계정으로 지정합니다. 자세한 내용은 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)을 참조하십시오. Tableau Server를 설치할 때 Active Directory를 ID 저장소로 사용하도록 구성한 경우 설치 후 '서비스 계정' 서비스 계정을 설정할 수 있습니다. ['서비스 계정' 서비스 계정 변경](https://help.tableau.com/current/server/ko-kr/runas_acct.htm)를 참조하십시오. 2. Tableau Desktop에서 통합 문서를 만듭니다. 데이터 연결을 만들 때 SQL Server 데이터베이스에 대한 통합 문서의 라이브 연결에 대해 Windows NT 통합 보안 사용을 선택합니다. ![Windows NT 통합 보안을 사용하여 서버에 로그온하는 옵션이 선택된 SQL Server 연결 구성 창입니다.](/tableau/current/ko-kr/server/ko-kr/Img/impers_runas_nt.png) 3. Tableau Desktop에서 통합 문서를 Tableau Server에 게시합니다(서버 > 통합 문서 게시). 4. 게시 대화 상자에서 인증을 클릭한 다음 인증 대화 상자의 드롭다운 목록에서 서버 '서비스 계정' 계정을 통해 가장을 선택합니다. !["서버 '서비스 계정' 계정을 통해 가장" 옵션이 표시된 인증 대화 상자입니다.](/tableau/current/ko-kr/server/ko-kr/Img/impers_runas_publish.png) 5. 확인을 클릭합니다. 6. Tableau Server에 사용자로 로그인하여 연결을 테스트합니다. 뷰를 클릭할 때 데이터베이스 자격 증명을 묻는 메시지가 표시되지 않아야 하며 사용자가 볼 수 있는 데이터만 확인해야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # '서비스 계정' 서비스 계정으로 데이터 액세스 Windows 인증이 구성된 경우 '서비스 계정' 서비스 계정에 Tableau Server에서 액세스하는 데이터베이스에 대한 읽기 및 쿼리 사용 권한이 필요합니다. 설계에 따라 '서비스 계정' 서비스 계정 사용 권한은 _Creator_ 역할 또는 _Explorer(게시 가능)_ 역할이 있는 Tableau Server 사용자와 동일한 데이터베이스 액세스 권한을 갖게 됩니다. 이러한 역할이 있는 사용자는 Tableau Server에서 Windows 인증 옵션을 사용하여 데이터베이스에 연결하는 경우 '서비스 계정' 서비스 계정과 동일한 액세스 수준으로 데이터베이스를 액세스하고 볼 수 있습니다. 예를 들어 Creator 역할이 있는 사용자는 '서비스 계정' 서비스 계정에 액세스 권한이 부여된 모든 데이터베이스를 볼 수 있습니다. Creator 사용자가 웹 브라우저에서 새 데이터 원본을 만들 때 데이터베이스 호스트 이름을 지정하고 Windows 인증을 선택하는 경우 사용자는 '서비스 계정' 서비스 계정에 사용 권한이 부여된 데이터베이스를 볼 수 있게 됩니다. 데이터베이스 자산에 대한 보기 액세스 권한이 웹 브라우저를 사용하여 Tableau Server에 연결한 사용자로 제한되지 않습니다. 위에서 설명한 것과 같은 역할이 있고 데이터베이스 서버 이름을 알고 있는 전문 지식이 있는 사용자는 Tableau Desktop에서 '서비스 계정' 서비스 계정에 사용 권한이 부여된 데이터베이스를 볼 수 있는 통합 문서를 만들 수도 있습니다. 여기에서 설명하는 기능은 사용자가 Tableau Server에 인증하는 방법과 관계없이 '서비스 계정' 서비스 계정으로 액세스하는 모든 데이터 원본에 일반적으로 적용됩니다. 예를 들어 사용자가 Kerberos 또는 SAML을 사용하여 Tableau Server에 인증하는 경우에도 '서비스 계정'으로 구성된 모든 데이터 원본에 대한 액세스 권한은 동일합니다. Creator 또는 Explorer(게시 가능) 역할이 있는 사용자는 '서비스 계정' 서비스 계정에 사용 권한이 부여된 모든 데이터에 액세스할 수 있습니다. ## 권장 사항 이러한 시나리오에서 데이터베이스에 대한 사용자 액세스가 허용 가능한지 여부는 조직에서 평가해야 합니다. 일반적으로, '서비스 계정' 서비스 계정의 기능과 범위를 줄이면 사용자가 실수로 데이터베이스 콘텐츠에 액세스할 가능성이 줄어듭니다. 하지만 '서비스 계정' 서비스 계정의 기능과 범위를 줄이면 관리자와 사용자의 자격 증명 관리 부담이 커질 수 있습니다. 비즈니스 요구 사항과 데이터 액세스 정책의 관점에서 다음과 같은 권장 사항을 평가하십시오. - 맨 먼저 Creator 역할이나 Explorer(게시 가능) 역할이 있는 모든 사용자를 신뢰해야 합니다. 이러한 사용자가 Tableau에서 진실되게 작업을 수행한다고 믿어야 합니다. - '서비스 계정' 서비스 계정으로 액세스하는 데이터 원본에 대한 게시 권한이 있는 모든 사용자를 신뢰할 수 없는 경우 이러한 데이터 원본에 자격 증명을 내장하는 것이 좋습니다. - 데이터 원본에 자동화된 추출 새로 고침이 설정되어 있지 않은 경우, 즉 데이터 원본이 기본적으로 라이브 연결로 액세스되는 경우 Kerberos 위임을 사용할 수 있습니다. 요구 사항에 대해서는 [Kerberos 위임 사용](https://help.tableau.com/current/server/ko-kr/kerberos_delegation.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # 1단계(기존 설치): Tableau Prep Conductor 사용 이 항목에서는 기존 Tableau Server 설치에서 Tableau Prep Conductor를 사용하는 방법에 대해 설명합니다. Tableau Prep Conductor는 Tableau Server 버전 2019.1 이상에서만 지원됩니다. Tableau Server 2018.3 이하 버전을 사용하는 경우 Tableau Server 설치에서 Tableau Prep Conductor를 사용하도록 설정하기 전에 먼저 Tableau Server를 2019.1로 업그레이드해야 합니다. 사용자 기반 또는 코어 기반의 배포를 기준으로 Data Management를 통해 Tableau Prep Conductor에 라이선스가 부여됩니다. 배포에는 라이선스가 허가된 프로덕션 Tableau Server 설치와 프로덕션 설치를 지원하는 라이선스가 허가된 비프로덕션 Tableau Server 설치가 포함됩니다. 배포에 대한 자세한 내용은 [Tableau 배포 가이드](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_welcome.htm)를 참조하십시오. 이 항목에서는 기존 Tableau Server 설치에서 Tableau Prep Conductor를 사용하는 방법에 대해 설명합니다. ## 업그레이드 전 ### 업그레이드 준비: - [업그레이드하기 전에 알아야 할 사항](https://help.tableau.com/current/server/ko-kr/upgrade_know_before.htm) - [Tableau Prep Conductor 라이선스](https://help.tableau.com/current/prep/ko-kr/prep_conductor_licensing.htm) - [Tableau Server 하드웨어 요구 사항 및 추천 항목](https://help.tableau.com/current/server/ko-kr/server_hardware_min.htm) ### 공용 게이트웨이 설정 구성 Tableau Server가 다음 중 하나로 설정된 경우: - 부하 분산 장치가 전체 게이트웨이에 요청을 배포합니다. - 역방향 프록시가 외부 (인터넷) 클라이언트 요청을 인증하고 SSL 기반 암호화를 오프로드합니다. 다음 공용 게이트웨이 설정을 구성해야 합니다. `tsm configuration set -k gateway.public.host -v `(이는 사용자가 Tableau Server에 액세스하는 데 사용하는 URL이어야 함) `tsm configuration set -k gateway.public.port -v 443` 게이트웨이 설정 구성에 대한 자세한 내용은 [Tableau Server의 프록시 구성](https://help.tableau.com/current/server/ko-kr/proxy.htm#configure-tableau-server-to-work-with-a-reverse-proxy-server)을 참조하십시오. ## 사용자 기반 라이선스를 사용한 Tableau Server 설치 프로덕션 Tableau Server 설치에 권장되는 토폴로지는 흐름 실행을 위한 전용 노드입니다. 자세한 내용은 [Tableau Server의 최소 하드웨어 요구 사항 및 추천 항목](https://help.tableau.com/current/server/ko-kr/server_hardware_min.htm)을 참조하십시오. ### Tableau Server 단일 노드 설치 현재 단일 노드 Tableau Server 설치가 있는 경우 두 번째 노드를 추가하고 흐름 실행 전용으로 사용하는 것이 좋습니다. 1. 아래 항목의 정보를 사용하여 현재 Tableau Server 설치에서 업그레이드를 실행하십시오. - [Windows](https://help.tableau.com/current/server/ko-kr/upgrade.htm) - [Linux](https://help.tableau.com/current/server-linux/ko-kr/upgrade.htm) **활성화** 단계에서는 Tableau Server 제품 키를 사용하여 Tableau Server를 활성화합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. 2. 설치를 완료한 후 Data Management 제품 키를 추가하여 노드에서 Tableau Prep Conductor를 사용하도록 설정합니다. Data Management 제품 키는 다른 서버 키와 마찬가지로 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. - Tableau 서비스 관리자 웹 인터페이스의 **구성** 탭에서 **라이선스**를 클릭하고 **라이선스 활성화**를 클릭합니다. - 새 제품 키를 입력하거나 붙여 넣고 **활성화**를 클릭합니다. - **등록** 페이지에서 필드에 정보를 입력하고 **등록**을 클릭합니다. 3. 서버를 다시 시작하라는 메시지가 표시됩니다. 서버를 다시 시작하고 Tableau Prep Conductor가 사용하도록 설정되었고 실행되는지 확인합니다. - Tableau 서비스 관리자 웹 인터페이스에서 **상태** 탭을 클릭하여 상태를 확인합니다. Tableau Prep Conductor가 사용되도록 설정되고 실행되는 경우 프로세스 목록에 Tableau Prep Conductor가 **활성**으로 표시됩니다. Tableau Prep Conductor가 사용되도록 설정되지 않은 경우 프로세스 목록에 Tableau Prep Conductor가 포함되지만 상태 정보가 표시되지 않습니다. **Tableau Prep Conductor가 사용하도록 설정되지 않음:** ![Tableau Prep Conductor가 사용하도록 설정되지 않음으로 표시된 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_disabled_singlenode.png) **Tableau Prep Conductor가 사용하도록 설정되고 실행됨:** ![Tableau Prep Conductor가 사용하도록 설정되고 실행 중임을 표시하는 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_enabled_singlenode.png) 4. Tableau Server 설치에 두 번째 노드를 추가합니다. 설치 프로그램이 필요한 특정 프로세스(예: 클러스터 컨트롤러)를 사용하도록 설정합니다. 예약된 흐름 작업을 실행하는 데 필요한 백그라운더 프로세스를 사용하도록 설정합니다. 백그라운더 프로세스를 사용하도록 설정하면 설치 프로그램이 자동으로 노드의 단일 데이터 엔진 인스턴스와 Tableau Prep Conductor를 사용하도록 설정합니다. 이 노드에는 다른 프로세스를 추가하지 마십시오. 5. 다음 명령을 실행하여 이 노드를 흐름 작업만 수행하는 전용 노드로 설정합니다. 노드 역할에 대한 자세한 내용은 [Tableau Server의 노드 역할](https://help.tableau.com/current/server/ko-kr/server_node_roles.htm)을 참조하십시오. - 전용 노드의 nodeID를 가져와 각 노드의 서비스 목록을 확인합니다. `tsm topology list-nodes -v`. - 위에 설명된 명령을 실행하여 가져온 nodeID를 사용하여 전용 노드에 대한 노드 역할을 설정합니다. `tsm topology set-node-role -n -r flows`. - 변경 사항을 적용하고 서버를 다시 시작합니다. `tsm pending-changes apply`. - 상태를 검토하여 모든 프로세스가 올바르게 구동 및 실행되는지 그리고 올바르게 구성되었는지를 확인합니다. `tsm status -v`. Tableau Prep Conductor가 Tableau Server 설치에 추가되었습니다. ### Tableau Server 다중 노드 설치 1. 아래 항목의 정보를 사용하여 현재 Tableau Server 설치에서 업그레이드를 실행하십시오. - [Windows](https://help.tableau.com/current/server/ko-kr/upgrade.htm) - [Linux](https://help.tableau.com/current/server-linux/ko-kr/upgrade.htm) **활성화** 단계에서는 Tableau Server 제품 키를 사용하여 Tableau Server를 활성화합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. 2. 설치를 완료한 후 Data Management 제품 키를 추가하여 Tableau Prep Conductor를 사용하도록 설정합니다. 그러면 백그라운더 프로세스가 이미 사용되고 있는 노드에서 Tableau Prep Conductor가 자동으로 사용되도록 설정됩니다. Data Management 제품 키는 다른 서버 키와 마찬가지로 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. - Tableau 서비스 관리자 웹 인터페이스의 **구성** 탭에서 **라이선스**를 클릭하고 **라이선스 활성화**를 클릭합니다. - 새 제품 키를 입력하거나 붙여 넣고 **활성화**를 클릭합니다. - **등록** 페이지에서 필드에 정보를 입력하고 **등록**을 클릭합니다. 3. 서버를 다시 시작하라는 메시지가 표시됩니다. 서버를 다시 시작하고 Tableau Prep Conductor가 사용하도록 설정되었고 실행되는지 확인합니다. - Tableau 서비스 관리자 웹 인터페이스에서 **상태** 탭을 클릭하여 모든 프로세스의 상태를 확인합니다. Tableau Prep Conductor가 사용되도록 설정되고 실행되는 경우 프로세스 목록에 Tableau Prep Conductor가 **활성**으로 표시됩니다. Tableau Prep Conductor가 사용되도록 설정되지 않은 경우 프로세스 목록에 Tableau Prep Conductor가 포함되지만 상태 정보가 표시되지 않습니다. **Tableau Prep Conductor가 사용하도록 설정되지 않음:** ![Tableau Prep Conductor가 사용하도록 설정되지 않음으로 표시된 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_disabled_multinode.png) **Tableau Prep Conductor가 사용하도록 설정되고 실행됨:** ![Tableau Prep Conductor가 사용하도록 설정되고 실행 중임을 표시하는 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_enabled_multinode.png) 4. Tableau Server 설치에 새 노드를 추가합니다. 설치 프로그램이 필요한 특정 프로세스(예: 클러스터 컨트롤러)를 사용하도록 설정합니다. 예약된 흐름 작업을 실행하는 데 필요한 백그라운더 프로세스를 사용하도록 설정합니다. 백그라운더 프로세스를 사용하도록 설정하면 설치 프로그램이 자동으로 노드의 단일 데이터 엔진 인스턴스와 Tableau Prep Conductor를 사용하도록 설정합니다. 이 노드에는 다른 프로세스를 추가하지 마십시오. **참고:** 전용 노드 수는 조정 서비스 집합의 총 수를 계산하는 데 포함됩니다. 새 전용 노드를 포함하여 클러스터에 있는 총 노드 수에 따라 새 노드에 조정 서비스를 배포해야 할 수 있습니다. 자세한 내용은 [조정 서비스 집합 배포](https://help.tableau.com/current/server/ko-kr/distrib_ha_zk.htm)를 참조하십시오. 5. 다음 명령을 실행하여 이 노드를 흐름 관련 작업만 수행하는 전용 노드로 설정합니다. 노드 역할에 대한 자세한 내용은 [Tableau Server의 노드 역할](https://help.tableau.com/current/server/ko-kr/server_node_roles.htm)을 참조하십시오. - 전용 노드의 nodeID를 가져와 각 노드의 서비스 목록을 확인합니다. - `tsm topology list-nodes -v`. - 위에 설명된 명령을 실행하여 가져온 nodeID를 사용하여 전용 노드에 대한 노드 역할을 설정합니다. - `tsm topology set-node-role -n -r flows`. - 변경 사항을 적용하고 서버를 다시 시작합니다. - `tsm pending-changes apply`. - 상태를 검토하여 모든 프로세스가 올바르게 구동 및 실행되는지 그리고 올바르게 구성되었는지를 확인합니다. - `tsm status -v`. 6. 이 단계에서는 Tableau Prep Conductor가 다른 노드에서 사용되고 있을 수 있습니다. 기본적으로 노드의 백그라운더 프로세스는 흐름 작업을 포함한 모든 유형의 모든 작업을 수행합니다. Tableau Prep Conductor와 흐름 작업을 특정 노드로만 격리하려면 다음 중 하나를 수행하도록 백그라운더를 구성하면 됩니다. - 흐름 작업만 실행: `tsm topology set-node-role -n -r flows`. - 흐름을 제외한 다른 모든 작업 실행: `tsm topology set-node-role -n -r no-flows`. Tableau Prep Conductor가 Tableau Server 설치에 추가되었습니다. ## 코어 기반 라이선스를 사용한 Tableau Server 설치 프로덕션 Tableau Server 설치에 권장되는 토폴로지는 흐름 실행을 위한 전용 노드입니다. 자세한 내용은 [Tableau Server의 최소 하드웨어 요구 사항 및 추천 항목](https://help.tableau.com/current/server/ko-kr/server_hardware_min.htm)을 참조하십시오. 코어 기반 라이선스의 Data Management에는 Tableau Server용 Tableau Prep Conductor와 4개 단위로 제공되는 Tableau Prep Conductor 코어를 사용하도록 설정하는 제품 키가 포함됩니다. Tableau Prep Conductor 코어는 흐름 실행을 전담하는 노드에 적용되어야 합니다. 이러한 제품 키는 다른 서버 키와 마찬가지로 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. Tableau Prep Conductor 라이선스에 대해 자세히 알아보려면 [Tableau Server용 Tableau Prep Conductor 라이선스](https://help.tableau.com/current/prep/ko-kr/prep_conductor_licensing.htm)를 참조하십시오. ### Tableau Server 단일 노드 설치 현재 단일 노드 Tableau Server 설치가 있는 경우 두 번째 노드를 추가하고 흐름 실행 전용으로 사용하는 것이 좋습니다. 1. 아래 항목의 정보를 사용하여 현재 Tableau Server 설치에서 업그레이드를 실행하십시오. - [Windows](https://help.tableau.com/current/server/ko-kr/upgrade.htm) - [Linux](https://help.tableau.com/current/server-linux/ko-kr/upgrade.htm) 2. 제품 키를 활성화합니다. 그러면 백그라운더 프로세스가 이미 사용되고 있는 노드에서 Tableau Prep Conductor를 사용할 수 있게 됩니다. 코어 기반 라이선스를 사용하는 경우 Tableau 배포에 Data Management 제품 키와 리소스 코어 제품 키를 모두 적용해야 합니다. 첫 번째 키는 Tableau Prep Conductor를 통해 Tableau Server에서 흐름을 실행할 수 있도록 만들고 두 번째 키는 Tableau Prep Conductor 노드에 대한 여분의 코어를 추가합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. - Tableau 서비스 관리자 웹 인터페이스의 **구성** 탭에서 **라이선스**를 클릭하고 **라이선스 활성화**를 클릭합니다. - 새 제품 키를 입력하거나 붙여 넣고 **활성화**를 클릭합니다. - **등록** 페이지에서 필드에 정보를 입력하고 **등록**을 클릭합니다. 3. 서버를 다시 시작하라는 메시지가 표시됩니다. 서버를 다시 시작하고 Tableau Prep Conductor가 사용하도록 설정되었고 실행되는지 확인합니다. - Tableau 서비스 관리자 웹 인터페이스에서 **상태** 탭을 클릭하여 상태를 확인합니다. Tableau Prep Conductor가 사용되도록 설정되고 실행되는 경우 프로세스 목록에 Tableau Prep Conductor가 **활성**으로 표시됩니다. Tableau Prep Conductor가 사용되도록 설정되지 않은 경우 프로세스 목록에 Tableau Prep Conductor가 포함되지만 상태 정보가 표시되지 않습니다. **Tableau Prep Conductor가 사용하도록 설정되지 않음:** ![Tableau Prep Conductor가 사용하도록 설정되지 않음으로 표시된 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_disabled_singlenode.png) **Tableau Prep Conductor가 사용하도록 설정되고 실행됨:** ![Tableau Prep Conductor가 사용하도록 설정되고 실행 중임을 표시하는 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_enabled_singlenode.png) 4. Tableau Server 설치에 두 번째 노드를 추가합니다. 설치 프로그램이 필요한 특정 프로세스(예: 클러스터 컨트롤러)를 사용하도록 설정합니다. 예약된 흐름 작업을 실행하는 데 필요한 백그라운더 프로세스를 사용하도록 설정합니다. 백그라운더 프로세스를 사용하도록 설정하면 설치 프로그램이 자동으로 노드의 단일 데이터 엔진 인스턴스와 Tableau Prep Conductor를 사용하도록 설정합니다. 이 노드에는 다른 프로세스를 추가하지 마십시오. > [!IMPORTANT] > > **중요:** 이 컴퓨터의 물리적 코어 수는 구매한 Tableau Prep Conductor 코어 수보다 작거나 같아야 합니다. 예를 들어 Tableau Prep Conductor 코어 4개를 구매한 경우 노드의 물리적 코어 수는 최대 4개만 가능합니다. Tableau Prep Conductor 라이선스 작동 방식에 대해 알아보려면 [Tableau Server용 Tableau Prep Conductor 라이선스](https://help.tableau.com/current/prep/ko-kr/prep_conductor_licensing.htm)를 참조하십시오. 5. 다음 명령을 실행하여 이 노드를 흐름 작업만 수행하는 전용 노드로 설정합니다. 노드 역할에 대한 자세한 내용은 [Tableau Server의 노드 역할](https://help.tableau.com/current/server/ko-kr/server_node_roles.htm)을 참조하십시오. - 전용 노드의 nodeID를 가져와 각 노드의 서비스 목록을 확인합니다. `tsm topology list-nodes -v`. - 위에 설명된 명령을 실행하여 가져온 nodeID를 사용하여 전용 노드에 대한 노드 역할을 설정합니다. `tsm topology set-node-role -n -r flows`. - 변경 사항을 적용하고 서버를 다시 시작합니다. `tsm pending-changes apply`. - 상태를 검토하여 모든 프로세스가 올바르게 구동 및 실행되는지 그리고 올바르게 구성되었는지를 확인합니다. `tsm status -v`. Tableau Prep Conductor가 Tableau Server 설치에 추가되었습니다. ### Tableau Server 다중 노드 설치 1. 아래 항목의 정보를 사용하여 현재 Tableau Server 설치에서 업그레이드를 실행하십시오. - [Windows](https://help.tableau.com/current/server/ko-kr/upgrade.htm) - [Linux](https://help.tableau.com/current/server-linux/ko-kr/upgrade.htm) 2. 제품 키를 활성화합니다. 그러면 백그라운더 프로세스가 이미 사용되고 있는 노드에서 Tableau Prep Conductor를 사용할 수 있게 됩니다. 코어 기반 라이선스를 사용하는 경우 Tableau 배포에 Data Management 제품 키와 리소스 코어 제품 키를 모두 적용해야 합니다. 첫 번째 키는 Tableau Prep Conductor를 통해 Tableau Server에서 흐름을 실행할 수 있도록 만들고 두 번째 키는 Tableau Prep Conductor 노드에 대한 여분의 코어를 추가합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. - Tableau 서비스 관리자 웹 인터페이스의 **구성** 탭에서 **라이선스**를 클릭하고 **라이선스 활성화**를 클릭합니다. - 새 제품 키를 입력하거나 붙여 넣고 **활성화**를 클릭합니다. - **등록** 페이지에서 필드에 정보를 입력하고 **등록**을 클릭합니다. 3. 서버를 다시 시작하라는 메시지가 표시됩니다. 서버를 다시 시작하고 Tableau Prep Conductor가 사용하도록 설정되었고 실행되는지 확인합니다. - Tableau 서비스 관리자 웹 인터페이스에서 **상태** 탭을 클릭하여 상태를 확인합니다. Tableau Prep Conductor가 사용되도록 설정되고 실행되는 경우 프로세스 목록에 Tableau Prep Conductor가 **활성**으로 표시됩니다. Tableau Prep Conductor가 사용되도록 설정되지 않은 경우 프로세스 목록에 Tableau Prep Conductor가 포함되지만 상태 정보가 표시되지 않습니다. **Tableau Prep Conductor가 사용하도록 설정되지 않음:** ![Tableau Prep Conductor가 사용하도록 설정되지 않음으로 표시된 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_disabled_multinode.png) **Tableau Prep Conductor가 사용하도록 설정되고 실행됨:** ![Tableau Prep Conductor가 사용하도록 설정되고 실행 중임을 표시하는 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_enabled_multinode.png) 4. Tableau Server 설치에 새 노드를 추가합니다. 프로덕션 Tableau Server 설치에는 흐름 관련 작업을 실행하는 전용 노드를 사용하는 것이 좋습니다. 설치 프로그램이 필요한 특정 프로세스(예: 클러스터 컨트롤러)를 사용하도록 설정합니다. 예약된 흐름 작업을 실행하는 데 필요한 백그라운더 프로세스를 사용하도록 설정합니다. 백그라운더 프로세스를 사용하도록 설정하면 설치 프로그램이 자동으로 노드의 단일 데이터 엔진 인스턴스를 사용하도록 설정합니다. 이 노드에는 다른 프로세스를 추가하지 마십시오. **참고:** 전용 노드 수는 조정 서비스 집합의 총 수를 계산하는 데 포함됩니다. 새 전용 노드를 포함하여 클러스터에 있는 총 노드 수에 따라 새 노드에 조정 서비스를 배포해야 할 수 있습니다. 자세한 내용은 [조정 서비스 집합 배포](https://help.tableau.com/current/server/ko-kr/distrib_ha_zk.htm)를 참조하십시오. > [!IMPORTANT] > > **중요:** > 이 컴퓨터의 물리적 코어 수는 구매한 Tableau Prep Conductor 코어 수보다 작거나 같아야 합니다. 예를 들어 Tableau Prep Conductor 코어 4개를 구매한 경우 노드의 물리적 코어 수는 최대 4개만 가능합니다. Tableau Prep Conductor 라이선스 작동 방식에 대해 알아보려면 [Tableau Server용 Tableau Prep Conductor 라이선스](https://help.tableau.com/current/prep/ko-kr/prep_conductor_licensing.htm)를 참조하십시오. 5. 다음 명령을 실행하여 이 노드를 흐름 작업만 수행하는 전용 노드로 설정합니다. 그러면 새 노드에서 Tableau Prep Conductor를 사용할 수 있게 됩니다. 자세한 내용은 [Tableau Server의 노드 역할](https://help.tableau.com/current/server/ko-kr/server_node_roles.htm)을 참조하십시오. - 전용 노드의 nodeID를 가져와 각 노드의 서비스 목록을 확인합니다. `tsm topology list-nodes -v`. - 위에 설명된 명령을 실행하여 가져온 nodeID를 사용하여 전용 노드에 대한 노드 역할을 설정합니다. `tsm topology set-node-role -n nodeID -r flows`. - 변경 사항을 적용하고 서버를 다시 시작합니다. `tsm pending-changes apply`. - 상태를 검토하여 모든 프로세스가 올바르게 구동 및 실행되는지 그리고 올바르게 구성되었는지를 확인합니다. `tsm status -v`. 6. 이 단계에서는 Tableau Prep Conductor가 백그라운더 프로세스가 있는 다른 노드에서 사용되고 있을 수 있습니다. 기본적으로 노드의 백그라운더 프로세스는 흐름 작업을 포함한 모든 유형의 모든 작업을 수행합니다. Tableau Prep Conductor와 흐름 작업을 특정 노드로만 격리하려면 다음 중 하나를 수행하도록 백그라운더를 구성하면 됩니다. - 흐름 작업만 실행: `tsm topology set-node-role -n -r flows`. - 흐름을 제외한 다른 모든 작업 실행: `tsm topology set-node-role -n -r no-flows`. ## 다음 단계 [2단계: Tableau Server에 대한 흐름 설정 구성](https://help.tableau.com/current/server/ko-kr/prep_conductor_configure_server_site_settings.htm) ### 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자는 Tableau Server를 설치 또는 업그레이드하고 Tableau Server에서 Tableau Prep Conductor를 사용하도록 설정할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # 1단계(새 설치): Tableau Server와 Tableau Prep Conductor 설치 이 항목에서는 Tableau Server의 새 설치에서 Tableau Prep Conductor를 사용하는 방법에 대해 설명합니다. Tableau Prep Conductor는 Tableau Server 버전 2019.1 이상에서만 지원됩니다. Tableau Prep Conductor는 배포를 기준으로 Data Management를 통해 라이선스가 부여됩니다. 배포에는 라이선스가 허가된 프로덕션 Tableau Server 설치와 프로덕션 설치를 지원하는 라이선스가 허가된 비프로덕션 Tableau Server 설치가 포함됩니다. 배포에 대한 자세한 내용은 [Tableau 배포 가이드](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_welcome.htm)를 참조하십시오. ## 설치 전 수행할 작업 프로덕션 Tableau Server 설치에 권장되는 토폴로지는 흐름 실행을 위한 전용 노드입니다. 현재 단일 노드 Tableau Server 설치를 계획 중인 경우 두 번째 노드를 추가하고 흐름 실행 전용으로 사용하는 것이 좋습니다. - Tableau Server 및 Tableau Prep Conductor에 대한 하드웨어 권장 사항을 검토하십시오. - [Tableau Server 설치의 최소 하드웨어 요구 사항 및 권장 사항](https://help.tableau.com/current/server/ko-kr/server_hardware_min.htm)(Windows). - [Tableau Server 설치의 최소 하드웨어 요구 사항 및 권장 사항](https://help.tableau.com/current/server-linux/ko-kr/server_hardware_min.htm)(Linux). ## Tableau Server 설치 및 Tableau Prep Conductor 사용 설정 다음 항목에 제공된 지침에 따라 Tableau Server를 설치합니다. [Windows: Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/jumpstart.htm) [Linux: Tableau Server 설치 항목](https://help.tableau.com/current/server-linux/ko-kr/jumpstart.htm) **활성화** 단계에서는 Tableau Server 제품 키를 사용하여 Tableau Server를 활성화합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. ### 공용 게이트웨이 설정 구성 Tableau Server가 다음 중 하나로 설정된 경우: - 부하 분산 장치가 전체 게이트웨이에 요청을 배포합니다. - 역방향 프록시가 외부 (인터넷) 클라이언트 요청을 인증하고 SSL 기반 암호화를 오프로드합니다. 다음 공용 게이트웨이 설정을 구성해야 합니다. `tsm configuration set -k gateway.public.host -v `(이는 사용자가 Tableau Server에 액세스하는 데 사용하는 URL이어야 함) `tsm configuration set -k gateway.public.port -v 443` 게이트웨이 설정 구성에 대한 자세한 내용은 [Tableau Server의 프록시 구성](https://help.tableau.com/current/server/ko-kr/proxy.htm#configure-tableau-server-to-work-with-a-reverse-proxy-server)을 참조하십시오. ### Tableau Prep Conductor 사용 다음 단계에 따라 Data Management 제품 키를 Tableau Server에 추가합니다. 이 프로세스에서는 Tableau Server를 다시 시작해야 합니다. **참고:** 코어 기반 라이선스를 사용하는 경우 Tableau 배포에 Data Management 제품 키와 리소스 코어 제품 키를 모두 적용해야 합니다. 첫 번째 키는 Tableau Prep Conductor를 통해 Tableau Server에서 흐름을 실행할 수 있도록 만들고 두 번째 키는 Tableau Prep Conductor 노드에 대한 여분의 코어를 추가합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. 1. Tableau Server를 실행 중인 컴퓨터가 정방향 프록시를 통해 인터넷에 연결하도록 구성된 경우 계속하기 전에 [정방향 프록시에서 제품 키 작업 구성](https://help.tableau.com/current/server/ko-kr/activate_proxy.htm) 항목의 절차를 따릅니다. 2. 브라우저에서 TSM을 엽니다. `https://:8850` 3. 구성 탭에서 라이선스를 클릭하고 라이선스 활성화를 클릭합니다. 4. **Data Management 제품 키**를 입력하거나 붙여 넣고 **활성화**를 클릭합니다. 5. 등록 페이지에서 필드에 정보를 입력하고 등록을 클릭합니다. 6. 등록이 완료된 후 메시지에 따라 Tableau Server를 다시 시작합니다. ### Tableau Prep Conductor가 사용하도록 설정되고 실행되는지 확인 Data Management 제품 키를 활성화하면 백그라운더를 사용하는 모든 노드에서 Tableau Prep Conductor의 단일 인스턴스가 자동으로 사용하도록 설정됩니다. **다음 단계에 따라 이 설정이 사용되고 실행되는지 확인할 수 있습니다.** 1. 브라우저를 열고 Tableau Server URL을 입력한 다음 TSM 웹 UI 포트를 추가합니다. 다음은 URL의 표시 형식을 보여주는 몇 가지 예입니다. https://localhost:8850/(서버 컴퓨터에서 직접 작업하는 경우) https://MarketingServer:8850/(서버 이름을 알고 있는 경우) https://10.0.0.2:8850/(서버 IP 주소를 알고 있는 경우) 로그인 페이지가 나타나면 관리자 사용자 이름 및 비밀번호를 입력합니다. **참고:** Tableau Server는 설치 프로세스 중에 자체 서명 인증서를 만들고 구성합니다. 이 인증서는 TSM 웹 UI에 대한 트래픽을 암호화하는 데 사용됩니다. 자체 서명 인증서이므로 브라우저에서 기본적으로 이 인증서를 신뢰하지 않습니다. 따라서 인증서를 연결하기 전에 인증서의 신뢰성에 대한 경고가 브라우저에 표시됩니다. 2. Tableau 서비스 관리자 웹 인터페이스에서 **상태** 탭을 클릭하여 상태를 확인합니다. - Tableau Prep Conductor가 사용되도록 설정되고 실행되는 경우 프로세스 목록에 Tableau Prep Conductor가 하나 이상의 노드에서 **활성**으로 표시됩니다. Tableau Prep Conductor가 사용하도록 설정되지 않은 경우 프로세스 목록에 Tableau Prep Conductor가 포함되지만 어떤 노드에 대한 상태 정보도 표시되지 않습니다. **Tableau Prep Conductor가 사용하도록 설정되지 않음:** ![Tableau Prep Conductor가 사용되도록 설정되지 않음](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_disabled_multinode.png) **Tableau Prep Conductor가 사용하도록 설정되고 실행되고 있습니다. 아래의 이미지에서 Tableau Prep Conductor는 노드1과 노드3에서 사용됩니다.** ![Tableau Prep Conductor가 사용하도록 설정되고 실행 중임을 표시하는 Tableau 서비스 관리자 웹 인터페이스의 상태 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_TPC_enabled_multinode.png) ## Tableau Prep Conductor 전용 노드 흐름 실행 전용으로 사용할 계획인 노드에서 백그라운더 프로세스를 사용하도록 설정합니다(아직 설정하지 않은 경우). 이 노드에서는 VizQL 서버 같은 다른 프로세스를 실행하지 않는 것이 좋습니다. 이 노드는 흐름 실행을 전담하는 노드이므로 흐름 작업만 실행하도록 백그라운더를 구성해야 합니다. 기본적으로 백그라운더 프로세스는 흐름, 추출 새로 고침 및 구독을 포함한 모든 유형의 작업을 실행합니다. 자세한 내용은 [Tableau Server의 노드 역할](https://help.tableau.com/current/server/ko-kr/server_node_roles.htm)을 참조하십시오. 이 전용 노드에서 다음 tsm 명령을 실행하여 흐름 작업만 실행하도록 합니다. 1. 다음 명령을 실행하여 이 노드의 백그라운더가 흐름 작업만 실행하도록 합니다. `tsm topology set-node-role -n node1 -r flows` 2. 초기 노드에서 노드 역할을 흐름 없음으로 설정합니다. 이 노드의 백그라운더는 흐름을 제외한 모든 작업을 실행합니다. `tsm topology set-node-role -n node1 -r no-flows` 3. 변경 사항을 적용하고 Tableau Server를 다시 시작합니다. `tsm pending-changes apply` ### 다중 노드 설치 Tableau Server 설치에 3개 이상의 노드가 있는 경우 흐름 외의 모든 작업을 실행할 다른 노드를 구성할 수 있습니다. 1. 흐름을 허용하지 않도록 노드를 제한합니다. 이 명령을 실행하면 Tableau Prep Conductor가 제거되고 이 노드의 백그라운더가 흐름 작업을 실행하지 않습니다. `tsm topology set-node-role -n node1 -r no-flows` 2. 변경 사항을 적용하고 Tableau Server를 다시 시작합니다. `tsm pending-changes apply` ## 다음 단계 [2단계: Tableau Server에 대한 흐름 설정 구성](https://help.tableau.com/current/server/ko-kr/prep_conductor_configure_server_site_settings.htm) ### 이 작업을 수행할 수 있는 사용자 서버 관리자는 Tableau Server를 설치하고 Tableau Prep Conductor를 사용하도록 설정할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # 2노드 클러스터에 Tableau Server 설치 2노드 클러스터에 Tableau Server를 설치할 때 두 노드 중 하나 또는 모두에 서버 프로세스를 설치할 수 있습니다. 2노드 클러스터를 사용하면 작업이 여러 컴퓨터에 분산되기 때문에 Tableau Server 성능이 향상될 수 있습니다. 2노드 클러스터와 관련하여 다음 사항에 유의하십시오. - 2노드 클러스터는 장애 조치를 제공하거나 고가용성을 지원하지 않습니다. - 2노드 클러스터에 두 개 이상의 리포지토리 인스턴스를 설치할 수 없으며 리포지토리는 초기 노드에 있어야 합니다. 장애 조치나 고가용성이 필요한 경우 또는 리포지토리의 두 번째 인스턴스가 필요한 경우 컴퓨터 3개 이상이 있는 클러스터에 Tableau Server를 설치해야 합니다. 세 개 이상의 노드가 포함된 클러스터에서 리포지토리의 두 인스턴스를 구성하여 클러스터 장애 조치 기능을 제공할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # 2단계: Tableau Server에 대한 흐름 설정 구성 이 항목에서는 Tableau Server에 대해 구성할 수 있는 다양한 흐름 설정에 대해 설명합니다. 흐름에 대해 웹 작성을 사용하도록 설정하는 데 필요한 다양한 설정에 대한 자세한 내용은 [웹에서 흐름 만들기 및 상호 작용](https://help.tableau.com/current/server/ko-kr/web_author_flows.htm)을 참조하십시오. ## 게시, 예약 및 자격 증명 설정 데이터 관리 제품 키를 사용하여 Tableau Prep Conductor를 활성화하면 전체 Tableau Server 설치에서 Tableau Prep Conductor를 사용할 수 있게 됩니다. 사이트 설정을 추가로 수정하고 사용자 지정할 수 있습니다. 모든 사이트 또는 개별 사이트에 대한 흐름 관련 설정을 구성하려면 다음 지침을 사용합니다. Tableau Server 관리 페이지에 로그인하려면 다음 지침을 사용합니다. - Windows: [Tableau Server 관리 페이지](https://help.tableau.com/current/server/ko-kr/sign_in_server_admin.htm) - Linux: Tableau Server 관리 페이지 **사이트에 대한 흐름 게시 및 예약 허용 여부 구성:** 1. **Enable users to publish and schedule flows(사용자의 흐름 게시 및 예약 허용):** 이 설정은 Tableau Prep Conductor를 사용하도록 설정할 때 기본적으로 설정됩니다. 사이트가 여러 개인 경우 개별 사이트에 대해 선택적으로 Tableau Prep for Server 사용을 해제할 수 있습니다. 흐름을 허용하는 사이트에 대해 이 설정을 사용하지 않도록 설정하는 경우 [Tableau Prep Conductor를 사용하지 않도록 설정할 때의 결과](#Implicat)에서 자세한 내용을 참조하십시오. **설정** 아래의 **일반** 페이지에서 **Tableau Prep Conductor** 섹션으로 스크롤한 다음 **사용자가 흐름을 예약하고 모니터링할 수 있도록 허용** 확인란을 선택 취소합니다. 2. **사용자가 연결된 작업을 사용하여 흐름 실행을 함께 연결할 수 있도록 허용(버전 2021.3 이상):** 사용자가 흐름 작업을 순서대로 실행하도록 예약할 수 있습니다. 버전 2022.1부터 이 옵션은 기본적으로 사용됩니다. 이전 버전에서는 관리자가 이 기능을 먼저 사용하도록 설정해야 했습니다. 사이트가 여러 개인 경우 개별 사이트에 대해 연결된 작업을 선택적으로 해제할 수 있지만 먼저 서버 설정 수준에서 이 옵션을 사용하도록 설정해야 합니다. 연결된 작업이 예약된 후 이 설정이 해제되면 실행 중인 모든 작업이 완료되고 예약되어 있는 연결된 작업이 숨겨지며 예약된 작업 탭에 더 이상 표시되지 않습니다. 3. **자격 증명 내장** **\-게시자가 데이터 원본, 흐름 또는 통합 문서에 자격 증명을 내장하도록 허용**: 이 설정은 게시자가 게시된 흐름에 암호를 연결하는 것을 허용하여 웹 사용자를 자동으로 인증할 수 있도록 합니다. **\-게시자가 흐름 실행 및 데이터 추출 새로 고침 일정을 예약하도록 허용**: 이 옵션은 위의 설정을 사용하는 경우에만 사용할 수 있습니다. 이 설정을 사용하도록 설정하면 게시자가 게시 대화 상자에서 예약 옵션을 볼 수 있습니다. ### Tableau Prep Conductor를 사용하지 않도록 설정할 때의 결과 Tableau Prep Conductor를 한동안 사용하다가 사용하지 않도록 설정하면 흐름, 예약, 작업 및 흐름과 관련된 기타 항목을 볼 수 없게 됩니다. 다음 표에는 Tableau Prep for Server의 사용을 완전히 해제하거나 특정 사이트에 대해서만 해제하는 경우 볼 수 있는 항목과 볼 수 없는 항목에 대한 자세한 정보가 나와 있습니다.
 서버 수준에서 Prep 사용 안 함서버 수준에서 Prep을 사용하고 사이트에서는 사용 안 함서버 및 사이트에 대해 Prep 사용
흐름 표시예예예
서버 뷰에서 작업/예약 표시아니요예예
사이트 뷰에서 작업/예약 표시아니요아니요예
사이트 설정 표시(서버 관리자만 해당)예(사용 안 함)예예
TSM 상태 표시예(Tableau Prep Conductor는 표시되지 않음)예예
TSM 설정 표시예(사용 안 함)예예
> [!IMPORTANT] > > **중요**: 예약된 작업은 해당 사이트에 대해 Tableau Prep Conductor를 사용하지 않도록 설정한 경우에도 계속해서 실행되지만 결국 실패합니다. ## 흐름 실패에 대한 알림 구성 흐름 소유자에게 흐름 실행 실패에 대한 이메일 알림을 보내도록 Tableau Server를 구성할 수 있습니다. 예약된 작업, 연결된 작업을 통해 흐름을 실행하는 경우 또는 **지금 실행** 메뉴 옵션을 사용하여 수동으로 실행하는 경우 실패가 발생하면 이 알림이 전송됩니다. 먼저 서버 전체 설정을 사용하도록 설정한 다음 사이트 수준에서 구성해야 합니다. ### 서버 전체 이메일 알림을 사용하려면 아래에 설명된 것과 같이 TSM(Tableau 서비스 관리자) 웹 인터페이스 또는 TSM CLI를 사용할 수 있습니다. TSM 웹 인터페이스 사용 1. 브라우저에서 TSM을 엽니다. https://:8850. 2. 구성 탭에서 알림을 클릭한 다음 이메일 서버를 클릭합니다. 3. 이메일 서버 정보를 입력합니다. 4. **이벤트** 탭을 클릭합니다. 5. **콘텐츠 업데이트**에서 **Send emails when flow runs, encryption jobs, or scheduled refreshes fail(흐름 실행, 암호화 작업 또는 예약된 새로 고침이 실패하는 경우 이메일 보내기)**가 기본적으로 설정되지 않은 경우 이를 선택합니다. 6. 구성 정보를 입력한 후 보류 중인 변경 내용 저장을 클릭합니다. 7. 변경 내용 적용 후 다시 시작을 클릭합니다. TSM CLI 사용 tsm configuration set 명령을 사용하여 알림 값을 개별적으로 설정할 수 있습니다. Windows: [tsm configuration](https://help.tableau.com/current/server/ko-kr/cli_configuration_tsm.htm#tsm-configuration-set) Linux: [tsm configuration](https://help.tableau.com/current/server-linux/ko-kr/cli_configuration_tsm.htm#tsm-configuration-set) #### 알림 값 설정 tsm configuration set 명령을 다음 구문으로 사용합니다. 흐름 실패 알림을 사용하도록 설정하려면 다음 명령을 실행합니다. `tsm configuration set -k backgrounder.notifications_enabled -v true` **참고:** 이 명령을 실행하면 추출 새로 고침 실패와 흐름 실패에 대해 이메일 알림이 사용됩니다. 값 설정을 완료한 후 다음 명령을 실행해야 합니다. `tsm pending-changes apply` pending-changes apply 명령은 Tableau Server가 실행 중인 경우 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 메시지가 표시되지만 이 경우 다시 시작은 없습니다. --ignore-prompt 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. ### 사이트에 대한 알림을 구성하려면: **설정**의 **일반** 페이지에서 알림 관리 설정으로 스크롤하고 사이트 사용자에게 보내려는 알림 유형을 선택합니다. 이메일, Tableau 사이트 또는 Slack 작업 영역(관리자가 사이트를 Slack에 연결한 경우)을 통해 알림을 받을 수 있습니다. 자세한 내용은 [사이트 설정 참조](https://help.tableau.com/current/server/ko-kr/sites_add.htm)를 참조하십시오. ![사이트 구성 알림 센터](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_notification_center22_1.png) **참고:** 2020.4 이하에서 2021.1 이상으로 업그레이드하는 경우 알림 설정을 다시 만드십시오. 이전 알림 설정은 알림 관리 설정으로 자동 이동되지 않습니다. ## 다음 단계 [3단계: 흐름 작업에 대한 일정 만들기](https://help.tableau.com/current/server/ko-kr/prep_conductor_create_schedule_definitions.htm) ### 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자는 서버 및 사이트 수준 설정을 구성할 수 있습니다. Tableau 사이트 관리자는 사이트 수준 설정을 구성할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # 3단계: 흐름 작업에 대한 일정 만들기 ## 새 일정 만들기: 1. **일정** 탭에서 **새 일정**을 클릭합니다. ![새 일정 단추가 표시된 Tableau Server 또는 Tableau Cloud의 일정 탭입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_schedules.png) 2. **새 일정** 대화 상자에서 다음 정보를 입력하고 **만들기**를 클릭합니다. - **이름:** 일정의 설명적 이름을 입력합니다. 일반적으로 여기에는 일정 빈도의 설명이 포함됩니다. - **유형:** 작업 유형으로 흐름을 선택합니다. - **우선 순위:** 1~100의 기본 우선 순위를 정의할 수 있습니다. 여기서 1은 가장 높은 우선 순위입니다. 이 값은 기본적으로 작업에 할당됩니다. 큐에서 보류 중인 작업이 2개인 경우 우선 순위가 높은 작업이 먼저 실행됩니다. 할당된 작업 우선 순위가 없는 경우 기본값은 가장 높은 우선 순위인 0입니다. 관리자만 작업 우선 순위를 변경할 수 있습니다. 자세한 내용은 [예약된 서버 작업의 우선 순위가 결정되는 방법](https://help.tableau.com/current/server/ko-kr/task_prioritization.htm)을 참조하십시오. - **실행:** 일정을 병렬로 실행할지 순차적으로 실행할지 여부를 선택합니다. 일정을 병렬로 실행하면 사용 가능한 모든 백그라운더 프로세스에서 실행되므로 빠르게 완료될 수 있습니다. - 연결된 작업(버전 2021.3 이상): 일정을 사용하여 흐름을 순서대로 실행하도록 예약할 수 있는 경우 확인란을 선택합니다. 연결된 작업에는 병렬 실행 방법이 필요합니다. 버전 2022.1부터 이 옵션은 기본적으로 사용됩니다. 이전 버전에서는 먼저 서버 관리자가 서버에 대해 연결된 작업을 사용하도록 설정해야 사용자가 연결된 작업을 지원하도록 일정을 구성할 수 있었습니다. 자세한 내용은 [2단계: Tableau Server에 대한 흐름 설정 구성](https://help.tableau.com/current/server/ko-kr/prep_conductor_configure_server_site_settings.htm)을 참조하십시오. - **빈도:** 시간, 일, 주 또는 월 단위로 일정을 정의할 수 있습니다. ![Tableau Server의 일정 만들기 대화 상자입니다.](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_new_schedule.png) ## 다음 단계 [4단계: 입력 및 출력 위치를 허용 목록에 추가](https://help.tableau.com/current/server/ko-kr/prep_conductor_configure_network_shares.htm) ### 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자는 일정을 만들고 수정할 수 있습니다. 서버 수준에서 일정을 만들고 서버의 모든 사이트에 적용할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # 4단계: 입력 및 출력 위치를 허용 목록에 추가 이 항목에서는 이 기능에 적용되는 규칙과 네트워크의 디렉터리를 허용 목록에 추가하는 방법에 대해 설명합니다. 흐름 입력 및 출력 연결은 네트워크 디렉터리의 데이터베이스 또는 파일에 연결해야 할 수 있습니다. 그러므로 액세스를 허용할 디렉터리를 허용 목록에 추가해야 합니다. 입력 및 출력 연결은 허용 목록에 있는 위치의 데이터에만 연결할 수 있습니다. 기본적으로는 연결이 허용되지 않습니다. **참고**: 이 경우에도 흐름 파일(tflx)에 포함된 흐름 및 데이터를 Tableau Server에 게시할 수 있지만 디렉터리가 조직의 허용 목록에 포함되어 있지 않은 경우 흐름 실행이 실패합니다. ## 입력 및 출력 위치를 허용 목록에 추가 이 설정을 구성할 때는 다음 규칙이 적용되며 이러한 규칙을 고려해야 합니다. - Tableau Server에서 디렉터리 경로에 액세스할 수 있어야 합니다. 이러한 경로는 서버를 시작할 때와 흐름을 실행하는 동안 확인되며 Tableau Server에 흐름을 게시할 때는 확인되지 **않습니다**. - 흐름이 네트워크 공유 위치에 있는 .hyper 파일에서 읽거나 쓰는 경우 해당 파일이 포함된 디렉터리의 경로를 native\_api.allowed\_paths 허용 목록에 추가하십시오. 자세한 내용은 [tsm configuration set 옵션](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#nativeapiallowedpaths)을 참조하십시오. - 네트워크 디렉터리 경로는 절대 경로여야 하며 와일드카드 또는 기타 경로 이동 기호를 포함할 수 없습니다. 예를 들어 `\\myhost\myShare\*` **또는** `\\myhost\myShare*`는 잘못된 경로이므로 모든 경로가 허용되지 않습니다. _myShare_ 아래의 모든 폴더를 허용 목록에 추가하는 올바른 방법은 `\\myhost\myShare` **또는** `\\myhost\\myShare\`입니다. **참고:** `\\myhost\myShare` 구성은 `\\myhost\myShare1`을 허용하지 않습니다. 이러한 두 폴더를 허용 목록에 추가하려면 \\\\myhost\\myShare; \\\\myhost\\myShare1로 허용 목록에 추가해야 합니다. - **Windows:** - `*` 값(예: `tsm configuration set -k maestro.input.allowed_paths -v "*"`)을 사용하여 모든 네트워크 디렉터리를 허용하거나 네트워크 디렉터리 경로 목록을 세미콜론(**;**)으로 구분하여 지정할 수 있습니다. 디렉터리 경로 목록을 지정하는 경우 파일 공유의 루트가 아닌 특정 디렉터리를 지정해야 합니다. - 경로에 공백 또는 특수 문자가 포함된 경우 작은따옴표 또는 큰따옴표를 사용해야 합니다. 작은따옴표를 사용할지 큰따옴표를 사용할지는 사용하는 셸에 따라 결정됩니다. - 값이 `*`로 설정된 경우에도 로컬 디렉터리 경로는 허용되지 않습니다. - 흐름 출력을 네트워크 공유에 저장하려면 먼저 Tableau Server에서 서비스 계정 사용자 [서비스 계정을 구성](https://help.tableau.com/current/server/ko-kr/runas_acct.htm)해야 합니다. 기본 시스템 계정을 사용하면 네트워크 공유에 흐름을 저장할 수 없습니다. 그런 다음 네트워크 공유의 대상 디렉터리에 '서비스 계정' 사용자 계정에 대한 '모든 권한' 사용 권한을 구성합니다. 조직에서 중첩된 폴더 권한을 관리하는 방법에 따라 서비스 계정 사용자 계정이 대상 폴더에 액세스할 수 있도록 최소한 읽기, 쓰기, 실행, 삭제 및 폴더 나열 권한을 사용하여 폴더 계층 구조에 추가 사용 권한을 부여해야 할 수 있습니다. - **Linux:** - `*` 값(예: `tsm configuration set -k maestro.input.allowed_paths -v "*"`)을 사용하여 로컬 경로를 포함한 모든 경로(“native\_api.internal\_disallowed\_paths”를 사용하여 구성된 일부 시스템 경로 제외)를 허용하거나 경로 목록을 세미콜론(**;**)으로 구분하여 지정할 수 있습니다. - 4.7 이상의 커널 버전을 사용해야 합니다. 4.7 이전의 커널 버전에서는 네트워크 공유에 대한 허용 목록이 지원되지 않습니다. 이전 버전에서 출력을 네트워크 공유에 쓰면 hyper에서 파일이 출력되지 않아 흐름이 런타임 시 실패합니다. 이전 버전에서 네트워크 공유의 입력을 파일을 읽으면 흐름 실행이 실패합니다. 커널 버전을 확인하려면 Linux 터미널에서 `uname -r` 명령을 입력합니다. 그러면 Linux 컴퓨터에서 실행 중인 커널의 전체 버전이 표시됩니다. Red Hat Enterprise Linux의 경우 커널 버전 4.7 이상은 Red Hat Enterprise Linux 버전 8에서만 사용할 수 있습니다. - 흐름 출력을 네트워크 공유에 저장하려면 Tableau Server 리소스에 대한 액세스 권한이 있는 로컬 Linux 계정에 네트워크 공유의 대상 디렉터리에 대한 '모든 권한' 사용 권한을 부여해야 합니다. 경로가 흐름의 허용 목록과 internal\_disallowed 목록에 있는 경우 internal\_disallowed가 우선합니다. 흐름에 사용되는 입력 및 출력 경로의 마운트 지점은 `native_api.unc_mountpoints` 구성 키를 사용하여 구성되어야 합니다. 예를 들면 다음과 같습니다. `tsm configuration set -k native_api.unc_mountpoints -v 'mountpoints'` 이 구성에 대한 자세한 내용은 Tableau 기술 자료 문서 [Linux 기반 Tableau Server - Windows 공유 디렉터리에 연결하는 방법(영문)](https://kb.tableau.com/articles/howto/tableau-server-on-linux-how-to-connect-to-a-windows-shared-directory?lang=ko-kr)을 참조하십시오. 다음 명령을 사용하여 허용된 네트워크 디렉터리 경로의 목록을 만듭니다. **입력 연결의 경우:** `tsm configuration set -k maestro.input.allowed_paths -v your_networkdirectory_path_1;your_networkdirectory_path_2` `tsm pending-changes apply` **출력 연결의 경우:** `tsm configuration set -k maestro.output.allowed_paths -v your_networkdirectory_path_1;your_networkdirectory_path_2` `tsm pending-changes apply` > [!IMPORTANT] > > 중요: > 이러한 명령은 기존 정보를 덮어쓰고 사용자가 제공한 새 정보로 대체합니다. 기존 목록에 새 위치를 추가하려면 추가하려는 모든 위치(기존 위치 및 새 위치)의 목록을 제공해야 합니다. 다음 명령을 사용하여 입력 및 출력 위치의 현재 목록을 볼 수 있습니다. > > `tsm configuration get -k maestro.input.allowed_paths tsm configuration get -k maestro.output.allowed_paths` ## 다음 단계 [5단계: 선택적 서버 구성](https://help.tableau.com/current/server/ko-kr/prep_conductor_config_server_optional.htm) ### 이 작업을 수행할 수 있는 사용자 Windows에서 로컬 컴퓨터 관리자 그룹의 멤버는 _tsm_ 명령을 실행할 수 있습니다. Linux에서 **tsmadmin** 그룹의 멤버는 _tsm_ 명령을 실행할 수 있습니다. **tsmadmin** 그룹은 _tsm.authorized.groups_ 설정을 사용하여 구성할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # 5단계: 선택적 서버 구성 이 항목에 설명된 옵션은 Tableau Server에서 흐름 게시 및 흐름 예약을 사용하는 데 필요하지 않습니다. 이러한 옵션은 사용자의 요구 사항에 따라 환경을 사용자 지정하는 데 사용될 수 있습니다. ## 흐름에 대한 시간 초과 설정 정지된 작업으로 인해 후속 작업이 보류되지 않도록 흐름의 실행 시간에 대한 시간 제한을 설정할 수 있습니다. 다음 2개의 _tsm_ 명령 옵션은 흐름 백그라운드 작업이 취소되기 전까지 흐름을 실행할 수 있는 시간을 결정합니다. 이러한 두 명령은 흐름 작업의 총 시간 초과 값을 결정합니다. `backgrounder.default_timeout.run_flow`는 흐름 실행 작업이 취소되기 전까지의 시간(초)을 설정합니다. 예를 들면 다음과 같습니다. `tsm configuration set -k backgrounder.default_timeout.run_flow -v ` `tsm pending-changes apply` (기본값: 14400초 또는 4시간) `backgrounder.extra_timeout_in_seconds` 명령은 `backgrounder.querylimit`에 설정된 시간이 지난 후 백그라운드 작업을 취소하기 전까지 대기하는 시간(초)을 설정합니다. 이 설정을 사용하면 중단된 작업으로 인해 후속 작업이 방해를 받지 않게 할 수 있습니다. 이 설정은 `backgrounder.timeout_tasks`에 나열된 프로세스에 적용됩니다. 예를 들면 다음과 같습니다. `tsm configuration set -k backgrounder.extra_timeout_in_seconds -v ` (기본값: 1800초 또는 30분) 흐름을 실행 중인 서버에서 가용 리소스를 확인합니다. Tableau Prep Conductor용 전용 노드를 사용하는 것이 좋습니다. ## 일시 중단된 흐름 작업에 대한 임계값 설정 기본적으로 흐름 작업은 5회 연속 실패 후 일시 중단됩니다. 흐름 작업이 일시 중단되기 전의 흐름 작업 실패에 대한 임계값 수치를 변경하려면 다음 tsm configuration set 명령을 사용합니다. `tsm configuration set -k backgrounder.flow_failure_threshold_for_run_prevention -v ` 이 명령은 작업을 일시 중단하는 데 필요한 흐름 작업의 연속 실패 횟수에 대한 임계값을 설정합니다. 이 설정은 서버 전체 설정입니다. ### 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자는 서버 구성을 변경할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Active Directory 배포를 위한 도메인 신뢰 요구 사항 여러 도메인에 있는 Active Directory 환경(동일한 Active Directory 포레스트 또는 다른 포레스트)에서 Tableau Server를 실행하는 경우 일부 Tableau 기능이 도메인 간의 신뢰 관계에 따라 달라집니다. 예를 들어 어떤 관리자는 서버 응용 프로그램(예: Tableau Server)을 배포한 위치와 분리된 도메인에서 사용자를 관리합니다. 다른 조직에서는 Tableau Server 배포를 외부 파트너 또는 조직의 다른 파트너와 공유할 수 있습니다. 또한 Tableau Server가 연결하는 Windows 인증 데이터 원본(예: SQL Server, MSAS 또는 Oracle)이 다른 도메인에 있을 수도 있습니다. 이러한 경우에는 Tableau Server와 상호 작용하는 모든 도메인 간에 양방향 신뢰를 구성하는 것이 좋습니다. 그렇지 않은 경우에는 단일 방향 신뢰가 구성된 사용자 인증을 지원하도록 Tableau Server를 구성할 수 있습니다. 이 경우 도메인 간 단일 방향 신뢰는 Tableau Server가 설치된 도메인이 사용자 계정이 상주하는 도메인을 신뢰하도록 구성된 경우에 지원됩니다. 다음은 Tableau Server가 설치된 도메인과 사용자 계정이 상주하는 도메인 간의 단일 방향 신뢰를 보여 주는 그림입니다. ![두 개의 삼각형 중 하나는 'users.lan'이고 다른 하나는 'dev.local'로 표시되어 있으며, 삼각형을 향해 '신뢰'를 나타내는 화살표가 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/runas_oneway_trust.png) 이 시나리오에서 Tableau Server는 dev.local 도메인에 있고 users.lan Active Directory 도메인의 사용자를 Tableau Server로 가져왔습니다. 이 시나리오에는 단일 방향 신뢰가 필요합니다. 구체적으로, dev.local 도메인은 users.lan 도메인을 신뢰하도록 구성됩니다. users.lan 도메인에 있는 사용자는 정상적인 Active Directory 자격 증명을 사용하여 dev.local에 있는 Tableau Server에 액세스할 수 있습니다. 그러나 사용자가 도메인 애칭으로 로그온하려면 먼저 Tableau Server에서 해당 애칭을 업데이트해야 할 수 있습니다. 자세한 내용은 [Tableau 기술 자료](http://kb.tableau.com/articles/Issue/users-from-new-domain-unable-to-log-in-and-do-not-appear-in-user-list?lang=ko-kr)를 참조하십시오. 이 시나리오에서 Tableau Server를 구성하는 경우 설치 중에 주 사용자 도메인을 지정합니다. 자세한 내용은 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)을 참조하십시오. 또한 Tableau Server가 다른 Active Directory 도메인에 연결할 수 있게 하려면 TSM에서 `wgserver.domain.accept_list` 옵션을 설정하여 Tableau Server가 연결할 다른 도메인을 지정해야 합니다. 자세한 내용은 [wgserver.domain.accept\_list](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#wgserver-domain-acceptlist)를 참조하십시오. '서비스 계정' 서비스 계정에 사용자를 가져올 각 도메인에 대한 쿼리(읽기) 액세스 권한도 있어야 합니다. **참고:** 사용자가 있는 보조 도메인을 쿼리할 수 있는 사용 권한이 '서비스 계정' 서비스 계정에 없는 일부 시나리오에서는 모든 사용자 도메인에 대한 사용 권한이 있는 계정을 사용하여 ldap 바인딩을 구성해야 할 수도 있습니다. 이 작업을 수행할 때 단순 바인딩 대신 gssapi 바인딩을 사용하는 것이 좋습니다. 자세한 내용은 [LDAP 및 GSSAPI(Kerberos) 바인딩](https://help.tableau.com/current/server/ko-kr/plan_identity_store.htm#gssapi)을 참조하십시오. 이 단일 방향 신뢰 시나리오에서는 Kerberos SSO(Single Sign-On)가 지원됩니다. [외부 ID 저장소가 있는 배포의 사용자 관리](https://help.tableau.com/current/server/ko-kr/users_manage_ad.htm)를 검토하여 여러 도메인, 도메인 이름 지정, NetBIOS 및 Active Directory 사용자 이름 형식이 Tableau 사용자 관리에 미치는 영향을 확인하십시오. ### 단일 방향 신뢰 시나리오에서 라이브 데이터에 연결 단일 방향 신뢰 시나리오에서 Tableau Server에 연결하는 사용자는 클라우드에서 호스팅되는 라이브 데이터 또는 Windows 인증을 사용하지 않는 다른 모든 온-프레미스 데이터 원본에 연결할 수 있습니다. Windows 인증이 필요한 데이터 원본의 경우 시나리오를 복잡하게 하거나 Tableau Server 사용자가 연결할 수 없도록 하는 추가 인증 요구 사항이 있을 수 있습니다. 이는 Tableau Server에서 이러한 데이터 원본의 인증에 '서비스 계정' 서비스 계정을 사용하기 때문입니다. Windows 인증을 사용하는 데이터 원본과 다른 도메인에서 Tableau Server를 실행하는 경우 Tableau Server에 사용되는 '서비스 계정' 서비스 계정이 해당 데이터 원본에 액세스할 수 있는지 확인하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Active Directory를 통해 그룹 만들기 AD(Active Directory) 그룹을 가져와 Tableau Server에서 일치하는 그룹을 만들고 아직 서버에 존재하지 않는 AD 그룹의 각 멤버에 대해 사용자를 만들 수 있습니다. **참고**: 사용자 및 그룹 동기화와 관련하여 LDAP ID 저장소가 구성된 Tableau Server는 Active Directory와 동등합니다. Tableau Server의 Active Directory 동기화 기능은 올바르게 구성된 LDAP 디렉터리 솔루션에서 원활하게 작동합니다. 가져오기 프로세스의 일환으로 각 사용자에게 사이트 역할이 할당됩니다. 가져올 사용자가 Tableau Server에 있는 경우 가져오기 프로세스 중에 할당되는 사이트 역할은 사용자에게 서버에 대한 더 많은 액세스 권한을 부여할 때에만 적용됩니다. 사용자 가져오기는 사이트 역할 수준을 내리지 않습니다. ## 시작하기 전에 그룹을 가져오기 전에 [외부 ID 저장소가 있는 배포의 사용자 관리](https://help.tableau.com/current/server/ko-kr/users_manage_ad.htm)를 검토하여 다중 도메인, 도메인 이름 지정, NetBIOS 및 Active Directory 사용자 이름 형식이 Tableau 사용자 관리에 영향을 미치는 방식을 이해해야 합니다. ## AD의 그룹을 가져와서 추가 AD(Active Directory)의 그룹을 가져와서 Tableau Server에 사용자 그룹을 추가할 수 있습니다. 그룹을 가져올 때 먼저 그룹 이름을 입력하여 그룹을 검색합니다. 기본적으로 그룹 이름을 입력하면 Tableau Server가 AD(또는 LDAP)에 대해 와일드카드 쿼리(예: \*marketing\*)를 수행하므로 상당히 많은 검색 결과가 도출됩니다. 대규모 AD(또는 LDAP) ID 저장소에 대해 작업하는 경우 시간 초과가 발생해 가져올 그룹을 선택하지 못할 수 있습니다. 가져오기 프로세스 중에 시간을 절약하고 시간 초과 문제를 방지하려면 다음 방법 중 하나를 사용하여 그룹 이름을 검색하는 것이 좋습니다. - **정확히 일치:** 그룹 이름을 검색하는 가장 효율적인 방법입니다. 입력한 문자열 앞과 뒤에 따옴표(")를 포함하여 정확한 그룹 이름을 입력합니다. 예를 들어 **"marketing"**으로 입력합니다. - **부분 일치:** 그룹 이름의 일부를 입력하고 입력하는 문자열 앞뒤에 별표(\*)를 포함합니다. 예를 들어, **\*ket\***를 입력합니다. - **시작 문자:** 그룹 이름의 시작 부분을 입력하고 뒤에 별표(\*)를 입력합니다. 예를 들어 **market\***으로 입력합니다. - **끝 문자:** 별표(\*)를 입력한 다음 그룹 이름의 끝 부분을 입력합니다. 예를 들어 **\*ing**로 입력합니다. **참고:** 이러한 방법은 Tableau Server가 사용자를 검색하는 방법에도 적용됩니다. 1. 사이트에서 그룹을 클릭한 다음 그룹 추가를 클릭합니다. 2. 가져올 Active Directory 그룹의 이름을 입력한 다음 결과 목록에서 그룹 이름을 선택합니다. 성능을 향상하려면 위의 필터링 방법 중 하나를 사용하십시오. 서버가 실행 중인 것과 동일한 AD 도메인의 그룹을 가져오는 경우 도메인 없이 AD 그룹 이름만 입력하면 됩니다. 서버 도메인은 추정됩니다. ![Active Directory에서 그룹을 가져오기 위한 대화 상자입니다.](/tableau/current/ko-kr/server/ko-kr/Img/import_AD_group1.png) 3. 사용자의 최소 사이트 역할을 선택합니다. ![Active Directory에서 그룹을 가져오기 위한 대화 상자이며, 사이트 역할 드롭다운이 확장되고 사이트 관리자 Explorer가 선택되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/import_AD_group2.png) 4. (선택 사항) 로그인 시 역할 부여를 선택하여 그룹 사용자가 로그인할 때 새 사이트 역할 및 라이선스를 제공합니다. 자세한 내용은 [로그인 시 라이선스 부여](https://help.tableau.com/current/server/ko-kr/grant_role.htm)를 참조하십시오. 5. 가져오기 단추를 클릭합니다. **참고:** Active Directory에서 가져온 그룹 이름을 변경할 수 없습니다. 그룹 이름은 Active Directory에서만 변경할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Server의 Tableau Advanced Management 정보 **중요:** 2024년 9월 16일부터 Advanced Management는 더 이상 독립 Add-On 옵션으로 사용할 수 없습니다. Advanced Management 기능은 이전에 Advanced Management를 구매한 경우에만 사용할 수 있으며, Tableau Enterprise, Tableau Cloud+ 또는 Tableau+ Bundle(Tableau Cloud에 사용 가능) 또는 Tableau Enterprise 또는 Tableau Server+(Tableau Server에 사용 가능)와 같은 특정 라이선스 버전을 구매한 경우에만 사용할 수 있습니다. Tableau Advanced Management는 Tableau Server 기능 모음으로, 보안, 관리 용이성 및 확장성을 개선합니다. Tableau Enterprise가 있으면 Advanced Management 기능을 사용할 수 있습니다. 참고: Tableau Advanced Management에는 다양한 Tableau Server 기능과 개별적으로 설치되는 두 도구 Tableau Content Migration Tool 및 Tableau Resource Monitoring Tool가 포함되어 있습니다. 자세한 내용은 이 항목 뒷부분의 [기능 테이블](#feature_table)을 참조하십시오. ## Advanced Management 라이선스 요구 사항 Advanced Management은 Tableau Server별 배포를 기준으로 라이선스가 부여되며, 배포는 사용자 기반이거나 코어 기반일 수 있습니다. 배포에는 라이선스가 부여된 프로덕션 Tableau Server 설치와 프로덕션 설치를 지원하는 비 프로덕션의 라이선스가 부여된 Tableau Server 설치 2개가 포함됩니다. 배포에 대한 자세한 내용은 [EULA 문서 자료(영문)](https://mkt.tableau.com/files/Documentation.pdf?_ga=2.77356117.133433043.1563398594-1734029830.1510592172)를 참조하십시오. - Advanced Management는 라이선스가 허가된 Tableau Server 배포에서만 활성화할 수 있습니다. 즉, Advanced Management 제품 키를 적용하기 전에 사용자 기반 또는 코어 기반인 유효한 키로 Tableau Server를 먼저 활성화해야 합니다. Advanced Management 기능을 구입하고 제품 키를 얻는 방법에 대한 자세한 내용은 계정 관리자에게 문의하십시오. - 제품 키가 활성화되고 사용하도록 설정된 경우 Advanced Management에 포함된 모든 기능을 사용할 수 있습니다. - Advanced Management 제품 키가 제거 또는 비활성화된 경우 유효한 Advanced Management 라이선스가 필요한 기능을 더 이상 사용할 수 없게 됩니다. 관련된 데이터는 삭제되지 않습니다. 각 기능은 라이선스 만료 시 발생하는 상황에 약간의 차이가 있을 수 있습니다. 개별 기능에 대한 자세한 내용은 아래 표의 링크를 참조하십시오. 다음 표에는 포함된 기능 중 유효한 Advanced Management 라이선스가 필요한 기능이 나와 있습니다.
기능설명기능을 사용하기 위한 요구 사항버전
Tableau Resource Monitoring Tool 정보Tableau Server 상태를 종합적으로 보여 줍니다. Resource Monitoring Tool를 사용하면 느린 로드 시간, 추출 실패 및 기타 중요 문제의 원인이 되는 문제를 식별하고 최종 사용자 환경에 영향을 미치는 문제를 사전 예방적으로 해결할 수 있습니다.모니터링 중인 Tableau Server 설치에 Advanced Management 라이선스가 있어야 합니다.

2019.3 이상에서 사용할 수 있습니다.

Linux 지원은 버전 2020.4에서 도입되었습니다.

Tableau Content Migration Tool 정보Content Migration Tool는 Tableau Server 프로젝트, 사이트 및 배포 간에 콘텐츠를 복사하거나 마이그레이션할 수 있는 손쉬운 방법을 제공합니다. 개별 Tableau Server 설치의 프로젝트 간(예: Tableau Server 개발 인스턴스와 Tableau Server 프로덕션 인스턴스 간)에 또는 단일 Tableau Server 설치의 프로젝트 간에 이 작업을 수행할 수 있습니다.
  • 원본 Tableau Server(이동하려는 콘텐츠가 있는 서버)와 대상 Tableau Server(콘텐츠를 이동하려는 대상 서버) 모두 유효한 Advanced Management 라이선스가 있어야 합니다.
  • .NET 4.6.1을 지원하는 Microsoft Windows 버전(Windows 7 이상, Windows Server 2008R2 이상)에 Content Migration Tool 를 설치해야 합니다.
버전 2019.3 이상에서 사용할 수 있습니다.
작업 로그작업 로그는 향후 분석 및 감사를 위해 로컬 하드 드라이브의 vizportal logs 폴더에 로그 이벤트를 기록합니다.

Tableau Server에 유효한 Advanced Management 라이선스가 있어야 합니다.

버전 2022.3 이상에서 사용할 수 있습니다.
Tableau Server 외부 리포지토리Tableau Server 외부의 Tableau Server 리포지토리를 배포할 수 있습니다. Tableau Server 리포지토리는 모든 사용자 상호 작용, 추출 새로 고침 및 기타 항목에 대한 데이터를 저장하는 PostgreSQL 데이터베이스입니다.외부 리포지토리를 사용 중인 Tableau Server에 Advanced Management 라이선스가 있어야 합니다.

버전 2019.3 이상에서 사용할 수 있습니다.

- AWS는 Tableau Server 버전 2019.3 이상에서 지원됩니다.

- Azure는 Tableau Server 버전 2020.4 이상에서 지원됩니다.

노드 역할을 통한 워크로드 관리노드 역할을 사용하면 Tableau Server 설치에서 특정 유형의 워크로드가 처리되는 위치를 구성할 수 있습니다. 노드 역할 기능을 사용하면 리소스를 특정 워크로드(예: 추출 새로 고침, 구독) 전용으로 할당하거나 확장할 수 있습니다.Tableau Server에 유효한 Advanced Management 라이선스가 있어야 합니다.버전 2019.3 이상에서 사용할 수 있습니다.
Tableau Server 키 관리 시스템추출 암호화를 위한 KMS로 AWS를 사용하도록 Tableau Server를 구성하는 추가 기능을 제공합니다.Tableau Server에 유효한 Advanced Management 라이선스가 있어야 합니다.

버전 2019.3 이상에서 사용할 수 있습니다.

- AWS는 Tableau Server 버전 2019.3 이상에서 지원됩니다.

- Azure는 Tableau Server 버전 2021.1 이상에서 지원됩니다.

Tableau Server 외부 파일 저장소NAS(네트워크 연결 저장소)를 파일 저장소로 사용할 수 있습니다. 이 경우 파일 저장소를 Tableau Server 로컬에서 실행할 필요가 없습니다.Tableau Server에 유효한 Advanced Management 라이선스가 있어야 합니다.버전 2020.1 이상에서 사용할 수 있습니다.
Tableau 백그라운더 리소스 제한Tableau Server Resource Limits Manager는 설정된 리소스 제한과 관련하여 백그라운더 리소스 사용량을 추적함으로써 리소스 제한이 올바르게 적용되는지 확인합니다.Tableau Server에 유효한 Advanced Management 라이선스가 있어야 합니다.버전 2022.1 이상에서 사용할 수 있습니다.
Tableau Server 독립 게이트웨이Tableau Server 독립 게이트웨이를 사용하면 Tableau Server 관리형 역방향 프록시를 별도의 컴퓨터에 설치할 수 있습니다. DMZ에 독립 게이트웨이를 설치하여 Server 설치 및 모든 데이터에 대한 보안을 제공할 수 있습니다. 독립 게이트웨이는 다양한 구성으로 사용할 수 있으며 클라이언트 연결 요구 사항에 맞게 확장할 수 있습니다.Tableau Server에 유효한 Advanced Management 라이선스가 있어야 합니다.버전 2022.1 이상에서 사용할 수 있습니다.
## Advanced Management 제품 키 활성화 Advanced Management 라이선스는 Tableau Server 설치에 적용되며 사용자 기반 및 코어 기반 설치 모두에 사용할 수 있습니다. 다음은 Tableau Server 설치에서 Advanced Management를 활성화하는 방법에 대한 간략한 개요입니다. TSM 웹 인터페이스 사용 1. 브라우저에서 TSM을 엽니다. https://:8850 2. **구성** 탭에서 **라이선스**를 클릭합니다. **라이선스 활성화**를 클릭합니다. 3. Advanced Management 제품 키를 입력하거나 붙여 넣고 **활성화**를 클릭합니다. 4. **등록** 페이지에서 등록 정보를 입력하고 **등록**을 클릭합니다. 5. 등록이 완료된 후 메시지에 따라 Tableau Server를 다시 시작합니다. **참고:** 새 Tableau Server 설치인 경우 Tableau Server 제품 키를 적용하기 전에 Advanced Management 키를 적용하면 오류가 표시됩니다. 그러나 설치를 계속하고 위에 설명된 것과 동일한 단계를 사용하여 Tableau Server 제품 키를 적용할 수 있습니다. TSM CLI 사용 1. Tableau Server 클러스터의 노드에서 관리자로 명령 프롬프트를 엽니다. 2. Advanced Management 제품 키를 사용하여 다음 명령을 실행하여 라이선스를 활성화합니다. `tsm licenses activate -k ` **참고:** 새 Tableau Server 설치인 경우 이 명령을 두 번 실행해야 합니다. 먼저 Tableau Server 제품 키를 사용하여 실행한 다음 Advanced Management 제품 키를 사용하여 실행합니다. 3. 변경 사항을 적용하고 서버를 다시 시작합니다. `tsm pending-changes apply` ### 이 작업을 수행할 수 있는 사용자 서버 관리자만 Advanced Management 라이선스 키를 활성화할 수 있습니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba Cloud 기반 Tableau Server 문제 해결 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Alibaba Cloud Elastic Compute Service(ECS) 인스턴스 기반 Tableau Server에서 문제가 발생하거나 설치 후 Tableau Server에 액세스하는 데 문제가 발생하는 경우 다음 문제 해결 팁을 검토하십시오. - **RDP를 사용하여 인스턴스에 연결할 수 없음** 다음 문제가 하나 이상 있는 경우 RDP를 사용하여 인스턴스에 연결하지 못할 수 있습니다. - 올바른 자격 증명을 사용하고 있는지 확인합니다. - **다른 사용자** 옵션을 선택하고 자격 증명을 입력합니다. - 인스턴스에서 유효한 사용자 이름을 사용하고 있는지 확인합니다. 예를 들어 **myuser**라는 관리자 계정으로 인스턴스를 만든 경우 RDP 대화 상자에서 **.\\myuser**를 사용자 이름으로 입력합니다. - **원격 브라우저에서 서버에 액세스할 수 없음** 다음 문제가 하나 이상 있는 경우 원격 브라우저를 사용하여 서버에 액세스하지 못할 수 있습니다. - 인스턴스에 로그인하고 서버가 실행 중인지 확인합니다. - 인스턴스에서 브라우저를 열고 서버에 로컬로 액세스합니다(예: http://localhost 또는 http://localhost:port. 여기서 port는 서버의 수신 포트로 구성된 포트 번호임). - Alibaba Cloud Elastic Compute Service(ECS) 콘솔에서 인스턴스에 대한 HTTP 트래픽을 허용하도록 끝점을 구성했는지 확인합니다. **참고:** Windows ping 유틸리티를 사용하여 인스턴스에 대한 연결을 테스트할 수 없습니다. ping 유틸리티를 공용 인터넷에서 사용하는 경우 항상 시간 초과가 보고됩니다. - **Tableau Server 라이선스가 취소됨 오류 메시지가 표시됨** 라이선스를 비활성화하지 않고 인스턴스를 종료한 경우 이 오류가 발생할 수 있습니다. [Tableau 지원](http://www.tableau.com/ko-kr/support/request)에 문의하십시오. - **Tableau Server가 모든 CPU 코어를 사용하지 않음** Tableau Server 코어 기반 라이선스를 사용할 때 다음과 같은 증상이 하나 이상 발생할 수 있습니다. - Tableau Server 설치 시 설치 프로그램에 Tableau Server를 실행 중인 컴퓨터에서 표시되는 것보다 적은 수의 코어가 나타날 수 있습니다. - Tableau Server의 라이선스 페이지에서 사용 중인 라이선스 아래에 표시되는 코어 수가 예상보다 적게 표시됩니다. - `tsm licenses list`를 실행할 경우 Tableau Server가 보고하는 코어 수가 예상보다 적을 수 있습니다. 자세한 내용은 [Tableau Server에서 일부 코어가 인식 안 됨](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=ko-kr)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba Cloud 기반 Tableau Server 배포 옵션 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Alibaba Cloud Elastic Compute Service(ECS) 인스턴스에 Tableau Server를 배포할 수 있습니다. Alibaba Cloud 기반 Tableau Server 배포는 다음을 지원합니다.
Tableau ServerAlibaba Cloud ECS 자체 배포
프로덕션 지원성공을 나타내는 확인 표시 아이콘입니다.
인스턴스 교체 없이 Tableau 업그레이드성공을 나타내는 확인 표시 아이콘입니다.
Linux에서 설치성공을 나타내는 확인 표시 아이콘입니다.
Windows에서 설치성공을 나타내는 확인 표시 아이콘입니다.
스케일업성공을 나타내는 확인 표시 아이콘입니다.
스케일아웃(노드 추가)성공을 나타내는 확인 표시 아이콘입니다.
Active Directory 지원성공을 나타내는 확인 표시 아이콘입니다.
BYOL 라이선스성공을 나타내는 확인 표시 아이콘입니다.
자체 배포 옵션에 대한 자세한 내용이 아래에 설명되어 있습니다. - **Alibaba Cloud Elastic Compute Service(ECS) 인스턴스에 자체 배포** – 가장 유연한 배포 옵션이며 Tableau Server를 환경에 맞게 사용자 지정할 수 있습니다. Tableau Server를 ECS 인스턴스에 자체 배포하는 옵션은 간소화된 구성으로 시작해서 나중에 확장해야 하는 개발, 테스트 및 프로덕션 환경에 권장됩니다. 자체 배포에 대한 자세한 내용은 [Alibaba Cloud 기반 단일 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_alibaba_single_server.htm)를 참조하십시오. 분산 환경의 배포에 대한 자세한 내용은 [분산 환경의 Alibaba Cloud 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_alibaba_multiple_server.htm)를 참조하십시오. Tableau Server의 라이선스 옵션에 대한 자세한 내용은 [라이선스 개요](https://help.tableau.com/current/server/ko-kr/license_server_overview.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba Cloud 기반 Tableau Server 토폴로지 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Alibaba Cloud에 Tableau Server를 배포하는 경우 Tableau Desktop과 Alibaba Cloud Elastic Compute Service(ECS) 인스턴스 기반 Tableau Server 간의 통합 수준 및 정도를 선택할 수 있습니다. Tableau Desktop과 데이터 원본에서 데이터를 추출하는 Tableau Desktop 기능을 데이터와 Tableau Server를 연결하는 다리로 사용할 수 있습니다. 필요에 따라 또는 Alibaba Cloud에 이미 많은 양의 데이터가 있는 경우 Tableau Server에서 전체 범위의 Alibaba Cloud 서비스를 활용하도록 선택할 수 있습니다. 다음 다이어그램에서는 Tableau Desktop 및 Tableau Server와의 데이터 원본 통합을 보여 줍니다. ![Tableau Desktop과 클라우드 기반 가상 컴퓨터를 통해 원시 데이터에서 사용자 액세스까지의 데이터 변환 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_cloud_topology.png) 다음 다이어그램에서 모든 데이터는 Alibaba Cloud에서 호스팅됩니다. 안전하고 확장 가능한 방식으로 관리되는 구조화 데이터 및 비구조화 데이터를 모두 분석할 수 있습니다. Alibaba Cloud에만 있는 데이터, Alibaba Cloud 외부에 있는 관리되지 않는 데이터 또는 이 둘의 조합을 활용할 수 있습니다. 두 유형의 데이터가 동일하게 지원되므로, 이러한 유연성은 온프레미스 데이터에서 클라우드로의 이동을 지원하는 조직의 역량을 크게 향상시킵니다. ![Alibaba Cloud의 데이터를 사용하여 데이터 수집, 저장, 분석 및 시각화 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_alibaba_data_sources.png) [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba Cloud 기반 단일 Tableau Server 자체 배포 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Alibaba Cloud Elastic Compute Service(ECS) 인스턴스에 Tableau Server를 설치하고 실행할 수 있습니다. ECS 인스턴스에서 Tableau Server를 설치하고 구성하려면 다음 작업을 수행합니다. ## 1단계: VPC 설정 ECS 인스턴스를 시작할 VPC(Virtual Private Cloud)를 만들고 Tableau Server를 설치합니다. 또한 ECS 인스턴스 간의 통신을 용이하게 만드는 가상 스위치(VSwitch)를 만듭니다. 1. [Alibaba Cloud 콘솔](https://account.alibabacloud.com/login/login.htm)(https://account.alibabacloud.com/login/login.htm)에 로그인합니다. 2. Alibaba Cloud 대시보드의 **Networking(네트워킹)**에서 **Virtual Private Cloud(가상 사설 클라우드)**를 클릭합니다. 3. 지역 드롭다운 목록에서 리소스를 만들려는 지역을 선택합니다. 4. **VPC** 콘솔에서 **Create VPC(VPC 만들기)**를 클릭합니다. 5. **Create VPC(VPC 만들기)** 페이지에서 다음을 지정합니다. 1. **Name(이름):** VPC의 이름(최대 128자)을 입력합니다. 2. **IPv4 CIDR Block(IPv4 CIDR 블록):** 사설 IPv4 CIDR 범위를 선택합니다. **참고:** VPC를 만든 후에는 IPv4 CIDR 블록을 변경할 수 없습니다. 3. **Description(설명):** VPC에 대해 알 수 있도록 설명(최대 256자)을 입력합니다. 6. VSwitch에서 다음을 지정합니다. 1. **Name(이름):** 가상 스위치(VSwitch)의 이름(최대 128자)을 입력합니다. 2. **Zone(영역):** 가용성 영역을 선택합니다. 3. **IPv4 CIDR Block(IPv4 CIDR 블록):** 사설 IPV4 CIDR 범위를 선택합니다. 4. **Description(설명):** VSwitch에 대해 알 수 있도록 설명(최대 256자)을 입력합니다. 7. 마쳤으면 선택 내용을 검토한 다음 **OK(확인)**를 클릭합니다. ## 2단계: 보안 그룹 만들기 ECS 인스턴스와 함께 사용할 보안 그룹을 만듭니다. 보안 그룹은 인터넷에서 ECS 인스턴스로의 액세스를 허용하거나 거부하는 가상 방화벽입니다. 1. Alibaba Cloud 대시보드의 **Products & Services(제품 및 서비스)**에서 **Elastic Compute Service**를 클릭합니다. 2. **Elastic Compute Service** 페이지의 Network & Security(네트워크 및 보안)에서 **Security Groups(보안 그룹)**를 클릭합니다. 3. Security Groups(보안 그룹) 페이지에서 Create Security Group(보안 그룹 만들기)을 클릭합니다. 4. **Create Security Group(보안 그룹 만들기)** 페이지에서 다음을 지정합니다. 1. **Template(템플릿):** Web Server Windows(웹 서버 Windows)를 선택합니다. 2. **Security Group Name(보안 그룹 이름)**: 보안 그룹의 이름(최대 128자)을 입력합니다. 3. **Description(설명):** 보안 그룹에 대해 알 수 있도록 설명(최대 256자)을 입력합니다. 4. **Network Type(네트워크 유형):** VPC를 선택합니다. 5. **VPC:** 앞서 만든 VPC를 선택합니다. 6. **Tag(태그):** 키/값 쌍을 입력하여 보안 그룹에 태그를 지정하면 나중에 쉽게 검색/필터링할 수 있습니다. 5. **OK(확인)**를 클릭한 다음 Notes(참고) 대화 상자에서 Create Rules Now(지금 규칙 만들기)를 클릭합니다. 6. Ingress(수신) 탭에 나열된 각 포트에 대해 Modify(수정)를 클릭한 다음 Authorization Objects(권한 부여 개체) 필드에서 네트워크의 트래픽만 ECS 인스턴스에 연결할 수 있도록 네트워크에 해당하는 IP 주소 범위를 변경합니다. ## 3단계: ECS 인스턴스 설정 Tableau Server를 설치할 ECS 인스턴스를 만듭니다. 1. Alibaba Cloud 대시보드의 **Products & Services(제품 및 서비스)**에서 **Elastic Compute Service**를 클릭합니다. 2. **Elastic Compute Service** 페이지에서 **Instances(인스턴스)**를 클릭합니다. 3. **Instances(인스턴스)** 페이지에서 Create Instance(인스턴스 만들기)를 클릭합니다. 4. Elastic Compute Service (ECS) 페이지에서 Custom(사용자 지정)을 클릭합니다. 5. Billing Method(청구 방법)에서 Subscription(구독)을 클릭합니다. 6. Region(지역)에서 VPC를 만든 지역 및 가용성 영역을 선택합니다. 7. Instance Type(인스턴스 유형)에서 Current Generation(현재 세대)을 선택하고 X86-Architecture를 선택한 다음 인스턴스 목록에서 ecs.g5.4xlarge를 선택합니다. **참고:** 일부 인스턴스 유형은 일부 지역에서 사용하지 못할 수 있습니다. 8. Image(이미지)에서 Public Image(공개 이미지)를 선택하고 운영 체제 목록에서 Windows Server와 지원되는 버전 중 하나(예: 2012 R2 Data Center Edition 64bit English Edition)를 선택합니다. 9. Storage(저장소)의 System Disk(시스템 디스크)에서 SSD Cloud Disk(SSD 클라우드 디스크)를 선택한 다음 크기를 50GiB로 설정합니다. 10. Data Disk(데이터 디스크)에서 Add Disk(디스크 추가)를 클릭하고 SSD Cloud Disk(SSD 클라우드 디스크)를 선택한 다음 크기를 100GiB로 설정합니다. 11. Duration(기간)에서 인스턴스를 임대할 기간을 선택하고 Next: Networking(다음: 네트워킹)을 클릭합니다. 12. Network(네트워크)에서 앞서 만든 VPC 및 VSwitch를 선택합니다. 13. Security Group(보안 그룹)에서 앞서 만든 보안 그룹을 선택합니다. 14. Next: System Configurations(다음: 시스템 구성)를 클릭하고 관리자 암호 및 인스턴스 이름을 지정합니다. 15. Next: Grouping(다음: 그룹화)을 클릭하고 태그 또는 배포 집합을 지정한 후 Next: Preview(다음: 미리 보기)를 클릭합니다. 16. 선택 내용을 검토하고 Terms of Service(서비스 약관)를 검토한 후 **Create Order(주문 만들기)**를 클릭합니다. ## 4단계: ECS 인스턴스에 연결 ECS 인스턴스를 만든 후에는 인스턴스에 연결하고 Tableau Server를 설치할 준비를 해야 합니다. ECS 인스턴스에 연결하는 방법에 대한 자세한 내용은 Alibaba 웹 사이트에서 [인스턴스에 연결(영문)](https://www.alibabacloud.com/help/doc-detail/71529.htm)을 참조하십시오. 1. Alibaba Cloud 대시보드의 **Products & Services(제품 및 서비스)**에서 **Elastic Compute Service**를 클릭합니다. 2. **Elastic Compute Service** 페이지에서 **Instances(인스턴스)**를 클릭합니다. 3. 인스턴스 목록에서 인스턴스를 선택한 다음 **Connect(연결)**를 클릭합니다. 4. 메시지가 표시되면 VNC 암호를 입력합니다. 5. Microsoft Windows 로그인 이름 및 암호를 입력하고 Enter 키를 누릅니다. ## 5단계: ECS 인스턴스에 Tableau Server 설치 ECS 인스턴스에 Tableau Server를 설치하는 작업은 다른 모든 서버에 설치하는 작업과 유사합니다. 1. 다음 중 하나를 수행하여 Tableau Server 설치 프로그램을 VM에 복사합니다. - **설치 프로그램 직접 다운로드**. VM에 로그인한 상태에서 브라우저를 열고 [Tableau Server 다운로드 페이지](http://www.tableau.com/ko-kr/products/server/download)로 이동한 다음 64비트 버전의 Tableau Server를 다운로드합니다. **참고:** Windows Server에서 기본적으로 사용되는 강화된 보안 구성은 Internet Explorer의 인터넷 영역을 항상 높음으로 설정하며 이 영역에 대한 설정은 변경할 수 없습니다. 따라서 Internet Explorer를 사용하여 공개 사이트로 이동할 때에는 이러한 사이트를 신뢰할 수 있는 사이트 목록에 추가해야 합니다. - **VM에 설치 프로그램 복사**. Tableau Server 설치 프로그램의 복사본이 컴퓨터에 있는 경우 이 복사본을 VM에 복사합니다. VM에 설치 프로그램을 배치할 폴더를 만듭니다. 컴퓨터에서 Tableau Server 설치 프로그램 파일(예: TableauServer-64bit-10.5.exe)을 인스턴스에 업로드합니다. 2. VM에서 Tableau Server 설치 프로그램을 실행하여 서버 설치 프로세스를 시작합니다. 설치 프로세스는 다른 모든 서버에서와 같은 방식으로 작동합니다. 자세한 내용은 [Tableau Server 설치 및 구성](https://help.tableau.com/current/server/ko-kr/install_config_top.htm)을 참조하십시오. ## 6단계: 원격 브라우저에서 Tableau Server 액세스 Tableau Server를 설치한 Alibaba Cloud ECS 인스턴스에 사용자가 액세스할 수 있는지 확인합니다. 1. Elastic Compute Services 콘솔에서 **Instances(인스턴스)**를 클릭하고 목록에서 인스턴스를 선택한 다음 외부 IP 주소를 찾습니다. 2. 인스턴스가 아닌 다른 컴퓨터에서 브라우저를 엽니다. 3. 브라우저에서 인스턴스를 설치한 Tableau Server의 외부 IP 주소를 입력합니다. 예를 들어 `http://13.64.47.61`입니다. 4. 설치 프로세스의 끝에서 만든 관리자 사용자의 자격 증명을 사용하여 로그인합니다. 로그인하면 Tableau Server 콘텐츠 페이지가 표시됩니다. ## 7단계: ECS 인스턴스의 Tableau Server에 데이터 게시 ECS 인스턴스에 Tableau Server를 설치한 후에는 조직의 사용자가 서버에 통합 문서 및 데이터 원본을 게시할 수 있습니다. 프로세스는 사용자가 ECS 인스턴스에서 실행되는 서버에 로그인해야 한다는 점을 제외하면 Tableau Server를 온프레미스에 설치한 경우와 동일합니다. 사용자 게시를 허용하기 전에 Tableau Server에서 게시자 사이트 역할을 사용하여 각 사용자를 만들고 게시자 권한을 사용자에게 할당해야 합니다. 자세한 내용은 [Tableau Server에 사용자 추가](https://help.tableau.com/current/server/ko-kr/users_add.htm)를 참조하십시오. Tableau Server에 통합 문서 및 데이터 원본을 게시하려는 사용자는 할당된 자격 증명을 사용하여 클라우드 서버 IP 주소로 서버에 로그인해야 합니다. 자세한 내용은 [Tableau Server에 통합 문서를 게시하는 방법](https://help.tableau.com/current/pro/desktop/ko-kr/help.htm)을 참조하십시오. ## 8단계: Tableau Server 라이선스 관리 Alibaba Cloud 콘솔 또는 인스턴스 내부 자체에서 ECS 인스턴스를 종료하는 경우 Tableau Server 라이선스를 관리할 필요가 없습니다. ECS 콘솔을 사용하여 [인스턴스를 중지](https://www.alibabacloud.com/help/doc-detail/25441.htm)하는 경우 인스턴스 요금이 계속해서 발생할 수 있습니다. 인스턴스를 삭제하면 외부 저장소를 포함한 모든 리소스 할당이 취소됩니다. 인스턴스가 더 이상 필요하지 않은 경우 인스턴스를 삭제해야 할 수 있습니다. 인스턴스를 종료하고 삭제하기 전에는 항상 Tableau Server 라이선스를 비활성화하십시오. 인스턴스를 삭제하기 전에 다음을 수행하십시오. 1. 인스턴스에 로그인합니다. 2. Tableau Server의 백업을 만든 다음 인스턴스를 더 이상 사용할 수 없게 된 후 액세스할 수 있는 다른 위치(예: [Alibaba Cloud Object Storage Service](https://www.alibabacloud.com/help/doc-detail/31817.htm))에 `.tsbak` 파일을 복사합니다. 자세한 내용은 [Tableau Server의 전체 백업 및 복원 수행](https://help.tableau.com/current/server/ko-kr/backup_restore.htm)을 참조하십시오. 3. [tsm licenses deactivate](https://help.tableau.com/current/server-linux/ko-kr/cli_licenses_tsm.htm#TSMDeactivate) 명령을 사용하여 Tableau Server 제품 키를 비활성화합니다. 이제 VM을 종료하고 삭제할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba Cloud에 Tableau Server 설치 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Alibaba Cloud Elastic Compute Service(ECS) 인스턴스에 Tableau Server를 설치하면 로컬 환경에서도 Tableau Server의 고급 기능을 사용할 수 있습니다. 고가의 서버를 여러 대 구입하고 유지 관리할 필요 없이 스케일업 및 스케일아웃을 수행할 수 있는 유연성이 필요한 경우 ECS 인스턴스에서 Tableau Server를 실행하는 것이 탁월한 선택입니다. 예를 들어 Tableau Server를 고가용성으로 구성하고, 다수의 조직에서 사용되는 모든 공통 엔터프라이즈 응용 프로그램(예: Active Directory)을 통합할 수 있습니다. Linux에서 Tableau Server를 사용하려고 하십니까? [Alibaba Cloud에 Tableau Server 설치](https://help.tableau.com/current/server-linux/ko-kr/ts_alibaba_welcome.htm "새 브라우저 탭에서 항목이 열림")를 참조하십시오. 다음과 같은 Alibaba 데이터베이스에 Tableau Server에서 사용할 데이터를 저장할 수 있습니다. - [Apsara DB RDS for Microsoft SQL Server](https://www.alibabacloud.com/product/apsaradb-for-rds-sql-server): Microsoft SQL Server용 온디맨드 데이터베이스 호스팅 서비스 - [Apsara DB RDS for MySQL](https://www.alibabacloud.com/product/apsaradb-for-rds-mysql): MySQL용 온디맨드 데이터베이스 호스팅 서비스 - [Apsara DB RDS for PostgreSQL](https://www.alibabacloud.com/product/apsaradb-for-rds-postgresql): PostgreSQL용 온디맨드 데이터베이스 호스팅 서비스 다음과 같은 기본 데이터 [커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/help.htm#exampleconnections_overview.htm)를 사용하여 Alibaba Cloud의 데이터에 연결할 수 있습니다. - [Microsoft SQL Server](https://help.tableau.com/current/pro/desktop/ko-kr/examples_sqlserver.htm): Microsoft SQL Server 데이터베이스에 연결합니다. - [MySQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_mysql.htm): MySQL 데이터베이스에 연결합니다. - [PostgreSQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_postgresql.htm): PostgreSQL 데이터베이스에 연결합니다. - [기타 데이터베이스(JDBC)](https://help.tableau.com/current/pro/desktop/ko-kr/examples_otherdatabases_jdbc.htm): JDBC(Java Database Connectivity) 표준을 사용하는 데이터베이스에 연결합니다. - [기타 데이터베이스(ODBC)](https://help.tableau.com/current/pro/desktop/ko-kr/examples_otherdatabases.htm): ODBC(Open Database Connectivity) 표준을 사용하는 데이터베이스에 연결합니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba Cloud에 Tableau Server를 설치하는 모범 사례 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 클라우드에서 Tableau Server를 원활하게 설치하려면 다음과 같은 최상의 방법을 따르십시오. - Tableau Server [배포 계획](https://help.tableau.com/current/server/ko-kr/plan.htm) 섹션을 숙지합니다. - [Alibaba Cloud 기반 Tableau Server 필수 요건](https://help.tableau.com/current/server/ko-kr/ts_alibaba_prerequisites.htm)을 숙지합니다. - Tableau Server [보안 강화 검사 목록](https://help.tableau.com/current/server/ko-kr/security_harden.htm)을 숙지합니다. - 클라우드 사용 경험이 없다면 Alibaba Cloud 기반 Tableau Server를 배포하기 전에 [Alibaba Cloud 무료 평가판](https://www.alibabacloud.com/campaign/free-trial)을 사용하여 클라우드 작업 방식에 익숙해지십시오. - Alibaba Cloud의 [네트워크 토폴로지](https://www.alibabacloud.com/help/doc-detail/34217.htm)를 읽고 아키텍처가 구성된 방식을 이해하십시오. ## 비용 절감 Alibaba Cloud는 사용한 시간만큼 지불하는 클라우드 기반 서비스를 제공합니다. 비용은 실행한 서비스와 서비스 사용 기간으로 결정됩니다. 다양한 인스턴스 유형 및 크기 조합이 가능하며, 조합에 따라 비용이 달라집니다. 서비스 요금에 대한 자세한 내용은 [Alibaba Cloud 요금](https://www.alibabacloud.com/pricing)을 참조하십시오. [Alibaba Cloud 요금 계산기](https://www.alibabacloud.com/pricing-calculator#/)를 사용하여 총 월별 비용을 예측할 수 있습니다. 사용 비용을 지속적으로 모니터링하고 관리하려면 월별 Alibaba Cloud 비용이 미리 정의된 지출 한도에 도달한 경우 이메일을 보내도록 Alibaba Cloud에서 청구 알림을 설정할 수 있습니다. 1. Alibaba Cloud 콘솔에서 Billing Management(청구 관리)를 클릭합니다. 2. Account Overview(계정 개요) 페이지에서 Monthly Spending Alert(월별 지출 알림) 옆에 있는 Setting(설정)을 클릭합니다. 3. Monthly Spending Alert(월별 지출 알림) 대화 상자에서 월별 지출 알림을 켜고 지출 한도를 입력한 다음 지출이 설정한 한도에 도달한 경우 알림을 받을 이메일 수신자를 설정합니다. 4. Save(저장)를 클릭합니다. 지출을 추적하는 방법에 대한 자세한 내용은 Alibaba 웹 사이트에서 [인스턴스 지출을 보는 방법(영문)](https://www.alibabacloud.com/help/doc-detail/106929.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Alibaba ECS 인스턴스 유형 및 크기 선택 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Alibaba Cloud는 다양한 크기의 여러 인스턴스 유형을 제공합니다. 성공적인 Tableau Server 배포에 있어 작업 부하에 적합한 인스턴스를 선택하는 것이 중요한 요소입니다. 광범위한 인스턴스 중에서 선택할 수 있습니다. 사용 가능한 인스턴스 유형 및 크기의 전체 목록을 보려면 Alibaba 웹 사이트에서 [Instance type families](https://www.alibabacloud.com/help/doc-detail/25378.htm)(인스턴스 유형 패밀리)를 참조하십시오. Tableau Server를 실행할 수 있는 인스턴스를 선택해야 합니다. 인스턴스는 Tableau Server 하드웨어 지침(최소 8코어 및 128GB RAM)을 충족해야 합니다. 64비트 Tableau Server에는 최소 4코어 CPU(Alibaba Cloud Elastic Compute Service(ECS) 인스턴스에서 vCPU 8개에 해당) 및 64GB RAM이 필요합니다. 하지만 단일 프로덕션 ECS 인스턴스의 경우 총 8개 CPU 코어(ECS 인스턴스에서 vCPU 16개에 해당) 및 128GB RAM을 사용할 것을 강력하게 권장합니다. Windows 운영 체제는 이 16개 vCPU를 8개 코어로 인식하므로 라이선스에 부정적인 영향을 미치지 않습니다. ## 개발, 테스트 및 프로덕션 환경을 위한 일반적인 인스턴스 유형 및 크기 - ecs.c5.4xlarge - ecs.g5.4xlarge - ecs.r5.4xlarge **참고:** 일부 인스턴스 유형은 일부 지역에서 사용하지 못할 수 있습니다. ## 단일 프로덕션 인스턴스의 권장 사양
구성 요소/리소스Alibaba Cloud

CPU

16개 이상의 vCPU

운영 체제
 2021.3.0 ~ 2023.3.02023.3.1 ~ 2026.2.x
Windows Server 2016
Windows Server 2019(x64)
Windows Server 2022참고: 2023.3.1 이전 버전에서 Windows Server 2022는 지원되지 않습니다. 2023년 4월부터 Windows 기반의 모든 2023.3.1 이전 Tableau Server 버전에 대한 설치 프로그램은 Windows 2022에서의 설치를 차단합니다.

메모리

128GB 이상 RAM(vCPU당 4GB RAM)

저장소

2개 볼륨:

운영 체제용 30~50GiB 볼륨

Tableau Server용 100GiB 이상의 볼륨

저장소 유형

SSD 클라우드 디스크

SSD 클라우드 디스크에 대한 자세한 내용은 Alibaba 웹 사이트에서 클라우드 디스크 및 공유 블록 저장소(영문)를 참조하십시오.

디스크 지연 시간

Windows의 Avg. Transfer disk/sec 성능 카운터로 측정 시 20ms보다 작거나 같아야 합니다.

Alibaba Cloud의 디스크 지연 시간 및 해당 시간과 IOPS와의 관계에 대한 자세한 내용은 Alibaba 웹 사이트에서 저장소 매개 변수 및 성능 테스트(영문)를 참조하십시오.

[주요 콘텐츠로 건너뛰기](#main-content) # Amazon Redshift IAM OAuth 설정 Tableau 2023.3.2부터 OAuth 2.0/OIDC를 사용하여 외부 ID 공급자의 ID를 Amazon Redshift에 페더레이션할 수 있습니다. 이들 지침은 이전 AWS IAM 서비스에 적용됩니다. IAM IDC 통합에 대해서는 [Amazon Redshift IAM 아이덴티티 센터 OAuth 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_redshift_iam_idc.htm)을 참조하십시오. ID 공급자에 따라 통합을 구성하는 데 여러 단계가 필요할 수 있습니다. 다음은 개요 수준의 정보입니다. Tableau는 AWS 또는 IDP를 구성하는 방법에 대한 자세한 지침을 제공할 수 없지만 일반적인 접근 방식은 아래에 설명되어 있습니다. ## 1단계: IDP 구성 1. Tableau Desktop용 IDP 및 Tableau Server 또는 Tableau Cloud에서 OAuth 클라이언트를 만듭니다. Desktop 클라이언트에는 `PKCE` 활성화가 필요하고 `http://localhost` 리디렉션을 사용해야 합니다. 2. 권한 부여에 사용할 사용자 지정 클레임을 역할에 추가합니다. 특히 원본 IAM을 사용하는 경우 `DbUser` 및 `DbGroups`에 대한 클레임을 추가하려 할 수 있습니다. 이들은 나중에 IAM 정책에서 사용될 수 있습니다. 3. Tableau OAuth 구성 파일을 만듭니다. [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "GitHub의 OAuth 설명서")의 설명서와 [여기](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "GitHub의 OAuth 예시")에서 예시를 참조하십시오. 다른 IDP의 사례도 유용합니다. 1. Tableau OAuth 구성 ID 앞에 '`custom_`'을 붙여야 합니다. **참고:** Oauth 구성 ID는 최대 36자로 제한합니다. 이보다 긴 ID를 사용하면 오류가 발생하지는 않지만 작동하지도 않습니다. 2. IDP가 동적 localhost 포트를 지원하는 경우 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`을 사용하지 않도록 설정합니다. IDP가 지원하지 않는 경우 구성 파일과 IDP의 허용 목록에 여러 localhost 콜백 URL을 추가해야 합니다. 4. 데스크톱 호스트의 각 응용 프로그램과 연결된 `OAuthConfigs` 폴더(Tableau Desktop, Tableau Prep Builder, Tableau Bridge)와 OAuth를 사용할 각 Tableau Server 및 Tableau Cloud 사이트에 새 Tableau OAuth 구성 파일을 설치합니다. ## AWS에서 IDP 구성 1\. AWS에서 IDP 모델을 만듭니다. Amazon 설명서 [웹 아이덴티티 페더레이션](https://docs.aws.amazon.com/ko_kr/IAM/latest/UserGuide/id_roles_providers_oidc.html "웹 아이덴티티 페더레이션에 대한 AWS 설명서") 및 [OIDC ID 공급자 생성](https://docs.aws.amazon.com/ko_kr/IAM/latest/UserGuide/id_roles_providers_create_oidc.html "OIDC ID 공급자 생성에 대한 AWS 설명서")을 참조하십시오. 2\. 특히 IDP를 위해 역할과 정책을 만듭니다. AWS 설명서에서 [OIDC를 위한 역할 생성](https://docs.aws.amazon.com/ko_kr/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html "OIDC용 역할 생성에 대한 AWS 설명서")을 참조하십시오. ## Redshift 사용자의 역할 구성 Redshift에 필요한 정책을 연결할 수 있습니다. 토큰의 사용자 지정 클레임을 사용하여 역할에 권한을 부여할 수도 있습니다. [AWS 설명서](https://docs.aws.amazon.com/redshift/latest/mgmt/options-for-providing-iam-credentials.html "IAM 자격 증명 제공에 대한 AWS 설명서")에 SAML을 사용한 몇 가지 예가 있습니다. 이들 예는 OAuth에 쉽게 적용할 수 있습니다. OAuth의 경우 클레임은 단순히 '`DbUser`', '`DbGroups`' 등입니다. 다음은 AWS 설명서에 있는 정책의 예입니다. { "Version": "2012-10-17", "Statement": \[ { "Effect": "Allow", "Action": "redshift:GetClusterCredentials", "Resource": \[ "arn:aws:redshift:us-west-1:123456789012:dbname:cluster-identifier/dev", "arn:aws:redshift:us-west-1:123456789012:dbuser:cluster-identifier/${redshift:DbUser}", "arn:aws:redshift:us-west-1:123456789012:cluster:cluster-identifier" \], "Condition": { "StringEquals": { "aws:userid": "AROAJ2UCCR6DPCEXAMPLE:${redshift:DbUser}@example.com" } } }, { "Effect": "Allow" "Action": "redshift:CreateClusterUser", "Resource": "arn:aws:redshift:us-west-1:12345:dbuser:cluster-identifier/${redshift:DbUser}" }, { "Effect": "Allow", "Action": "redshift:JoinGroup", "Resource": "arn:aws:redshift:us-west-1:12345:dbgroup:cluster-identifier/my\_dbgroup" }, { "Effect": "Allow", "Action": \[ "redshift:DescribeClusters", "iam:ListRoles" \], "Resource": "\*" } \] } ## Redshift에 연결 사용자는 맡을 역할 ARN을 지정한 다음 이전에 설치된 OAuth 구성을 선택해야 합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/redshift_oauth__iam_connect.png) 올바로 구성되면 사용자는 Tableau에 대해 토큰을 인증하고 권한을 부여할 수 있도록 IDP로 리디렉션됩니다. Tableau에 openid 및 새로 고침 토큰이 수신됩니다. AWS는 IDP에서 토큰과 서명을 검증하고, 토큰에서 클레임을 추출하고, 클레임과 IAM 역할의 매핑을 조회하고, Tableau가 사용자를 대신하여 역할을 맡는 것을 허용하거나 차단할 수 있습니다. 이를 [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html "AssumeRoleWithWebIdentity에 대한 AWS 설명서")라고 합니다. ## 토큰 기본적으로 Redshift OAuth IAM은 ID 토큰을 드라이버에 전달합니다. Tableau Bridge를 사용하는 고객을 포함하여 온프레미스 고객의 경우 대신 TDC 파일을 사용하여 액세스 토큰을 전달할 수 있습니다. .tdc 파일 구성 및 설치에 대한 자세한 내용은 [연결 사용자 지정 및 조정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_customize.htm) 및 [Tableau Server에서 .tdc 파일 사용](https://help.salesforce.com/s/articleView?id=001458291&type=1)을 참조하십시오. ## 그룹 페더레이션 정보 IAM 역할과 함께 OAuth 인증을 사용하는 경우 그룹 페더레이션을 사용할지 여부를 선택할 수 있습니다. 이렇게 하면 커넥터가 Redshift와 연동하기 위해 인증 API와 상호 작용하는 방식이 변경됩니다. - 연결 중에 그룹 페더레이션 확인란(버전 2025.1 이상에서 사용 가능)을 선택하면 Redshift 드라이버는 프로비저닝된 클러스터에서 자격 증명을 얻기 위해 [`getClusterCredentialsWithIAM`](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentialsWithIAM.html) API를 사용합니다. - 그룹 페더레이션 확인란을 선택하지 않은 경우 [`getClusterCredentials`](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentials.html) API가 대신 사용됩니다. 이 두 API는 약간 다른 속성을 가진 IAM 토큰을 반환합니다. 자세한 내용은 위 링크의 AWS API 설명서와 [ODBC 드라이버 옵션(영문)](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-configuration-options.html "AWS에 ODBC 2.0을 구성하는 방법에 대한 정보")을 참조하십시오. #### 사용 시 참고 사항 - Tableau Desktop 및 Tableau Prep Builder 2024.3 이전 버전의 경우 'group\_federation=1'을 사용하여 고급 드라이버 구성 필드에서 이를 설정할 수 있습니다. 또한 사용자 지정 연결 속성을 정의하는 데 TDC 파일을 사용하여 구성할 수도 있습니다. TDC 사용에 대한 자세한 내용은 [연결 사용자 지정 및 조정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_customize.htm)을 참조하십시오. - 2024.3 버전부터 온프레미스(Tableau Desktop, Tableau Prep Builder 및 Tableau Server)의 연결 대화 상자에 group\_federation 필드가 있습니다. 이는 2025.1부터 Tableau Cloud에서 사용할 수 있습니다(2025년 2월부터 사용 가능). - Tableau Server에서 그룹 페더레이션을 사용하려면 ODBC extras 허용 목록에 group\_federation을 추가해야 합니다. 자세한 내용은 [지정 커넥터에 대한 연결 문자열 사용자 지정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_string_custom.htm)을 참조하십시오. ## Okta Okta를 사용하는 경우 '조직 권한 부여 서버'보다는 '사용자 지정 권한 부여 서버'를 사용하는 것이 더 좋습니다. 사용자 지정 권한 부여 서버가 더 유연합니다. 기본적으로 생성된 'default'라는 사용자 지정 권한 부여 서버가 있습니다. 권한 부여 URL은 다음과 같이 표시됩니다. https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize ![](/tableau/current/ko-kr/server/ko-kr/Img/redshift_oauth_iam_okta_800x332.png) ## 드라이버 업데이트 기존 IAM 서비스를 사용하는 Redshift OAuth의 경우 다음 중 하나를 사용할 수 있습니다. - 버전 1.59 이상의 Redshift ODBC v1 드라이버([https://docs.aws.amazon.com/redshift/latest/mgmt/configure-odbc-connection.html](https://docs.aws.amazon.com/redshift/latest/mgmt/configure-odbc-connection.html "Amazon에서 Redshift ODBC V1 드라이버 다운로드")에서 다운로드 가능) - 버전 2.0.1.0 이상의 Redshift ODBC v2 드라이버([https://github.com/aws/amazon-redshift-odbc-driver/tags](https://github.com/aws/amazon-redshift-odbc-driver/tags "Amazon에서 Redshift ODBC V2 드라이버 다운로드")에서 다운로드 가능). 참고로, OSX용 v2 드라이버는 없습니다. ## 문제 해결 오류를 진단하는 가장 좋은 방법은 Tableau를 제거하는 것입니다. 대신 드라이버 관리자 또는 유사한 도구를 사용하여 테스트할 수 있습니다. 이 테스트는 문제 해결을 위한 것이므로 이 기능을 일상적으로 사용할 때는 DSN 또는 '기타 ODBC' 커넥터를 사용해서는 안 됩니다. 유효한 테스트를 보장하기 위해, 클러스터 정보, 데이터베이스, 토큰 및 네임스페이스를 제외한 매개 변수는 아래와 같아야 합니다. **참고:** 테스트 시 DSN의 연결 문자열에 DbUser 또는 DbGroups를 지정하지 마십시오. Tableau는 이러한 항목에 액세스할 수 없으며 이들을 연결 문자열에 포함할 수 없습니다. 이들을 토큰 클레임에는 포함할 수 있습니다. 첫 번째 연결 시 드라이버에서 유효하지 않거나 만료된 토큰에 대한 오류 메시지가 표시되면(오류 메시지에 \[28000\] 또는 \[08001\]과 같은 SQLState 오류 코드가 표시됨) Tableau에서 OAuth 흐름이 성공적으로 완료되었고 드라이버에서 실패한 것입니다. 이는 AWS 측이나 IDP 측의 구성이 잘못되었음을 의미합니다. 또한 드라이버에서 반환되는 사용 권한 또는 권한 부여 오류가 있을 수도 있으며, 이는 또한 Tableau에서 제어할 수 없는 부분입니다. 테스트를 시작하기 전에, 먼저 드라이버에 보낼 액세스 토큰(IAM IDC의 기본값) 또는 새로 고침 토큰(사용자 지정한 경우)을 가져와야 합니다. Okta를 예로 들면 다음과 같습니다. 이를 수행하는 방법은 거의 모든 IDP에서 매우 유사합니다. 이 방식을 사용하려면 리소스 소유자 비밀번호 부여 유형을 사용하도록 설정해야 합니다. IDP URL, 클라이언트 암호, 클라이언트 ID, 사용자 이름 및 비밀번호를 입력하십시오. curl -X POST "https://OKTA\_URL/v1/token" \\ \-H 'accept: application/json' \\ \-H "Authorization: Basic $(echo -n 'CLIENTID:CLIENTSECRET' | base64)" \\ \-H "Content-Type: application/x-www-form-urlencoded" \\ \-d "grant\_type=password&username=USER&password=PASSWORD&scope=openid" 토큰이 있으면 DSN을 사용하여 테스트할 수 있습니다. Windows에서는 ODBC 드라이버 관리자를 사용할 수 있습니다. Mac에서는 iODBC 드라이버 관리자 UI를 사용할 수 있습니다. Linux에서는 Tableau Server의 customer-bin 폴더에 포함된 isql 명령줄 도구를 사용할 수 있습니다. 고정된 AWS 프로필을 사용하는 플러그인은 해당 연결의 모든 사용자에 대해 동일한 프로필을 사용해야 작동합니다. 다른 OAuth 플러그인은 시스템 브라우저에 직접 액세스해야 하지만, 이는 서버 측에서 작동하지 않습니다. 다음은 Windows에서 ODBC 드라이버 관리자를 사용하는 예입니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/redshift_oauth_iam_troubleshoot.jpg) [주요 콘텐츠로 건너뛰기](#main-content) # Amazon Redshift IAM 아이덴티티 센터 OAuth 설정 Tableau 2023.3.2부터 OAuth 2.0/OIDC를 사용하여 외부 ID 공급자의 ID를 Amazon Redshift에 페더레이션할 수 있습니다. 이 지침은 최신 AWS IAM IDC 서비스에 적용됩니다. 기존 IAM 통합에 대해서는 [Amazon Redshift IAM OAuth 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_redshift_iam.htm)을 참조하십시오. ID 공급자에 따라 통합을 구성하는 데 여러 단계가 필요할 수 있습니다. 다음은 개요 수준의 정보입니다. Tableau는 AWS 또는 IDP를 구성하는 방법에 대한 자세한 지침을 제공할 수 없지만 일반적인 접근 방식은 다음과 같습니다. Redshift에 인증을 구현하는 자세한 예는 '[AWS IAM 아이덴티티 센터를 사용하여 Tableau 및 Okta를 Amazon Redshift와 통합(영문)](https://aws.amazon.com/blogs/big-data/integrate-tableau-and-okta-with-amazon-redshift-using-aws-iam-identity-center/)' 및 '[AWS IAM 아이덴티티 센터를 사용하여 Tableau와 Microsoft Entra ID를 Amazon Redshift와 통합](https://aws.amazon.com/blogs/big-data/integrate-tableau-and-microsoft-entra-id-with-amazon-redshift-using-aws-iam-identity-center/)'을 참조하십시오. ## 1단계: IDP 구성 1. Tableau Desktop용 IDP 및 Tableau Server 또는 Tableau Cloud에서 OAuth 클라이언트를 만듭니다. Desktop 클라이언트에는 `PKCE` 활성화가 필요하고 `http://localhost` 리디렉션을 사용해야 합니다. 2. 권한 부여에 사용할 필수 사용자 지정 클레임을 역할에 추가합니다. 3. Tableau OAuth 구성 파일을 만듭니다. [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "Tableau OAuth 구성 파일 생성에 대한 GitHub 설명서")의 설명서와 [예시](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "Tableau OAuth 구성 파일 생성에 대한 GitHub의 예")를 참조하십시오. 다른 IDP의 사례도 유용합니다. 1. Tableau OAuth 구성 ID 앞에 '`custom_`'을 붙여야 합니다. **참고:** Oauth 구성 ID는 최대 36자로 제한합니다. 이보다 긴 ID를 사용하면 오류가 발생하지는 않지만 작동하지도 않습니다. 2. IDP가 동적 localhost 포트를 지원하는 경우 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`을 사용하지 않도록 설정합니다. 지원하지 않는 경우 구성 파일과 IDP의 허용 목록에 여러 localhost 콜백 URL을 추가해야 합니다. 4. 데스크톱 호스트의 각 응용 프로그램과 연결된 `OAuthConfigs` 폴더(Tableau Desktop, Tableau Prep Builder, Tableau Bridge)와 OAuth를 사용할 각 Tableau Server 및 Tableau Cloud 사이트에 새 Tableau OAuth 구성 파일을 설치합니다. ## 2단계: AWS에서 IDP 및 역할 구성 이에 대한 자세한 내용은 AWS 설명서를 참조하십시오. ## 3단계: Redshift에 연결 1. Redshift에 연결합니다. 2. Authentication(인증)으로 OAuth를 선택합니다. 3. Federation Type(페더레이션 유형)으로 Identity Center(아이덴티티 센터)를 선택합니다. 4. (선택 사항) 필요한 경우 Identity Center Namespace(아이덴티티 센터 네임스페이스)를 지정합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/redshift_oauth_idc_connect.png "Redshift 연결 대화 상자") 올바로 구성되면 Tableau에 대해 토큰을 인증하고 권한을 부여할 수 있도록 IDP로 리디렉션됩니다. Tableau에 액세스 토큰 및 새로 고침 토큰이 수신됩니다. 인증을 위해 드라이버에 액세스 토큰을 보냅니다. ## 토큰 기본적으로 IAM IDC에 대한 Redshift OAuth는 액세스 토큰을 드라이버에 전달합니다. Tableau Bridge를 사용하는 고객을 포함하여 온프레미스 고객의 경우 대신 TDC 파일을 사용하여 ID 토큰을 전달할 수 있습니다. .tdc 파일 구성 및 설치에 대한 자세한 내용은 [연결 사용자 지정 및 조정](https://help.tableau.com/current/pro/desktop/ko-kr/connect_customize.htm) 및 [Tableau Server에서 .tdc 파일 사용](https://help.salesforce.com/s/articleView?id=001458291&type=1)을 참조하십시오. ## Okta Okta를 사용하는 경우 '조직 권한 부여 서버'를 사용하는 대신에 '사용자 지정 권한 부여 서버'를 사용하는 것이 더 좋습니다. 사용자 지정 권한 부여 서버가 더 유연합니다. 사용자 지정 권한 부여 서버는 기본적으로 생성되며 '기본값'이라고 합니다. 권한 부여 URL은 다음과 같이 표시됩니다. https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize ![](/tableau/current/ko-kr/server/ko-kr/Img/redshift_oauth_idc_okta_800x332.png) ## 드라이버 업데이트 IAM IDC 서비스를 사용하는 Redshift OAuth의 경우, 최소 2.x 버전의 ODBC 드라이버를 사용해야 합니다. [https://github.com/aws/amazon-redshift-odbc-driver/tags](https://github.com/aws/amazon-redshift-odbc-driver/tags "Redshift ODBC 버전 2용 드라이버 다운로드")에서 Redshift ODBC 드라이버의 최신 버전을 다운로드하십시오. 참고로, OSX용 v2 드라이버는 아직 없습니다. ## Redshift IAM IDC OAuth 문제 해결 오류를 진단하는 가장 좋은 방법은 Tableau를 제거하는 것입니다. 대신 드라이버 관리자 또는 유사한 도구를 사용하여 테스트할 수 있습니다. 이 테스트는 문제 해결을 위한 것이므로 이 기능을 일상적으로 사용할 때는 DSN 또는 '기타 ODBC' 커넥터를 사용해서는 안 됩니다. 유효한 테스트를 보장하기 위해, 클러스터 정보, 데이터베이스, 토큰 및 네임스페이스를 제외한 매개 변수는 아래와 같아야 합니다. 첫 번째 연결 시 드라이버에서 유효하지 않거나 만료된 토큰에 대한 오류 메시지가 표시되면(오류 메시지에 \[28000\] 또는 \[08001\]과 같은 SQLState 오류 코드가 표시됨) Tableau에서 OAuth 흐름이 성공적으로 완료되었고 드라이버에서 실패한 것입니다. 이는 AWS 측이나 IDP 측의 구성이 잘못되었음을 의미합니다. 또한 드라이버에서 반환되는 사용 권한 또는 권한 부여 오류가 있을 수도 있으며, 이는 또한 Tableau에서 제어할 수 없는 부분입니다. 테스트를 시작하기 전에, 먼저 드라이버에 보낼 액세스 토큰(IAM IDC의 기본값) 또는 새로 고침 토큰(사용자 지정한 경우)을 가져와야 합니다. Okta를 예로 들면 다음과 같습니다. 이를 수행하는 방법은 거의 모든 IDP에서 매우 유사합니다. 이 방식을 사용하려면 리소스 소유자 비밀번호 부여 유형을 사용하도록 설정해야 합니다. IDP URL, 클라이언트 암호, 클라이언트 ID, 사용자 이름 및 비밀번호를 입력하십시오. curl -X POST "https://OKTA\_URL/v1/token" \\ \-H 'accept: application/json' \\ \-H "Authorization: Basic $(echo -n 'CLIENTID:CLIENTSECRET' | base64)" \\ \-H "Content-Type: application/x-www-form-urlencoded" \\ \-d "grant\_type=password&username=USER&password=PASSWORD&scope=openid" 토큰이 있으면 DSN을 사용하여 테스트할 수 있습니다. Windows에서는 ODBC 드라이버 관리자를 사용할 수 있습니다. Linux에서는 Tableau Server의 customer-bin 폴더에 포함된 isql 명령줄 도구를 사용할 수 있습니다. 다른 플러그인은 서버 환경에서 작동하지 않을 수 있으므로 테스트에 사용하지 않는 것이 좋습니다. 고정된 AWS 프로필을 사용하거나 브라우저에 직접 액세스해야 합니다. 다음은 Windows에서 ODBC 드라이버 관리자를 사용하는 예입니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/redshift_oauth_idc_troubleshoot.png) [주요 콘텐츠로 건너뛰기](#main-content) # Amazon Web Services에 Tableau Server 설치 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Amazon Web Services(AWS) VM(가상 컴퓨터)에 Tableau Server를 설치하면 로컬 환경에서도 Tableau Server의 고급 기능을 사용할 수 있습니다. 고가의 서버를 여러 대 구입하고 유지 관리할 필요 없이 스케일업 및 스케일아웃을 수행할 수 있는 유연성이 필요한 경우 AWS VM에서 Tableau Server를 실행하는 것이 탁월한 선택입니다. 예를 들어 Tableau Server를 고가용성으로 구성하고, 다수의 조직에서 사용되는 모든 공통 엔터프라이즈 응용 프로그램(예: Active Directory)을 통합할 수 있습니다. Linux에서 Tableau Server를 사용하려고 하십니까? [Amazon Web Services에 Tableau Server 설치](https://help.tableau.com/current/server-linux/ko-kr/ts_aws_welcome.htm "새 브라우저 탭에서 항목이 열림")를 참조하십시오. Tableau Server는 다수의 기본 AWS 서비스를 활용할 수 있습니다. - [Amazon CloudWatch](https://aws.amazon.com/cloudwatch): AWS 기반 솔루션의 구성 요소를 모니터링합니다. - [Amazon Route53](https://aws.amazon.com/route53): 사용자 요청을 AWS 인프라에 연결하기 위한 DNS 웹 서비스입니다. - [AWS Certificate Manager](https://aws.amazon.com/certificate-manager): AWS에서 사용할 SSL 및 TLS 인증서를 쉽게 배포할 수 있습니다. - [AWS CloudFormation](https://aws.amazon.com/cloudformation): 미리 정의된 템플릿을 사용하여 통제된 방식으로 관련 AWS 리소스를 만들고 관리할 수 있도록 도와 줍니다. - [Elastic Load Balancing](https://aws.amazon.com/elasticloadbalancing): Elastic Load Balancing을 사용하여 Tableau 요청을 여러 Tableau 게이트웨이에 분산시킬 수 있습니다. 또한 다음과 같은 AWS 기능을 사용하여 Tableau Server에서 사용할 데이터를 저장할 수 있습니다. Tableau는 다음과 같은 AWS 데이터 원본에 데이터를 연결할 수 있게 해 주는 네이티브 데이터 [커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/help.htm#exampleconnections_overview.htm)를 제공합니다. - [Amazon Athena](https://help.tableau.com/current/pro/desktop/ko-kr/examples_amazonathena.htm): Amazon S3에서 SQL을 사용하여 데이터를 분석하는 데 사용할 수 있는 대화형 쿼리 서비스입니다. - [Amazon Aurora for MySQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_amazonaurora.htm): 고성능 MySQL 호환 데이터베이스입니다. - [Amazon EMR Hadoop Hive](https://help.tableau.com/current/pro/desktop/ko-kr/examples_amazonemr.htm): 대량의 데이터를 처리하기 위한 관리되는 Hadoop 프레임워크입니다. - [Amazon Redshift](https://help.tableau.com/current/pro/desktop/ko-kr/examples_amazonredshift.htm): 대량의 데이터에 대한 저장과 마이닝을 위한 데이터 웨어하우징 솔루션입니다. - Amazon RDS(Amazon Relational Database Service): [Amazon Aurora for MySQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_amazonaurora.htm), [PostgreSQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_postgresql.htm), [MySQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_mysql.htm), [MariaDB](https://help.tableau.com/current/pro/desktop/ko-kr/examples_mariadb.htm), [Oracle](https://help.tableau.com/current/pro/desktop/ko-kr/examples_oracle.htm) 및 [Microsoft SQL Server](https://help.tableau.com/current/pro/desktop/ko-kr/examples_sqlserver.htm)를 지원하는 관계형 데이터베이스 솔루션입니다. - Amazon S3(Amazon Simple Storage Service): 클라우드 기반 저장소 솔루션입니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Amazon Web Services에 Tableau Server를 설치하는 모범 사례 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 클라우드에서 Tableau Server를 원활하게 설치하려면 다음과 같은 최상의 방법을 따르십시오. - Tableau Server [배포 계획](https://help.tableau.com/current/server/ko-kr/plan.htm) 섹션을 숙지합니다. - [시작하기 전에 준비할 사항](https://help.tableau.com/current/server/ko-kr/ts_aws_prerequisites.htm)을 숙지합니다. - Tableau Server [보안 강화 검사 목록](https://help.tableau.com/current/server/ko-kr/security_harden.htm)을 숙지합니다. - 클라우드 사용 경험이 없다면 AWS 기반 Tableau Server를 배포하기 전에 [AWS Free Tier](https://aws.amazon.com/free/)를 통해 클라우드 작업 방식에 익숙해지십시오. - [network topology on AWS](http://docs.aws.amazon.com/gettingstarted/latest/awsgsg-intro/gsg-aws-compute-network.html)(AWS의 네트워크 토폴로지)를 읽고 아키텍처가 구성된 방식을 이해하십시오. - [Amazon 탄력적 네트워크 인터페이스](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_ElasticNetworkInterfaces.html)를 사용하여 Amazon EC2 인스턴스에 대한 정적 MAC 주소를 제공하십시오. ## 비용 절감 AWS는 사용한 시간만큼 지불하는 클라우드 기반 서비스를 제공합니다. 비용은 실행한 서비스와 서비스 사용 기간으로 결정됩니다. 다양한 인스턴스 유형 및 크기 조합이 가능하며, 조합에 따라 비용이 달라집니다. 서비스 가격에 대한 자세한 내용은 AWS 웹 사이트에서 [AWS 요금](https://aws.amazon.com/pricing/)을 참조하십시오. AWS 웹 사이트의 [AWS Simple Monthly Calculator](http://calculator.s3.amazonaws.com/index.html)(간단한 AWS 월별 요금 계산기)를 사용하여 총 월별 비용을 예측할 수 있습니다. 또한 AWS 웹 사이트의 [AWS TCO(총 소유 비용) 계산기](https://aws.amazon.com/tco-calculator/)를 사용하여 온-프레미스와 클라우드를 비교할 수 있습니다. 사용 비용을 지속적으로 모니터링하고 관리하려면 Amazon CloudWatch를 사용하여 월별 AWS 비용이 미리 정의된 지출 한도에 도달한 경우 알림을 받을 수 있습니다. 자세한 내용은 AWS 웹 사이트의 Amazon CloudWatch 사용자 가이드에서 [CloudWatch를 사용하여 예상 요금 모니터링](http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/gs_monitor_estimated_charges_with_cloudwatch.html)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # ATR(Authorization to Run) 서비스를 사용하여 Tableau Server 활성화 Server ATR(Authorization to Run) 서비스를 사용하면 라이선스 활성화를 실행하지 않고 온프레미스, 클라우드, 컨테이너 또는 가상 환경에 배포된 Tableau Server를 활성화할 수 있습니다. ATR 서비스는 제품 키 만료 날짜가 도래할 때까지 라이선스를 기기에 연결하는 구성 가능한 기간의 단기 임대(ATR 기간)를 제공하여 활성화를 가능하게 합니다. ATR이 활성화 용량 추적을 처리하므로 기초 하드웨어가 변경된 경우 최대 활성화 오류가 발생하지 않습니다. 이 옵션은 모든 Tableau Server 설치에 대해 권장됩니다. Tableau Server를 온라인으로 활성화하는 경우(기본값) Tableau Server는 라이선스 부여 목적으로 다양한 인터넷 위치에 연결합니다. 자세한 내용은 [인터넷 통신](https://help.tableau.com/current/server/ko-kr/plan_network.htm)을 참조하십시오. Tableau Server를 오프라인으로 활성화하는 경우에도 ATR 서비스를 사용하여 활성화할 수는 있지만 ATR 기간이 오프라인 활성화로 작동하는 방식에는 약간의 차이가 있습니다. 자세한 내용은 [오프라인 활성화를 위한 ATR 기간](#ATR2)을 참조하십시오. 서버 라이선스를 단순화하려면 서버 ATR(Authorization to Run) 서비스를 사용하는 것이 좋습니다. 서버 ATR을 사용하지 않기로 선택한 경우 서버 ATR의 동적 관리 기능을 제공하지 않는 레거시 라이선스 기술이 사용됩니다. 선택한 활성화 유형은 이러한 Tableau Server 설치에 영구적으로 적용됩니다. 나중에 이를 변경하려면 Tableau Server를 백업하고 제거한 다음 다시 설치해야 합니다. ## Tableau Server ATR 작동 방식 ATR 서비스를 사용하도록 설정하면, Tableau Server가 정기적으로 Tableau에서 호스팅되는 ATR(Authorization to Run) 서비스에 연결하여 라이선스 및 권한 부여 기간(ATR 기간 또는 임대)을 기반으로 Tableau의 실행이 허가되는지 확인합니다. 이 통신이 성공하는 한 Tableau는 사용자에게 영향을 주지 않고 실행됩니다. ATR을 사용하도록 설정했지만 Tableau Server가 오프라인으로 활성화되면 Tableau Server는 Tableau 실행 권한이 있는지 확인하기 위해 정기적으로 ATR 서비스에 연결할 수 없습니다. 대신 Tableau Server는 제품 키가 처음 오프라인으로 활성화된 시점부터 ATR 기간을 내부적으로 추적합니다. ### ATR 기간 기본적으로 Tableau Server 인스턴스에는 확인을 위해 ATR 서비스에 성공적으로 연결할 수 있도록 5일의 ATR 임대(기간)가 제공됩니다. 즉, 초기 권한 부여 후 활성화가 만료되기 전까지 Tableau Server를 네트워크 연결 없이 5일간 사용할 수 있었습니다. Tableau Server 및 ATR 서비스 간 권한 부여 확인은 정기적으로 시도되며 확인이 성공할 때마다 ATR 기간이 전체 기간으로 재설정됩니다. 권한 부여 확인 빈도는 다양하며 ATR 기간에 따라 다릅니다.
ATR 기간권한 부여 확인 빈도
4시간 미만15분마다
24시간 미만1시간마다
7일 미만12시간마다
7일 초과24시간마다
예를 들어 ATR 기간이 48시간인 경우 Tableau Server는 12시간마다 ATR 서비스에 연결하여 권한 부여 확인을 완료하고 ATR 기간은 각 권한 부여 확인이 성공한 후 48시간으로 재설정됩니다. 그러면 다음번 권한 부여 확인까지 ATR 기간이 0으로 카운트다운되기 시작합니다. Tableau Server 컴퓨터가 종료되거나 인터넷에 액세스할 수 없는 경우 Tableau Server는 더 이상 ATR 서비스에 연결하지 못합니다. 이런 일이 발생하면 ATR 기간은 48시간으로 재설정되지 않고 0이 될 때까지 카운트다운이 이어집니다. ATR 기간이 0이 되기 전에 Tableau Server가 시작되지 않거나 ATR 서비스와 통신할 수 없는 경우 라이선스가 만료되므로 라이선스를 다시 활성화해야 합니다. **참고:** Tableau Server는 가능한 한 계속 실행해야 합니다. Tableau Server가 ATR 기간 내에 권한 부여 확인을 성공적으로 완료할 수 없는 경우 ATR 서비스는 라이선스 임대를 회수하므로 라이선스를 다시 활성화해야 합니다. ATR 기간을 보려면 [tsm licenses atr-configuration get](https://help.tableau.com/current/server/ko-kr/cli_licenses_tsm.htm#TSMAtr-configuration-get)을 참조하십시오. ## Server ATR 기간 설정 또는 변경 Server ATR(Authorization to Run)을 사용하여 Tableau Server를 활성화하는 경우 ATR 기간을 변경하고 기본값인 432000초(5일)와 다른 설정을 사용할 수 있습니다. 수명이 짧은 테스트 서버 또는 VM(가상 컴퓨터)를 생성하는 경우 ATR 기간을 줄이는 것이 좋을 수 있습니다. 마찬가지로 장기간 유지하려는 서버가 있는 경우에는 ATR 기간을 늘리는 것이 좋습니다. 새 VM을 자주 시작하는 경우 ATR 기간을 줄이면 이전 VM이 사용하던 용량을 회수하여 새 VM에 사용할 수 있습니다. 반면, ATR 기간을 늘리면 갱신 주기는 길어지지만 용량이 자주 회수되지는 않습니다. ATR 기간을 변경하려면 `tsm licenses atr-configuration set –duration ` 명령을 사용합니다. 자세한 내용은 [tsm licenses atr-configuration set](https://help.tableau.com/current/server/ko-kr/cli_licenses_tsm.htm#TSMAtr-configuration-set)를 참조하십시오.
ATR 기간(초)최소값최대값기본값
Tableau Server(컨테이너 외)3600(1시간)7776000(90일)432000(5일)
ATR 기간을 설정하고 활성화 서비스를 수동으로 시작하려면 다음 명령을 실행합니다. **참고:** 명령 프롬프트에서 관리자로 다음 명령을 실행해야 합니다. 컴퓨터의 구성 방식에 따라 C:\\Windows\\System32 폴더에서 명령을 실행해야 할 수 있습니다. 1. 초기 노드에서 관리자로 명령 프롬프트를 열고 다음 명령을 사용합니다. 2. `tsm licenses atr-configuration set -–duration ` 3. `tsm pending-changes apply` 4. `net stop activationservice_0` 5. `net start activationservice_0` ## 오프라인 활성화를 위한 ATR 기간 Tableau Server가 오프라인으로 활성화되면 ATR 기간은 제품 키가 오프라인으로 활성화된 날로부터 1년 또는 제품 키 갱신 날짜 중 먼저 도래하는 날짜로 설정됩니다. ATR 기간이 설정된 날짜에 도달하면 제품 키가 비활성화됩니다. 오프라인 환경에서 Tableau는 ATR 서비스와 통신할 수 없으므로 권한 부여 확인은 수행되지 않습니다. `tsm licenses atr-configuration get` 명령을 사용하여 오프라인 활성화에 대한 ATR 기간을 보는 경우 결과는 예상대로 `0`이 됩니다. 오프라인 활성화에 대한 ATR 기간을 보려면 대신 `ATRDiag -product "Tableau Server"` 명령을 사용하십시오. 자세한 내용은 [ATRDiag.exe 명령줄 참조](https://help.tableau.com/current/server/ko-kr/atrdiag.htm)를 참조하십시오. 결과 출력에서 `TTL End` 날짜는 ATR 기간이 끝나는 날짜입니다. ### 오프라인 환경에서 ATR 기간 업데이트 오프라인 환경에서는 권한 부여 확인이 불가능하므로 위에서 설명한 대로 ATR 기간은 고정된 값으로 설정됩니다. 예기치 않은 서버 다운타임을 방지하려면 설치 시 ATR 기간을 알고 있어야 하며, 만료되기 전에 ATR 기간을 업데이트할 수 있도록 계획해야 합니다. 이 작업을 수행하는 방법은 USL 키가 있는지 또는 USL 이외의 키가 있는지에 따라 달라집니다. - **USL 키:** USL 키가 있는 경우 [USL 오프라인 라이선스 자격 업데이트](https://help.tableau.com/current/server/ko-kr/license_usl.htm#USL)의 지침을 따르십시오. - **USL 이외의 키:** USL이 아닌 키를 사용하는 경우 ATR을 사용한 오프라인 활성화는 지원되지 않습니다. 수동 단계를 수행해야 합니다. 자세한 내용은 [Tableau Server 2023.1+: ATR을 통한 오프라인 비활성화를 사용할 수 없음](https://help.salesforce.com/s/articleView?id=001534333&type=1) 기술 자료를 참조하십시오. ## 다른 Tableau Server로 서버 ATR 제품 키 이동 기존 Tableau Server에서 제품 키 사용을 중지하고 Tableau Server의 새 설치에 사용하려면 서버 ATR 제품 키를 이동하면 됩니다. 다음과 같은 경우 제품 키를 이동하려 할 수 있습니다. - 개발 환경 또는 사전 프로덕션 환경 간 전환 - 업그레이드된 하드웨어로 Tableau Server 이동 - 클라우드 인프라로 Tableau Server 이동 - VM(가상 컴퓨터) 또는 컨테이너와 같은 일시적 Tableau Server 사용 ## 다른 Tableau Server에서 재사용할 수 있도록 제품 키 비활성화 ### 버전 2021.4 이상에서 제품 키 비활성화 특정 Tableau Server 설치에서 라이선스 용량을 회수하여 다른 설치에 사용하려는 경우 Server ATR을 사용하여 활성화된 제품 키를 제거할 수 있습니다. 제품 키 재확보에 대한 자세한 내용은 [제품 키 비활성화](https://help.tableau.com/current/server/ko-kr/license_deactivate.htm)를 참조하십시오. ### 버전 2021.3 이하에서 제품 키 비활성화 ATR 서비스를 사용하여 Tableau Server 라이선스를 활성화하는 경우 라이선스를 수동으로 비활성화할 수 없습니다. 라이선스당 하나의 프로덕션 설치와 두 개의 비프로덕션 설치를 이용할 수 있습니다. 라이선스에 미사용 활성화가 있는 경우 다른 Tableau Server에서 동일한 라이선스를 활성화할 수 있습니다. 활성화를 소진한 경우 다음 단계를 수행하면 ATR 임대가 만료된 후에도 라이선스를 활성화할 수 있습니다. 1. 기존 Tableau Server에서 임대된 활성화의 새로 고침을 사용하지 않도록 설정합니다. 다음 방법 중 하나를 사용하여 이를 수행할 수 있습니다. - 기존 Tableau Server를 종료합니다. - 기존 Tableau Server를 제거합니다. - 이더넷 케이블을 뽑거나 WiFi 연결을 해제하여 인터넷에서 기존 Tableau Server의 연결을 끊습니다. 2. ATR 임대가 만료된 후 다른 Tableau Server에서 라이선스를 다시 사용할 수 있습니다. 3. 새 컴퓨터에 Tableau Server를 설치합니다. 메시지가 표시되면 동일한 라이선스를 사용하여 Tableau Server를 활성화합니다. [주요 콘텐츠로 건너뛰기](#main-content) # ATRDiag.exe 명령줄 참조 ATRDiag 명령줄 유틸리티를 사용하여 로그인 기반 라이선스 관리 및 ATR(Authorization to Run) 기능과 관련된 라이선싱 문제를 관리할 수 있습니다. ## 개요 `ATRDiag -dumpATR -showAll -showVerbose -product ["Tableau Desktop"]["Tableau Prep"]["Tableau Server"]` `-subProduct {subProduct} -version {version} -setVersion {version}` `-log [Trace][Debug][Info][Warn][Error][Fatal][Off] -status -deleteAllATRs` `-deleteInvalidATRs -deleteATR {atrIdToDelete}` `-enableATRFeature -disableATRFeature -enableLBLMFeature -disableLBLMFeature` `-requireLBLMFeature -setDuration {seconds`} **참고:** 모든 ATRDiag 옵션은 대/소문자를 구분하지 않습니다. ## 옵션 `-dumpATR` 명령 프롬프트에 유효한 ATR(Authorization to Run)을 표시합니다(있는 경우). 유효한 ATR이 둘 이상인 경우 `-version/-product/-subProduct/-version`을 사용하여 덤프할 ATR을 제어합니다. `-showAll` 레지스트리 콘텐츠를 열거하여 사용 가능한 ATR을 표시합니다(일부는 유효하지 않을 수 있음). `-showVerbose` 레지스트리 콘텐츠를 열거하고 `-version/-product/-subProduct/-version`을 사용하여 제품별로 제공합니다. `-product ["Tableau Desktop"]["Tableau Prep"]["Tableau Server"]` 기본값은 "Tableau Desktop"입니다. Server ATR을 표시하려면 "Tableau Server"를 지정해야 합니다. 예: `atrdiag -product "Tableau Server"` ![특성 세부 정보가 있는 명령 프롬프트 창입니다.](/tableau/current/ko-kr/server/ko-kr/Img/atrdiag_product_tableau_server.png) `-subProduct {subProduct}` 기본값은 "Professional"입니다. `-version {version}` 기본값은 없습니다. 이 필드의 유효한 값은 "Tableau 2021.1"입니다. `-setVersion {version}` \-version에 대해 기본값을 유지합니다. `-log [Trace][Debug][Info][Warn][Error][Fatal][Off]` ATR 로그 정보를 표시합니다. `-status` ATR 기능 상태(사용 또는 사용 안 함) 및 라이선스 서버를 제공하고 ATR을 덤프합니다. `-deleteAllATRs` 컴퓨터에 있는 모든 ATR을 제거합니다. `-deleteInvalidATRs` 유효하지 않은 모든 ATR을 제거합니다. `-deleteATR {atrIdToDelete}` ID를 기준으로 ATR을 제거합니다. `-enableATRFeature` ATR 기능을 설정합니다. 관리자로 실행해야 합니다. Tableau Desktop에서만 사용 가능합니다. `-disableATRFeature` ATR 기능을 해제합니다. 관리자로 실행해야 합니다. Tableau Desktop에서만 사용 가능합니다. `-enableLBLMFeature` LBLM(로그인 기반 라이선스 관리)을 설정합니다. 관리자로 실행해야 합니다. `-disableLBLMFeature` LBLM(로그인 기반 라이선스 관리)을 해제합니다. 관리자로 실행해야 합니다. `-requireLBLMFeature` LBLM(로그인 기반 라이선스 관리) 기능을 필수로 설정합니다. 관리자로 실행해야 합니다. `-setDuration {seconds}` `ATRRequestedDurationSeconds`를 초 단위로 설정합니다. 관리자로 실행해야 합니다. ## 전역 옵션 `-h, --help` 선택 사항입니다. 명령 도움말을 보여 줍니다. [주요 콘텐츠로 건너뛰기](#main-content) # AWS RDS(Relational Database Service)에서 PostgreSQL DB 인스턴스 만들기 버전 2019.3부터 AWS 클라우드 플랫폼에서 외부 리포지토리를 호스팅할 수 있습니다. 이 항목에서는 Tableau Server 외부 리포지토리로 사용할 AWS RDS PostgreSQL DB 인스턴스를 만드는 방법에 대해 설명합니다. 외부 리포지토리에 사용할 수 있는 전체 호스트 목록을 보려면 [Tableau Server 외부 리포지토리](https://help.tableau.com/current/server/ko-kr/server_external_repo.htm)를 참조하십시오. ## 요구 사항 및 권장 사항 - 최소한 8vCPU 및 32GB RAM이 포함된 인스턴스를 사용합니다. 이는 Tableau Server 외부 리포지토리에 사용하기 위한 최소 권장 AWS RDS 인스턴스 크기이지만 정확한 요구 사항은 사용자 요구 사항 및 사용량에 따라 달라집니다. 우수한 성능을 위해 16 vCPU 및 128GB RAM Amazon RDS 메모리 최적화 인스턴스 유형을 사용하는 것이 좋습니다. 처음에 작은 인스턴스 유형으로 시작하고 나중에 더 큰 인스턴스 유형이 필요해지면 기존 RDS 인스턴스를 업그레이드할 수 있습니다. 자세한 내용은 [RDS 인스턴스 업그레이드](https://help.tableau.com/current/server/ko-kr/server_external_repo_upgrade_RDS_instance_type.htm)를 참조하십시오. Tableau Server와 외부 PostgreSQL DB 인스턴스 간의 SSL 연결을 사용한 보안 통신은 필수는 **아니지만** 권장됩니다. - Tableau Server 클러스터의 모든 노드가 PostgreSQL DB 인스턴스에 연결할 수 있어야 합니다. 이렇게 하는 방법 중 하나는 PostgreSQL DB 인스턴스를 Tableau Server 클러스터의 모든 노드가 액세스할 수 있는 사용 권한을 가진 보안 그룹의 멤버로 만드는 것입니다. - PostgreSQL의 버전은 로컬로 설치할 때 Tableau Server에서 사용하는 버전과 일치해야 합니다. Tableau Server 2020.4는 PostgreSQL 버전 12를 사용합니다. - Tableau는 내부 데이터베이스 사용자가 내부에서 사용할 비밀번호를 자동으로 생성합니다. 이러한 비밀번호는 32자 길이이며 소문자와 숫자로 구성됩니다. 관리자가 액세스하거나 구성할 수 없습니다. 외부 PostgreSQL 인스턴스의 경우 관리자가 비밀번호 정책을 설정할 수 있습니다(사용 중인 플랫폼에 따라 다름). 숫자 및 소문자 이외의 문자 유형을 포함하는 정책을 지정하면 외부 리포지토리를 사용하도록 Tableau Server를 구성하는 동안 오류가 발생할 수 있습니다. ## Amazon RDS에서 PostgreSQL DB 인스턴스 만들기 ### 1단계: 매개 변수 그룹 만들기 _postgresql.conf_ 파일에서 로컬 PostgreSQL 인스턴스에 대해 설정한 PostgreSQL 매개 변수는 DB 인스턴스의 DB 매개 변수 그룹에서 유지 관리됩니다. DB 인스턴스를 만들 경우 관련 DB 매개 변수 그룹의 매개 변수가 로드됩니다. Tableau Server 수준에서 대부분의 매개 변수를 기본값으로 설정할 수 있습니다. 특정 성능 또는 로깅 요구 사항이 있는 경우 매개 변수 값을 수정할 수 있지만 다음 매개 변수를 기본값으로 두고 변경하지 않는 것이 좋습니다. - `standard_conforming_strings` - `escape_string_warning` 또한 성능 문제를 방지하기 위해 `work_mem` 값을 16384 이상으로 설정하는 것이 좋습니다. PostgreSQL 매개 변수에 대한 자세한 내용과 전체 목록은 AWS 사이트에서 [PostgreSQL 파라미터 작업](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.html#Appendix.PostgreSQL.CommonDBATasks.Parameters)을 참조하십시오. ### 2단계: Amazon RDS에서 PostgreSQL DB 인스턴스 만들기 새 PostgreSQL DB 인스턴스를 만들려면 [Amazon 설명서 사이트](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html)에 제공된 지침을 따르십시오. 다음은 새 PostgreSQL DB 인스턴스에 대한 구성 옵션과 권장 값입니다. - **Instance Specifications(인스턴스 사양)** - **1단계**에서 만든 매개 변수 그룹을 사용합니다. - 사용 중인 Tableau Server 버전의 호환되는 PostgreSQL 버전을 사용합니다. Tableau Server 버전과 호환되는 PostgreSQL 버전의 전체 목록은 [제품 호환성](https://help.tableau.com/current/server/ko-kr/server_external_repo_upgrade_postgres.htm#postgres-ts-compat)을 참조하십시오. - db.m4.2xlarge 이상의 DB 인스턴스 클래스를 사용합니다. - 최소 100GB의 저장소를 할당합니다. - 저장소 유형 및 Provisioned IOPS: 기본값을 유지합니다(로드 테스트에 따라 권장 사항이 달라질 수 있음). - **Settings(설정)** - 마스터 사용자 이름으로 **rails**를 사용해야 합니다. > [!IMPORTANT] > > **Tableau Server에서 외부 리포지토리가 올바르게 작동하려면 이 요구 사항이 충족되어야 합니다.** - AWS의 요구 사항을 충족하는 암호를 선택합니다. - **Network and Security(네트워크 및 보안)** - 모든 Tableau Server 노드에서 RDS 인스턴스에 연결할 수 있는지 확인하십시오. 대부분 모든 노드에서 액세스할 수 있도록 허용하는 보안 그룹을 만들어 처리합니다. - **Database Options(데이터베이스 옵션)** - 초기 데이터베이스를 만들지 마십시오. Tableau Server가 RDS 인스턴스에서 필요한 데이터베이스를 만들므로 데이터베이스 이름은 비워 두어야 합니다. - 포트는 아무 값이나 사용할 수 있지만 기본값인 5432로 유지하는 것이 좋습니다. - DB Parameter Group(DB 매개 변수 그룹)을 **1단계**에서 만든 매개 변수 그룹으로 설정합니다. - IAM DB 인증을 사용 안 함으로 둡니다. - **Encryption(암호화)** - 암호화를 사용할지 여부를 선택할 수 있습니다. - **Backup(백업)** - 이것은 Tableau Server의 백업이 아니라 AWS의 자동화된 백업을 위한 것입니다. 요구 사항을 충족하는 설정을 지정할 수 있습니다. - Monitoring(모니터링) - 요구 사항에 따라 설정을 지정할 수 있습니다. - **Log Exports(로그 내보내기)** - 요구 사항에 따라 설정을 지정할 수 있습니다. - **Maintenance(유지 관리)** - 자동 부 버전 업그레이드를 사용하지 않도록 설정합니다. Tableau Server는 특정 버전의 PostgreSQL을 사용하도록 작성되었습니다. 필요한 경우 Tableau Server 업그레이드 중에 PostgreSQL 버전을 업그레이드하라는 메시지가 표시됩니다. - **Delete Protection(삭제 방지)** - 요구 사항에 따라 설정을 지정할 수 있습니다. ### 3단계: PostgresSQL DB 인스턴스 끝점 가져오기 PostgreSQL 데이터베이스 인스턴스를 만든 후 AWS에 의한 초기화가 완료될 때까지 인스턴스를 사용할 수 없으며 이 과정에 몇 분 정도 걸릴 수 있습니다. 인스턴스가 준비되면 Tableau Server 리포지토리에 이 인스턴스를 사용하도록 Tableau Server를 구성하는 데 사용할 끝점 정보를 가져옵니다. ### 4단계: SSL 인증서 파일(.pem 파일) 다운로드 Tableau Server와 외부 리포지토리 간의 SSL을 사용한 보안 연결은 필수는 **아니지만** 권장됩니다. Tableau Server와 외부 리포지토리 간에 보안 연결을 설정하지 않으려는 경우 외부 DB 인스턴스를 Tableau Server 리포지토리로 사용하도록 Tableau Server를 구성할 때 .pem 파일이 필요합니다. 자세한 내용은 [SSL을 사용하여 DB 인스턴스에 대한 연결 암호화](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL)를 참조하십시오. Tableau Server와 외부 리포지토리 간에 보안 연결을 사용할 필요가 없는 경우 암호화되지 않은 연결을 허용하도록 RDS 인스턴스를 구성해야 합니다. > [!IMPORTANT] > > **중요**: RDS 인스턴스 SSL 인증서의 계획된 만료의 일부로, RDS 인스턴스를 새 인증서 파일로 업데이트해야 하는 경우 Tableau Server 설정도 새 인증서 파일을 사용하도록 업데이트해야 합니다. 이 작업은 최신 파일을 다운로드한 후 _tsm topology external-services repository replace-host_ 명령을 실행하고 새 인증서 파일을 제공하여 수행할 수 있습니다. ## PostgreSQL DB의 고가용성 구성 Tableau Server는 외부 리포지토리에 대한 고가용성을 관리하거나 설정하지 않습니다. Amazon RDS는 고가용성을 제공하고 장애 조치를 관리하는 데 사용할 수 있는 고가용성 기능을 제공합니다. 자세한 내용은 [Amazon RDS 고가용성](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.MultiAZ.html)을 참조하십시오. ## PostgreSQL DB의 재해 복구 재해가 발생한 경우 새 RDS 인스턴스를 설치해야 할 수 있습니다. 또한 RDS 인스턴스 관련 문제에서 복구하려면 다른 시나리오가 필요할 수 있습니다. 예를 들어 Tableau Server를 업그레이드한 경우 RDS 인스턴스에서 PostgreSQL 버전도 업그레이드해야 할 수 있습니다. PostgreSQL 업그레이드가 실패한 경우 새 RDS 인스턴스를 사용해야 할 수 있습니다. 이와 같은 시나리오에서 Tableau Server를 새 RDS 인스턴스를 사용하도록 구성하려면 다음 단계를 따릅니다. 1. **스냅샷을 새 RDS 인스턴스로 복원합니다.** AWS는 기존 RDS 인스턴스로의 스냅샷 복원을 지원하지 않습니다. RDS 스냅샷 백업 및 복원에 대한 자세한 내용은 [Amazon RDS 백업 및 복원(영문)](https://aws.amazon.com/rds/details/backup/)을 참조하십시오. 2. 새 RDS 인스턴스에 대한 연결 정보를 포함하는 **새 JSON 설정 파일을 만듭니다**. JSON 설정 파일 만들기에 대한 자세한 내용은 [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm)의 **1단계**를 참조하십시오. 3. `tsm topology external-services repository replace-host` **command** 명령을 사용하여 Tableau Server를 새 RDS 인스턴스를 가리키도록 설정합니다. `tsm topology external-services repository replace-host` 명령에 대한 자세한 내용은 [tsm topology](https://help.tableau.com/current/server/ko-kr/cli_topology_tsm.htm)를 참조하십시오. ## 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자만 Tableau Server를 외부 리포지토리를 사용하도록 구성할 수 있습니다. 또한 RDS 인스턴스를 만들기 위한 AWS 계정이 필요합니다. ## 다음 단계 새 설치: [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm) 외부 리포지토리를 사용하도록 기존 Tableau Server를 구성하려면 [Tableau Server 리포지토리 다시 구성](https://help.tableau.com/current/server/ko-kr/server_external_repo_reconfigure.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 기반 Tableau Server 문제 해결 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 이 항목의 제안에 따라 AWS Cloud의 Amazon EC2 인스턴스에 설치한 Tableau Server에서 발생하는 일반적인 문제를 해결하십시오. - **TSM CLI가 추가 노드에서 작동하지 않음** TSM CLI는 초기 노드의 이름 또는 IP 주소를 지정하는 `-s` 옵션을 포함하여 서버 클러스터의 모든 노드에서 tsm 명령을 실행할 수 있도록 설계되었습니다. AWS의 여러 노드에서 TSM 명령을 실행할 때 다음 증상이 발생할 수 있습니다. - `-s` 옵션을 사용하여 tsm 명령을 실행하면 다음 메시지가 표시될 수 있습니다. `Unable to verify the server's HTTPS certificate.` 초기 노드가 아닌 노드의 명령줄에서 TSM 명령을 실행하려면 `-s` 스위치와 초기 노드의 비공개 IP 주소를 사용해야 합니다. - **Tableau Server가 모든 CPU 코어를 사용하지 않음** Tableau Server 코어 기반 라이선스를 사용할 때 다음과 같은 증상이 하나 이상 발생할 수 있습니다. - Tableau Server 설치 시 설치 프로그램에 Tableau Server를 실행 중인 컴퓨터에서 표시되는 것보다 적은 수의 코어가 나타날 수 있습니다. - Tableau Server의 라이선스 페이지에서 사용 중인 라이선스 아래에 표시되는 코어 수가 예상보다 적게 표시됩니다. - `tsm licenses list`를 실행할 경우 Tableau Server가 보고하는 코어 수가 예상보다 적을 수 있습니다. 자세한 내용은 [Tableau Server에서 일부 코어가 인식 안 됨](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=ko-kr)을 참조하십시오. - **I/O 지연 시간이 높음** 디스크 드라이버 성능을 설정을 **Better Performance**(성능 향상)로 변경하면 문제가 해결될 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 기반 Tableau Server 배포 옵션 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 프로비저닝하는 Amazon EC2 인스턴스에 Tableau Server를 자체 배포하거나, AWS 기반 Tableau Server Quick Start에서 AWS CloudFormation 템플릿을 사용하여 Tableau Server를 배포하거나, AWS Marketplace에서 AWS CloudFormation 템플릿을 사용하여 AWS 기반 Tableau Server를 배포할 수 있습니다. 다음 표에는 각 옵션의 차이점이 나와 있습니다.
Tableau ServerAWS 자체 배포AWS Quick StartAWS Marketplace
프로덕션 지원성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.빨간색 X 아이콘입니다.
업그레이드 가능성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
Linux에서 설치성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
Windows에서 설치성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
스케일업성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
스케일아웃(노드 추가)성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.
Active Directory 지원성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.빨간색 X 아이콘입니다.
BYOL 라이선스성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
최신 버전의 Tableau 지원성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
각 배포 옵션에 대한 자세한 내용이 아래에 설명되어 있습니다. - **Amazon EC2 인스턴스에 자체 배포** – 가장 유연한 배포 옵션이며 Tableau Server를 환경에 맞게 사용자 지정할 수 있습니다. 시스템을 빠르게 시작하려면 AWS 기반 Tableau Server Quick Start 또는 AWS Marketplace의 Tableau Server(BYOL) 제품군을 대신 사용하십시오. Tableau Server를 Amazon EC2 인스턴스에 자체 배포하는 옵션은 간소화된 구성으로 시작해서 나중에 스케일업 또는 스케일아웃해야 하는 개발, 테스트 및 프로덕션 환경에 권장됩니다. VM을 바꾸지 않고도 Tableau Server를 업그레이드할 수 있습니다. 자체 배포에 대한 자세한 내용은 [단일 AWS 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_aws_single_server.htm)를 참조하십시오. 분산 환경의 배포에 대한 자세한 내용은 [분산 환경의 AWS 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_aws_multiple_server.htm)를 참조하십시오. - **AWS 기반 Tableau Server Quick Start** – AWS CloudFormation 템플릿을 사용하여 Microsoft Windows Server, CentOS 또는 Ubuntu Server를 실행하는 독립 실행형 Amazon EC2 인스턴스 또는 독립 실행형 Amazon EC2 인스턴스의 클러스터에 Tableau Server를 설치합니다. 이 배포 전략을 사용하면 빠르게 라이브로 전환하고 전체 비용을 절감할 수 있습니다. AWS 기반 Tableau Server Quick Start는 간소화된 구성으로 시작해서 나중에 스케일업 또는 스케일아웃해야 하는 개발, 테스트 및 프로덕션 환경에 권장됩니다. 자체 라이선스(BYOL)를 사용하거나 [영업 팀에 문의](https://www.tableau.com/ko-kr/about/contact#contact_sales)하여 제품 키를 확인할 수 있습니다. VM을 바꾸지 않고도 Tableau Server를 업그레이드할 수 있습니다. Quick Start를 사용한 Tableau Server 설치에 대한 자세한 내용은 [Tableau Server on AWS Quick Start](https://aws.amazon.com/quickstart/architecture/tableau-server/)(AWS 기반 Tableau Server Quick Start)를 참조하십시오. 다른 특화된 AWS 기반 Tableau Server Quick Start에 대해서는 다음을 참조하십시오. - [Cloud Analytics Modernization on AWS Quick Start: End-to-End Cloud Analystics with Tableau Server(AWS의 클라우드 분석 현대화 Quick Start: Tableau Server를 사용한 종합적인 클라우드 분석)](https://aws.amazon.com/quickstart/architecture/informatica-tableau-analytics/) - [Tableau Server on AWS for Healthcare Quick Start: Tableau Server on AWS for HIPAA Workloads(의료 분야를 위한 AWS 기반 Tableau Server Quick Start: HIPAA 작업 부하를 위한 AWS 기반 Tableau Server)](https://aws.amazon.com/quickstart/architecture/tableau-server-healthcare/) - **AWS Marketplace의 Tableau Server(BYOL)** – 몇 번의 클릭만으로 AWS 기반 Tableau Server(BYOL)의 단일 노드 인스턴스를 설치합니다. 이 솔루션은 시작할 때 Tableau Server를 배포하는 AWS CloudFormation 스크립트를 사용하며, 최신 AWS Quick Starts의 작동 방식과 보다 정확하게 일치하고 일관된 고객 사용자 환경(CX)을 보장합니다. [영업 팀](https://www.tableau.com/ko-kr/about/contact#contact_sales)에 문의하여 제품 키를 확인하거나 Amazon EC2 인스턴스에서 Tableau Server를 설치하고 실행한 후 Tableau Server 라이선스를 구매하고 연결된 제품 키를 활성화할 수 있습니다. AWS Marketplace에 대한 자세한 내용은 [AWS Marketplace](https://aws.amazon.com/marketplace/seller-profile?id=0ef849c5-c2fa-4699-9f67-c47555e148a5)를 참조하십시오. Tableau Server AWS Marketplace 제품군에는 다음과 같은 제한이 있습니다. - 단일 컴퓨터의 스케일업(수직 확장)만 지원됩니다. - Active Directory는 지원되지 않습니다. 로컬 인증만 지원됩니다. Active Directory 인증이 필요한 경우 [단일 AWS 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_aws_single_server.htm)를 참조하십시오. - 최적화된 특정 유형 및 크기의 Amazon EC2 인스턴스에 배포될 수 있습니다. - Windows 및 Linux를 지원합니다. - 최신 버전의 Tableau를 지원합니다. - VM을 바꾸지 않고도 Tableau Server를 업그레이드합니다. Tableau Server의 라이선스 옵션에 대한 자세한 내용은 [라이선스 개요](https://help.tableau.com/current/server/ko-kr/license_server_overview.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 기반 Tableau Server 보안 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Tableau Server를 온프레미스에 배포하든 클라우드에 배포하든 배포를 안전하게 하는 단계를 수행하는 것이 중요합니다. Tableau Server의 보안을 개선하는 방법에 대한 자세한 내용은 [보안](https://help.tableau.com/current/server/ko-kr/security.htm)을 참조하십시오. Tableau Server에 기본 제공되는 보안 기능에 더해 AWS의 다른 기능을 사용하여 Tableau Server 환경을 보호할 수 있습니다. 여기에는 다음이 포함됩니다. - **Amazon VPC**는 사설 서브넷을 만들어 환경의 네트워크 보안을 위한 추가 계층을 제공합니다. - **보안 그룹**은 네트워크에 연결할 수 있는 인바운드 및 아웃바운드 트래픽을 결정합니다. [CIDR(Classless Inter-Domain Routing)](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) 블록의 IP 주소로 인바운드 트래픽을 제한하십시오. 0000\\0은 모든 트래픽이 서버에 액세스할 수 있도록 하므로 안전하지 않습니다. 사용하지 마십시오. - **AWS IAM(Identity and Access Management)**은 AWS 내의 기능에 대한 사용자 액세스를 제어하는 특정 기능을 제공합니다. - **AWS Direct Connect**는 기업 네트워크에서 업계 표준 802.1Q VLAN을 사용하여 AWS Direct Connect 파트너를 통해 AWS에 연결하는 전용 네트워크 연결을 허용합니다. 자세한 내용은 AWS 웹 사이트의 AWS Direct Connect 사용 설명서에서 [AWS Direct Connect 위치에서 교차 연결 요청](http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html)을 참조하십시오. - **Amazon EBS 암호화**는 디스크 볼륨 내의 저장된 데이터와 EC2 인스턴스와 EBS 저장소를 이동하는 데이터를 암호화하는 단순하면서도 강력한 방법을 제공합니다. AWS와 Tableau Server에서 엔터프라이즈 응용 프로그램 보안을 구현하여 단일 보고서 또는 대시보드로 내부 사용자와 외부 사용자를 모두 포함하는 다양한 사용자 기반의 요구 사항을 안전하게 충족할 수 있습니다. 엔터프라이즈 응용 프로그램 보안에는 세 가지 주요 구성 요소가 있습니다. - [네트워크](#Network) - [클라이언트 액세스](#Access) - [데이터](#Data) ## 네트워크 AWS에서 Tableau Server의 네트워크 보안에는 Amazon VPC 보안 그룹이 사용됩니다. 이 보안 그룹은 SSL을 통해 내부 및 외부 통신을 보호합니다. 자세한 내용은 AWS 웹 사이트의 Amazon Virtual Private Cloud 사용 설명서에서 [VPC의 보안 그룹](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html)을 참조하십시오. ### Amazon VPC Amazon VPC는 클라우드 내에서 분리되어 있는 고유한 네트워크입니다.각 Amazon VPC 내의 네트워크 트래픽은 다른 Amazon VPC와 분리됩니다. Amazon VPC를 사용하면 고유한 네트워크 서브넷을 만들고 응용 프로그램 계층을 네트워크 서브넷으로 분할하여 제어 수준을 높일 수 있습니다. Amazon VPC 내의 개별 서브넷에서 Tableau Server를 설치하고 실행하는 것이 좋습니다. 이렇게 하면 Tableau Server와 다른 데이터 집합에 대한 액세스에 사용할 네트워크를 구성할 수 있기 때문입니다. 다음 그림은 Amazon VPC에서의 일반적인 단일 노드 Tableau Server 설치를 보여 줍니다. ![Tableau Server가 사설 서브넷에 배치되는 방식을 보여주는 네트워크 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/ts_aws_securing_vpc.png) ### 보안 그룹 보안 그룹을 사용하면 Tableau Server에 액세스할 수 있는 네트워크 트래픽의 유형을 정의할 수 있습니다. Amazon EC2 보안 그룹은 Amazon EC2 인스턴스의 수신 및 발신 네트워크 트래픽을 제어하는 방화벽 역할을 합니다. Amazon EC2 인스턴스에 적절한 보안 그룹을 정의하고 할당할 수 있습니다. 기본적으로 Amazon EC2 인스턴스는 인바운드 트래픽을 허용하지 않는 보안 그룹으로 시작됩니다. EC2 인스턴스에 액세스하려면 먼저 해당하는 인바운드 트래픽을 허용하도록 변경해야 합니다. 다음은 EC2 인스턴스의 Tableau Server에 연결하는 데 필요한 최소 요구 사항입니다. - 인스턴스 및 서비스에 액세스하고 관리하려면 원격 데스크톱 클라이언트를 사용하여 RDP(포트 3389)를 통해 연결합니다. - Tableau Server에서 호스팅되고 게시되는 콘텐츠를 보려면 HTTP(포트 80) 및 HTTPS(포트 443)를 통한 표준 웹 트래픽을 허용해야 합니다. - 여러 인스턴스에 Tableau Server 구성 요소가 있는 경우 해당 구성 요소 간의 통신을 허용해야 합니다. **전체** 및 **분산/고가용성** 범주 아래에 나열된 [포트](https://help.tableau.com/current/server/ko-kr/ports.htm)를 참조하십시오. 이러한 요구 사항에 따라 EC2 인스턴스에 대한 인바운드 트래픽에 세 가지 표준 포트(HTTP 80, HTTPS 443 및 RDP 3389)만 사용하도록 설정해야 합니다. 또한 일부 호스트의 원격 액세스(포트 3389)를 제한하고 HTTP 및 HTTPS 트래픽을 회사 네트워크 내의 호스트 또는 신뢰할 수 있는 클라이언트 집합으로 제한해야 합니다. ## 클라이언트 액세스 기본적으로 Tableau Server는 표준 HTTP 요청 및 응답을 사용합니다. 고객이 제공한 보안 인증서를 통해 HTTPS(SSL)를 사용하도록 Tableau Server를 구성할 수 있습니다. SSL을 사용하도록 Tableau Server를 구성하면 모든 콘텐츠와 클라이언트 간 통신이 암호화되며 HTTPS 프로토콜이 사용됩니다. SSL을 사용하도록 Tableau Server를 구성하면 브라우저와 서버의 SSL 라이브러리가 공통 암호화 수준을 협상합니다. Tableau Server는 OpenSSL을 서버 측 SSL 라이브러리로 사용하며 현재 허용되는 표준을 사용하도록 미리 구성됩니다. SSL을 통해 Tableau Server에 액세스하는 각 웹 브라우저는 브라우저에서 제공하는 표준 SSL 구현을 사용합니다. Tableau Server에서 SSL을 사용하는 방법에 대한 자세한 내용은 [SSL](https://help.tableau.com/current/server/ko-kr/ssl.htm)을 참조하십시오. Tableau Server는 포트 443에서만 SSL 트래픽을 수신합니다. SSL/TLS에 대해 사용자 지정 포트를 구성할 수 없습니다. ELB(Elastic Load Balancing)를 사용하는 경우 ELB에서 SSL 종료를 수행할 수도 있습니다. ELB에서 웹 트래픽의 암호화/암호화 해제를 처리하도록 허용하면 Tableau Server에서 SSL을 수동으로 구성할 필요 없이 간편하게 Tableau Server에 대한 클라이언트 연결을 보호할 수 있습니다. 자세한 내용은 AWS 웹 사이트에서 [AWS Elastic Load Balancing: Support for SSL Termination](https://aws.amazon.com/blogs/aws/elastic-load-balancer-support-for-ssl-termination/)(AWS Elastic Load Balancing: SSL 종료 지원)을 참조하십시오. ### AWS Directory Service 선택 사항입니다. AWS Directory Service는 AWS 리소스를 Microsoft Active Directory(AD Connector 사용) 같은 기존의 온프레미스 디렉터리에 연결하거나 AWS Cloud(Simple AD 사용)에서 새로운 독립 실행형 디렉터리를 설정하는 데 사용되는 관리되는 서비스입니다. 온프레미스 디렉터리에 간편하게 연결할 수 있으며 이 연결이 설정된 후에는 모든 사용자가 기존의 회사 자격 증명을 사용하여 AWS 리소스 및 응용 프로그램에 액세스할 수 있습니다. AWS Directory Service를 사용하면 Tableau Server의 기본 사용자 관리 시스템을 사용하여 사용자를 만들고 암호를 할당하는 로컬 인증 대신 Active Directory 기반 인증을 사용하도록 선택할 수 있습니다. Active Directory 기반 인증을 설정하려면 Tableau Server를 설치한 후 구성 단계에서 Active Directory를 선택해야 합니다. 나중에 Active Directory와 로컬 인증 사이를 전환할 수 없습니다. Active Directory 인증 모델은 Microsoft SSPI(Security Support Provider Interface)를 사용하여 Windows 사용자 이름 및 암호를 기반으로 사용자를 자동으로 로그인합니다. 이 경우 SSO(Single Sign-On)와 유사한 경험을 할 수 있습니다. ## 데이터 Tableau Server는 가능한 경우 원시 드라이버(원시 드라이버를 사용할 수 없는 경우 일반 ODBC 어댑터 사용)를 통해 데이터베이스에 연결하여 결과 집합을 처리하고, 추출을 새로 고치고, 다른 모든 데이터베이스 통신을 수행합니다. 비표준 포트로 통신하거나 전송 암호화를 사용하도록 드라이버를 구성할 수 있지만 이 유형의 구성은 Tableau Server에 영향을 주지 않습니다. 그러나 Tableau Server와 데이터베이스의 통신은 일반적으로 방화벽 뒤에서 수행되므로 이 통신을 암호화하지 않도록 선택할 수 있습니다. ### AWS의 데이터 저장소에 연결 Amazon RDS(Amazon Relational Database Service), Amazon EMR(Amazon Elastic MapReduce), Hadoop Hive 또는 Amazon Redshift 같은 AWS 리소스를 Amazon VPC에서 시작할 수 있습니다. Tableau Server를 데이터 저장소와 동일한 Amazon VPC에 배치하면 트래픽을 Amazon VPC 내에 유지할 수 있습니다. 다음 다이어그램에 표시된 것과 같이 서브넷을 보안 그룹과 함께 사용하여 리소스를 다른 계층에서 시작하고 Amazon VPC 내에서 리소스가 안전하게 통신하도록 할 수 있습니다. ![클라우드 네트워크의 아키텍처를 설명하는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/ts_aws_securing_data.png) ### AWS 외부의 데이터 저장소에 연결 필요한 경우 IPsec 하드웨어 VPN 연결을 사용하여 Amazon VPC를 회사 데이터 센터에 연결하고 AWS Cloud를 데이터 센터의 확장으로 사용할 수 있습니다. VPN 연결은 Amazon VPC에 연결된 가상 사설 게이트웨이와 회사 데이터 센터에 위치한 고객 게이트웨이로 구성됩니다. AWS Cloud 서비스를 활용할 때 인터넷 대신 사용할 수 있는 네트워크 서비스인 AWS Direct Connect를 사용하도록 선택할 수 있습니다. AWS Direct Connect를 사용하면 AWS Direct Connect 파트너를 통해 업계 표준 802.1Q VLAN을 사용하는 전용 네트워크 연결을 설정할 수 있습니다. 자세한 내용은 AWS 웹 사이트의 AWS Direct Connect 사용 설명서에서 [AWS Direct Connect 위치에서 교차 연결 요청](http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html)을 참조하십시오. 동일한 연결을 사용하여 공개 리소스(예: 공개 IP 주소를 사용하여 Amazon S3(Amazon Simple Storage Service)에 저장된 개체)와 비공개 리소스(예: Amazon VPC 내에서 비공개 IP 공간을 사용하여 실행되는 Amazon EC2 인스턴스)에 연결하면서 공개 환경과 비공개 환경의 네트워크를 분리할 수 있습니다. ### 저장된 데이터 암호화 Amazon EBS 암호화는 PII(개인 식별 정보)를 포함할 수 있는 볼륨을 투명하고 간편하게 암호화할 수 있는 방법을 제공합니다. EBS 암호화는 볼륨 내에 저장된 데이터오 볼륨과 인스턴스 사이를 이동하는 데이터를 AES-256을 사용하여 암호화합니다. 이 기능은 Tableau Server 성능에 거의 또는 전혀 영향을 미치지 않습니다. 그러므로 시스템에 PII가 저장되는지 여부와 관계없이 이 서비스를 사용하는 것이 좋습니다. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 기반 Tableau Server 확장 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Tableau Server는 CPU 코어와 메모리를 추가할 경우 수직 확장(스케일업)되고, 서버를 추가할 경우 수평 확장(스케일아웃)되도록 설계되었습니다. 이 아키텍처를 사용하면 컴퓨팅 리소스 사용을 극대화하는 동시에 대규모로 확장할 수 있습니다. 중복성을 구축하기 위해서는 리포지토리, 파일 저장소 및 기타 프로세스의 복사본을 호스팅할 여분의 서버를 추가해야 합니다. 이 시나리오에서는 초기 서버를 자체 노드로 격리해야 하며 가능한 한 적은 수의 서버 프로세스를 실행하는 것이 좋습니다. **참고:** 8코어 라이선스를 4코어 컴퓨터 두 대로 분할할 수 있지만 8코어 컴퓨터 단위로만 확장하는 것이 좋습니다. ## 부하 분산 AWS에서는 ELB(Elastic Load Balancing)가 자동으로 수신 응용 프로그램 트래픽을 클라우드의 여러 Amazon EC2 인스턴스 간에 분산시킵니다. 이를 통해 응용 프로그램에서 보다 더 높은 수준의 내결함성을 달성하고 응용 프로그램 트래픽을 분산시키는 데 필요한 부하 분산 기능의 용량을 원활하게 제공할 수 있습니다. ELB를 사용하여 Tableau Server 클러스터의 여러 게이트웨이로 요청을 분산시킬 수 있습니다. 아래 그림에서 3개 노드 모두에 게이트웨이가 있으며 사용 가능한 서버 프로세스에 대한 요청을 라우팅하는 데 사용됩니다. 리포지토리 프로세스와 달리 수동 또는 대기 게이트웨이 프로세스가 없습니다. 모든 게이트웨이가 능동입니다. Tableau Server 클러스터에 부하 분산 장치를 추가하는 경우 Tableau Server 사용자가 액세스하는 URL은 초기 Tableau Server가 아니라 부하 분산 장치에 속합니다. ![세 개의 Tableau Server에서 부하 분산 아키텍처를 보여주는 순서도입니다.](/tableau/current/ko-kr/server/ko-kr/Img/ts_aws_elb.png) ## 고가용성 여분의 노드를 추가하여 파일 저장소, 리포지토리 및 게이트웨이에 대한 중복성을 구현한 후에는 초기 Tableau Server에 대한 중복성을 추가로 구축할 수 있습니다. 이 작업은 초기 Tableau Server의 백업을 만들어 수행할 수 있습니다. 설치하는 동안 백업 서버에 라이선스를 부여해야 하지만 이는 Tableau EULA(최종 사용자 사용권 계약)에 따라 허용 가능한 세 가지 환경 중 하나로 간주되지 않습니다. 고가용성을 구성하려면 장애 조치 클러스터를 실행해야 합니다. 고가용성을 구성하는 경우 초기 Tableau Server에서 Tableau Server 프로세스가 거의 또는 전혀 실행되지 않을 수 있습니다. 자세한 내용은 Tableau Server 도움말에서 [고가용성](https://help.tableau.com/current/server/ko-kr/distrib_ha.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 기반 Tableau Server의 성능 최적화 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 AWS Cloud의 Amazon EC2 인스턴스에 설치된 Tableau Server의 성능 최적화는 Tableau Server 솔루션의 성능 조정을 위한 다른 차원을 추가합니다. 이 섹션에서는 클라우드에 적합하게 Tableau Server를 조정하는 방법을 설명합니다. 일반적인 성능 조정 정보는 [Tableau Server 성능 개요](https://help.tableau.com/current/server/ko-kr/perf.htm)를 참조하십시오. 성능 최적화를 지원하는 데 사용할 수 있는 도구에 대한 자세한 내용은 [성능 리소스](https://help.tableau.com/current/server/ko-kr/perf_resources.htm)를 참조하십시오. 모든 AWS 기반 Tableau Server 배포는 각 사용자의 고유한 작업 부하 요구 사항에 따라 다릅니다. 회사의 사용자가 다르고, 활용하는 데이터가 다르고, 문의하는 내용이 다르며, 비즈니스 요구 사항이 각기 다릅니다. 따라서 Tableau Server 작업 부하를 다양한 Amazon EC2 인스턴스 유형에서 테스트한 후 프로덕션 환경에 설치하는 것이 좋습니다. 작업 부하 요구 사항은 다음 요인의 영향을 받을 수 있습니다. - Tableau 데이터 추출 사용량(많음, 적음, 중간) - 비주얼리제이션 및 대시보드를 보는 사용자와 상호 작용하는 사용자의 비율 - Tableau 데이터 추출 새로 고침이 수행되는 시간(업무 시간 중간 또는 업무 시간 이후) - 지정된 기간의 동시 개별 사용자 수 - 뷰 및 대시보드의 복잡성 - Tableau 웹 작성을 활용하는 커뮤니티의 규모 올바른 인스턴스 유형을 선택하기 위한 몇 가지 일반적인 지침이 있습니다. Tableau는 자체 설계한 무료 확장성 테스트 도구인 TabJolt를 통해 Amazon EC2 인스턴스에서 부하 테스트를 실행하여 다음 메트릭을 기반으로 성능 및 확장성을 테스트할 수 있습니다. - 실행 중인 가상 사용자의 수 - 초당 평균 트랜잭션 - 평균 성공 응답 시간 - 평균 오류 비율(오류가 발생하는 데 60초 이상이 소요되는 모든 비주얼리제이션을 테스트에서 고려함) ## 성능을 위한 최상의 방법 다음은 AWS에서 Tableau를 배포할 때 성능과 관련하여 유용하게 참조할 수 있는 최상의 방법입니다. - 각 Amazon EC2 인스턴스를 8개 이상의 코어에서 실행 사용자 수가 비교적 적은 경우라 하더라도 vCPU 16개 미만(코어 8개에 해당)의 EC2 인스턴스는 일관적으로 우수한 성능을 제공하지 못합니다. 예를 들어 vCPU가 16개인 r4.4xlarge 인스턴스 하나는 각각 vCPU가 8개인 r4.2xlarge 인스턴스 2개보다 많은 사용자를 처리할 수 있으며 응답 시간 및 오류 비율이 낮습니다. 이 패턴은 수직 확장 시에도 일관적으로 유지됩니다. 16vCPU 인스턴스 4개와 32vCPU 인스턴스 2개는 8vCPU 인스턴스 8개보다 훨씬 더 높은 성능을 제공합니다. - 작업 부하에 따라 결과가 크게 달라짐 작업 부하의 강도는 여러 EC2 인스턴스 유형의 성능에 지속적인 영향을 미칩니다. 예를 들어 동일한 기반 가상 컴퓨터 인스턴스에서 다른 대시보드를 사용하는 경우 눈에 띄는 성능 차이가 발생합니다. 고유한 작업 부하가 아닌 다른 작업 부하를 사용하여 성능을 비교하는 것은 큰 의미가 없습니다. - CPU가 많을수록 좋음 Tableau Server 성능의 병목 현상은 주로 CPU에서 야기되는 경우가 많습니다. 일반적으로 Tableau에서 더 많은 작업을 수행하려면 성능이 좋은 CPU를 추가하는 것이 좋습니다. - Amazon EC2 인스턴스의 RAM이 충분한지 확인 CPU 수는 적지만 RAM이 많은 인스턴스에서 동일한 작업 부하를 실행했을 때 TPS(초당 트랜잭션 수)가 더 높았고, 응답 시간은 짧았으며, 오류 비율은 낮았습니다. RAM이 너무 작은 EC2 인스턴스에서는 고성능 CPU의 이점이 상쇄될 수 있습니다. 프로덕션 환경에서는 코어당 8GB RAM을 목표로 30GB 이상의 RAM을 사용하여 인스턴스를 실행하십시오. CPU가 많은 인스턴스를 선택하는 것이 중요하지만 RAM이 부족한 인스턴스에서 Tableau Server를 실행하면 CPU 수에 관계없이 성능이 저하될 수 있습니다. - SSD 기반 볼륨을 사용하는 것이 좋지만 Provisioned IOPS는 필요하지 않을 수 있음 Tableau Server에는 시스템 메타데이터를 저장하는 산업용 데이터베이스(PostgreSQL)를 포함하여 다수의 프로세스와 구성 요소가 포함되어 있습니다. Tableau Server가 제대로 작동하려면 합리적인 수준의 디스크가 필요하며 Amazon EBS(Elastic Block Store) SSD 기반 볼륨만 사용하는 것이 좋습니다. 자기 디스크는 데이터베이스의 요청을 효과적으로 처리하는 데 필요한 처리량을 제공하지 못합니다. 테스트에서 범용 SSD(gp2)와 EBS Provisioned IOPS 볼륨을 모두 실행했고 EBS 디스크 2개를 대부분의 테스트에 사용했습니다. 대부분의 EBS 볼륨에는 1,500 Provisioned IOPS가 포함되었습니다. 범용 SSD로 다시 테스트를 실행한 후 결과는 중간 수준의 작업 부하에서 거의 동일했습니다. AWS 기반 Tableau Server 작업 부하에서 Provisioned IOPS가 눈에 띄는 성능 차이를 보인 경우는 분명히 있었지만 그렇다고 해서 Provisioned IOPS가 기본적으로 필요하다고 가정할 수는 없습니다. 이를 확인하는 가장 좋은 방법은 Tableau Server 작업 부하를 직접 테스트하는 것입니다. - TabJolt를 사용하여 자체 테스트 수행 Amazon EC2 인스턴스의 작업 부하 및 구성에 따라 Tableau Server의 성능이 크게 달라질 수 있습니다. EC2는 유연하기 때문에 요구 사항에 적합한 설정과 인스턴스 유형의 조합을 쉽게 결정할 수 있습니다. 예를 들어 RAM 및 CPU를 많이 소모하는 일부 프로세스를 클러스터의 모든 컴퓨터에서 실행하는 대신 여러 시스템에 분리하면 TPS(초당 트랜잭션 수)가 크게 달라집니다. 서로 다른 작업 부하의 성능 특성을 비교할 필요는 없습니다. 재미있을 수는 있지만 유용한 결과를 얻지는 못합니다. 대신 동일한 작업 부하를 사용하여 가장 효과적인 하드웨어 및 소프트웨어 구성을 찾아 보십시오. AWS에서는 아주 쉽게 이 작업을 수행할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 인스턴스 유형 및 크기 선택 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 성공적인 Tableau Server 배포에 있어 작업 부하에 적합한 인스턴스를 선택하는 것이 중요한 요소입니다. 광범위한 Amazon EC2 인스턴스 유형에서 선택할 수 있습니다. 사용 가능한 인스턴스 유형 및 크기의 전체 목록을 보려면 AWS 웹 사이트에서 [Amazon EC2 인스턴스 유형](https://aws.amazon.com/ec2/instance-types/)을 참조하십시오. 64비트 Tableau Server에는 최소 4코어 CPU(AWS vCPU 8개에 해당) 및 64 GB RAM이 필요합니다. 하지만 단일 프로덕션 Amazon EC2 인스턴스의 경우 총 8개 CPU 코어(16개 AWS vCPU) 및 128GB RAM을 사용할 것을 강력하게 권장합니다. M5, M4, C5, C4, R4 및 R4 인스턴스의 경우 AWS vCPU는 2개 스레드의 Intel Xeon 코어로 구성된 단일 하이퍼스레드입니다. 단순하게 생각하면 AWS vCPU는 물리적 코어 한 개의 절반에 해당합니다. 따라서 Amazon EC2 인스턴스 크기를 선택할 때 구매하거나 배포하려는 코어 수의 두 배를 선택해야 합니다. 예를 들어 Tableau Server 8개 코어 라이선스를 구매한 경우(또는 8개 코어가 보장하는 충분한 활성 사용자를 지원해야 하는 경우) 16개 vCPU가 있는 Amazon EC2 인스턴스 유형을 선택해야 합니다. 물리적 코어와 동일한 vCPU 수에 대한 자세한 내용은 AWS 웹 사이트에서 [Amazon EC2 및 RDS DB 인스턴스 유형별 물리적 코어](https://aws.amazon.com/ko/ec2/physicalcores/)를 참조하십시오. Windows 운영 체제는 이 16개 vCPU를 8개 코어로 인식하므로 라이선스에 부정적인 영향을 미치지 않습니다. ## 개발, 테스트 및 프로덕션 환경을 위한 일반적인 인스턴스 유형 및 크기 - C5.4xlarge(개발 환경에만 적합함) - m5.4xlarge(개발 또는 테스트환경에만 적합함) - r5.4xlarge(개발, 테스트 또는 프로덕션 환경에 적합함) **참고:** Amazon EC2 T2 인스턴스에 Tableau Server를 설치하는 것은 지원되지 않습니다. Tableau Server에서 테스트를 마친 다양한 Amazon EC2 인스턴스 유형의 성능 비교에 대해서는 [Tableau at the Speed of EC2(EC2 속도의 Tableau)](https://www.tableau.com/ko-kr/learn/whitepapers/tableau-speed-of-aws-ec2)를 참조하십시오. ### 단일 프로덕션 인스턴스의 권장 사양
구성 요소/리소스Amazon Web Services

CPU

16개 이상의 vCPU

운영 체제
 2021.3.0 ~ 2023.3.02023.3.1 ~ 2026.2.x
Windows Server 2016
Windows Server 2019(x64)
Windows Server 2022참고: 2023.3.1 이전 버전에서 Windows Server 2022는 지원되지 않습니다. 2023년 4월부터 Windows 기반의 모든 2023.3.1 이전 Tableau Server 버전에 대한 설치 프로그램은 Windows 2022에서의 설치를 차단합니다.

메모리

128GB 이상 RAM(vCPU당 4GB RAM)

저장소

2개 볼륨:

운영 체제용 30~50GiB 볼륨

Tableau Server용 100GiB 이상의 볼륨

저장소 유형

EBS 권장(SSD(gp2) 또는 프로비저닝되는 IOPS)

디스크 지연 시간

Windows의 Avg. Transfer disk/sec 성능 카운터로 측정 시 20ms보다 작거나 같아야 합니다.

[주요 콘텐츠로 건너뛰기](#main-content) # AWS 키 관리 시스템 Tableau Server에는 저장 시 암호화를 사용하도록 설정할 수 있는 3개의 KMS(키 관리 시스템) 옵션이 있습니다. 2개 시스템에는 Advanced Management 기능이 필요하고 로컬 시스템은 Tableau Server의 모든 설치를 통해 제공됩니다. **중요:** 2024년 9월 16일부터 Advanced Management는 더 이상 독립 Add-On 옵션으로 사용할 수 없습니다. Advanced Management 기능은 이전에 Advanced Management를 구매한 경우에만 사용할 수 있으며, Tableau Enterprise, Tableau Cloud+ 또는 Tableau+ Bundle(Tableau Cloud에 사용 가능) 또는 Tableau Enterprise 또는 Tableau Server+(Tableau Server에 사용 가능)와 같은 특정 라이선스 버전을 구매한 경우에만 사용할 수 있습니다. 버전 2019.3부터 Tableau Server에는 다음과 같은 KMS 옵션이 추가되었습니다.  - 모든 설치를 통해 제공되는 로컬 KMS. 자세한 내용은 [Tableau Server 키 관리 시스템](https://help.tableau.com/current/server/ko-kr/security_kms.htm)을 참조하십시오. - Advanced Management의 일부로 제공되는 AWS 기반 KMS. 아래에 설명되어 있습니다. 버전 2021.1부터 Tableau Server에는 다른 KMS 옵션이 추가되었습니다.  - Advanced Management의 일부로 제공되는 Azure 기반 KMS. 자세한 내용은 [Azure Key Vault](https://help.tableau.com/current/server/ko-kr/security_kms_azure.htm)를 참조하십시오. 버전 2019.3 릴리스에서 Tableau Server는 AWS KMS(키 관리 시스템)를 Advanced Management의 일부로 지원합니다. ## 저장된 암호화를 위한 AWS KMS AWS KMS는 Tableau Server에서 Advanced Management의 일부로 제공됩니다. 자세한 내용은 [Tableau Server의 Tableau Advanced Management 정보](https://help.tableau.com/current/server/ko-kr/itm_intro.htm)를 참조하십시오. 조직에서 저장된 데이터 추출 암호화를 배포하는 경우, 선택적으로 추출 암호화를 위해 AWS를 KMS로 사용하도록 Tableau Server를 구성할 수 있습니다. AWS KMS를 사용하도록 설정하려면 AWS EC2에서 Tableau Server를 배포해야 합니다. AWS 시나리오에서 Tableau Server는 AWS KMS 고객 마스터 키(CMK)를 사용하여 [AWS 데이터 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys)를 생성합니다. Tableau Server는 모든 암호화된 추출에 대한 루트 마스터 키로 AWS 데이터 키를 사용합니다. 그러나 AWS KMS용으로 구성된 경우에도 원시 Java 키 저장소와 로컬 KMS는 여전히 Tableau Server에서 암호의 보안 저장소로 사용됩니다. AWS KMS는 암호화된 추출에 대한 루트 마스터 키를 암호화하는 데에만 사용됩니다. AWS를 사용하여 마스터 루트 키를 암호화하면 추출과 동일한 사용 권한으로 마스터 키를 저장하지 않게 되므로 보안 속성이 향상됩니다. ![데이터 암호화에 사용되는 다양한 키를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/security_kms_AWS_key_hierarchy.png) Tableau Server가 AWS KMS로 구성된 경우 키 계층 구조 ## Tableau Server 암호화된 추출에 대한 AWS KMS 구성 AWS 고객 마스터 키(CMK)를 사용하여 Tableau Server KMS 계층 구조의 루트 키를 암호화하려면 이 섹션에 설명된 대로 Tableau Server를 구성해야 합니다. 시작하기 전에 다음 요구 사항을 충족하는지 확인하십시오. - Tableau Server가 AWS EC2에 배포되어야 합니다. - Tableau Server가 Advanced Management로 구성되어야 합니다. [Tableau Server의 Tableau Advanced Management 정보](https://help.tableau.com/current/server/ko-kr/itm_intro.htm) 항목을 참조하십시오. - AWS 키 관리 서비스에서 만들어진 고객 마스터 키(CMK)에 대한 관리 권한이 있어야 합니다. - AWS KMS를 구성하는 사람의 사용자 ID(주로 이메일 주소)는 26자를 초과할 수 없습니다. ### 1단계: CMK 만들기 및 AWS에서 Tableau Server에 대한 키 정책 설정 다음 절차는 AWS KMS 서비스에서 수행합니다. 참조 자료는 AWS 설명서에 포함되어 있습니다. 1. Tableau Server에 사용할 CMK를 만듭니다. AWS 항목 [키 생성](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys)을 참조하십시오. 2. 서버 인스턴스의 IAM 역할을 업데이트합니다. Tableau Server는 인스턴스의 IAM 역할을 사용하여 AWS KMS를 인증할 수 있어야 합니다. 역할에는 연결된 정책이 있어야 합니다. 정책은 CMK에서 "GenerateDataKey" 및 "Decrypt" 작업을 호출할 수 있는 사용 권한을 인스턴스에 제공해야 합니다. 자세한 내용은 [IAM의 Amazon EC2 역할](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html)을 참조하십시오. Tableau Server의 다중 노드 배포에서는 서버의 모든 노드가 이 정책(또는 동등한 정책)이 연결된 역할로 실행되어야 합니다. 동일한 역할을 클러스터의 모든 노드에 할당할 수 있습니다. 3. 최소한 CMK에는 `Effect`가 `Allow`, `Prinicpal`(서버 인스턴스에 연결된 IAM 역할), `Action`: `GenerateDataKey` 및 `Decrypt`로 설정된 키 정책이 있어야 합니다. [AWS KMS에서 키 정책 사용](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html)을 참조하십시오. ### 2단계: AWS 구성 매개 변수 수집 AWS KMS의 전체 ARN 문자열이 필요합니다. 이 문자열은 AWS KMS 관리 페이지의 "General configuration"(일반 구성) 섹션에 있습니다. ARN은 arn:aws:kms:::key/ 형식으로 표시됩니다(예: `arn:aws:kms:us-west-2:867530990073:key/1abc23de-fg45-6hij-7k89-1l0mn1234567`). 또한 AWS 지역을 지정해야 하며, AWS 지역은 ARN 문자열에도 포함되어 있습니다. 위 예에서 지역은 `us-west-2`입니다. 지역은 KMS 인스턴스가 있는 위치입니다. 다음 단계에서는 [Amazon API 게이트웨이 테이블](https://docs.aws.amazon.com/general/latest/gr/rande.html)의 Region(지역) 열에 표시된 대로 지역을 지정해야 합니다. ### 3단계: AWS KMS를 위한 Tableau Server 구성 Tableau Server에서 다음 명령을 실행합니다. 이 명령은 서버를 다시 시작합니다. - `tsm security kms set-mode aws --aws-region "" --key-arn "arn:aws:kms:::key/"` `--key-arn` 옵션은 AWS KMS 관리 페이지의 "General configuration"(일반 구성) 섹션에 있는 ARN 문자열을 직접 복사합니다. 예를 들어 AWS KMS 인스턴스가 us-west-2 지역에서 실행되고, 계정 번호는 867530990073이고, CMK 키는 1abc23de-fg45-6hij-7k89-1l0mn1234567인 경우 명령은 다음과 같습니다. `tsm security kms set-mode aws --aws-region "us-west-2" --key-arn "arn:aws:kms:us-west-2:867530990073:key/1abc23de-fg45-6hij-7k89-1l0mn1234567"` ### 4단계: 저장된 암호화 사용 [저장된 추출 암호화](https://help.tableau.com/current/server/ko-kr/security_ear.htm)를 참조하십시오. ### 5단계: 설치 유효성 검사 1. 다음 명령을 실행합니다. `tsm security kms status` 다음과 같은 정보가 반환될 수 있습니다. - 고객 마스터 키(CMK)의 ARN(ID) - CMK가 존재하는 지역 - 사용 중인 루트 마스터 키(RMK)의 ID RMK는 CMK로 암호화된 키입니다. Tableau Server는 AWS KMS를 호출하여 CMK를 암호 해독합니다. 그런 다음 RMK를 사용하여 마스터 추출 키(MEK)를 암호화/암호 해독합니다. RMK는 변경할 수 있지만 한 번에 하나만 존재할 수 있습니다. - KMS는 마스터 추출 키(MEK) 모음을 저장합니다. 각 MEK에는 다음과 같은 정보가 포함됩니다. - ID(예: 8ddd70df-be67-4dbf-9c35-1f0aa2421521) - “encrypt or decrypt key”(키 암호화 또는 암호 해독) 또는 “decrypt-only key”(키 암호 해독만) 상태 키가 "encrypt or decrypt"(암호화 또는 암호 해독) 상태인 경우 Tableau Server는 키를 사용하여 새 데이터를 암호화합니다. 그렇지 않으면 키는 암호 해독에만 사용됩니다. - 만든 시점의 타임스탬프(예: "Created at: 2019-05-29T23:46:54Z") - 암호화 및 암호 해독 키로의 첫 번째 전환: 키가 암호화 또는 암호 해독 키가 된 시간을 나타내는 타임스탬프입니다. - 암호 해독 전용 키로 전환: 키가 암호 해독 전용으로 전환된 시간을 나타내는 타임스탬프입니다. 2. 추출 암호화 및 암호 해독 후 로그 보기: - 추출을 사이트에 게시한 다음 암호화합니다. [저장된 추출 암호화](https://help.tableau.com/current/server/ko-kr/security_ear.htm)를 참조하십시오. - Tableau Desktop을 사용하거나 브라우저에서 웹 작성을 사용하여 추출에 액세스합니다(사용할 추출이 암호 해독됨). - vizqlserver\_node 로그 파일에서 `AwsKmsEncryptionEnvelopeAccessor` 및 `AwsKmsEncryptionEnvelope` 문자열을 검색합니다. 로그의 기본 위치는 `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs`입니다. 성공적인 구성을 나타내는 로그 항목 예제에는 다음이 포함됩니다. - Decrypted the RMK with ID 1abc23de-fg45-6hij-7k89-1l0mn1234567 using the CMK with ARN arn:aws:kms:us-west-2:867530990073:key/1234567d-a6ba-451b-adf6-3179911b760f - Using RMK with ID 1abc23de-fg45-6hij-7k89-1l0mn1234567 to decrypt KMS store KMS와 관련된 게시 및 추출 새로 고침에 대해서는 백그라운더 로그를 검색합니다. 로그에 대한 자세한 내용은 [Tableau Server 로그 및 로그 파일 위치](https://help.tableau.com/current/server/ko-kr/logs_loc.htm)를 참조하십시오. ## 구성 문제 해결 ### 잘못된 다중 노드 구성 AWS KMS의 다중 노드 설정에서는 클러스터의 다른 노드가 잘못 구성된 경우에도 `tsm security kms status` 명령이 정상(OK) 상태를 보고할 수 있습니다. KMS 상태 검사는 Tableau Server 관리 컨트롤러 프로세스가 실행되고 있는 노드에 대해서만 보고하고 클러스터의 다른 노드에 대해서는 보고하지 않습니다. 기본적으로 Tableau Server 관리 컨트롤러 프로세스는 클러스터의 초기 노드에서 실행됩니다. 따라서 다른 노드가 잘못 구성되어 Tableau Server가 AWS CMK에 액세스할 수 없는 경우 이러한 노드는 시작될 수 없는 다양한 서비스에 대한 오류 상태를 보고할 수 있습니다. KMS를 AWS 모드로 설정한 후 일부 서비스가 시작되지 않는 경우 `tsm security kms set-mode local` 명령을 실행하여 로컬 모드로 되돌리십시오. ## AWS CMK 새로 고침 AWS CMK 새로 고침은 AWS로 수행하는 작업입니다. 기본적으로 AWS CMK는 1년에 한 번 새로 고쳐집니다. 자세한 내용은 AWS 항목 [자동 키 교체의 작동 방식](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html#rotate-keys-how-it-works)을 참조하십시오. ARN 및 지역은 변경되지 않으므로 일반적인 CMK 새로 고침 시나리오의 경우 Tableau Server에서 KMS 구성을 업데이트할 필요가 없습니다. AWS CMK가 새로 고쳐진 후 Tableau Server에서 내부 RMK 및 MEK를 다시 생성해야 합니다. 또한 모든 추출을 새 CMK로 다시 암호화해야 합니다. 1. `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/ko-kr/cli_security_tsm.htm#regenerate-tokens)` 명령을 실행하여 추출 암호화에 사용되는 RMK 및 MEK를 포함하여 Tableau Server의 모든 내부 키를 다시 생성하십시오. 2. 주어진 사이트의 추출을 다시 암호화하려면 `tabcmd reencryptextracts `을 실행하십시오. 암호화된 추출을 저장하는 모든 사이트에서 이 명령을 실행합니다. 사이트의 암호화된 추출 수에 따라 이 작업은 상당한 서버 처리 로드를 사용할 수 있습니다. 이 작업은 업무 시간이 아닐 때 실행하는 것이 좋습니다. [저장된 추출 암호화](https://help.tableau.com/current/server/ko-kr/security_ear.htm)를 참조하십시오. ## Tableau Server에서 RMK 및 MEK 다시 생성 Tableau Server에서 루트 마스터 키와 마스터 암호화 키를 다시 생성하려면 `[tsm security regenerate-internal-tokens](https://help.tableau.com/current/server/ko-kr/cli_security_tsm.htm#regenerate-tokens)` 명령을 실행합니다. ## AWS KMS를 사용한 백업 및 복원 추가 구성이나 절차 없이 AWS 모드에서 서버 백업을 수행할 수 있습니다. 백업에는 RMK 및 MEK의 암호화된 복사본이 포함됩니다. 키를 암호 해독하려면 AWS CMK의 액세스 권한과 컨트롤이 필요합니다. 복원 시나리오의 경우 복원 대상 서버는 로컬을 포함하여 KMS 모드 중 하나일 수 있습니다. 유일한 요구 사항은 백업이 복원될 서버에 백업 자체가 사용한 CMK에 대한 암호 해독 액세스 권한이 있어야 한다는 것입니다. 복원 시 백업의 MEK는 암호 해독 전용 키로 가져옵니다. RMK는 마이그레이션되지 않습니다. 새 RMK는 설치/복원 프로세스의 일부로 생성됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # AWS 토폴로지 기반 Tableau Server ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 AWS에 Tableau Server를 배포할 때 Amazon EC2 인스턴스에서 Tableau Desktop과 Tableau Server 간의 통합 수준 및 정도를 선택할 수 있습니다. Tableau Desktop과 데이터 원본에서 데이터를 추출하는 Tableau Desktop 기능을 사용하여 데이터와 Tableau Server 사이를 연결하는 역할로 사용할 수 있습니다. 필요에 따라 또는 AWS 클라우드에 이미 많은 양의 데이터가 있는 경우 Tableau Server와 함께 전체 범위의 AWS 서비스를 활용하도록 선택할 수 있습니다. 다음 다이어그램에서는 Tableau Desktop 및 Tableau Server와의 데이터 원본 통합을 보여 줍니다. ![Tableau Desktop과 클라우드 기반 가상 컴퓨터를 통해 원시 데이터에서 사용자 액세스까지의 데이터 변환 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_cloud_topology.png) 다음 다이어그램에서 모든 데이터는 AWS에서 호스팅됩니다. 안전하고 확장 가능한 방식으로 관리되는 구조화 데이터 및 비구조화 데이터를 모두 분석할 수 있습니다. AWS에만 있는 데이터, AWS 외부에 있는 관리되지 않는 데이터 또는 이 둘의 조합을 활용할 수 있습니다. 두 유형의 데이터가 동일하게 지원되므로, 이러한 유연성은 온프레미스 데이터에서 클라우드로의 이동을 지원하는 조직의 역량을 크게 향상시킵니다. ![AWS의 데이터를 사용하여 데이터 수집, 저장, 분석 및 시각화 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_aws_data_sources.png) [주요 콘텐츠로 건너뛰기](#main-content) # Azure Key Vault Tableau Server에는 저장 시 암호화를 사용하도록 설정할 수 있는 3개의 KMS(키 관리 시스템) 옵션이 있습니다. 2개 시스템에는 Advanced Management 기능이 필요하고 로컬 시스템은 Tableau Server의 모든 설치를 통해 제공됩니다. **중요:** 2024년 9월 16일부터 Advanced Management는 더 이상 독립 Add-On 옵션으로 사용할 수 없습니다. Advanced Management 기능은 이전에 Advanced Management를 구매한 경우에만 사용할 수 있으며, Tableau Enterprise, Tableau Cloud+ 또는 Tableau+ Bundle(Tableau Cloud에 사용 가능) 또는 Tableau Enterprise 또는 Tableau Server+(Tableau Server에 사용 가능)와 같은 특정 라이선스 버전을 구매한 경우에만 사용할 수 있습니다. 버전 2019.3부터 Tableau Server에는 다음과 같은 KMS 옵션이 추가되었습니다.  - 모든 설치를 통해 제공되는 로컬 KMS. 자세한 내용은 [Tableau Server 키 관리 시스템](https://help.tableau.com/current/server/ko-kr/security_kms.htm)을 참조하십시오. - Advanced Management의 일부로 제공되는 AWS 기반 KMS. 자세한 내용은 [AWS 키 관리 시스템](https://help.tableau.com/current/server/ko-kr/security_kms_aws.htm)을 참조하십시오. 버전 2021.1부터 Tableau Server에는 다른 KMS 옵션이 추가되었습니다.  - Advanced Management의 일부로 제공되는 Azure 기반 KMS. 아래에 설명되어 있습니다. ## 저장 시 암호화를 위한 Azure Key Vault 버전 2021.1.0부터 Tableau Server에서 Advanced Management의 일부로 Azure Key Vault를 사용할 수 있습니다. 자세한 내용은 [Tableau Server의 Tableau Advanced Management 정보](https://help.tableau.com/current/server/ko-kr/itm_intro.htm)를 참조하십시오. 조직에서 저장된 추출 암호화를 사용하여 데이터를 배포하는 경우 선택적으로 추출 암호화를 위한 KMS로 Azure Key Vault를 사용하도록 Tableau Server를 구성할 수 있습니다. Azure Key Vault를 사용하려면 Azure에 Tableau Server를 배포해야 합니다. Azure 시나리오에서 Tableau Server는 Azure Key Vault를 사용하여 모든 암호화된 추출의 RMK(루트 마스터 키)를 암호화합니다. 그러나 Azure Key Vault용으로 구성된 경우에도 Tableau Server 원시 Java 키 저장소와 로컬 KMS는 여전히 Tableau Server에서 암호의 보안 저장소로 사용됩니다. Azure Key Vault는 암호화된 추출에 대한 루트 마스터 키를 암호화하는 데에만 사용됩니다. ![데이터 암호화에 사용되는 다양한 키를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/security_kms_azure_hierarchy.png) Tableau Server가 Azure Key Vault로 구성된 경우 키 계층 구조 ## Tableau Server의 암호화된 추출에 대한 Azure Key Vault 구성 Azure Key Vault를 사용하여 Tableau Server KMS 계층 구조의 루트 키를 암호화하려면 이 섹션에 설명된 대로 Tableau Server를 구성해야 합니다. 시작하기 전에 다음 요구 사항을 충족하는지 확인하십시오. - Tableau Server가 Azure에 배포되어야 합니다. - Tableau Server가 Advanced Management 라이선스로 구성되어야 합니다. [Tableau Server의 Tableau Advanced Management 정보](https://help.tableau.com/current/server/ko-kr/itm_intro.htm) 항목을 참조하십시오. - 키가 상주하는 Azure의 키 자격 증명 모음에 대한 관리 제어 권한이 있어야 합니다. ### 1단계: Azure에서 Tableau Server의 키 자격 증명 모음 및 키 만들기 다음 절차는 Azure Key Vault 서비스에서 수행됩니다. 참조 자료는 Azure 설명서에 포함되어 있습니다. 1. Tableau Server에 사용할 키 자격 증명 모음을 만듭니다. Azure 항목 [키 자격 증명 모음 만들기](https://docs.microsoft.com/ko-kr/azure-stack/user/azure-stack-key-vault-manage-portal?view=azs-2008#create-a-key-vault)를 참조하십시오. 2. 자격 증명 모음에 키를 만듭니다. Azure 항목 [키 및 암호 관리](https://docs.microsoft.com/ko-kr/azure-stack/user/azure-stack-key-vault-manage-portal?view=azs-2008)를 참조하십시오. 키는 비대칭 RSA 유형이어야 하지만 크기에는 제한이 없습니다(Tableau Server는 키 크기를 개의치 않음). 최소 권한의 원칙을 사용하여 보안을 최대화하는 것이 좋습니다. Tableau에는 GET, UNWRAP KEY 및 WRAP KEY 명령 작업을 수행할 수 있는 권한이 필요하며 최소 권한을 위해 이러한 작업에 대한 액세스만 허용하는 것이 좋습니다. Tableau Server를 실행하는 VM에 액세스 정책을 할당합니다. Tableau Server의 다중 노드 배포에서는 서버 클러스터의 모든 노드에 액세스 정책을 할당해야 합니다. ### 2단계: Azure 구성 매개 변수 수집 Azure의 키 자격 증명 모음 이름과 키 이름이 필요합니다. ### 3단계: Azure Key Vault에 대한 Tableau Server 구성 Tableau Server에서 다음 명령을 실행합니다. 이 명령은 서버를 다시 시작합니다. - ``` tsm security kms set-mode azure --vault-name "" --key-name "" ``` `--vault-name` 및 `--key-name` 옵션은 Azure 키 자격 증명 모음의 문자열을 직접 복사합니다. 예를 들어 Azure 키 자격 증명 모음 이름이 `tabsrv-keyvault`이고 키가 `tabsrv-sandbox-key01`인 경우 명령은 다음과 같습니다. `tsm security kms set-mode azure --vault-name "tabsrv-keyvault" --key-name "tabsrv-sandbox-key01"` ### 4단계: 저장된 암호화 사용 자세한 내용은 [저장된 추출 암호화](security_ear.htm)를 참조하십시오. ### 5단계: 설치 유효성 검사 1. 다음 명령을 실행합니다. `[tsm security kms status](cli_security_tsm.htm#kms-status)` 다음과 같은 정보가 반환될 수 있습니다. - 상태: OK(컨트롤러 노드에서 Key Vault에 액세스할 수 있음을 나타냄) - Mode: Azure Key Vault - 자격 증명 모음 이름: - Azure Key Vault 키 이름:  - 활성 키를 나타내는 MEK의 사용 가능한 UUID 목록 - KMS 데이터에 액세스할 수 없는 경우 오류 정보 2. 추출 암호화 및 암호 해독 후 로그 보기: - 추출을 사이트에 게시한 다음 암호화합니다. [저장된 추출 암호화](security_ear.htm)를 참조하십시오. - Tableau Desktop을 사용하거나 브라우저에서 웹 작성을 사용하여 추출에 액세스합니다(사용할 추출이 암호 해독됨). - vizqlserver\_node 로그 파일에서 `AzureKeyVaultEnvelopeAccessor` 및 `AzureKeyVaultEnvelope` 문자열을 검색합니다. 로그의 기본 위치는 `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs`입니다. Azure Key Vault와 관련된 게시 및 추출 새로 고침에 대해서는 백그라운더 로그를 검색합니다. 로그에 대한 자세한 내용은 [Tableau Server 로그 및 로그 파일 위치](logs_loc.htm)를 참조하십시오. ## 구성 문제 해결 ### 잘못된 다중 노드 구성 Azure Key Vault의 다중 노드 설정에서는 클러스터의 다른 노드가 잘못 구성된 경우에도 `tsm security kms status` 명령이 정상(OK) 상태를 보고할 수 있습니다. KMS 상태 검사는 Tableau Server 관리 컨트롤러 프로세스가 실행되고 있는 노드에 대해서만 보고합니다. 클러스터의 다른 노드에 대해서는 보고하지 않습니다. 기본적으로 Tableau Server 관리 컨트롤러 프로세스는 클러스터의 초기 노드에서 실행됩니다. 따라서 다른 노드가 잘못 구성되어 Tableau Server가 Azure 키에 액세스할 수 없는 경우 이러한 노드는 시작될 수 없는 다양한 서비스에 대한 오류 상태를 보고할 수 있습니다. KMS를 "azure" 모드로 설정한 후 일부 서비스가 시작되지 않는 경우 `tsm security kms set-mode local` 명령을 실행하여 로컬 모드로 되돌리십시오. ## Azure 키 새로 고침 Azure에서 Azure 키를 새로 고칩니다. 필수 또는 예정된 키 새로 고침 기간은 없습니다. Azure에서 새 키 버전을 만들어 키를 새로 고칠 수 있습니다. Key Vault 이름과 키 이름은 변경되지 않으므로 일반적인 Azure 키 새로 고침 시나리오의 경우 Tableau Server에서 KMS 구성을 업데이트할 필요가 없습니다. ## Azure Key Vault를 사용한 백업 및 복원 추가 구성이나 절차 없이 Azure Key Vault 모드에서 서버 백업을 수행할 수 있습니다. 백업에는 RMK 및 MEK의 암호화된 복사본이 포함됩니다. 키를 암호 해독하려면 Azure Key Vault의 액세스 권한과 컨트롤이 필요합니다. 복원 시나리오의 경우 복원 대상 서버는 Azure Key Vault 또는 로컬 KMS 모드 중 하나일 수 있습니다. 유일한 요구 사항은 백업이 복원될 서버에 백업 자체가 사용한 Azure Key Vault에 대한 액세스 권한이 있어야 한다는 것입니다. [주요 콘텐츠로 건너뛰기](#main-content) # Azure에서 Azure 데이터베이스 PostgreSQL 인스턴스 만들기 버전 2020.4부터 Azure 클라우드 플랫폼에서 외부 리포지토리를 호스팅할 수 있습니다. 이 항목에서는 Tableau Server 외부 리포지토리로 사용할 PostgreSQL용 Azure 데이터베이스 인스턴스를 만드는 방법에 대해 설명합니다. ## 요구 사항 및 권장 사항 - Tableau Server 외부 리포지토리를 위한 50GB의 저장소가 있는 8개 vCore 메모리 최적화 서버를 사용하는 것이 좋지만 정확한 요구 사항은 사용자 요구 사항 및 사용량에 따라 다릅니다. Tableau Server가 이미 있는 경우 기존 리포지토리의 사용량을 검토하여 저장소 요구량을 결정하십시오. 더 많은 저장소가 필요한 경우 리소스를 확장할 수도 있습니다. 자세한 내용은 [PostgreSQL Azure 데이터베이스 리소스 확장(영문)](https://docs.microsoft.com/en-us/azure/postgresql/concepts-pricing-tiers#scale-resources)을 참조하십시오. - Tableau Server와 외부 PostgreSQL DB 인스턴스 사이에 SSL을 사용하는 보안 통신이 권장되지만 요구 사항은 아닙니다. Tableau Server와 외부 리포지토리 간에 보안 연결을 사용하지 않으려는 경우 암호화되지 않은 연결을 허용하도록 Azure 데이터베이스를 구성해야 합니다. - Tableau Server 클러스터의 모든 노드가 PostgreSQL DB 인스턴스에 연결할 수 있어야 합니다. 모든 Tableau Server 노드의 연결을 허용하도록 데이터베이스 인스턴스를 설정해야 합니다. 이렇게 설정하는 방법은 두 가지입니다. - 가장 안전한 방법: 가상 네트워크 서비스 끝점을 통한 비공개 액세스만 허용하도록 PostgreSQL용 Azure 데이터베이스 인스턴스를 구성합니다. 자세한 내용은 [PostgreSQL용 Azure 데이터베이스에 가상 네트워크 서비스 끝점 및 규칙 사용(영문)](https://docs.microsoft.com/en-us/azure/postgresql/concepts-data-access-and-security-vnet) 및 [VNet 서비스 끝점 만들기 및 관리(영문)](https://docs.microsoft.com/en-us/azure/postgresql/howto-manage-vnet-using-portal)를 참조하십시오. Azure 가상 네트워크에 대한 [개요 항목](https://docs.microsoft.com/ko-kr/azure/virtual-network/virtual-networks-overview)을 검토할 수도 있습니다. - 또는 다양한 공개 IP 주소의 연결을 허용하도록 PostgreSQL용 Azure 데이터베이스를 구성할 수 있습니다. 이 방법은 Azure 데이터베이스 끝점을 인터넷의 공개 액세스에 노출합니다. - Azure 데이터베이스 인스턴스를 설정할 때 관리자 사용자 이름으로 **postgres**를 사용하는 것이 좋습니다. 다른 사용자 이름을 사용하도록 선택하는 경우 사용자 이름이 **pg** 또는 **azure**로 시작하지 않는지 확인하십시오. 또한 사용자 이름으로 **rails**, **tblwgadmin**, **tableau**, **readonly** 또는 **tbladminviews**를 사용할 수 없습니다. - PostgreSQL의 버전은 로컬로 설치할 때 Tableau Server에서 사용하는 버전과 일치해야 합니다. Tableau Server 버전과 호환되는 PostgreSQL 버전의 전체 목록은 [제품 호환성](https://help.tableau.com/current/server/ko-kr/server_external_repo_upgrade_postgres.htm#postgres-ts-compat)을 참조하십시오. - Tableau는 내부 데이터베이스 사용자가 내부에서 사용할 비밀번호를 자동으로 생성합니다. 이러한 비밀번호는 32자 길이이며 소문자와 숫자로 구성됩니다. 관리자가 액세스하거나 구성할 수 없습니다. 외부 PostgreSQL 인스턴스의 경우 관리자가 비밀번호 정책을 설정할 수 있습니다(사용 중인 플랫폼에 따라 다름). 숫자 및 소문자 이외의 문자 유형을 포함하는 정책을 지정하면 외부 리포지토리를 사용하도록 Tableau Server를 구성하는 동안 오류가 발생할 수 있습니다. ## Azure에서 데이터베이스 PostgreSQL 인스턴스 만들기 ### 1단계: PostgreSQL용 Azure 데이터베이스 인스턴스에 대한 위임된 서브넷 만들기 이 단계는 인스턴스를 만들 때 네트워킹 옵션으로 비공개 액세스를 설정하기 위한 필수 요건입니다. 보안 통신을 위해서는 데이터베이스에 대한 비공개 액세스를 설정하는 것이 필수입니다. 이렇게 하면 해당 가상 네트워크의 모든 위치에서 만드는 가상 컴퓨터가 데이터베이스 인스턴스에 연결할 수 있지만 가상 네트워크 외부에서는 연결할 수 없습니다. 현재 Tableau Server를 호스팅하는 동일한 가상 네트워크에서 Azure 데이터베이스 인스턴스에 대한 새 위임된 서브넷을 만듭니다. 비공개 액세스 설정에 대한 자세한 내용은 Azure 웹 사이트에서 [PostgreSQL - Flexible Server용 Azure 데이터베이스의 네트워킹 옵션(영문)](https://docs.microsoft.com/en-us/azure/postgresql/flexible-server/concepts-networking#private-access-vnet-integration)을 참조하십시오. ### 2단계: PostgreSQL용 Azure 데이터베이스 인스턴스 만들기 새 PostgreSQL용 Azure 데이터베이스를 만들려면 [Azure 설명서 사이트](https://docs.microsoft.com/en-us/azure/postgresql/flexible-server/quickstart-create-server-portal)에 제공된 지침을 따르십시오. 다음은 새 PostgreSQL DB 인스턴스에 대한 구성 옵션과 필수 값 및 권장 사항입니다. - **Server Details(서버 세부 정보)** - 새 서버를 작성하려면 Data source(데이터 원본)로 None(없음)을 지정합니다. - Admin user name(관리자 사용자 이름)의 경우 **postgres**를 관리자 사용자 이름으로 사용하는 것이 좋습니다. 다른 사용자 이름을 사용하도록 선택하는 경우 사용자 이름이 **pg** 또는 **azure**로 시작하지 않는지 확인하십시오. 또한 사용자 이름으로 **rails**, **tblwgadmin**, **tableau**, **readonly** 또는 **tbladminviews**를 사용할 수 없습니다. - Azure의 요구 사항을 충족하는 비밀번호를 선택합니다. - 사용 중인 Tableau Server 버전의 호환되는 PostgreSQL 버전을 사용합니다. Tableau Server 버전과 호환되는 PostgreSQL 버전의 전체 목록은 [제품 호환성](https://help.tableau.com/current/server/ko-kr/server_external_repo_upgrade_postgres.htm#postgres-ts-compat)을 참조하십시오. - 최소 512GB의 저장소를 할당합니다. - Azure Database for PostgreSQL의 'azure\_pg\_admin' 사용자는 uuid-ossp 및 unaccent 확장 프로그램을 사용하도록 허용해야 합니다. - **Compute and Storage(컴퓨팅 및 저장소)** - 최소한 General Purpose(범용) 컴퓨터 계층 및 Standard\_D8s\_v3(8개 vCore, 32GB RAM) 컴퓨팅 크기를 포함하는 Flexible Server를 사용합니다. - **네트워크 옵션** - Private Access (Virtual Network)(비공개 액세스(가상 네트워크))를 선택합니다. 이렇게 하면 데이터베이스에 대한 비공개 보안 통신이 보장됩니다. - High availability(고가용성) - 요구 사항에 따라 고가용성 옵션을 사용하도록 설정합니다. - **Backup(백업)** - 요구 사항에 따라 보존 기간을 설정합니다. 이것은 Tableau Server의 백업이 아니라 Azure의 자동화된 백업을 위한 것입니다. 요구 사항을 충족하는 설정을 지정할 수 있습니다. ### 3단계: 서버 수준 방화벽 규칙 구성 데이터베이스가 만들어지면 Tableau Server 노드에 대한 액세스를 허용하도록 서버 수준 방화벽 규칙을 구성합니다. 모든 Tableau Server 노드에서 1단계에서 설명한 전용 서브넷을 사용하여 데이터베이스 인스턴스에 연결할 수 있는지 확인하십시오. ### 4단계: PostgreSQL용 Azure 데이터베이스 인스턴스 구성 Tableau Server 수준에서 인스턴스에 대한 대부분의 매개 변수 값을 기본값으로 설정할 수 있습니다. 특정 성능 또는 로깅 요구 사항이 있는 경우 매개 변수 값을 수정할 수 있지만 다음 매개 변수를 기본값으로 두고 변경하지 않는 것이 좋습니다. - `standard_conforming_strings` - `escape_string_warning` 또한 성능 문제를 방지하기 위해 `work_mem` 값을 16384 이상으로 설정하는 것이 좋습니다. 서버 매개 변수를 구성하는 방법에 대한 자세한 내용은 이 [Azure 설명서](https://docs.microsoft.com/en-us/azure/postgresql/howto-configure-server-parameters-using-portal#viewing-and-editing-parameters)를 참조하십시오. ### 5단계: PostgresSQL DB 인스턴스 끝점 가져오기 인스턴스가 준비되면 Tableau Server 리포지토리에 이 인스턴스를 사용하도록 Tableau Server를 구성하는 데 사용할 끝점 정보를 가져옵니다. ### 6단계: SSL 인증서 파일 다운로드 Tableau Server와 외부 리포지토리 간의 SSL을 사용한 보안 통신은 필수는 **아니지만** 권장됩니다. Tableau Server와 외부 리포지토리 간의 보안 연결을 설정하려면 인증서 파일을 다운로드합니다. 이 외부 리포지토리를 사용하도록 Tableau Server를 구성하려면 이 인증서 파일이 필요합니다. 자세한 내용은 [PostgreSQL용 Azure 데이터베이스에 대한 TLS 연결 구성(영문)](https://docs.microsoft.com/ko-kr/azure/postgresql/concepts-ssl-connection-security)을 참조하십시오. Tableau Server와 외부 리포지토리 간에 보안 연결을 사용할 필요가 없는 경우 암호화되지 않은 연결을 허용하도록 Azure 데이터베이스 인스턴스를 구성합니다. ## PostgreSQL DB의 고가용성 구성 Tableau Server는 외부 리포지토리에 대한 고가용성을 관리하거나 설정하지 않습니다. Azure는 고가용성을 제공하는 데 사용할 수 있는 고가용성 기능을 제공합니다. 자세한 내용은 [Azure 데이터베이스 고가용성(영문)](https://docs.microsoft.com/en-us/azure/postgresql/concepts-hyperscale-high-availability)을 참조하십시오. ## PostgreSQL DB의 재해 복구 재해가 발생한 경우 새 PostgreSQL용 Azure 데이터베이스 인스턴스를 설치해야 할 수 있습니다. 또한 데이터베이스 인스턴스 관련 문제에서 복구하려면 다른 시나리오가 필요할 수 있습니다. 이와 같은 시나리오에서 Tableau Server를 새 Azure 데이터베이스 인스턴스를 사용하도록 구성하려면 다음 단계를 따릅니다. 1. **새 Azure 데이터베이스 인스턴스로 백업을 복원합니다.** PostgresQL용 Azure 데이터베이스에서 복원을 수행하면 원래 서버의 백업에서 새 서버가 만들어집니다. PostgreSQL용 Azure 데이터베이스 백업 및 복원에 대한 자세한 내용은 [PostgreSQL용 Azure 데이터베이스 백업 및 복원(영문)](https://docs.microsoft.com/en-us/azure/postgresql/concepts-backup)을 참조하십시오. 2. 새 PostgreSQL용 Azure 데이터베이스 인스턴스에 대한 연결 정보를 포함하는 **새 JSON 설정 파일을 만듭니다**. JSON 설정 파일 만들기에 대한 자세한 내용은 [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm)의 **1단계**를 참조하십시오. 3. `tsm topology external-services repository replace-host` **명령**을 사용하여 Tableau Server를 새 PostgreSQL용 Azure 데이터베이스 인스턴스를 가리키도록 설정합니다. `tsm topology external-services repository replace-host` 명령에 대한 자세한 내용은 [tsm topology](https://help.tableau.com/current/server/ko-kr/cli_topology_tsm.htm)를 참조하십시오. ## 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자만 Tableau Server를 외부 리포지토리를 사용하도록 구성할 수 있습니다. 또한 Azure 데이터베이스를 만들기 위한 Azure 계정이 필요합니다. ## 다음 단계 새 설치: [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm) 외부 리포지토리를 사용하도록 기존 Tableau Server를 구성하려면 [Tableau Server 리포지토리 다시 구성](https://help.tableau.com/current/server/ko-kr/server_external_repo_reconfigure.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Content Migration Tool 명령줄 인터페이스 사용 Tableau Content Migration Tool의 설치 폴더에는 명령줄 인터페이스인 `tabcmt.cmd`가 있습니다. 기본 설치 폴더는 `%PROGRAMFILES%\Tableau\Tableau Content Migration Tool`(32비트 Windows) 또는 `%PROGRAMFILES(x86)%\Tableau\Tableau Content Migration Tool`(64비트 Windows)입니다. **참고:** `tabcmt.cmd` 유틸리티는 Content Migration Tool 콘솔 실행기인 `tabcmt-runner.exe`와 다른 것입니다. 콘솔 실행기는 명령줄에서 마이그레이션을 실행하는 데 사용되는 별도의 명령줄 유틸리티입니다. Content Migration Tool 콘솔 실행기에 대한 자세한 내용은 [Tableau Content Migration Tool 콘솔 실행기 사용](https://help.tableau.com/current/server/ko-kr/cmt-deployment_console_runner.htm)을 참조하십시오. 다음은 `tabcmt` 명령줄에서 사용할 수 있는 명령입니다. - [migrate](#migrate) - [help](#help) - [update](#update) - [version](#version) ## migrate 마이그레이션 계획 파일을 GUI의 마이그레이션 단계로 엽니다. tabcmt migrate ## help 명령줄 인터페이스와 사용 가능한 명령에 대한 일반적인 도움말을 표시합니다. ### 예 사용 가능한 모든 명령을 표시합니다. tabcmt help 특정 명령에 대한 도움말 및 사용 정보를 표시합니다. tabcmt help ## license 2022년 7월부터 사용 중단되었습니다. 이 명령은 레거시 라이선스에만 적용할 수 있습니다. 현재 사용자의 응용 프로그램 라이선스를 관리합니다. ### 예 현재 라이선스 정보를 표시합니다. tabcmt license 현재 라이선스를 제거/비활성화합니다. edt license remove 일련 키 또는 오프라인 라이선스 키를 설정/활성화합니다. tabcmt license 라이선스 파일 사용을 설정/활성화합니다. tabcmt license \[--passphrase=\] ## update 응용 프로그램 업데이트에 대한 옵션을 관리합니다. ### 예 현재 업데이트 설정을 표시합니다. tabcmt update 자동 업데이트 알림을 사용하거나 사용하지 않도록 설정합니다. tabcmt update --disabled= 업데이트를 검색하고 다운로드할 URL을 설정합니다. tabcmt update --url= 베타 업데이트 표시를 사용하거나 사용하지 않도록 설정합니다. false로 설정하면 안정된 릴리스 업데이트만 표시됩니다. tabcmt update --beta= ## version 현재 응용 프로그램 버전 정보를 표시합니다. tabcmt version ## 이 작업을 수행할 수 있는 사용자 명령줄 인터페이스를 사용하려면 다음이 모두 필요합니다. - Content Migration Tool 컴퓨터에 대한 관리자 사용 권한 - Explorer 이상의 역할이 있는 Tableau 사이트 사용자 계정 - 원본 사이트에 대한 통합 문서 보기 및 다운로드/복사본 저장 사용 권한 - 대상 사이트에 대한 게시 권한 [주요 콘텐츠로 건너뛰기](#main-content) # Creator: 웹에서 데이터에 연결 통합 문서를 만들고 웹에서 뷰를 작성하여 웹의 데이터를 분석하려면 먼저 데이터에 연결해야 합니다. Tableau에서는 Tableau Desktop을 통해 게시된 웹의 데이터 원본 연결이나 Tableau Cloud, Tableau Server 또는 Tableau Public을 통한 직접 데이터 연결을 지원합니다. 2019.3부터 Tableau Server 및 Tableau Cloud에서 Data Management 제공의 일부로 Tableau Catalog를 사용할 수 있습니다. 환경에서 Tableau Catalog를 사용하는 경우 탐색에서 데이터를 탐색하고 연결할 수 있을 뿐 아니라 Tableau Catalog에서 데이터베이스 및 테이블과 같은 더 많은 종류의 데이터를 탐색하고 연결할 수 있습니다. Tableau Catalog에 대한 자세한 내용은 [Tableau Server](https://help.tableau.com/current/server/ko-kr/dm_catalog_overview.htm) 또는 [Tableau Cloud](https://help.tableau.com/current/online/ko-kr/dm_catalog_overview.htm) 도움말에서 "Tableau Catalog 정보"를 참조하십시오. 2021.4부터 Data Management에 가상 연결(데이터에 대한 중앙 액세스 지점)이 포함됩니다. 자세한 내용은 [Tableau Server](https://help.tableau.com/current/server/ko-kr/dm_vconn_overview.htm) 또는 [Tableau Cloud](https://help.tableau.com/current/online/ko-kr/dm_vconn_overview.htm) 도움말에서 "가상 연결 및 데이터 정책 정보"를 참조하십시오. ## 데이터에 연결 페이지 열기 웹에서 데이터에 연결 페이지를 사용하여 연결할 데이터에 액세스합니다. Tableau Server 또는 Tableau Cloud에 로그인한 후 두 가지 방법으로 이 페이지를 열 수 있습니다. - 홈\> 새로 만들기 > 통합 문서 - 탐색 > 새로 만들기 > 통합 문서 Tableau Public에 있는 경우 작성자 프로필에서 이 페이지를 열 수 있습니다. - 내 프로필 \> 비주얼리제이션 만들기 데이터에 연결 대화 상자에는 인기 있는 여러 콘텐츠의 스크롤 가능한 목록이 표시됩니다. Data Management 라이선스가 있는 경우 가상 연결을 사용하여 데이터에 연결할 수 있고, Data Management가 있고 Tableau Catalog를 사용하는 경우 데이터베이스, 파일 및 테이블과 같은 외부 자산에도 연결할 수 있습니다. 반응형 검색 필드에는 텍스트를 입력할 때 업데이트되는 제안 목록이 표시됩니다. 필터 검색에서는 데이터 유형, 인증 상태 또는 선택한 데이터 유형에 따른 기타 필터로 결과를 필터링할 수 있습니다. 예를 들어 일부 데이터 유형의 경우 태그, 연결 유형, 데이터 품질 경고 또는 기타 기준으로 필터링할 수 있습니다. 이전 버전의 대화 상자와 약간 다르게 작동하지만 전반적인 기능은 유사합니다. ![데이터 원본, 가상 연결, 데이터베이스 및 파일, 테이블에 연결하는 옵션을 사용하여 Tableau Cloud의 데이터에 연결합니다.](/tableau/current/ko-kr/server/ko-kr/Img/connect_to_data.png) 데이터에 연결 페이지에 표시되는 탭은 사용 중인 제품에 따라 달라집니다. Tableau Server에서는 이 사이트 기반, 파일 및 커넥터 탭 중에서 선택하여 데이터에 연결합니다. ### 이 사이트 기반 데이터에 연결 1. 이 사이트 기반을 선택하여 게시된 데이터 원본을 찾아보거나 검색합니다. 2. 이름 아래에서 데이터 원본을 선택하고 연결 단추를 클릭합니다. **참고:** Data Management가 있으면 데이터 원본에 연결할 수 있을 뿐 아니라 이 사이트 기반을 사용하여 가상 연결을 통해 데이터에 연결할 수 있습니다. Tableau Catalog를 사용하도록 설정한 경우 데이터베이스, 파일 및 테이블에도 연결할 수 있습니다. ### 파일에 연결 Tableau는 브라우저에서 직접 Excel, 텍스트 기반 데이터 원본(.xlsx, .csv, .tsv) 및 파일 하나만 필요한 공간 파일 형식(.kml, .geojson, .topojson, .json, Esri 모양 파일 및 .zip 형식으로 패키지된 Esri 파일 지리 데이터베이스)을 업로드하는 것을 지원합니다. 데이터에 연결 패널의 파일 탭에서 파일을 필드에 끌어 놓거나 컴퓨터에서 업로드를 클릭하여 해당 파일에 연결합니다. 업로드할 수 있는 최대 파일 크기는 1GB입니다. ### 커넥터 사용 커넥터 탭에서 클라우드 데이터베이스 또는 엔터프라이즈의 서버에 저장되어 있는 데이터에 연결할 수 있습니다. 사용자가 자신이 만든 각 데이터 연결에 대한 연결 정보를 제공해야 합니다. 예를 들어 대부분의 데이터 연결에서 서버 이름과 로그인 정보를 제공해야 합니다. Tableau를 각 커넥터 유형에 연결하여 데이터 원본을 설정하는 방법에 대한 자세한 내용은 [지원되는 커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/exampleconnections_overview.htm)를 참조하십시오. 필요한 커넥터가 ‘커넥터’ 탭에 나타나지 않는 경우 Tableau Desktop을 통해 데이터에 연결하고 웹 작성을 위해 Tableau Cloud 또는 Tableau Server에 데이터 원본을 게시할 수 있습니다. Tableau Desktop에서 [데이터 원본 게시](https://help.tableau.com/current/pro/desktop/ko-kr/publish_datasources.htm) 방법에 대해 자세히 알아보십시오. Tableau가 데이터에 연결되면 분석할 데이터를 준비하고 뷰를 작성할 수 있도록 데이터 원본 페이지가 열립니다. 자세히 알아보려면 [Creator: 웹에서 데이터 준비](https://help.tableau.com/current/pro/desktop/ko-kr/creator_data_prep.htm)를 참조하십시오. #### Tableau Server 커넥터

Actian Matrix*

Alibaba AnalyticDB for MySQL‡

Alibaba Data Lake Analytics‡

Alibaba MaxCompute‡

Amazon Athena‡

Amazon Aurora for MySQL‡

Amazon EMR Hadoop Hive‡

Amazon Redshift‡

Apache Drill‡

Aster Database*

Azure Data Lake Storage Gen2‡

Box‡

Cloudera Hadoop‡

Databricks‡

Datorama by Salesforce‡

Denodo‡

Dremio by Dremio‡

Dropbox‡

Esri 커넥터‡

Exasol‡

Google BigQuery**‡

Google BigQuery JDBC**‡

Google Cloud SQL‡

Google 드라이브‡

Impala‡

Kognito*

Kyvos‡

Hortonworks Hadoop Hive

IBM BigInsights

IBM DB2‡

IBM PDA(Netezza)*

Kyvos‡

MariaDB‡

MarkLogic*

Microsoft Azure SQL Database‡

Microsoft Azure Synapse Analytics‡

Microsoft SQL Server‡

MonetDB*

MongoDB BI Connector‡

MySQL‡

OData‡

OneDrive‡

Oracle‡

Pivotal Greenplum Database‡

PostgreSQL‡

Progress OpenEdge*

Presto‡

Qubole Presto‡

SAP HANA(가상 연결 전용)‡

SAP Sybase ASE*

SAP Sybase IQ*

Salesforce‡

SharePoint 목록‡

SingleStore(이전의 MemSQL)‡

Snowflake‡

Spark SQL‡

Teradata***‡

Vertica‡

\*Linux 서버에서는 사용할 수 없습니다. \*\*Google BigQuery는 웹에서 데이터 원본을 만들 때 OAuth가 필요합니다. 서버 관리자가 [Google에 대한 OAuth를 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_google.htm)할 수 있는 방법에 대해 알아보십시오. \*\*\*Teradata 웹 작성은 현재 쿼리 구간 설정 기능을 지원하지 않습니다. 자세한 내용은 [Teradata](https://help.tableau.com/current/pro/desktop/ko-kr/examples_teradata.htm)를 참조하십시오. ‡Data Management가 있는 경우 가상 연결을 지원합니다. 자세한 내용은 Tableau Server 도움말에서 [가상 연결 및 데이터 정책 정보](https://help.tableau.com/current/server/ko-kr/dm_vconn_overview.htm)를 참조하십시오. #### Tableau Catalog 지원되는 커넥터 Tableau Catalog는 Tableau Server가 지원하는 데이터 커넥터의 하위 집합에 대한 연결을 지원합니다. 데이터 원본, 데이터베이스, 파일 또는 테이블이 회색으로 표시되는 경우 Tableau Server에서 연결할 수 없습니다. 하지만 이 경우에도 올바른 사용 권한이 있다면 Tableau Desktop 연결 패널에서 연결할 수 있습니다. Tableau Cloud에서는 이 사이트 기반, 파일, 커넥터 및 대시보드 스타터 탭 중에서 선택하여 데이터에 연결합니다. ### 이 사이트 기반 데이터에 연결 1. 이 사이트 기반을 선택하여 게시된 데이터 원본을 찾아보거나 검색합니다. 2. 이름 아래에서 데이터 원본을 선택하고 연결 단추를 클릭합니다. **참고:** Data Management가 있으면 데이터 원본에 연결할 수 있을 뿐 아니라 이 사이트 기반을 사용하여 가상 연결을 통해 데이터에 연결할 수 있습니다. Tableau Catalog를 사용하도록 설정한 경우 데이터베이스, 파일 및 테이블에도 연결할 수 있습니다. ### 파일에 연결 Tableau에서는 브라우저에서 직접 Excel 또는 텍스트 기반 데이터 원본(.xlsx, .csv, .tsv)을 업로드할 수 있습니다. 데이터에 연결 패널의 파일 탭에서 Excel 또는 텍스트 파일을 필드에 끌어 놓거나 컴퓨터에서 업로드를 클릭하여 해당 파일에 연결합니다. 업로드할 수 있는 최대 파일 크기는 1GB입니다. ### 커넥터 사용 커넥터 탭에서 클라우드 데이터베이스 또는 엔터프라이즈의 서버에 저장되어 있는 데이터에 연결할 수 있습니다. 사용자가 자신이 만든 각 데이터 연결에 대한 연결 정보를 제공해야 합니다. 예를 들어 대부분의 데이터 연결에서 서버 이름과 로그인 정보를 제공해야 합니다. 커넥터를 사용하여 Tableau를 데이터에 연결하는 방법에 대한 자세한 내용은 [지원되는 커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/exampleconnections_overview.htm)를 참조하십시오. 필요한 커넥터가 ‘커넥터’ 탭에 나타나지 않는 경우 Tableau Desktop을 통해 데이터에 연결하고 웹 작성을 위해 Tableau Cloud 또는 Tableau Server에 데이터 원본을 게시할 수 있습니다. Tableau Desktop에서 [데이터 원본 게시](https://help.tableau.com/current/pro/desktop/ko-kr/publish_datasources.htm) 방법에 대해 자세히 알아보십시오. **참고**: Tableau Cloud에서 데이터에 연결할 수 없는 경우 데이터베이스에 공개적으로 액세스할 수 있는지 확인하십시오. Tableau Cloud는 공개 인터넷에서 액세스할 수 있는 데이터에만 연결할 수 있습니다. 데이터가 사설망 뒤에 있는 경우 Tableau Bridge를 사용하여 연결할 수 있습니다. 자세히 알아보려면 [게시자: Tableau Bridge를 사용하여 Tableau Cloud 데이터를 최신 상태로 유지](https://help.tableau.com/current/online/ko-kr/qs_refresh_local_data.htm)를 참조하십시오. #### Tableau Cloud 커넥터

Alibaba AnalyticsDB for MySQL‡

Alibaba Data Lake Analytics‡

Amazon Athena‡

Amazon Aurora for MySQL‡

Amazon EMR Hadoop Hive‡

Amazon Redshift‡

Apache Drill‡

Azure Data Lake Storage Gen2‡

Azure Synapse Analytics(SQL Server 호환)

Box‡

Cloudera Hadoop‡

Databricks‡

Datorama by Salesforce‡

Denodo‡

Dremio by Dremio‡

Dropbox*‡

Esri 커넥터‡

Exasol‡

Google BigQuery*‡

Google Cloud SQL(MySQL 호환)‡§

Google 드라이브‡

Hortonworks Hadoop Hive

Impala‡

Kyvos‡

MariaDB‡

Microsoft Azure SQL Database‡

Microsoft Azure Synapse Analytics‡

Microsoft SQL Server‡

MongoDB BI Connector‡

MySQL‡

OData‡

OneDrive*‡

Oracle‡

Pivotal Greenplum Database‡

PostgreSQL‡

Presto‡

Qubole Presto‡

Salesforce‡

SAP HANA(가상 연결 전용)‡

SharePoint 목록‡

SingleStore(이전의 MemSQL)‡

Snowflake‡

Spark SQL‡

Teradata**‡

Vertica‡

\*Tableau Cloud에서 Google BigQuery, OneDrive 및 Dropbox 연결에 대해 OAuth 2.0 표준을 사용하는 방법에 대한 자세한 내용은 [OAuth 연결](https://help.tableau.com/current/online/ko-kr/protected_auth.htm)을 참조하십시오. \*\*Teradata 웹 작성은 현재 쿼리 구간 설정 기능을 지원하지 않습니다. 자세한 내용은 [Teradata](https://help.tableau.com/current/pro/desktop/ko-kr/examples_teradata.htm)를 참조하십시오. ‡Data Management가 있는 경우 가상 연결을 지원합니다. 자세한 내용은 Tableau Cloud 도움말에서 [가상 연결 및 데이터 정책 정보](https://help.tableau.com/current/online/ko-kr/dm_vconn_overview.htm)를 참조하십시오. §Tableau Cloud는 Google Cloud SQL을 사용한 SSL을 지원하지 않습니다. #### Tableau Catalog 지원되는 커넥터 Tableau Catalog는 Tableau Cloud가 지원하는 데이터 커넥터의 하위 집합에 대한 연결을 지원합니다. 데이터 원본, 데이터베이스, 파일 또는 테이블이 회색으로 표시되는 경우 Tableau Cloud에서 연결할 수 없습니다. 하지만 이 경우에도 올바른 사용 권한이 있다면 Tableau Desktop 연결 패널에서 연결할 수 있습니다. ### 대시보드 스타터 사용 Tableau Cloud에서 대시보드 스타터를 사용하여 LinkedIn Sales Navigator, Oracle Eloqua, Salesforce, ServiceNow ITSM 및 QuickBooks Online의 데이터를 작성하고 분석할 수 있습니다. 대시보드 스타터 탭의 미리 작성된 디자인 목록에서 옵션을 선택하고 대시보드 사용을 클릭합니다. 자세한 내용은 [클라우드 기반 데이터 원본을 위한 대시보드 스타터](https://help.tableau.com/current/pro/desktop/ko-kr/starters.htm)를 참조하십시오. ### Tableau Bridge를 사용한 웹 작성 데이터 뷰를 작성하거나 Tableau Cloud 내의 웹에서 직접 작업할 때 Tableau Bridge는 다양한 데이터베이스 및 클라우드 데이터 환경에 대한 완벽한 쿼리 지원을 제공합니다. - **명명된 커넥터**: Tableau Cloud 연결 패널에 표시되는 지원되는 모든 명명된 커넥터에 대해, 웹 작성 세션 중에 바로 새로운 데이터 연결을 설정할 수 있습니다. - **명명되지 않은/일반 커넥터**: 이미 작동하는 기존 Bridge 기반 아키텍처를 가리키는 콘텐츠를 수정할 때 웹 작성은 명명되지 않은 특정 데이터베이스 커넥터와 완벽하게 호환됩니다. 여기에는 다음이 포함됩니다. - 명명되지 않은 일부 커넥터에는 데이터 원본 편집 옵션을 사용하지 못할 수 있습니다. - 작동하는 기존 클라우드 통합 문서 내에서 내장된 데이터 원본을 편집합니다. Tableau는 모든 상황에서 웹 작성을 통해 게시된 데이터 원본을 편집하는 것을 지원하지 않습니다. 제한 사항은 다음과 같습니다. - 명명되지 않은(일반) 커넥터를 사용하는 게시된 데이터 원본에는 **데이터 원본 편집** 옵션을 사용하지 못할 수 있습니다. 단추가 회색으로 나타납니다. - Bridge 데이터 원본에 대한 여러 연결을 포함하는 라이브 게시된 데이터 원본을 편집하는 것은 현재 지원되지 않으며, 이 경우 오류가 발생합니다. 자세한 내용은 [Bridge와의 연결](https://help.tableau.com/current/online/ko-kr/to_sync_local_data.htm)을 참조하십시오. Tableau Public에서는 지원되는 파일을 업로드하여 데이터에 연결할 수 있습니다. ### 파일에 연결 Tableau에서는 브라우저에서 직접 Excel 또는 텍스트 기반 데이터 원본(.xlsx, .csv, .tsv)을 업로드할 수 있습니다. 데이터에 연결 패널의 파일 탭에서 Excel 또는 텍스트 파일을 필드에 끌어 놓거나 컴퓨터에서 업로드를 클릭하여 해당 파일에 연결합니다. 업로드할 수 있는 최대 파일 크기는 1GB입니다. 데이터 집합이 없는 경우 Tableau Public 웹 사이트의 무료 [샘플 데이터 집합](https://public.tableau.com/ko-kr/s/resources?qt-overview_resources=1#qt-overview_resources)을 확인하십시오. ### 커넥터 사용 커넥터 탭에서 클라우드 데이터베이스에 저장되어 있는 데이터에 연결할 수 있습니다. 사용자가 자신이 만든 각 데이터 연결에 대한 연결 정보를 제공해야 합니다. 예를 들어 대부분의 데이터 연결에서 로그인 정보를 제공해야 합니다. 커넥터를 사용하여 Tableau를 데이터에 연결하는 방법에 대한 자세한 내용은 [지원되는 커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/exampleconnections_overview.htm)를 참조하십시오. 필요한 커넥터가 '커넥터' 탭에 나타나지 않는 경우 Tableau Desktop을 통해 데이터에 연결하고 데이터 추출을 만들 수 있습니다. **참고**: Tableau Public에서 데이터에 연결할 수 없는 경우 데이터베이스에 공개적으로 액세스할 수 있는지 확인하십시오. Tableau Public은 공개 인터넷에서 액세스할 수 있는 데이터에만 연결할 수 있습니다. #### Tableau Public 커넥터

Google 드라이브

OData

## 연결한 후 Tableau가 데이터에 연결되면 분석할 데이터를 준비하고 뷰를 작성할 수 있도록 데이터 원본 페이지가 열립니다. 자세히 알아보려면 [Creator: 웹에서 데이터 준비](https://help.tableau.com/current/pro/desktop/ko-kr/creator_data_prep.htm)를 참조하십시오. ## 웹 작성에서 데이터를 최신으로 유지 **Tableau Cloud 또는 Tableau Server에서 업로드된 파일 업데이트**: 웹 작성을 위해 수동으로 파일(Excel 또는 텍스트)을 업로드하는 경우 Tableau가 자동으로 파일을 새로 고칠 수 없습니다. 데이터를 업데이트하려면 “연결 편집”을 선택하여 파일의 새 버전을 업로드하십시오. Tableau Public에서 비주얼리제이션으로 이동하고 업데이트 요청을 클릭합니다. Tableau Desktop Public Edition에서 'Keep this data in sync(이 데이터를 동기화 상태로 유지)'를 선택하여 데이터를 자동으로 최신 상태로 유지할 수도 있습니다. **Tableau Cloud에서 파일 기반의 게시된 데이터 원본 업데이트**: Tableau Cloud에 파일 기반 데이터를 사용하는 게시된 데이터 원본(Tableau Desktop을 통해 게시됨)이 있는 경우 Tableau Bridge를 사용하여 데이터를 최신 상태로 유지할 수 있습니다. 자세한 내용은 [Tableau Bridge를 사용하여 데이터 새로 고침 옵션 확장](https://help.tableau.com/current/online/ko-kr/to_sync_local_data.htm)을 참조하십시오. 웹 작성을 통해 게시된 데이터 원본을 편집하는 것은 모든 시나리오에서 지원되는 것은 아닙니다. 제한 사항은 다음과 같습니다. - 명명되지 않은(일반) 커넥터를 사용하는 게시된 데이터 원본에는 데이터 원본 편집 옵션을 사용할 수 없습니다. 단추가 회색으로 나타날 수 있습니다. - 웹 작성을 통해 생성되었는지 Tableau Desktop에서 게시되었는지 여부에 관계없이 라이브 PDS를 편집하면 연결 오류가 발생할 수 있습니다. Tableau Cloud가 Bridge를 통해 라우팅하는 대신 데이터베이스에 대한 직접 연결을 시도하여 요청이 실패할 수 있습니다. - Bridge 데이터 원본에 대한 여러 연결을 포함하는 라이브 PDS를 편집하는 것은 현재 지원되지 않으며, 이 경우 오류가 발생합니다. Bridge로 웹 작성 중 발생하는 오류 이해 웹 작성 실패 시 표시되는 오류 메시지는 Bridge 관련 문제임을 명확하게 나타내지 않을 수도 있습니다. 일반적인 시나리오 및 그 의미: - 네트워크 또는 로그인 시간 초과 오류(예: '네트워크 관련 또는 인스턴스 관련 오류가 발생했습니다' 또는 '로그인 시간 초과가 만료됨')는 Tableau Cloud가 Bridge를 통해 라우팅하지 않고 직접 연결을 시도한 것을 나타낼 수 있습니다. Bridge 클라이언트가 연결되어 있고 올바른 풀에 할당되었는지 확인하십시오. - NO\_POOLED\_AGENTS\_ASSIGNED\_NAMED\_POOL 오류는 사이트에 대해 구성된 명명된 풀에 할당된 Bridge 에이전트가 없음을 나타냅니다. 이 오류를 해결하려면 활성 Bridge 클라이언트를 할당하십시오. - 데이터 원본 편집 단추가 회색으로 표시되어 있다면, 해당 데이터 원본은 명명되지 않은 커넥터를 사용하며 이 경우 현재 웹 작성을 통해 편집하는 것은 지원되지 않습니다. [주요 콘텐츠로 건너뛰기](#main-content) # CSV 파일 가져오기 지침 사용자 정보가 포함된 CSV(쉼표로 구분된 값) 파일을 만들어 가져오는 방식으로 사용자를 일괄 추가할 수 있습니다. CSV 파일에 라이선스 수준 및 게시 액세스와 같은 특성을 포함하면 파일을 가져올 때 사용자에게 적용할 수 있습니다. 이 항목에서는 CSV 파일 자체에 대한 세부 정보를 다룹니다. CSV를 사용하여 사용자를 가져오려면 다음과 같이 하면 됩니다. - 서버 또는 사이트 관리 페이지를 사용합니다. 자세한 내용은 [사용자 가져오기](https://help.tableau.com/current/server/ko-kr/users_import.htm)를 참조하십시오. - `tabcmd` 유틸리티를 사용합니다. 자세한 내용은 [createsiteusers filename.csv](https://help.tableau.com/current/server/ko-kr/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)를 참조하십시오. 사이트 또는 서버 수준에서 사용자를 가져올 수 있습니다. 특정 사이트가 아닌 서버로 사용자를 가져오는 경우 사용자를 사이트에 할당하지 않고 라이선스 없음으로 가져옵니다. **참고:** 달리 명시되지 않는 한 이 항목에 명시된 지침은 [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm) 유무와 관계없이 구성된 Tableau Server에 적용됩니다. ## CSV 파일 형식 요구 사항 사용자를 가져오기 위한 CSV 파일의 형식 요구 사항은 다음과 같습니다. - 열 머리글이 없어야 합니다. Tableau Server는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다. - BOM(바이트 순서 표시)이 있는 UTF-8 형식은 사이트로 가져올 때만 지원됩니다. Tableau Cloud Manager로 가져오는 경우 UTF-8 형식을 사용하고 파일에서 BOM을 제거해야 합니다. - BIG-5와 같은 문자 인코딩을 UTF-8로 변환해야 합니다. 이 작업은 텍스트 편집기에서 파일을 열고 다른 이름으로 저장 명령을 사용하여 수행할 수 있습니다. - 도메인 구분 기호 이외의 `@` 문자가 **username** 필드에 있는 경우 16진수 형식인 `\0x40`이어야 합니다. 예를 들어 `user@fremont@mycompany.com`은 `user\0x40fremont@mycompany.com`이 되어야 합니다. ## CSV 파일의 필수 열 구조 파일에는 머리글 행이 포함되어서는 안 됩니다. 모든 열을 채울 필요는 없지만 필요한 모든 쉼표 구분 기호를 포함하여 필수 열 구조를 유지해야 합니다. 열 구조는 제품과 가져오기 도구에 따라 다릅니다. 환경에 적합한 구조를 사용하고 있는지 확인해야 합니다. - **Tableau Cloud:** 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리자 수준, 게시 기능, 이메일 주소 - **TCM(Tableau Cloud Manager)가 있는 Tableau Cloud:** 테넌트 또는 사이트 URI, 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리자 수준, 게시 기능, 이메일 주소, 인증 유형 - **Tableau Server:** 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리 수준, 게시 기능, 이메일 주소 - **ID 풀을 사용한 Tableau Server:** 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리 수준, 게시 기능, 이메일 주소, ID 풀 이름, 식별자 각 열에 사용할 수 있는 값에 대한 자세한 내용은 아래의 열 세부 정보 섹션을 참조하십시오. > [!WARNING] > > **중요:** 열의 순서는 매우 중요합니다. 열의 내용과 관계없이 첫 번째 열은 사용자 이름으로, 두 번째 열은 암호로, 세 번째 열은 표시 이름으로 처리되는 식입니다. 필드의 값을 생략해도 필드의 쉼표 구분 기호는 포함해야 합니다. ## Tableau Server의 열 세부 정보 **참고**: 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 Unlicensed 사이트 역할만 할당할 수 있습니다. CSV 파일의 열 구조: `username, password, display name, license level, admin level, publishing capability, email address` ### 열 세부 정보  **Username:** _필수_ 항목입니다. 사용자의 이름입니다. - 서버가 Active Directory를 사용하도록 구성되어 있는 경우 이 값은 Active Directory에 정의되어 있는 사용자와 일치해야 합니다. 사용자 이름이 도메인 간에서 고유하지 않은 경우 `example\Adam`또는 `adam@example`과 같이 사용자 이름의 일부로 도메인을 포함합니다. - [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)에 사용자를 추가하는 경우 다음을 확인하십시오. - AD를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 AD sAMAccountName 값을 사용해야 합니다. - LDAP를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 LDAP username 값을 사용해야 합니다. **Password:** 사용자의 비밀번호입니다. 이 열이 필요한지 여부는 서버 구성에 따라 다릅니다. - 로컬 인증: _필수_ 항목입니다. Tableau Server 2024.2부터 비밀번호 필드가 필수 사항이 되었습니다. 자세한 내용은 기술 자료 [Tableau Server 2024.2에서 tabcmd를 통해 사용자를 추가하려고 하면 예기치 않은 'errorCode=134' 오류 발생(영문)](https://help.salesforce.com/s/articleView?id=002277940&type=1)을 참조하십시오. - Active Directory: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. **Display name:** 표시 이름은 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이 열이 사용되는지 여부는 서버 구성에 따라 다릅니다. - 로컬 인증: 사용자의 표시 이름이 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다. - Active Directory: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. **License level:** **Creator**, **Explorer**, **Viewer** 또는 **Unlicensed**일 수 있습니다. - 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다. - 사용자 기반 서버 설치 환경에서 사용자 추가가 라이선스에서 허용하는 사용자 수를 초과하면 사용자가 라이선스 없음 사용자로 추가됩니다. - `tabcmd`를 사용하고 라이선스를 지정했지만 사용자 가져오기에서 라이선스 한도를 초과한 경우 사용자를 라이선스 없음 사용자로 가져옵니다. **Administrator level:** **System**, **Site** 또는 **None**일 수 있으며 사용자를 관리자로 가져올지 여부를 결정합니다. - System은 서버 관리자이며, Site는 사이트 관리자이고, None은 관리자가 아닌 사용자입니다. - 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 Unlicensed 만 할당할 수 있습니다. - 웹 UI를 사용하여 사용자를 가져오는 경우 서버(모든 사이트) 수준에서 파일을 가져오는 경우에만 관리자 사이트 역할을 System으로 설정할 수 있습니다. 특정 사이트에 로그인되어 있으며 CSV 파일에 사용자의 관리자 열이 System으로 설정되어 있으면 Tableau Server가 해당 사용자를 사이트 관리자로 가져옵니다. **Publishing capability:** **Yes/True/1** 또는 **No/False/0**일 수 있습니다. 웹 UI를 사용하는 경우 특정 사이트에 로그인되어 있는 상태로 가져오는 경우에만 게시 기능이 사용됩니다. - 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다. - 라이선스 수준이 Explorer인 경우 게시 기능 값은 Explorer(게시 가능)와 Explorer 간의 사이트 역할을 구분하는 값입니다. - 라이선스 수준이 Viewer(뷰어) 또는 Unlicensed(라이선스 없음)인 경우 사용자는 이 열의 값에 관계없이 게시할 수 없습니다. **Email address**: 이메일 주소는 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이메일 주소가 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다. 비워 둔 열은 열 구조를 유지하기 위해 쉼표로 구분해야 합니다. ### ID 풀 ID 풀에 사용자를 추가하는 경우 표준 열과 다음 열이 필요합니다. CSV 파일의 열 구조: `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier` 추가 열 세부 정보: **Identity pool name:** 사용자를 추가할 ID 풀의 이름입니다. ID 풀에 사용자를 추가하고 ID 풀 이름을 지정하지 않으면 Tableau Server 설치 중에 TSM에서 프로비저닝한 사용자 집합인 초기 풀(TSM 구성됨)에 사용자가 추가됩니다. **Identifier:** 추가할 사용자의 식별자입니다. 식별자는 ID 일치 목적으로만 사용됩니다. 자세한 내용은 [Tableau의 사용자 이름 및 식별자](https://help.tableau.com/current/server/ko-kr/identity_pools.htm#usernames_identifiers)을 참조하십시오. - 로컬 인증: _선택 사항_ - Active Directory 또는 LDAP: _필수_ #### ID 풀을 사용하여 사용자 일괄 추가 CSV 가져오기 프로세스를 사용하여 다음을 수행할 수 있습니다. - 추가 ID 풀에 사용자를 일괄 추가합니다. **참고:** CSV 가져오기 프로세스를 사용하여 사용자가 이미 속한 ID 풀을 다른 ID 풀로 바꿀 수는 없습니다. 다른 ID 풀 값을 가진 기존 사용자를 추가하면 해당 사용자가 추가 ID 풀에 추가됩니다. - 아직 식별자가 없는 사용자를 위해 식별자를 일괄 추가합니다. **참고:** 동일한 풀에 있는 사용자에 대해 다른 식별자를 추가해도 해당 사용자의 기존 식별자는 대체되지 않습니다. 대신 해당 사용자에 대한 새 식별자 레코드가 만들어집니다. ### Tableau Server의 CSV 가져오기 예제 > [!TIP] > > **팁**: 참고로, 구조는 `username, password, display name, license level, admin level, publishing capability, email address`입니다. 다음 예제에서는 여러 사용자에 대한 정보를 포함하는 CSV 파일을 보여 줍니다. henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com - 사이트를 관리하는 동안 이 파일을 가져오는 경우 해당 사이트에 사용자 네 명이 추가됩니다. 사용자 Michelle의 `Administrator` 설정은 `System`입니다. 하지만 사용자를 사이트로 가져오기 때문에 Tableau Server가 Michelle에게 사이트 관리자 Creator 사이트 역할을 부여합니다. 사용자 중 세 명에게 게시가 허용되어 있습니다. - 서버를 관리하는 동안 이 파일을 가져오는 경우 서버에 사용자 네 명이 추가되지만 어떠한 사이트에도 사용자가 추가되지 않습니다. 한 사용자만 서버 관리자로 가져오고 나머지 사용자는 라이선스 없음으로 설정됩니다. #### ID 풀 예제 > [!TIP] > > **팁**: 참고로, 구조는 `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier`입니다. 다음 예는 ID 풀에 추가된 사용자 2명에 대한 정보를 포함하는 CSV 파일을 보여줍니다. henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki 다음 예는 추가 ID 풀에 추가된 사용자 2명에 대한 정보를 포함하는 CSV 파일을 보여줍니다. henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki 다음 예는 기존 식별자가 없는 사용자 2명에 대한 정보를 포함하는 CSV 파일을 보여줍니다. janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez ### tabcmd를 통해 전달된 큰 CSV 파일의 성능 개선 **참고:** 이러한 설정은 Tableau Server 버전 2022.1 이하에 적용됩니다. 이러한 설정이 영향을 미치는 검색 및 인덱스 서비스는 버전 2022.3부터 사용 중단되었며 2023.3에서는 사용 중지(완전히 제거됨)되었습니다. 서버 관리자는 tabcmd 명령을 통해 큰 CSV 파일을 가져올 때 성능을 개선하는 데 도움이 되는 서버 설정을 사용하도록 설정할 수 있습니다. 이 작업은 `tsm configuration set` 명령과 다음과 같은 옵션을 사용하여 수행할 수 있습니다. - `vizportal.csv_user_mgmt.index_site_users` - `vizportal.csv_user_mgmt.bulk_index_users` - `searchserver.index.bulk_query_user_groups` 기본적으로 이러한 옵션은 사용자가 서버 데이터베이스에 추가될 때 한 명씩 인덱싱하는 것이 아니라 CSV 파일을 처리한 후에 사용자를 인덱싱합니다. 따라서 파일을 처리하는 데 필요한 메모리와 데이터베이스 호출 횟수가 줄어듭니다. 이러한 `tsm configuration set` 옵션은 `tabcmd createsiteusers`, `deletesiteusers`, `addusers` 및 `removeusers` 명령에 적용됩니다. 이러한 설정에 대한 설명은 [tsm configuration set 옵션](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm)을 참조하십시오. ## CSV 설정 및 사이트 역할 사용자에 대한 라이선스 수준, 관리자 및 게시자 설정은 가져오기 프로세스 중에 사용자의 사이트 역할이 설정되는 방식을 결정합니다. 다음은 CSV에서 사이트 역할을 캡처하는 방법을 보여줍니다.
사이트 역할License levelAdministrator levelPublishing capability

서버 관리자

이 역할은 서버를 관리하는 동안 사용자를 가져오는 경우에만 유효합니다(즉, 특정 사이트에 로그인하지 않은 경우).

모든 라이선스가 가능하지만 서버 관리자 사이트 역할은 Creator 라이선스를 사용할 수 있으면 항상 해당 라이선스를 사용합니다. 사용할 수 있는 Creator 라이선스가 없는 경우 라이선스 문제 해결에서 Tableau Server가 이 문제를 처리하는 방식에 대해 알아보십시오.SystemTrue

사이트 관리자 Creator 또는 사이트 관리자 Explorer

이러한 역할은 특정 사이트에 로그인한 상태에서 사용자를 가져오는 경우에만 유효합니다.

Creator 또는 ExplorerSiteTrue
CreatorCreatorNoneTrue
Explorer(게시 가능)ExplorerNoneTrue
ExplorerExplorerNoneFalse
Viewer(뷰어)Viewer(뷰어)NoneFalse
UnlicensedUnlicensedNoneFalse
[주요 콘텐츠로 건너뛰기](#main-content) # Data Management 라이선스 **중요:** 2024년 9월 16일부터 Data Management는 더 이상 독립 Add-On 옵션으로 사용할 수 없습니다. Data Management 기능은 이전에 Data Management를 구매한 경우에만 사용할 수 있으며, Tableau Enterprise, Tableau Cloud+ 또는 Tableau+ Bundle(Tableau Cloud에 사용 가능) 또는 Tableau Enterprise 또는 Tableau Server+(Tableau Server에 사용 가능)와 같은 특정 라이선스 버전을 구매한 경우에만 사용할 수 있습니다. Data Management에는 Tableau Catalog, Tableau Prep Conductor, 가상 연결 및 데이터 정책이 포함되며 Tableau Enterprise를 구매하면 사용할 수 있습니다. 자세한 내용은 계정 관리자에게 문의(또는 Tableau [가격](https://www.tableau.com/ko-kr/pricing/teams-orgs) 페이지로 이동)하십시오. Data Management는 라이선스가 허가된 Tableau Server 배포 환경에서만 활성화할 수 있습니다. 배포에는 라이선스가 허가된 프로덕션 Tableau Server 설치와 프로덕션 설치를 지원하는 라이선스가 허가된 비프로덕션 Tableau Server 설치가 포함됩니다. 배포에 대한 자세한 내용은 [EULA 문서 자료(영문)](http://www.tableau.com/legal/Documentation)를 참조하십시오. ## Tableau Prep Conductor Tableau Enterprise를 구매하면 Tableau Server에서 Prep Conductor를 사용하도록 설정해야 합니다. 자세한 내용은 [Tableau Server에서 Tableau Prep Conductor 사용 및 구성](https://help.tableau.com/current/server/ko-kr/prep_conductor_config_server_overview.htm)을 참조하십시오. - Data Management가 활성화되고 사용하도록 설정된 경우 Tableau Server 또는 Tableau Cloud에서 흐름을 예약하고 흐름을 모니터링할 수 있습니다. - Data Management가 제거 또는 비활성화되거나 Data Management 라이선스가 만료된 경우 흐름을 예약하는 기능을 사용할 수 없습니다. - Tableau Server 또는 Tableau Cloud 라이선스가 여전히 활성화되어 있고 유효한 경우 Tableau Server REST API를 사용하여 흐름을 다운로드할 수 있습니다. 자세한 내용은 [흐름 메서드(영문)](https://help.tableau.com/current/api/rest_api/ko-kr/REST/rest_api_ref_flow.htm)를 참조하십시오. ## Tableau Catalog Tableau Enterprise를 구매하면 Tableau Server에서 Catalog를 사용하도록 설정해야 합니다. 자세한 내용은 [Tableau Catalog 사용](https://help.tableau.com/current/server/ko-kr/dm_catalog_enable.htm)을 참조하십시오. - Data Management가 활성화되어 있고 사용하도록 설정된 경우 Tableau Catalog를 사용하여 데이터를 검색하고, 데이터 자산을 조정하고, 영향 분석을 수행하고, Tableau 콘텐츠에 사용된 데이터 계보를 추적할 수 있습니다. - Data Management가 제거 또는 비활성화되거나 라이선스가 만료된 경우 정보는 서버에 유지됩니다. 이 경우 Tableau Catalog 관련 정보는 Tableau Metadata API를 통해서만 액세스할 수 있으며, 더 이상 제품에 나타나지 않습니다. 자세한 내용은 [Metadata API](https://help.tableau.com/current/api/metadata_api/ko-kr/index.html)를 참조하십시오. - Data Management이 제거 또는 비활성화되거나 라이선스가 만료된 경우 모든 새로운 Tableau Catalog 정보(예: 테이블 설명, 데이터 품질 경고, 열 설명)에 대한 쓰기 API를 사용할 수 없습니다. 여전히 Metadata API를 사용하여 정보를 읽을 수 있지만 테이블과 데이터베이스에 대한 사용 권한을 제품에서 명시적으로 관리할 수 없습니다. ## 가상 연결 및 데이터 정책 Tableau Enterprise를 구매하고 Tableau용 Data Management를 사용하도록 설정하면 Tableau Server에서 가상 연결 및 데이터 정책의 사용이 자동으로 설정됩니다. Tableau용 Data Management를 구매하고 라이선스를 취득하면 가상 연결 및 데이터 정책이 자동으로 사용되도록 설정됩니다. - Data Management가 활성 상태이고 사용되도록 설정되면 가상 연결을 사용하여 데이터에 대한 중앙 액세스 지점을 제공하는 공유 가능한 리소스를 만들 수 있습니다. 또한 중앙 집중식 행 수준 보안을 사용하여 사용자 데이터를 필터링할 수 있는 데이터 정책도 만들 수 있습니다. - Data Management가 제거 또는 비활성화되거나 라이선스가 만료된 경우 정보는 서버에 유지되지만 액세스할 수 없게 됩니다. - Data Management를 다시 활성화하면 정보가 서버에 복원되고 액세스할 수 있게 됩니다. ## Data Management 라이선스 작동 방식 구매한 라이선스에 따라 Tableau Server 배포는 사용자 기반이거나 코어 기반일 수 있습니다. ### 사용자 기반 사용자 기반 라이선스 메트릭을 사용하면 단일 컴퓨터나 클러스터의 여러 컴퓨터에 Tableau Server를 배포할 수 있습니다. Tableau Server에 액세스하는 각 사용자에게 라이선스가 부여되어야 합니다. 관리자가 사용자를 추가하고 라이선스를 부여합니다. Tableau Server에 추가한 첫 번째 Creator 또는 Explorer 제품 키는 Tableau Server를 활성화하며 서버 관리자가 사용합니다. Data Management 제품 키는 배포 수준에서 포함된 기능을 활성화하고 해당 기능은 Tableau Server에 대해 이미 라이선스가 허가된 모든 사용자에게 라이선스가 허가됩니다. ### 코어 기반 코어 기반 라이선스 메트릭은 Tableau Server의 사용자 계정 수에 제한을 두지 않습니다. 대신, 이 라이선스는 Tableau Server를 실행할 수 있는 컴퓨터 코어의 최대 수를 제한합니다. **참고:** 코어 기반 라이선스를 구매하여 사용하는 경우 Tableau 배포에 Data Management 제품 키와 리소스 코어 제품 키를 모두 적용해야 합니다. 첫 번째 키는 Tableau Prep Conductor를 통해 Tableau Server에서 흐름을 실행할 수 있도록 만들고 두 번째 키는 Tableau Prep Conductor 노드에 대한 여분의 코어를 추가합니다. 모든 제품 키는 [고객 포털](http://customer.tableau.com/)을 통해 제공됩니다. 일반적으로 모든 컴퓨터의 총 코어 수는 Tableau Server 라이선스에서 허용하는 총 코어 수를 초과해서는 안 됩니다. Tableau Server 배포에서 Data Management 제품 키를 활성화하면 특정 수의 Tableau Prep Conductor 코어가 포함됩니다. 이 시나리오에서 모든 컴퓨터의 총 코어 수는 Tableau Server 라이선스와 Data Management 라이선스가 함께 허용하는 총 코어 수를 초과해서는 안 됩니다. 이 항목에서는 Tableau Server 라이선스를 통해 라이선스가 있는 코어를 Tableau Server 코어라고 하고, Data Management를 통해 라이선스가 허가된 코어를 Tableau Prep Conductor 코어라고 합니다. 다음은 코어 기반 메트릭에서 라이선스가 적용되는 방식과 관련된 몇 가지 개념입니다. - 한 노드는 한 가지 유형(Tableau Server 코어 또는 Tableau Prep Conductor 코어)으로만 라이선스가 허가될 수 있습니다. - Tableau Prep Conductor 코어는 Tableau Prep Conductor 실행 전용으로 사용되는 노드에 적용할 수 있으며 해당 노드의 백그라운더는 흐름 백그라운드 작업만 실행하도록 설정됩니다. 이 경우 이 노드의 총 코어 수는 Data Management 라이선스가 허용하는 코어 수를 초과할 수 없습니다. 이 노드에 Tableau Prep Conductor, 백그라운더 및 데이터 엔진 이외의 다른 라이선스가 허가된 프로세스가 활성화된 경우 이 노드는 Tableau Server 코어 라이선스를 요구하며 사용합니다. - 위에서 언급한 것처럼, 백그라운더 노드 역할은 노드에서 사용하는 라이선스에도 영향을 미칩니다. 예를 들어 백그라운더 노드 역할이 모든 유형의 작업(기본값)을 실행하도록 설정된 경우 이 노드는 Tableau Server 코어를 통해 라이선스가 허가됩니다. 노드 역할에 대한 자세한 내용은 [Tableau Server의 노드 역할](https://help.tableau.com/current/server/ko-kr/server_node_roles.htm)을 참조하십시오. 다음 표와 결정 흐름을 참조하여 노드의 라이선스가 허가되는 방식을 파악하십시오.
노드의 프로세스노드의 코어 수가 계산되는 방식노드의 라이선스가 허가되는 방식

다음 프로세스 중 하나가 사용되도록 설정된 상태:

  • 응용 프로그램 서버
  • 백그라운더(노드 역할은 모든 작업을 실행하도록 설정됨)
  • 파일 저장소
  • 데이터 서버
  • VizQL 서버
Tableau Server 코어의 총 수Tableau Server 코어

다음 프로세스만 사용되도록 설정된 상태:

  • Tableau Prep Conductor
  • 백그라운더(노드 역할은 흐름만 실행하도록 설정됨)
  • 데이터 엔진

Data Management를 통해 구매한 Tableau Prep 코어의 총 수

참고: 사용할 수 있는 Tableau Prep Conductor 코어가 없지만 Tableau Server 코어를 사용할 수 있는 경우 Tableau Server 코어가 사용됩니다.

Data Management에 포함된 Tableau Prep 코어

참고: 사용할 수 있는 Tableau Prep Conductor 코어가 없지만 Tableau Server 코어를 사용할 수 있는 경우 Tableau Server 코어가 사용됩니다.

![라이선스 의사 결정 흐름](/tableau/current/ko-kr/server/ko-kr/Img/prep_conductor_licensing_flow_chart.png) 라이선스가 허가된 프로세스에 대한 자세한 내용은 [Tableau Server 프로세스](https://help.tableau.com/current/server/ko-kr/processes.htm)를 참조하십시오. Tableau Server 라이선스에 대한 자세한 내용은 [Tableau Server 라이선스 개요](https://help.tableau.com/current/server/ko-kr/license_server_overview.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Data Management 정보 **중요:** 2024년 9월 16일부터 Data Management는 더 이상 독립 Add-On 옵션으로 사용할 수 없습니다. Data Management 기능은 이전에 Data Management를 구매한 경우에만 사용할 수 있으며, Tableau Enterprise, Tableau Cloud+ 또는 Tableau+ Bundle(Tableau Cloud에 사용 가능) 또는 Tableau Enterprise 또는 Tableau Server+(Tableau Server에 사용 가능)와 같은 특정 라이선스 버전을 구매한 경우에만 사용할 수 있습니다. Data Management는 Tableau Server 또는 Tableau Cloud 환경에서 Tableau 콘텐츠 및 데이터 자산을 관리할 때 도움이 되는 기능을 모은 것입니다. Tableau Server 2019.1부터 온프레미스 Tableau Server 배포에서 Tableau Prep Conductor를 사용할 수 있고, 버전 2019.3에서는 Tableau Cloud 배포에서 Tableau Prep Conductor를 사용할 수 있습니다. Tableau Prep Conductor를 사용하여 흐름을 예약하고 모니터링할 수 있습니다. Tableau 2019.3부터는 Tableau Catalog가 Data Management에 포함됩니다. 따라서 데이터 관리 공간에서 다양한 추가 기능을 사용할 수 있습니다. Tableau Catalog를 사용하면 데이터를 검색하고, 데이터 자산을 큐레이션하고, 데이터 품질을 알리고, 영향 분석을 수행하고, Tableau 콘텐츠의 계보를 추적할 수 있습니다. Tableau 2021.4부터 Data Management에 가상 연결 및 데이터 정책이라는 추가 거버넌스 및 보안 기능이 추가됩니다. 가상 연결 에디터를 사용하여 다음을 만들 수 있습니다. - 데이터에 대한 공유 가능한 중앙 액세스 지점을 제공하는 가상 연결 - 연결 수준에서 행 수준 보안을 적용하는 데이터 정책 ## Data Management 기능 다음 표에는 다음을 포함하는 Data Management의 기능이 나와 있습니다. - Tableau Catalog - Tableau Prep Conductor - 가상 연결 - 데이터 정책 ### Tableau Catalog
기능설명
메타데이터에 대한 사용 권한Tableau Catalog를 사용하면 외부 자산을 보고 관리할 수 있는 사용자와 사용 권한을 설정하여 계보를 통해 표시되는 메타데이터를 제어할 수 있습니다.
연결 성능 확장 - 데이터 검색웹에서 작성하든지, 아니면 Tableau Desktop에서 작성하든지, 이제 Tableau Server 또는 Tableau Cloud 사이트의 게시된 데이터 원본 및 통합 문서에서 사용하는 특정 데이터베이스 및 테이블을 검색하고 연결할 수 있습니다.
확장된 검색Tableau Catalog에서 열, 데이터베이스 및 테이블을 기반으로 한 결과를 포함하도록 검색이 확장됩니다.
외부 자산 태그 지정태그를 사용하여 Tableau Server 및 Tableau Cloud의 항목을 분류하여 사용자가 외부 자산(데이터베이스, 파일, 테이블 및 열)을 필터링하는 데 도움을 줄 수 있습니다.
데이터베이스 및 테이블 인증데이터베이스 및 테이블을 인증하여 설정된 표준을 충족하는 신뢰할 수 있는 데이터를 쉽게 찾을 수 있도록 지원합니다.
데이터 품질 경고 설정사용자에게 오래되거나 사용 중단된 데이터와 같은 데이터 품질 문제를 알리도록 경고를 설정할 수 있습니다.
계보 및 영향 분석계보 도구는 데이터의 출처를 추적합니다. 이 도구를 사용하여 데이터 변경의 영향을 분석하고, 영향을 받을 수 있는 사용자를 식별하고, 통합 문서, 데이터 원본 또는 흐름의 소유자나 데이터베이스 또는 테이블의 연락처로 데이터 관련 업데이트에 대한 이메일을 보낼 수 있습니다.
데이터 세부 정보사용된 데이터에 대한 정보를 확인하여 게시된 비주얼리제이션을 보다 정확하게 이해할 수 있도록 지원합니다.
자산에 설명 추가데이터베이스, 테이블 및 열에 설명을 추가하여 사용자가 원하는 데이터를 더 쉽게 찾을 수 있도록 도와줍니다.
개발자 리소스Tableau REST API - 메타데이터 메서드프로그래밍 방식으로 외부 자산을 추가, 업데이트 및 제거하고 Tableau 콘텐츠 및 외부 자산에 설명과 같은 여분의 메타데이터를 추가합니다.
Tableau Metadata APITableau Server 또는 Tableau Cloud에 게시된 콘텐츠의 메타데이터를 프로그래밍 방식으로 쿼리합니다. Tableau Server REST API의 메타데이터 메서드를 사용하여 특정 메타데이터를 프로그래밍 방식으로 업데이트합니다. 
참고: 메타데이터 API에는 Data Management가 필요하지 않습니다.
GraphiQLGraphiQL이라는 브라우저 내 대화형 툴을 사용하여 Metadata API 스키마에 대한 쿼리를 탐색하고 테스트하십시오.
참고: GraphiQL에는 Data Management가 필요하지 않습니다.
### Tableau Prep Conductor | 기능 | 설명 | | --- | --- | | 흐름 작업 예약([Tableau Cloud](https://help.tableau.com/current/online/ko-kr/prep_conductor_online_schedule_flow_task.htm) 또는 [Tableau Server](https://help.tableau.com/current/server/ko-kr/prep_conductor_schedule_flow_task.htm) 도움말 참조) | 예약된 흐름 작업을 만들어 흐름을 특정 시간에 실행하거나 반복적으로 실행할 수 있습니다. | | [흐름 상태 및 성능 모니터링](https://help.tableau.com/current/server/ko-kr/prep_conductor_monitor_flow.htm) | 사이트 또는 서버 수준에서 흐름 실패 시 이메일 알림을 설정하고, 일시 중단된 흐름 작업을 보고 재시작하고, 오류 및 알림을 봅니다. | | [흐름에 대한 관리 뷰](https://help.tableau.com/current/server/ko-kr/prep_conductor_admin_views.htm) | 관리 뷰를 사용하여 흐름과 관련된 활동, 성능 기록 및 서버 또는 사이트 수준에서 사용된 디스크 공간을 모니터링할 수 있습니다. | | Tableau REST API - [흐름 메서드(영문)](https://help.tableau.com/current/api/rest_api/ko-kr/REST/rest_api_ref_flow.htm) | 프로그래밍 방식으로 흐름을 예약합니다. | ### 가상 연결 및 데이터 정책 | 기능 | 설명 | | --- | --- | | [가상 연결 만들기](https://help.tableau.com/current/server/ko-kr/dm_vconn_create_conn.htm) | 큐레이팅된 데이터에 대한 공유 및 재사용 가능한 연결을 만들 수 있는 Tableau 콘텐츠 유형입니다. | | [행 수준 보안에 대한 데이터 정책 만들기](https://help.tableau.com/current/server/ko-kr/dm_vconn_create_rlspolicy.htm) | 가상 연결 에디터를 사용하여 연결 수준에서 데이터에 행 수준 보안을 적용하는 정책 조건이 포함된 데이터 정책을 만듭니다. | | [사용자로 미리 보기를 통해 행 수준 보안 테스트](https://help.tableau.com/current/server/ko-kr/dm_vconn_test_preview.htm) | 사용자로 미리 보기를 통해 데이터 정책을 테스트하여 사용자에게 해당하는 데이터만 표시되는지 확인합니다. | | [가상 연결에 대한 추출 새로 고침 예약](https://help.tableau.com/current/server/ko-kr/dm_vconn_extract.htm) | 연결의 테이블에 대한 추출 새로 고침 일정을 만들어 해당 가상 연결을 사용하는 모든 콘텐츠의 데이터를 최신 상태로 유지합니다. | ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Desktop 라이선스 만료 **참고:** 이 뷰는 서버 관리자만 사용할 수 있습니다. 다중 사이트 배포의 서버 뷰에 액세스하려면 사이트 메뉴를 클릭한 다음 **모든 사이트 관리**를 선택합니다. 관리 뷰 탐색 방법에 대한 자세한 내용은 [관리 뷰](https://help.tableau.com/current/server/ko-kr/adminview.htm) 를 참조하십시오. Desktop 라이선스 만료 뷰는 서버 관리자에게 조직에서 만료되거나 유지 관리 갱신이 필요한 Tableau Desktop 라이선스에 대한 정보를 제공합니다. 이를 통해 라이선스를 효율적으로 관리할 수 있습니다. 이 뷰에서 다음과 같은 질문에 대한 답을 구할 수 있습니다. - 만료된 한시적 라이선스는 무엇입니까? - 유지 관리가 만료된 영구 라이선스는 무엇입니까? - 유지 관리 갱신이 임박한 영구 라이선스는 무엇입니까? 라이선스를 갱신하거나 추가 갱신 정보를 가져오려면 [Tableau 라이선스 갱신 방법](https://www.tableau.com/ko-kr/support/renew)을 참조하십시오. **참고:** 라이선스 관련 데이터를 가져오려면 Tableau Server로 데이터를 전송하도록 각 Tableau Desktop의 복사본을 구성해야 합니다. 이 구성은 설치 시점에 Tableau를 설치하고 구성하는 스크립트 처리나 타사 소프트웨어를 사용하여 수행할 수 있습니다. 자세한 내용은 [Desktop 라이선스 보고 구성](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_reporting_admin.htm)을 참조하십시오. 라이선스 데이터를 보려면 Tableau Server에서 Desktop 라이선스 보고를 사용하도록 설정해야 합니다. 자세한 내용은 [Desktop 라이선스 보고 사용 및 구성](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_reporting_admin.htm#enable)을 참조하십시오. 필터: - **제품 키** - 문자열을 입력하여 라이선스에서 해당 문자열을 포함하는 라이선스만 표시하도록 대시보드를 필터링합니다. 예를 들어 TDTD로 시작하는 라이선스만 표시하려면 TDTD를 입력하고 Return 키를 눌러 뷰를 필터링합니다. 문자열 다음에 있는 "x" 표시를 클릭하면 필터가 재설정됩니다. - **부서** - 이 필터를 사용하여 대시보드에 라이선스를 표시할 부서를 제어할 수 있습니다. 이 필터는 Tableau Desktop 복사본을 등록할 때 사용한 부서 값을 기반으로 채워집니다. - **기간** - 이 필터를 사용하여 대시보드에 정보를 표시할 기간을 제어할 수 있습니다. 이 뷰에는 다음과 같은 테이블이 포함되어 있으며, 이러한 테이블은 뷰의 맨 위에서 설정한 필터의 영향을 받습니다. - What keys have expired maintenance(유지 관리가 만료된 키) - 이 테이블에서는 유지 관리가 만료된 제품 키와 유지 관리를 갱신할 수 있는 6개월의 기간이 마감되는 시점을 나타내는 수직선을 보여 줍니다. 키 유지 관리가 만료된 기간이 6개월이 넘은 경우 지원 또는 업그레이드 자격을 얻으려면 새 키를 구매해야 합니다. - **What term licenses have expired**(만료된 한시적 라이선스) - 만료된 한시적 제품 키를 보여 줍니다. - What is the maintenance schedule for my keys(내 키에 대한 유지 관리 일정) - 키와 해당 유지 관리 상태를 보여 줍니다. [주요 콘텐츠로 건너뛰기](#main-content) # Desktop 라이선스 보고 문제 해결 Tableau Server 및 Tableau Desktop 인스턴스가 올바르게 구성된 경우 2개의 관리 뷰, 즉 [Desktop 라이선스 사용량](https://help.tableau.com/current/server/ko-kr/adminview_desktop_license_usage.htm) 및 [Desktop 라이선스 만료](https://help.tableau.com/current/server/ko-kr/adminview_desktop_license_expiration.htm)에서 Tableau Desktop 라이선스 사용량 정보를 볼 수 있습니다. 이러한 뷰가 표시되지 않으면 아래의 요구 사항을 확인하십시오. 뷰가 표시되지만 뷰 안에 데이터가 없는 경우 Desktop 배포 가이드: [라이선스 보고 문제 해결](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_troubleshoot.htm#trouble)의 문제 해결 항목을 참조하여 문제를 해결할 수 있습니다. Tableau Desktop을 구성하는 방법에 대한 자세한 내용은 Tableau Desktop 배포 가이드의 [Desktop 라이선스 보고 구성](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_reporting_admin.htm)을 참조하십시오. ## 관리 뷰를 사용할 수 없음 Desktop 라이선스 보고 관리 뷰는 Tableau Server 관리자만 사용할 수 있습니다. 서버 상태 페이지(사이트 메뉴에서 모든 사이트 관리 선택)에 Desktop 라이선스 사용량 및 Desktop 라이선스 만료 뷰에 대한 링크가 표시되지 않는 경우 다음을 확인합니다. - Tableau Server 관리자로 로그인되어 있습니다. - 관리자가 실행하는 Tableau Server 버전이 10.0 이상이고 사용자가 실행하는 Tableau Desktop 버전이 10.0 이상입니다. Desktop 라이선스 보고는 Tableau Server 및 Tableau Desktop 10.0 버전부터 제공됩니다. - Tableau Server에 Desktop 라이선스 보고 기능이 설정되어 있습니다. (이 기능은 기본적으로 해제되어 있습니다.) 자세한 내용은 [Desktop 라이선스 보고 사용 및 구성](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_reporting_admin.htm#enable)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Desktop 라이선스 사용량 **참고:** 이 뷰는 서버 관리자만 사용할 수 있습니다. 다중 사이트 배포의 서버 뷰에 액세스하려면 사이트 메뉴를 클릭한 다음 **모든 사이트 관리**를 선택합니다. 관리 뷰 탐색 방법에 대한 자세한 내용은 [관리 뷰](https://help.tableau.com/current/server/ko-kr/adminview.htm) 를 참조하십시오. 서버 관리자가 Desktop 라이선스 사용량 뷰를 사용하여 조직의 Tableau Desktop 라이선스 사용량 데이터를 확인할 수 있습니다. 이를 통해 라이선스를 효율적으로 관리하고 라이선스 수가 많거나 적은지를 결정할 수 있습니다. 이 뷰에서 다음과 같은 질문에 대한 답을 구할 수 있습니다. - 회사에서 Tableau Desktop 라이선스를 사용하고 있는 사람은 누구입니까? - 공유되거나 양도된 라이선스가 있습니까? - 사용되어서는 안 되는 컴퓨터에서 사용되고 있는 라이선스가 있습니까? - 특정 사용자가 자신의 라이선스를 사용하고 있습니까? - 회사에서 사용되고 있는 라이선스의 유형은 무엇입니까? **참고:** 라이선스 관련 데이터를 가져오려면 Tableau Server로 데이터를 전송하도록 각 Tableau Desktop의 복사본을 구성해야 합니다. 이 구성은 설치 시점에 Tableau를 설치하고 구성하는 스크립트 처리나 타사 소프트웨어를 사용하거나 설치 후에 레지스트리 또는 속성 목록 파일을 수정하여 수행할 수 있습니다. 자세한 내용은 [Desktop 라이선스 보고 구성](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_reporting_admin.htm)을 참조하십시오. 라이선스 데이터를 보려면 Tableau Server에서 Desktop 라이선스 보고를 사용하도록 설정해야 합니다. 자세한 내용은 [Desktop 라이선스 보고 사용 및 구성](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_reporting_admin.htm#enable)을 참조하십시오. 필터 - **제품 키**. 문자열을 입력하여 제품 키에 해당 문자열이 포함된 라이선스만 표시하도록 대시보드를 필터링합니다. 예를 들어 TDTD로 시작하는 라이선스만 표시하려면 TDTD를 입력하고 Return 키를 눌러 뷰를 필터링합니다. 필터를 재설정하려면 문자열 다음에 있는 X를 클릭합니다. - **동작**. 이 필터를 사용하여 수행된 동작을 기반으로 대시보드에 표시되는 항목을 제어합니다. 동작에는 **활성화**, 사용 및 반환(비활성화)이 있습니다. 사용 동작을 선택하지 않으면 상단 막대 그래프에 아무것도 표시되지 않습니다. - **부서**. 이 필터를 사용하여 대시보드에 라이선스를 표시할 부서를 제어할 수 있습니다. 이 필터는 Tableau Desktop을 등록할 때 지정한 부서 값을 기반으로 채워집니다. - **기간 선택(일)**. 이 슬라이더를 사용하여 대시보드에 정보를 표시할 기간(일)을 지정합니다. 기본값은 183일입니다. 처음 세 필터의 필터 카드를 마우스오버하면 드롭다운 아이콘이 나타납니다. 이 아이콘을 클릭하여 뷰에 필터와 일치하는 데이터를 포함할지(기본값), 아니면 필터와 일치하는 데이터를 제외할지를 지정합니다. ![값 포함 및 값 제외의 두 가지 옵션이 있는 드롭다운 메뉴입니다.](/tableau/current/ko-kr/server/ko-kr/Img/filter_include_exclude.png) ## **지난 일간 Tableau를 사용한 사용자는 누구입니까?** 이 대시보드 영역에는 Tableau Desktop 라이선스 유형(영구 및 한시적)의 막대 그래프와 지정된 기간 동안 각 라이선스 유형을 사용한 사용자의 수가 표시됩니다. 라이선스 유형을 마우스오버하면 라이선스 유형에 대한 설명이 표시됩니다. 세그먼트를 클릭하면 해당 라이선스 유형만 표시되도록 대시보드에서 나머지 유형이 필터링됩니다. 이 동작은 사용된 라이선스와 사용되지 않은 라이선스를 보여 주는 두 테이블을 모두 필터링합니다. 예를 들어 해당 기간 동안 사용된 한시적 라이선스의 목록을 보려면 한시적 막대를 클릭하십시오. "사용됨" 및 "사용되지 않음" 목록이 한시적 라이선스만 표시하도록 필터링됩니다. 막대 그래프 아래에 자세한 정보를 보여 주는 테이블이 표시됩니다. 테이블의 각 행에는 오른쪽의 시간 표시줄 위에 동작이 마지막으로 실행된 시간을 보여 주는 동작 아이콘이 표시됩니다. 이메일이나 제품 키 같은 값을 선택하고 복사할 수 있는 형식으로 기초 데이터 목록을 표시하려면 라이선스 목록의 행을 클릭하고 데이터 보기 아이콘을 클릭하십시오. ![데이터 보기 아이콘입니다.](/tableau/current/ko-kr/server/ko-kr/Img/view_data.png) 데이터가 요약 형식으로 표시됩니다. 모든 데이터를 표시하려면 전체 데이터를 클릭하십시오. 이 뷰에서 개별 값을 선택하여 복사하거나 데이터를 텍스트 파일로 다운로드할 수 있습니다. ## **지난 일간 사용되지 않은 라이선스는 무엇입니까?** 이 대시보드 영역에는 지정된 기간 동안 사용되지 않은 라이선스 목록이 표시됩니다. 시간 표시줄에는 마지막 사용 날짜가 표시됩니다. 마지막 사용 날짜 마크를 마우스오버하면 Tableau 복사본의 등록된 사용자를 비롯한 정보가 제공됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # Dremio에 대한 OAuth 설정 이 항목에서는 Dremio 데이터 원본을 OAuth 인증에 맞게 설정하는 방법을 설명합니다. Tableau Server 인스턴스마다 이 단계를 완료합니다. Dremio에 대한 OAuth 설정은 다음 작업으로 구성됩니다. 1. Dremio에 OAuth 클라이언트를 등록합니다. 2. 1단계에서 가져온 정보를 사용하여 Dremio OAuth에 Tableau Server를 구성합니다. 3. (선택 사항) 사이트별 OAuth를 구성합니다. ## 1단계: Dremio에서 OAuth 클라이언트 등록 Dremio 설명서의 [ID 공급자(영문)](https://docs.dremio.com/cloud/api/identity-providers/) 항목을 참조하여 Dremio 지원 IdP를 구성하고 Dremio OAuth에 대해 Tableau Server를 구성하는 데 필요한 OAuth 클라이언트 ID 및 암호 구성 매개 변수를 얻습니다. ## 2단계: Dremio OAuth에 대해 Tableau Server 구성 Dremio OAuth에 대해 Tableau Server를 구성하려면 다음에 나오는 tsm 명령에 아래 나열된 매개 변수를 사용합니다. - **Dremio 클라이언트 ID:** 클라이언트 ID는 1단계의 등록 프로세스 도중 생성됩니다. tsm 명령에서 `[your_client_id]`에 이 값을 복사합니다. - **Dremio 클라이언트 암호:** 클라이언트 암호는 1단계의 절차에서 생성됩니다. tsm 명령에서 `[your_client_secret]`에 이 값을 복사합니다. - **Tableau Server URL:** Tableau Server URL(예: `https://myco.com`)입니다. tsm 명령에서 `[your_server_url]`에 이 값을 복사합니다. - **구성 ID:** tsm 명령 `dremio`에서 사용할 매개 변수 `oauth.config.id`의 값입니다. 다음 tsm 명령을 실행하여 Dremio에 대해 OAuth를 구성합니다. `tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys` `tsm pending-changes apply` ### 여러 커넥터 설정 여러 커넥터를 설정해야 하는 경우 단일 명령에 모든 커넥터를 포함해야 합니다. 예를 들면 다음과 같습니다.  `tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys` `tsm pending-changes apply` ## 사이트에 대해 사용자 지정 OAuth 구성 사이트에 대해 사용자 지정 Dremio OAuth를 구성할 수 있습니다. 1) 서버에 구성된 OAuth 클라이언트를 재정의하거나 2) 고유한 OAuth 클라이언트가 필요한 데이터에 대한 안전한 연결을 지원하려면 사용자 지정 OAuth 클라이언트를 구성하는 것이 좋습니다. 사용자 지정 OAuth 클라이언트를 구성하면 사이트 수준 구성이 서버 측 구성보다 우선하며 생성된 모든 새로운 OAuth 자격 증명에 사이트 수준 OAuth 클라이언트가 기본적으로 사용됩니다. Tableau Server를 다시 시작하지 않아도 구성이 적용됩니다. **중요:** 사용자 지정 기존 OAuth 클라이언트를 구성하기 전에 설정된 OAuth 자격 증명은 임시로 사용 가능하지만 중단 없는 데이터 액세스를 보장하려면 서버 관리자와 사용자 모두가 저장된 자격 증명을 업데이트해야 합니다. ### 1: OAuth 클라이언트 ID value, 클라이언트 암호 값 및 리디렉션 URL 준비 사용자 지정 OAuth 클라이언트를 구성하려면 아래에 나열된 정보가 필요합니다. 이 정보를 준비한 후 사이트에 대한 사용자 지정 OAuth 클라이언트를 등록할 수 있습니다. - **OAuth 클라이언트 ID 및 클라이언트 암호 값:** 먼저 OAuth 클라이언트를 데이터 공급자(커넥터)에 등록하여 Tableau Server용으로 생성된 클라이언트 ID와 암호 값을 검색합니다. - **리디렉션 URL:** 올바른 리디렉션 URL을 기록합니다. 아래 **2단계**의 등록 프로세스 중에 필요합니다. https://.com/auth/add\_oauth\_token 예: https://example.com/auth/add\_oauth\_token ### 2: OAuth 클라이언트 ID 및 클라이언트 암호 등록 아래에 설명된 절차에 따라 사용자 지정 OAuth 클라이언트를 사이트에 등록합니다. 1. 관리자 자격 증명을 사용하여 Tableau Server 사이트에 로그인하고 설정 페이지로 이동합니다. 2. OAuth 클라이언트 레지스트리에서 OAuth 클라이언트 추가 단추를 클릭합니다. 3. 위의 **1단계**의 정보를 포함하여 필요한 정보를 입력합니다. 1. 연결 유형의 경우 사용자 지정 OAuth 클라이언트를 구성하려는 커넥터를 선택합니다. 2. OAuth 인스턴스 URL은 여러 OAuth 클라이언트가 등록되는 경우에 필요합니다. 그 외에는 선택 사항입니다. 3. 클라이언트 ID, 클라이언트 암호 및 리디렉션 URL의 경우 위의 **1단계**에서 준비한 정보를 입력합니다. 4. OAuth 클라이언트 추가 단추를 클릭하여 등록 프로세스를 완료합니다. ![OAuth 클라이언트를 생성하기 위한 양식이며, 연결 유형, OAuth 인스턴스 URL, 클라이언트 ID, 클라이언트 암호, 리디렉션 URL에 대한 필드가 포함되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/oauth_custom.png) 4. (선택 사항) 지원되는 모든 커넥터에 대해 3단계를 반복합니다. 5. 설정 페이지의 맨 아래 또는 맨 위에 있는 저장 단추를 클릭하여 변경 내용을 저장합니다. ### 3: 저장된 자격 증명의 유효성 검사 및 업데이트 중단 없는 데이터 액세스를 보장하려면 관리자(및 사이트 사용자)가 이전에 저장된 자격 증명을 삭제하고 다시 추가하여 사이트에 사용자 지정 OAuth 클라이언트를 사용해야 합니다. 1. 내 계정 설정 페이지로 이동합니다. 2. 데이터 원본의 저장된 자격 증명에서 다음을 수행합니다. 1. 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 기존의 저장된 자격 증명 옆에서 삭제를 클릭합니다. 2. 커넥터 이름 옆에서 추가를 클릭하고 표시되는 메시지에 따라 1) 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트에 연결하고 2) 최신 자격 증명을 저장합니다. ### 4: 사용자에게 저장된 자격 증명을 업데이트하도록 알림 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 저장된 자격 증명을 업데이트하도록 사이트 사용자에게 알립니다. 사이트 사용자는 [저장된 자격 증명 업데이트](https://help.tableau.com/current/server/ko-kr/manage_stored_credentials.htm#oauth_update_credentials)에 설명된 절차를 사용하여 저장된 자격 증명을 업데이트할 수 있습니다. ## OAuth 인증에 대한 정방향 프록시 Tableau Server의 OAuth 인증으로 정방향 프록시를 설정하는 방법(Windows만 해당)에 대한 자세한 내용은 Tableau 도움말에서 [OAuth 인증에 대한 정방향 프록시 구성](https://help.tableau.com/current/pro/desktop/ko-kr/config_proxy_oauth.htm#server)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Dropbox에 대한 OAuth 설정 이 항목에서는 Dropbox 데이터 원본을 OAuth 인증에 맞게 설정하는 방법을 설명합니다. Tableau Server 인스턴스마다 이 단계를 완료합니다. Dropbox에 대한 OAuth 설정은 다음 작업으로 구성됩니다. 1. Dropbox 개발자 포털 앱 콘솔에서 새 앱을 만듭니다. 2. 새 앱을 만드는 과정에서 얻은 정보를 사용하여 서버를 구성합니다. 3. (선택 사항) 사이트별 OAuth를 구성합니다. ## 1단계: 새 앱 만들기 1. Dropbox 개발자 콘솔에 로그인하고 **App console**(앱 콘솔)을 선택합니다. 2. **Create app**(앱 만들기) 단추를 클릭합니다. 3. 앱을 구성하고 이름을 지정한 다음 **Create app**(앱 만들기) 단추를 선택합니다. 4. 앱을 만든 후 Permissions(사용 권한) 탭으로 이동하여 files.content.read 사용 권한이 선택되어 있는지 확인합니다. 5. **Settings**(설정) 탭으로 이동하고 Tableau Server의 인터넷 주소를 사용하여 리디렉션 URI를 추가합니다. 6. URI 끝에 auth/add\_oauth\_token 텍스트를 추가합니다. 예: 7. https://your\_server\_url.com/auth/add\_oauth\_token 8. **Settings**(설정) 탭에서 앱 키, 앱 암호 및 리디렉션 URI를 복사합니다. ## 2단계: Dropbox에 대한 Tableau Server 구성 Tableau Server 컴퓨터에서 bash 셸을 열고 다음 tsm 명령을 실행합니다. `tsm configuration set -k oauth.dropbox.redirect_uri -v ` `tsm configuration set -k oauth.dropbox.client_id -v ` `tsm configuration set -k oauth.dropbox.client_secret -v ` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하기 위해 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 변경 내용이 메시지 없이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 사이트에 대해 사용자 지정 OAuth 구성 사이트에 대해 사용자 지정 Dropbox OAuth를 구성할 수 있습니다. 1) 서버에 구성된 OAuth 클라이언트를 재정의하거나 2) 고유한 OAuth 클라이언트가 필요한 데이터에 대한 안전한 연결을 지원하려면 사용자 지정 OAuth 클라이언트를 구성하는 것이 좋습니다. 사용자 지정 OAuth 클라이언트를 구성하면 사이트 수준 구성이 서버 측 구성보다 우선하며 생성된 모든 새로운 OAuth 자격 증명에 사이트 수준 OAuth 클라이언트가 기본적으로 사용됩니다. Tableau Server를 다시 시작하지 않아도 구성이 적용됩니다. **중요:** 사용자 지정 기존 OAuth 클라이언트를 구성하기 전에 설정된 OAuth 자격 증명은 임시로 사용 가능하지만 중단 없는 데이터 액세스를 보장하려면 서버 관리자와 사용자 모두가 저장된 자격 증명을 업데이트해야 합니다. ### 1: OAuth 클라이언트 ID value, 클라이언트 암호 값 및 리디렉션 URL 준비 사용자 지정 OAuth 클라이언트를 구성하려면 아래에 나열된 정보가 필요합니다. 이 정보를 준비한 후 사이트에 대한 사용자 지정 OAuth 클라이언트를 등록할 수 있습니다. - **OAuth 클라이언트 ID 및 클라이언트 암호 값:** 먼저 OAuth 클라이언트를 데이터 공급자(커넥터)에 등록하여 Tableau Server용으로 생성된 클라이언트 ID와 암호 값을 검색합니다. - **리디렉션 URL:** 올바른 리디렉션 URL을 기록합니다. 아래 **2단계**의 등록 프로세스 중에 필요합니다. https://.com/auth/add\_oauth\_token 예: https://example.com/auth/add\_oauth\_token ### 2: OAuth 클라이언트 ID 및 클라이언트 암호 등록 아래에 설명된 절차에 따라 사용자 지정 OAuth 클라이언트를 사이트에 등록합니다. 1. 관리자 자격 증명을 사용하여 Tableau Server 사이트에 로그인하고 설정 페이지로 이동합니다. 2. OAuth 클라이언트 레지스트리에서 OAuth 클라이언트 추가 단추를 클릭합니다. 3. 위의 **1단계**의 정보를 포함하여 필요한 정보를 입력합니다. 1. 연결 유형의 경우 사용자 지정 OAuth 클라이언트를 구성하려는 커넥터를 선택합니다. 2. OAuth 인스턴스 URL은 여러 OAuth 클라이언트가 등록되는 경우에 필요합니다. 그 외에는 선택 사항입니다. 3. 클라이언트 ID, 클라이언트 암호 및 리디렉션 URL의 경우 위의 **1단계**에서 준비한 정보를 입력합니다. 4. OAuth 클라이언트 추가 단추를 클릭하여 등록 프로세스를 완료합니다. ![OAuth 클라이언트를 생성하기 위한 양식이며, 연결 유형, OAuth 인스턴스 URL, 클라이언트 ID, 클라이언트 암호, 리디렉션 URL에 대한 필드가 포함되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/oauth_custom.png) 4. (선택 사항) 지원되는 모든 커넥터에 대해 3단계를 반복합니다. 5. 설정 페이지의 맨 아래 또는 맨 위에 있는 저장 단추를 클릭하여 변경 내용을 저장합니다. ### 3: 저장된 자격 증명의 유효성 검사 및 업데이트 중단 없는 데이터 액세스를 보장하려면 관리자(및 사이트 사용자)가 이전에 저장된 자격 증명을 삭제하고 다시 추가하여 사이트에 사용자 지정 OAuth 클라이언트를 사용해야 합니다. 1. 내 계정 설정 페이지로 이동합니다. 2. 데이터 원본의 저장된 자격 증명에서 다음을 수행합니다. 1. 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 기존의 저장된 자격 증명 옆에서 삭제를 클릭합니다. 2. 커넥터 이름 옆에서 추가를 클릭하고 표시되는 메시지에 따라 1) 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트에 연결하고 2) 최신 자격 증명을 저장합니다. ### 4: 사용자에게 저장된 자격 증명을 업데이트하도록 알림 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 저장된 자격 증명을 업데이트하도록 사이트 사용자에게 알립니다. 사이트 사용자는 [저장된 자격 증명 업데이트](https://help.tableau.com/current/server/ko-kr/manage_stored_credentials.htm#oauth_update_credentials)에 설명된 절차를 사용하여 저장된 자격 증명을 업데이트할 수 있습니다. ## OAuth 인증에 대한 정방향 프록시 Tableau Server의 OAuth 인증으로 정방향 프록시를 설정하는 방법(Windows만 해당)에 대한 자세한 내용은 Tableau 도움말에서 [OAuth 인증에 대한 정방향 프록시 구성](https://help.tableau.com/current/pro/desktop/ko-kr/config_proxy_oauth.htm#server)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Einstein Discovery 통합 구성 버전 2021.1.0부터 Tableau Server는 Einstein Discovery 통합을 지원합니다. 따라서 통합 문서 및 대시보드의 작성자와 Viewer(뷰어)에게 Einstein Discovery 예측을 제공할 수 있습니다. 이제 버전 2021.2.0부터 Einstein Discovery 예측을 웹에서 흐름을 작성할 때 사용할 수 있습니다. Einstein Discovery in Tableau는 [salesforce.com](http://salesforce.com/)에 의해 제공됩니다. 해당 약관에 대해서는 [salesforce.com](http://salesforce.com/)과의 계약을 참조하십시오. Einstein Discovery를 Tableau Server와 통합하려면 Tableau Server에서 필요한 일부 구성 단계를 수행하고 Einstein Discovery를 실행하는 Salesforce 조직에서 일부 단계를 수행해야 합니다. 이 개요에서는 대시보드 확장 프로그램, 분석 확장 프로그램과 Tableau Prep 확장 프로그램에 대한 단계를 설명하고 서버 구성을 완료하기 위한 단계가 포함된 특정 항목에 대한 링크를 제공합니다. 라이선스 및 사용 권한 요구 사항을 포함하여 Tableau에서 Einstein Discovery 예측을 사용하는 방법에 대한 자세한 내용은 Tableau Desktop 및 웹 작성 도움말에서 [Tableau에서 Einstein Discovery 예측 통합](https://help.tableau.com/current/pro/desktop/ko-kr/einstein_discovery_predictions.htm)을 참조하십시오. 흐름에 예측을 추가하는 방법에 대한 자세한 내용은 [흐름에 Einstein Discovery 예측 추가](https://help.tableau.com/current/prep/ko-kr/prep_predictions.htm)를 참조하십시오. ## Einstein Discovery 대시보드 확장 프로그램 Einstein Discovery 대시보드 확장 프로그램을 사용하면 통합 문서 작성자가 Tableau에서 실시간 예측을 표시할 수 있습니다. 대시보드 확장 프로그램은 Tableau 통합 문서의 원본 데이터와 Salesforce에 배포 된 Einstein Discovery 기반 모델을 사용하여 필요 시 대화형으로 예측을 제공합니다. Einstein Discovery 대시보드 확장 프로그램에 대해 Tableau Server를 구성하려면 다음을 수행해야 합니다. 1. Tableau Server: 1. 저장된 OAuth 토큰을 Tableau Server의 데이터 연결 및 확장 프로그램에 사용하도록 설정합니다. [저장된 액세스 토큰 허용](https://help.tableau.com/current/server/ko-kr/allow_saved_tokens.htm) 2. 서버에 대한 대시보드 확장 프로그램을 사용하도록 설정합니다. [Tableau Server에서 대시보드 및 비주얼리제이션 확장 프로그램 관리](https://help.tableau.com/current/server/ko-kr/dashboard_extensions_server.htm)를 참조하십시오. 2. Einstein Discovery를 실행하는 조직의 Salesforce: 1. [Salesforce.com에서 Tableau Server의 Einstein Discovery 통합에 대한 CORS 구성](https://help.tableau.com/current/server/ko-kr/config_cors_sfdc.htm)합니다. 2. Tableau CRM을 실행하는 조직의 Salesforce에서 연결된 앱을 만듭니다. [1단계: Salesforce에서 앱 통합 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#createSF-connectedApp)를 참조하십시오. 3. Tableau Server에서 연결된 앱의 정보를 사용하여 저장된 SF OAuth 자격 증명에 대해 서버를 구성합니다. [2단계: Salesforce.com OAuth에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#configServerSF-SavedOAuth) ## Einstein Discovery 분석 확장 프로그램 Einstein Discovery 분석 확장 프로그램은 사용자가 Tableau의 계산된 필드에 직접 예측을 포함할 수 있는 기능을 제공합니다. 테이블 계산 스크립트는 모델에 필요한 관련 예측 ID 및 입력 데이터를 전달하여 Salesforce에 배포된 모델의 예측을 요청합니다. Salesforce에서 모델 관리자를 사용하여 Tableau 테이블 계산 스크립트를 자동 생성한 다음 이 스크립트를 Tableau 통합 문서에서 사용할 계산된 필드에 붙여 넣습니다. Einstein Discovery 분석 확장 프로그램에 대해 Tableau Server를 구성하려면 다음을 수행해야 합니다. 1. Tableau Server: 1. 저장된 OAuth 토큰을 Tableau Server의 데이터 연결 및 확장 프로그램에 사용하도록 설정합니다. [저장된 액세스 토큰 허용](https://help.tableau.com/current/server/ko-kr/allow_saved_tokens.htm) 2. 서버에 분석 확장 프로그램을 사용하도록 설정하고 연결 유형을 구성합니다. 자세한 내용은 [분석 확장 프로그램에 대한 연결 구성](https://help.tableau.com/current/server/ko-kr/config_r_tabpy.htm)을 참조하십시오. 2. Einstein Discovery를 실행하는 조직의 Salesforce에서 연결된 앱을 만듭니다. [1단계: Salesforce에서 앱 통합 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#createSF-connectedApp)를 참조하십시오. 3. Tableau Server에서 연결된 앱의 정보를 사용하여 저장된 SF OAuth 자격 증명에 대해 서버를 구성합니다. [2단계: Salesforce.com OAuth에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#configServerSF-SavedOAuth) ## Einstein Discovery Tableau Prep 확장 프로그램 _버전 2021.2.0부터 Tableau Server 및 Tableau Cloud에서 지원됨_ Einstein Discovery Tableau Prep 확장 프로그램을 통해 사용자는 웹에서 흐름을 작성할 때 흐름에 Einstein 예측을 직접 내장할 수 있습니다. Einstein Discovery Tableau Prep 확장 프로그램에 대해 Tableau Server 또는 Tableau Cloud를 구성하려면 다음을 수행해야 합니다. 1. Tableau Server: 1. 저장된 OAuth 토큰을 Tableau Server의 데이터 연결 및 확장 프로그램에 사용하도록 설정합니다. [저장된 액세스 토큰 허용](https://help.tableau.com/current/server/ko-kr/allow_saved_tokens.htm)을 참조하십시오. 2. 서버에 대해 Tableau Prep 확장 프로그램을 사용하도록 설정합니다. [Tableau Prep 확장 프로그램 사용](https://help.tableau.com/current/server/ko-kr/web_author_flows.htm#prep_extensions)을 참조하십시오. 2. Einstein Discovery를 실행하는 조직의 Salesforce에서 연결된 앱을 만듭니다. [1단계: Salesforce에서 앱 통합 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#createSF-connectedApp)를 참조하십시오. 3. Tableau Server에서 연결된 앱의 정보를 사용하여 저장된 SF OAuth 자격 증명에 대해 서버를 구성합니다. [2단계: Salesforce.com OAuth에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#configServerSF-SavedOAuth) ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Eventing 상태 가져오기 Tableau Server 환경에서 Tableau Catalog(또는 Tableau Metadata API)를 사용하도록 설정한 후 Eventing API를 사용하여 인덱싱 성능을 측정할 수 있습니다. 아래에 설명된 단계는 서버 관리자가 수행해야 합니다. ## 1단계: REST API를 사용하여 인증 Eventing API에 액세스하려면 먼저 Tableau Server에 대해 인증하고 토큰을 가져와야 합니다. 이 작업은 Tableau REST API를 사용하여 수행할 수 있습니다. 자세한 내용은 REST API 도움말에서 [로그인 및 로그아웃(인증)](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm)을 참조하십시오. 또는 관리자 자격 증명을 사용하여 Tableau Server에 로그인할 수 있습니다. ## 2단계: GET 요청 수행 다음 GET 요청을 수행하거나 URL을 브라우저에 붙여 넣습니다. http://my\_tableau\_server/api/metadata/v1/control/eventing/status ### 응답의 상태 값 Eventing API는 다음 값을 반환합니다. - `contentType`은 가장 최근에 인덱싱된 콘텐츠 유형입니다. - `queueSize`는 인덱싱 큐의 항목 수입니다. 큐 크기가 클수록 항목이 Catalog 또는 Metadata API에 표시되는 데 걸리는 시간이 더 길어질 수 있습니다. 큐 크기가 시간이 지남에 따라 증가하는 경우 비대화형 컨테이너 및 인덱싱 프로세스를 지원하도록 백그라운더 기능을 조정해야 할 수 있습니다. 자세한 내용은 [비대화형 마이크로서비스 컨테이너의 메모리](https://help.tableau.com/current/server/ko-kr/dm_catalog_enable.htm#Memory)을 참조하십시오. - `checkpointCreatedTime`은 항목이 인덱싱된 마지막 기록 시간(UTC)입니다. Eventing API는 5분마다 마지막으로 인덱싱된 항목을 확인합니다. ### 예제 응답 요청은 JSON 텍스트를 반환합니다. JSON을 더 읽기 쉬운 형식으로 보려면 JSON 뷰어 또는 브라우저 추가 기능을 사용할 수 있습니다. { "contentType": "PublishedDatasource", "queueSize": 312, "checkpointCreatedTime": "2020-07-29T23:50:25.763Z" } [주요 콘텐츠로 건너뛰기](#main-content) # gatewaySettings 엔터티 Tableau Server 컴퓨터의 게이트웨이 설정을 구성해야 합니다. 아래의 구성 파일 템플릿을 사용하여 json 파일을 만듭니다. 옵션을 적절한 값으로 채운 후 다음 명령으로 json 파일을 전달하고 설정을 적용합니다. `tsm settings import -f /path/to/file.json` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ### 게이트웨이 설정 아래 템플릿의 게이트웨이 설정은 Tableau Server에 대한 HTTP 설정을 지정합니다. SSL/TLS를 사용하는 것이 좋습니다. Tableau Server는 SSL/TLS에 포트 443을 사용하도록 하드 코딩되어 있습니다. 따라서 SSL을 사용하도록 설정한 경우 gatewaySettings 엔터티를 업데이트할 필요가 없습니다. ### 구성 템플릿 이 템플릿을 사용하여 게이트웨이 설정을 구성합니다. **중요:** 모든 엔터티 옵션은 대/소문자를 구분합니다. 구성 파일, 엔터티 및 키에 대한 자세한 설명은 [구성 파일 예제](https://help.tableau.com/current/server/ko-kr/config_file_example.htm)를 참조하십시오. { "configEntities": { "gatewaySettings": { "\_type": "gatewaySettingsType", "port": 80, "sslRedirectEnabled": true, "publicHost": "localhost" } } } ### 구성 파일 참조 다음 표에는 `"gatewaySettings"` 엔터티 집합과 함께 포함할 수 있는 모든 옵션이 나열되어 있습니다. \_type 필수 항목입니다. 값: `"gatewaySettingsType"` 변경하지 마십시오. port HTTP 포트를 지정합니다. 기본값은 포트 80입니다. sslRedirectEnabled 옵션: `true` 또는 `false` publicHost http/s 서비스의 호스트 이름을 지정합니다. trustedIPs Tableau Server와 통신하는 신뢰할 수 있는 IP 주소를 지정합니다. 신뢰할 수 있는 IP 주소에는 업스트림 프록시 서버 및 Tableau Server의 신뢰할 수 있는 인증에 사용되는 서버가 포함됩니다. [Tableau Server에 대한 프록시 및 부하 분산 장치 구성](https://help.tableau.com/current/server/ko-kr/proxy.htm) 및 [Tableau Server에 신뢰할 수 있는 IP 주소 또는 호스트 이름 추가](https://help.tableau.com/current/server/ko-kr/trusted_auth_trustIP.htm)를 참조하십시오. Tableau Server를 클러스터에서 실행 중인 경우 클러스터의 다른 모든 노드는 이 엔터티가 업데이트하는 해당 구성 파일에 자동으로 포함됩니다. 따라서 `trustedIPs`에 대해 새 값을 지정하는 경우 다른 노드의 IP 주소를 값에 포함시켜야 합니다. 이 옵션에는 문자열 목록을 사용하며, 각 IP 또는 호스트를 따옴표로 묶고 쉼표로 구분(공백 없이)한 후 대괄호로 묶어 전달해야 합니다. 예를 들어 `["192.168.1.101","192.168.1.102","192.168.1.103"]` 또는 `["webserv1","webserv2","webserv3"]`을 사용할 수 있습니다. trustedHosts Tableau Server와 통신하는 신뢰할 수 있는 IP 주소를 지정합니다. 일반적으로 이 값에는 업스트림 프록시 서버 목록이 포함됩니다. trustedHosts의 값은 클라이언트 요청 대상을 결정하는 데 사용됩니다. Tableau Server를 클러스터에서 실행 중인 경우 클러스터의 다른 모든 노드는 이 엔터티가 업데이트하는 해당 구성 파일에 자동으로 포함됩니다. 따라서 `trustedIPs`에 대해 새 값을 지정하는 경우 다른 노드의 IP 주소를 값에 포함시켜야 합니다. 이 옵션에는 문자열 목록을 사용하며, 각 IP 또는 호스트를 따옴표로 묶고 쉼표로 구분(공백 없이)한 후 대괄호로 묶어 전달해야 합니다. 예를 들어 `["192.168.1.101","192.168.1.102","192.168.1.103"]` 또는 `["webserv1","webserv2","webserv3"]`을 사용할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Google Cloud Platform 기반 Tableau Server 문제 해결 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 GCE(Google Compute Engine) VM(가상 컴퓨터) 기반 Tableau Server에서 문제가 발생하거나 설치 후 Tableau Server에 액세스하는 데 문제가 발생하는 경우 다음 문제 해결 팁을 검토하십시오. - **RDP를 사용하여 VM에 연결할 수 없음** 다음 문제가 하나 이상 있는 경우 RDP를 사용하여 VM에 연결하지 못할 수 있습니다. - 올바른 자격 증명을 사용하고 있는지 확인합니다. - **다른 사용자** 옵션을 선택하고 자격 증명을 입력합니다. - GCP 인스턴스에서 유효한 사용자 이름을 사용하고 있는지 확인합니다. 예를 들어 **myuser**라는 관리자 계정으로 인스턴스를 만든 경우 RDP 대화 상자에서 **.\\myuser**를 사용자 이름으로 입력합니다. - **원격 브라우저에서 서버에 액세스할 수 없음** 다음 문제가 하나 이상 있는 경우 원격 브라우저를 사용하여 서버에 액세스하지 못할 수 있습니다. - 인스턴스에 로그인하고 서버가 실행 중인지 확인합니다. - 인스턴스에서 브라우저를 열고 서버에 로컬로 액세스합니다(예: http://localhost 또는 http://localhost:port. 여기서 port는 서버의 수신 포트로 구성된 포트 번호임). - GCP Compute Engine 콘솔에서 인스턴스에 대한 HTTP 트래픽을 허용하도록 끝점을 구성했는지 확인합니다. **참고:** Windows ping 유틸리티를 사용하여 인스턴스에 대한 연결을 테스트할 수 없습니다. ping 유틸리티를 공용 인터넷에서 사용하는 경우 항상 시간 초과가 보고됩니다. - **Tableau Server 라이선스가 취소됨 오류 메시지가 표시됨** 라이선스를 비활성화하지 않고 인스턴스를 종료한 경우 이 오류가 발생할 수 있습니다. [Tableau 지원](http://www.tableau.com/ko-kr/support/request)에 문의하십시오. - **Tableau Server가 모든 CPU 코어를 사용하지 않음** Tableau Server 코어 기반 라이선스를 사용할 때 다음과 같은 증상이 하나 이상 발생할 수 있습니다. - Tableau Server 설치 시 설치 프로그램에 Tableau Server를 실행 중인 컴퓨터에서 표시되는 것보다 적은 수의 코어가 나타날 수 있습니다. - Tableau Server의 라이선스 페이지에서 사용 중인 라이선스 아래에 표시되는 코어 수가 예상보다 적게 표시됩니다. - `tsm licenses list`를 실행할 경우 Tableau Server가 보고하는 코어 수가 예상보다 적을 수 있습니다. 자세한 내용은 [Tableau Server에서 일부 코어가 인식 안 됨](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=ko-kr)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Google Cloud Platform 기반 Tableau Server 배포 옵션 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 GCE(Google Compute Engine) VM(가상 컴퓨터)에 Tableau Server를 배포할 수 있습니다. GCE 기반 Tableau Server 배포는 다음을 지원합니다.
Tableau ServerGoogle Compute Engine VM 자체 배포
프로덕션 지원성공을 나타내는 확인 표시 아이콘입니다.
VM을 바꾸지 않고 Tableau 업그레이드성공을 나타내는 확인 표시 아이콘입니다.
Linux에서 설치성공을 나타내는 확인 표시 아이콘입니다.
Windows에서 설치성공을 나타내는 확인 표시 아이콘입니다.
스케일업성공을 나타내는 확인 표시 아이콘입니다.
스케일아웃(노드 추가)성공을 나타내는 확인 표시 아이콘입니다.
Active Directory 지원성공을 나타내는 확인 표시 아이콘입니다.
BYOL 라이선스성공을 나타내는 확인 표시 아이콘입니다.
자체 배포 옵션에 대한 자세한 내용이 아래에 설명되어 있습니다. - **Google Compute Engine VM에 자체 배포** – 가장 유연한 배포 옵션이며 Tableau Server를 환경에 맞게 사용자 지정할 수 있습니다. Tableau Server를 Google Compute Engine에 자체 배포하는 옵션은 간소화된 구성으로 시작해서 나중에 확장해야 하는 개발, 테스트 및 프로덕션 환경에 권장됩니다. 자체 배포에 대한 자세한 내용은 [단일 Google Cloud Platform 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_gcp_single_server.htm)를 참조하십시오. 분산 환경의 배포에 대한 자세한 내용은 [분산 환경의 Google Cloud Platform 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_gcp_multiple_server.htm)를 참조하십시오. Tableau Server의 라이선스 옵션에 대한 자세한 내용은 [라이선스 개요](https://help.tableau.com/current/server/ko-kr/license_server_overview.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Google Cloud Platform 기반 Tableau Server 토폴로지 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Google Cloud Platform에 Tableau Server를 배포하는 경우 Tableau Desktop과 GCE(Google Compute Engine) VM(가상 컴퓨터) 기반 Tableau Server 간의 통합 수준 및 정도를 선택할 수 있습니다. Tableau Desktop과 데이터 원본에서 데이터를 추출하는 Tableau Desktop 기능을 데이터와 Tableau Server를 연결하는 다리로 사용할 수 있습니다. 필요에 따라 또는 Google Cloud Platform에 이미 많은 양의 데이터가 있는 경우에는 Tableau Server와 함께 Google Cloud Platform 서비스의 전체 범위를 활용하도록 선택할 수 있습니다. 다음 다이어그램에서는 Tableau Desktop 및 Tableau Server와의 데이터 원본 통합을 보여 줍니다. ![Tableau Desktop과 클라우드 기반 가상 컴퓨터를 통해 원시 데이터에서 사용자 액세스까지의 데이터 변환 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_cloud_topology.png) 다음 다이어그램에서 모든 데이터는 Google Cloud Platform에서 호스팅됩니다. 안전하고 확장 가능한 방식으로 관리되는 구조화 데이터 및 비구조화 데이터를 모두 분석할 수 있습니다. Google Cloud Platform에만 있는 데이터, Google Cloud Platform 외부에 있는 관리되지 않는 데이터 또는 이 둘의 조합을 활용할 수 있습니다. 두 유형의 데이터가 동일하게 지원되므로, 이러한 유연성은 온프레미스 데이터에서 클라우드로의 이동을 지원하는 조직의 역량을 크게 향상시킵니다. ![Google의 데이터를 사용하여 데이터 수집, 저장, 분석 및 시각화 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_google_data_sources.png) [주요 콘텐츠로 건너뛰기](#main-content) # Google Cloud Platform에 Tableau Server 설치 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 GCE(Google Compute Engine) VM(가상 컴퓨터)에 Tableau Server를 설치하면 로컬 환경에서도 Tableau Server의 고급 기능을 사용할 수 있습니다. 고가의 서버를 여러 대 구입하고 유지 관리할 필요 없이 스케일업 및 스케일아웃을 수행할 수 있는 유연성이 필요한 경우 GCE VM에서 Tableau Server를 실행하는 것이 탁월한 선택입니다. 예를 들어 Tableau Server를 고가용성으로 구성하고, 다수의 조직에서 사용되는 모든 공통 엔터프라이즈 응용 프로그램(예: Active Directory)을 통합할 수 있습니다. Linux에서 Tableau Server를 사용하려고 하십니까? [Google Cloud Platform에 Tableau Server 설치](https://help.tableau.com/current/server-linux/ko-kr/ts_gcp_welcome.htm "새 브라우저 탭에서 항목이 열림")를 참조하십시오. Tableau Server는 다수의 기본 Google 클라우드 서비스를 활용할 수 있습니다. - [Google Persistent Disk](https://cloud.google.com/persistent-disk/): VM(가상 컴퓨터)을 위한 클라우드 기반 블록 저장소입니다. - [Google Cloud Storage](https://cloud.google.com/storage/): 데이터 아카이브를 위한 클라우드 기반 통합 개체 저장소입니다. - [Google Cloud Dataflow](https://cloud.google.com/dataflow/): 스트림 및 일괄 데이터 처리를 위한 클라우드 기반 서비스입니다. - [Google Cloud Dataproc](https://cloud.google.com/dataproc/): Spark 및 Hadoop 클러스터 실행을 위한 클라우드 기반 서비스입니다. 또한 다음과 같은 Google 클라우드 서비스를 사용하여 Tableau Server에서 사용할 데이터를 저장할 수 있습니다. Tableau는 다음과 같은 Google 데이터 원본에 데이터를 연결할 수 있게 해 주는 기본 데이터 [커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/help.htm#exampleconnections_overview.htm)를 제공합니다. - [Google Analytics](https://help.tableau.com/current/pro/desktop/ko-kr/examples_googleanalytics.htm): 웹 사이트 트래픽을 추적하고 보고하는 웹 분석 도구입니다. - [Google BigQuery](https://help.tableau.com/current/pro/desktop/ko-kr/examples_googlebigquery.htm): 분석을 위한 관리되는 엔터프라이즈 데이터 웨어하우스입니다. - [Google Cloud SQL](https://help.tableau.com/current/pro/desktop/ko-kr/examples_googlecloudsql.htm): 관리되는 SQL 데이터베이스 서비스입니다. - [Google 스프레드시트](https://help.tableau.com/current/pro/desktop/ko-kr/examples_googlesheets.htm): Google Docs에 포함된 스프레드시트입니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Google Cloud Platform에 Tableau Server를 설치하는 최상의 방법 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 클라우드에서 Tableau Server를 원활하게 설치하려면 다음과 같은 최상의 방법을 따르십시오. - Tableau Server [배포 계획](https://help.tableau.com/current/server/ko-kr/plan.htm) 섹션을 숙지합니다. - [Google Cloud Platform 기반 Tableau Server 필수 요건](https://help.tableau.com/current/server/ko-kr/ts_gcp_prerequisites.htm)을 숙지합니다. - Tableau Server [보안 강화 검사 목록](https://help.tableau.com/current/server/ko-kr/security_harden.htm)을 숙지합니다. - 클라우드 사용 경험이 없다면 Google Cloud Platform 기반 Tableau Server를 배포하기 전에 [Google Cloud Platform 무료 등급](https://cloud.google.com/free/)을 사용하여 클라우드 작업 방식에 익숙해지십시오. - Google Cloud Platform의 [기업 조직을 위한 권장사항](https://cloud.google.com/docs/enterprise/best-practices-for-enterprise-organizations)을 읽어 보십시오. - Google Cloud Platform의 [네트워크 토폴로지](https://cloud.google.com/vpc/docs/vpc)를 읽고 아키텍처가 구성된 방식을 이해하십시오. ## 비용 절감 Google Cloud Platform은 사용한 시간만큼 지불하는 클라우드 기반 서비스를 제공합니다. 비용은 실행한 서비스와 서비스 사용 기간으로 결정됩니다. 다양한 인스턴스 유형 및 크기 조합이 가능하며, 조합에 따라 비용이 달라집니다. 서비스 요금에 대한 자세한 내용은 [Google Cloud Platform 가격 책정](https://cloud.google.com/pricing/)을 참조하십시오. [Google Cloud Platform 요금 계산기](https://cloud.google.com/products/calculator/)를 사용하여 총 월별 비용을 예측할 수 있습니다. 또한 [Google Cloud Platform TCO 계산기](https://cloud.google.com/pricing?authuser=0&hl=fi#calculators)를 사용하여 온프레미스와 클라우드를 비교할 수 있습니다. 사용 비용을 지속적으로 모니터링하고 관리하려면 월별 Google Cloud Platform 비용이 미리 정의된 지출 한도에 도달한 경우 알림을 제공하도록 Google Cloud Platform 청구 알림을 설정할 수 있습니다. 자세한 내용은 Google 웹 사이트에서 [예산 및 알림 설정](https://support.google.com/cloud/answer/6293540?visit_id=0-636416330629139015-862362861&rd=1)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Google Cloud에서 PostgreSQL 인스턴스 만들기 버전 2021.4부터 Google Cloud 플랫폼에서 Tableau Server 외부 리포지토리를 호스팅할 수 있습니다. 이 항목에서는 Google Cloud에서 Tableau Server 외부 리포지토리로 사용할 PostgreSQL 인스턴스를 만드는 방법에 대해 설명합니다. 외부 리포지토리에 사용할 수 있는 전체 호스트 목록을 보려면 [Tableau Server 외부 리포지토리](https://help.tableau.com/current/server/ko-kr/server_external_repo.htm)를 참조하십시오. ## 요구 사항 및 권장 사항 - 최소한 8vCPU 및 32GB RAM이 포함된 대용량 메모리 컴퓨터 유형을 사용합니다. 이는 Tableau Server 외부 리포지토리에 사용하기 위한 최소 권장 PostgreSQL 인스턴스 크기이지만 정확한 요구 사항은 사용자 요구 사항 및 사용량에 따라 달라집니다. 대부분의 시나리오에서 우수한 성능을 원한다면 vCPU 16개와 128GB RAM이 포함된 대용량 메모리 인스턴스 유형을 사용하는 것이 좋습니다. - Tableau Server와 외부 PostgreSQL DB 인스턴스 간의 SSL 연결을 사용한 보안 통신은 필수는 아니지만 권장됩니다. - Tableau Server 클러스터의 모든 노드가 PostgreSQL 인스턴스에 연결할 수 있어야 합니다. 이렇게 하는 방법 중 하나는 PostgreSQL 인스턴스를 Tableau Server 클러스터의 모든 노드가 액세스할 수 있는 사용 권한을 가진 보안 그룹의 멤버로 만드는 것입니다. - PostgreSQL 버전은 지원되는 버전이어야 합니다. 자세한 내용은 [제품 호환성](https://help.tableau.com/current/server/ko-kr/server_external_repo_upgrade_postgres.htm#postgres-ts-compat)에서 지원되는 버전 정보를 참조하십시오. - Tableau는 내부 데이터베이스 사용자가 내부에서 사용할 비밀번호를 자동으로 생성합니다. 이러한 비밀번호는 32자 길이이며 소문자와 숫자로 구성됩니다. 관리자가 액세스하거나 구성할 수 없습니다. 외부 PostgreSQL 인스턴스의 경우 관리자가 비밀번호 정책을 설정할 수 있습니다(사용 중인 플랫폼에 따라 다름). 숫자 및 소문자 이외의 문자 유형을 포함하는 정책을 지정하면 외부 리포지토리를 사용하도록 Tableau Server를 구성하는 동안 오류가 발생할 수 있습니다. ## Google Cloud에서 데이터베이스 PostgreSQL 인스턴스 만들기 ### 1단계: 새 PostgreSQL 인스턴스 만들기 Google 웹 사이트([여기](https://cloud.google.com/sql/docs/postgres/create-instance))에 제공된 지침을 사용하여 PostgreSQL 인스턴스를 만듭니다. vCPU 16개와 128GB RAM이 포함된 대용량 메모리 컴퓨터 유형을 사용하는 것이 좋습니다. ### 2단계: PostgreSQL 인스턴스에 대한 데이터베이스 플래그 구성 Tableau Server 수준에서 인스턴스에 대한 대부분의 매개 변수 값을 기본값으로 설정할 수 있습니다. 특정 성능 또는 로깅 요구 사항이 있는 경우 매개 변수 값을 수정할 수 있지만 다음 매개 변수를 기본값으로 두고 변경하지 않는 것이 좋습니다. - `standard_conforming_strings` - `escape_string_warning` 또한 성능 문제를 방지하기 위해 `work_mem` 값을 16384 이상으로 설정하는 것이 좋습니다. 데이터베이스 플래그에 대한 자세한 내용은 Google 웹 사이트에서 [이 항목](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/flags&sa=D&source=docs&ust=1635271250753000&usg=AOvVaw1dZNOfdZ1CEnSfup_wasnb)을 참조하십시오. ### 3단계: PostgreSQL DB 인스턴스 끝점 가져오기 인스턴스가 준비되면 Tableau Server 리포지토리에 이 인스턴스를 사용하도록 Tableau Server를 구성하는 데 사용할 끝점 정보를 가져옵니다. ### 4단계: SSL 인증서 파일 다운로드 Tableau Server와 외부 리포지토리 간의 SSL을 사용한 보안 통신은 필수는 아니지만 권장됩니다. Tableau Server와 외부 리포지토리 간에 보안 연결을 설정하려면 이 외부 리포지토리를 사용하도록 Tableau Server를 구성할 때 인증서 파일을 사용해야 합니다. 자세한 내용은 Google 웹 사이트에서 [SSL/TLS 인증서 구성](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/configure-ssl-instance&sa=D&source=docs&ust=1635271250769000&usg=AOvVaw3YRZJ0JQdXSkhNjdOxhuww)을 참조하십시오. ## PostgreSQL DB의 고가용성 구성 Tableau Server는 외부 리포지토리에 대한 고가용성을 관리하거나 설정하지 않습니다. Google Cloud는 고가용성을 제공하는 데 사용할 수 있는 고가용성 기능을 제공합니다. 자세한 내용은 Google 웹 사이트에서 [인스턴스에서 고가용성 사용 설정 및 중지](https://cloud.google.com/sql/docs/postgres/configure-ha)를 참조하십시오. ## PostgreSQL DB의 재해 복구 재해가 발생한 경우 PostgreSQL 인스턴스에 새 PostgreSQL 데이터베이스를 설치해야 할 수 있습니다. 또한 데이터베이스 인스턴스 관련 문제에서 복구하려면 다른 시나리오가 필요할 수 있습니다. 이와 같은 시나리오에서 Tableau Server를 새 PostgreSQL 인스턴스를 사용하도록 구성하려면 다음 단계를 따릅니다. 1. **새 PostgreSQL 인스턴스로 백업을 복원합니다.** Google Cloud Platform에서 동일한 인스턴스로 복원할지 새 인스턴스를 만들지 선택할 수 있습니다. 자세한 내용은 Google 웹 사이트에서 [인스턴스 복원](https://cloud.google.com/sql/docs/postgres/backup-recovery/restoring)을 참조하십시오. 새 인스턴스를 만들고 다음 단계를 수행하여 복구하는 것이 좋습니다. 2. 새 인스턴스에서 새 PostgreSQL용 Azure 데이터베이스 인스턴스에 대한 연결 정보를 포함하는 **새 JSON 설정 파일을 만듭니다**. JSON 설정 파일 만들기에 대한 자세한 내용은 [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm)의 **1단계**를 참조하십시오. 3. `tsm topology external-services repository replace-host` **명령**을 사용하여 Tableau Server를 새 PostgreSQL용 Azure 데이터베이스 인스턴스를 가리키도록 설정합니다. `tsm topology external-services repository replace-host` 명령에 대한 자세한 내용은 [tsm topology](https://help.tableau.com/current/server/ko-kr/cli_topology_tsm.htm)를 참조하십시오. ## 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자만 Tableau Server를 외부 리포지토리를 사용하도록 구성할 수 있습니다. 또한 PostgreSQL 데이터베이스 인스턴스를 만들기 위한 Google Cloud 계정이 필요합니다. ## 다음 단계 새 설치: [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm) 외부 리포지토리를 사용하도록 기존 Tableau Server를 구성하려면 [Tableau Server 리포지토리 다시 구성](https://help.tableau.com/current/server/ko-kr/server_external_repo_reconfigure.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Google Compute Engine 가상 컴퓨터 유형 및 크기 선택 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Google Cloud Platform은 많은 유형의 GCE(Google Compute Engine) VM(가상 컴퓨터)을 다양한 크기로 제공합니다. Tableau Server의 성공적인 배포에서 중요한 요소 중 하나는 작업 부하에 적합한 VM을 선택하는 것입니다. 광범위한 VM 중에서 VM을 선택할 수 있습니다. 사용 가능한 모든 VM 유형 및 크기의 전체 목록을 보려면 Google 웹 사이트에서 [Machine Types](https://cloud.google.com/compute/docs/machine-types)(컴퓨터 유형) 페이지를 참조하십시오. Tableau Server를 실행할 수 있는 VM을 선택해야 합니다. VM은 Tableau Server 하드웨어 지침(최소 8코어 및 128GB RAM)을 충족해야 합니다. 64비트 Tableau Server에는 최소 4코어 CPU(Google Compute Engine vCPU 8개에 해당) 및 64GB RAM이 필요합니다. 하지만 단일 프로덕션 Google Compute Engine VM의 경우 총 8개 CPU 코어(Google Compute Engine vCPU 16개) 및 128GB RAM을 사용할 것을 강력하게 권장합니다. Windows 운영 체제는 이 16개 vCPU를 8개 코어로 인식하므로 라이선스에 부정적인 영향을 미치지 않습니다. ## 개발, 테스트 및 프로덕션 환경을 위한 일반적인 VM 유형 및 크기 - n2-standard-16 ## 단일 프로덕션 인스턴스의 권장 사양
구성 요소/리소스Google Cloud Platform

CPU

16개 이상의 vCPU

운영 체제
 2021.3.0 ~ 2023.3.02023.3.1 ~ 2026.2.x
Windows Server 2016
Windows Server 2019(x64)
Windows Server 2022참고: 2023.3.1 이전 버전에서 Windows Server 2022는 지원되지 않습니다. 2023년 4월부터 Windows 기반의 모든 2023.3.1 이전 Tableau Server 버전에 대한 설치 프로그램은 Windows 2022에서의 설치를 차단합니다.

메모리

128GB 이상 RAM(vCPU당 4GB RAM)

저장소

2개 볼륨:

운영 체제용 30~50GiB 볼륨

Tableau Server용 100GiB 이상의 볼륨

저장소 유형

SSD 영구 디스크, 200GB++

SSD 영구 디스크에 대한 자세한 내용은 Google Cloud Platform 웹 사이트에서 Storage Options(저장소 옵션)를 참조하십시오.

디스크 지연 시간

Windows의 Avg. Transfer disk/sec 성능 카운터로 측정 시 20ms보다 작거나 같아야 합니다.

[주요 콘텐츠로 건너뛰기](#main-content) # Google에 대한 OAuth 설정 기본적으로 Google Analytics 및 Google BigQuery 커넥터는 공급자가 Tableau Server용으로 생성하고 동일한 사이트의 모든 사용자가 공유하는 OAuth 토큰에 대해 관리되는 키 체인을 사용합니다. Google 드라이브 및 Google BigQuery(JDBC) 연결은 기본적으로 저장된 자격 증명을 사용하며 Tableau 2022.3부터 Tableau Server가 Google용 OAuth 클라이언트 ID 및 암호로 설정되어야 합니다. Tableau Server에서 각 커넥터에 대해 OAuth 클라이언트 ID와 암호를 구성하여 관리되는 키 체인을 사용하는 커넥터를 저장된 자격 증명을 사용하도록 변환할 수 있습니다. 이 항목에서는 저장된 자격 증명을 사용하여 OAuth에 대한 Google 연결을 설정하는 방법에 대해 설명합니다. Tableau Server 인스턴스마다 이 단계를 완료합니다. 관리되는 키 체인 및 저장된 자격 증명에 대한 자세한 내용은 [OAuth 연결](https://help.tableau.com/current/server/ko-kr/protected_auth.htm)을 참조하십시오. **참고:**  - 모든 Google 기반 커넥터에는 관리되는 키 체인(기본값), 서버 전체 OAuth 또는 사이트별 OAuth가 필요합니다. - 저장된 자격 증명을 사이트에 사용하려면 서버 전체 OAuth를 먼저 구성해야 합니다. - 서버 전체 OAuth는 사이트 전체 OAuth가 구성된 경우 사용할 수 있습니다. - 사이트별 OAuth를 사용하는 경우 각 사이트를 개별적으로 구성해야 합니다. - 라이브 연결 프롬프트, 연결 편집 및 웹 작성을 지원하려면 관리되는 키 체인을 저장된 자격 증명으로 전환하여 오류를 방지하십시오. ### 단계 요약 다음 일반 단계에 따라 OAuth를 설정하십시오. 1. API 액세스를 사용하도록 설정하고 Google에서 액세스 토큰을 만듭니다. 2. 1단계에서 가져온 정보를 사용하여 Tableau Server를 구성합니다. 3. (선택 사항) 사이트별 OAuth를 구성합니다. 4. Google 데이터 원본을 만들고 편집합니다. ## 클라이언트 ID를 가져오고 Google API를 사용하도록 설정 **참고** 이 단계는 이 내용을 작성할 당시 Google Cloud Platform 콘솔의 설정을 반영하고 있습니다. 자세한 내용은 Google Developers Console Help에서 [Using OAuth 2.0 for Web Server Applications](https://developers.google.com/accounts/docs/OAuth2WebServer)를 참조하십시오. 1. [Google Cloud Platform](http://cloud.google.com/)에 로그인하고 Go to my console을 클릭합니다. 2. 드롭다운 메뉴에서 Select a Project(프로젝트 선택), Create project(프로젝트 만들기)를 선택합니다. 3. 새 프로젝트 양식이 나타나면 다음을 완료합니다. - 이 프로젝트를 사용할 Tableau Server 인스턴스를 반영하는 의미 있는 이름을 프로젝트에 지정합니다. - 프로젝트 ID를 변경할지 여부를 결정합니다. **참고**: 프로젝트를 만든 후에는 프로젝트 ID를 변경할 수 없습니다. 자세한 내용은 물음표 아이콘을 클릭하십시오. ![새 프로젝트를 만들기 위한 대화 상자입니다.](/tableau/current/ko-kr/server/ko-kr/Img/config_oauth_google3.png) 4. 새 프로젝트를 열고 APIs & Services(API 및 서비스) > **OAuth consent screen**(OAuth 동의 화면)으로 이동한 후 User Type(사용자 유형)을 선택합니다. 5. **OAuth consent screen(OAuth 동의 화면)** 탭을 클릭한 다음 사용자에게 표시된 **Product name(제품 이름)**에 의미 있는 이름을 입력합니다. 6. **Credentials**(자격 증명)을 클릭하고 Create Credentials(자격 증명 만들기) 탭을 클릭한 다음 OAuth client ID(OAuth 클라이언트 ID)를 클릭합니다. 7. Create OAuth client ID(OAuth 클라이언트 ID 만들기) 화면에서 필수 필드를 작성합니다. 단계에 따라 OAuth 토큰을 승인합니다. - Web Application을 선택합니다. - 클라이언트 Name(이름)을 입력합니다. - **Authorized JavaScript Origins**(공인 JavaScript 출처)에 대해 ADD URI(URI 추가)를 클릭하고 HTTP 또는 HTTPs를 사용하여 Tableau Server 도메인 이름을 입력합니다. - **Authorized redirect URIs**(승인된 리디렉션 URI)에 대해 ADD URI(URI 추가)를 클릭하고 기존의 텍스트를 Tableau Server의 인터넷 주소로 바꾼 다음 **auth/add\_oauth\_token** 텍스트를 끝에 추가합니다. 예를 들면 다음과 같습니다. `https://your_server_url.com/auth/add_oauth_token` 8. Authorized Redirect URI를 복사하여 Tableau Server 컴퓨터에서 액세스할 수 있는 위치에 붙여 넣습니다. 9. Create(만들기)를 클릭합니다. 10. Google에서 반환하는 다음 값을 복사하여 Tableau Server 컴퓨터에서 접근할 수 있는 위치에 붙여 넣습니다. - 클라이언트 ID - 클라이언트 암호 11. APIs & services(API 및 서비스)에서 BigQuery API, Google Drive API(Google 스프레드시트를 사용하는 경우) 또는 Analytics API가 사용되도록 설정되어 있는지 확인합니다. API를 사용하려면 페이지 맨 위에 있는 **ENABLE API**(API 사용)를 클릭합니다. **참고:** Tableau Server와 Google Analytics 4 간의 연결을 설정하려면 Google 콘솔에서 Google Analytics Admin API와 Google Analytics Data API를 모두 사용하도록 설정해야 합니다. 이러한 API를 추가하면 프로세스 중에 발생할 수 있는 잠재적인 사용 권한 오류를 방지할 수 있습니다. ## Google OAuth에 대해 Tableau Server 구성 [클라이언트 ID를 가져오고 Google API를 사용하도록 설정](#configure-google)의 단계를 완료하여 얻은 정보를 사용하여 Tableau Server를 구성할 수 있습니다. - Tableau Server 컴퓨터에서 셸을 열고 다음 명령을 실행하여 액세스 토큰 및 URI를 지정합니다. `tsm configuration set -k oauth.google.client_id -v ` `tsm configuration set -k oauth.google.client_secret -v ` `tsm configuration set -k oauth.google.redirect_uri -v ` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 사이트에 대해 사용자 지정 OAuth 구성 사이트에 대해 사용자 지정 Google OAuth 클라이언트를 구성할 수 있습니다. 1) 서버에 구성된 OAuth 클라이언트를 재정의하거나 2) 고유한 OAuth 클라이언트가 필요한 데이터에 대한 안전한 연결을 지원하려면 사용자 지정 OAuth 클라이언트를 구성하는 것이 좋습니다. 사용자 지정 OAuth 클라이언트를 구성하면 사이트 수준 구성이 서버 측 구성보다 우선하며 생성된 모든 새로운 OAuth 자격 증명에 사이트 수준 OAuth 클라이언트가 기본적으로 사용됩니다. Tableau Server를 다시 시작하지 않아도 구성이 적용됩니다. **중요:** 사용자 지정 기존 OAuth 클라이언트를 구성하기 전에 설정된 OAuth 자격 증명은 임시로 사용 가능하지만 중단 없는 데이터 액세스를 보장하려면 서버 관리자와 사용자 모두가 저장된 자격 증명을 업데이트해야 합니다. ### 1: OAuth 클라이언트 ID value, 클라이언트 암호 값 및 리디렉션 URL 준비 사용자 지정 OAuth 클라이언트를 구성하려면 아래에 나열된 정보가 필요합니다. 이 정보를 준비한 후 사이트에 대한 사용자 지정 OAuth 클라이언트를 등록할 수 있습니다. - **OAuth 클라이언트 ID 및 클라이언트 암호 값:** 먼저 OAuth 클라이언트를 데이터 공급자(커넥터)에 등록하여 Tableau Server용으로 생성된 클라이언트 ID와 암호 값을 검색합니다. - **리디렉션 URL:** 올바른 리디렉션 URL을 기록합니다. 아래 **2단계**의 등록 프로세스 중에 필요합니다. https://.com/auth/add\_oauth\_token 예: https://example.com/auth/add\_oauth\_token ### 2: OAuth 클라이언트 ID 및 클라이언트 암호 등록 아래에 설명된 절차에 따라 사용자 지정 OAuth 클라이언트를 사이트에 등록합니다. 1. 관리자 자격 증명을 사용하여 Tableau Server 사이트에 로그인하고 설정 페이지로 이동합니다. 2. OAuth 클라이언트 레지스트리에서 OAuth 클라이언트 추가 단추를 클릭합니다. 3. 위의 **1단계**의 정보를 포함하여 필요한 정보를 입력합니다. 1. 연결 유형의 경우 사용자 지정 OAuth 클라이언트를 구성하려는 커넥터를 선택합니다. 2. OAuth 인스턴스 URL은 여러 OAuth 클라이언트가 등록되는 경우에 필요합니다. 그 외에는 선택 사항입니다. 3. 클라이언트 ID, 클라이언트 암호 및 리디렉션 URL의 경우 위의 **1단계**에서 준비한 정보를 입력합니다. 4. OAuth 클라이언트 추가 단추를 클릭하여 등록 프로세스를 완료합니다. ![OAuth 클라이언트를 생성하기 위한 양식이며, 연결 유형, OAuth 인스턴스 URL, 클라이언트 ID, 클라이언트 암호, 리디렉션 URL에 대한 필드가 포함되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/oauth_custom.png) 4. (선택 사항) 지원되는 모든 커넥터에 대해 3단계를 반복합니다. 5. 설정 페이지의 맨 아래 또는 맨 위에 있는 저장 단추를 클릭하여 변경 내용을 저장합니다. ### 3: 저장된 자격 증명의 유효성 검사 및 업데이트 중단 없는 데이터 액세스를 보장하려면 관리자(및 사이트 사용자)가 이전에 저장된 자격 증명을 삭제하고 다시 추가하여 사이트에 사용자 지정 OAuth 클라이언트를 사용해야 합니다. 1. 내 계정 설정 페이지로 이동합니다. 2. 데이터 원본의 저장된 자격 증명에서 다음을 수행합니다. 1. 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 기존의 저장된 자격 증명 옆에서 삭제를 클릭합니다. 2. 커넥터 이름 옆에서 추가를 클릭하고 표시되는 메시지에 따라 1) 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트에 연결하고 2) 최신 자격 증명을 저장합니다. ### 4: 사용자에게 저장된 자격 증명을 업데이트하도록 알림 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 저장된 자격 증명을 업데이트하도록 사이트 사용자에게 알립니다. 사이트 사용자는 [저장된 자격 증명 업데이트](https://help.tableau.com/current/server/ko-kr/manage_stored_credentials.htm#oauth_update_credentials)에 설명된 절차를 사용하여 저장된 자격 증명을 업데이트할 수 있습니다. ## Google 데이터 원본 만들기 및 편집 다음으로 Google 데이터 원본을 서버에 게시해야 합니다. 예제는 Tableau Desktop 항목인 [Google BigQuery](https://help.tableau.com/current/pro/desktop/ko-kr/examples_googlebigquery.htm)를 참조하십시오. 데이터 원본을 게시한 후 최종 단계는 이전에 구성한 내장된 액세스 토큰을 사용하도록 데이터 원본 연결을 편집하는 것입니다. [Tableau Server에서 연결 편집](https://help.tableau.com/current/server/ko-kr/connections_modify.htm)을 참조하십시오. ## 액세스 토큰 관리 OAuth를 사용하도록 서버를 구성한 후 사용자가 자신의 프로필에서 액세스 토큰을 관리하도록 허용하거나, 중앙에서 직접 토큰을 관리할 수 있습니다. 자세한 내용은 [저장된 액세스 토큰 허용](https://help.tableau.com/current/server/ko-kr/allow_saved_tokens.htm)을 참조하십시오. ## OAuth 인증에 대한 정방향 프록시 Tableau Server의 OAuth 인증으로 정방향 프록시를 설정하는 방법(Windows만 해당)에 대한 자세한 내용은 Tableau 도움말에서 [OAuth 인증에 대한 정방향 프록시 구성](https://help.tableau.com/current/pro/desktop/ko-kr/config_proxy_oauth.htm#server)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Server Helm 차트 - 문제 해결 **중요**: 이 설명서에서는 Helm 및 Helm 차트에 대한 지식이 있다고 가정하며 상세한 설명적 예를 제공하지 않습니다. 설명서는 Tableau Server와 Helm 및 Helm 차트에 익숙한 고객을 대상으로 작성되었습니다. ## 소개 이 항목에서는 Helm 차트를 사용하여 Kubernetes에 Tableau Server를 배포할 때 발생하는 일반적인 문제를 진단하고 해결하는 데 도움이 되는 도움말을 제공합니다. 설치 문제, 런타임 문제 및 디버깅 방법을 다룹니다. ## 일반적인 문제 해결 단계 Kubernetes에서 Tableau Server와 관련된 문제가 발생한 경우: 1. 포드 상태 및 이벤트 확인 2. 컨테이너 로그 검토 3. 리소스 가용성 확인 4. 영구 볼륨 클레임 확인 5. Herm 릴리스 상태 검토 6. 서비스 및 네트워크 연결 검토 ## 포드가 시작되지 않음 1. 포드 상태 확인: kubectl get pods -l app.kubernetes.io/instance=tableau-server kubectl describe pod 2. 로그 확인: kubectl logs 3. 이벤트 확인: kubectl get events --sort-by='.lastTimestamp' ## 영구 볼륨 문제 1. PVC 상태 확인: kubectl get pvc kubectl describe pvc 2. 저장소 클래스 확인: kubectl get storageclass ## 라이선스 키 문제 1. 라이선스 키가 설정되어 있는지 확인: kubectl get secret tableau-server-secrets -o jsonpath='{.data.LICENSE\_KEY}' | base64 -d 2. 라이선스 키 업데이트: \# Edit values.yaml and upgrade helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/values.yaml ## 상태 검사 실패 1. 상태 검사 스크립트 확인: kubectl exec -- /docker/alive-check kubectl exec -- /docker/server-ready-check 2. 상태 검사 타이밍 조정: healthChecks: liveness: initialDelaySeconds: 600 # Increase if server takes longer to start ## 다중 노드 부트스트랩 문제 1. 부트스트랩 볼륨 확인: kubectl get pvc | grep bootstrap 2. 부트스트랩 파일 확인: kubectl exec -- ls -la /docker/config/bootstrap 3. ReadWriteMany 액세스 모드 확인: persistence: bootstrap: accessMode: ReadWriteMany # Required for multi-node 4. EFS 정적 프로비저닝을 위한 부트스트랩 PV/PVC 바인딩 확인: kubectl get pv tableau-bootstrap-pv kubectl get pvc -n default tableau-server-bootstrap kubectl describe pv tableau-bootstrap-pv kubectl describe pvc -n default tableau-server-bootstrap 5. PVC를 바인딩한 후 마운트가 실패하는 경우 EFS CSI/IAM 오류 확인: kubectl describe pod -n default tableau-server-primary-0 kubectl get events -n default --sort-by='.lastTimestamp' 6. `driver name efs.csi.aws.com not found` 오류: [Amazon EKS(Elastic Kubernetes Service) 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm#EKS-Prereq-storageclass)에 설명된 대로 EKS 부가기능을 설치하고 확인합니다. 7. `DescribeMountTargets` 권한 부여 실패 수정 - 기본 설정 방법: aws iam attach-role-policy \\ --role-name \\ --policy-arn arn:aws:iam::aws:policy/AmazonElasticFileSystemClientReadWriteAccess 그런 다음 영향을 받은 포드(주 노드와 모든 작업자 노드)를 다시 시작합니다. 작업자는 레이블로 선택되므로 모든 복제본이 처리됩니다. - 대체 방법 부트스트랩 PV 구성에서 대상 IP의 강제 마운트: `persistence.bootstrap.pv.csi.volumeAttributes.mounttargetip`(또는 수동 PV `volumeAttributes.mounttargetip`)을 설정하고 다시 적용하거나 업그레이드합니다. ## 추가 리소스 - [Tableau Server 설명서](https://help.tableau.com/current/server-linux/ko-kr/) - [Tableau Server 로그 참조](https://help.tableau.com/current/server-linux/ko-kr/logs.htm) - [Kubernetes 문제 해결](https://kubernetes.io/docs/tasks/debug/) - [Helm 문제 해결](https://helm.sh/docs/faq/troubleshooting/) - [Herm 설명서](https://helm.sh/docs/) [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Server Helm 차트 - 배포 **중요**: 이 설명서에서는 Helm 및 Helm 차트에 대한 지식이 있다고 가정하며 상세한 설명적 예를 제공하지 않습니다. 설명서는 Tableau Server와 Helm 및 Helm 차트에 익숙한 고객을 대상으로 작성되었습니다. 이 항목에서는 Helm 차트를 사용하여 Kubernetes에 Tableau Server를 배포하는 개략적인 단계를 안내합니다. ## 필수 요건 시작하기 전에 필수 요건을 충족하는지 확인하십시오. 자세한 내용은 [Tableau Server Helm 차트 - 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm)을 참조하십시오. ### Helm 차트 다운로드 Helm 차트는 Tableau Server 컨테이너 설정 도구(`tableau-server-container-setup-tool-.tar.gz`)의 일부로 제공되며, [Tableau Server 다운로드](http://tableau.com/ko-kr/support/releases/server/latest) 페이지에서 다운로드할 수 있습니다. 추출 후 필요한 Helm 차트 파일은 `helm/tableau` 디렉터리에 위치합니다. ## Helm 차트를 사용하여 Tableau Server를 배포하는 방법에 대한 빠른 개요 **중요**: 다음은 Helm 차트를 사용하여 Tableau Server를 배포하는 방법에 대한 기본적이고 개략적인 설명입니다. 이는 전체 절차가 아닙니다. Helm 및 Helm 차트에 대한 지식이 있다는 것을 전제로 합니다. 시작하기 전에 Helm 차트를 사용하여 Tableau Server를 배포하기 위한 필수 요건을 충족하는지 확인하십시오. 자세한 내용은 [Tableau Server Helm 차트 - 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm)을 참조하십시오. ### values.yaml에 라이선스 키 추가 `values.yaml`을 편집하고 라이선스 키를 설정합니다. ### 단일 노드 Tableau Server 배포 명령 프롬프트에서 다음 명령을 실행하여 Tableau Server의 단일 노드 인스턴스를 배포하십시오. 참고로, ``를 사용자의 릴리스 네임스페이스(예: `tableau` 또는 `default`)로 대체하십시오. helm install tableau-server ./helm/tableau-server \\ -n \\ --create-namespace \\ -f ./helm/tableau-server/values-single.yaml ### 다중 노드 Tableau Server 배포 위와 동일한 네임스페이스 규칙을 사용하여 프롬프트에서 다음 명령을 실행하여 Server의 다중 노드 인스턴스를 배포합니다. helm install tableau-server ./helm/tableau-server \\ \-n \\ \--create-namespace \\ -f ./helm/tableau-server/values-multinode.yaml ## EKS 다중 노드 실행서(네임스페이스 + 정적 부트스트랩 PV) 이 섹션에서는 EKS의 작업 순서(전용 네임스페이스, EFS CSI 추가 기능, 노드 역할의 IAM, 정적 부트스트랩 PV 및 Helm)에 대해 설명합니다. 1. 전용 네임스페이스를 만듭니다. 부트스트랩 PV의 `claimFef.namespace`와 일치해야 합니다. 이 예에서는 `tableau`를 사용합니다. kubectl create namespace tableau-server kubectl get namespace tableau 2. EFS CSI 부가기능이 존재하는지 확인합니다. 부가기능이 없는 경우 새로 만들고 상태가 `ACTIVE`가 될 때까지 기다립니다. kubectl get csidriver efs.csi.aws.com aws eks describe-addon \\ --cluster-name \\ --addon-name aws-efs-csi-driver \\ --region \\ --query 'addon.status' 3. StorageClass를 확인합니다. `efs-bootstrap` StorageClass - 아직 없는 경우 적용합니다. 자세한 내용은 [Amazon EKS(Elastic Kubernetes Service) 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm#EKS-Prereq-storageclass)을 참조하십시오. kubectl get csidriver efs.csi.aws.com aws eks describe-addon \\ --cluster-name \\ --addon-name aws-efs-csi-driver \\ --region \\ --query 'addon.status' 4. 정적 부트스트랩 PV를 확인합니다. `claimRef`는 Helm 차트에서 만드는 것과 동일한 네임스페이스 및 PVC 이름(`tableau-server-bootstrap`)을 참조합니다. `fs-...`를 EFS 파일 시스템 ID로 바꿉니다. cat > /tmp/tableau-bootstrap-pv.yaml <<'EOF' apiVersion: v1 kind: PersistentVolume metadata: name: tableau-bootstrap-pv spec: capacity: storage: 1Gi volumeMode: Filesystem accessModes: - ReadWriteMany persistentVolumeReclaimPolicy: Retain storageClassName: efs-bootstrap claimRef: namespace: tableau name: tableau-server-bootstrap csi: driver: efs.csi.aws.com volumeHandle: EOF kubectl apply -f /tmp/tableau-bootstrap-pv.yaml kubectl get pv tableau-bootstrap-pv 5. 노드 인스턴스 역할의 IAM을 확인합니다. EFS 클라이언트 및 EC2 읽기 전용 정책을 연결합니다. 노드 그룹의 ``을 확인하려면 [Amazon EKS(Elastic Kubernetes Service) 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm#EKS-Prereq-storageclass)을 참조하십시오. `efs-bootstrap` StorageClass - 아직 없는 경우 적용합니다. 자세한 내용은 [Amazon EKS(Elastic Kubernetes Service) 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm#EKS-Prereq-storageclass)을 참조하십시오. kubectl get csidriver efs.csi.aws.com aws eks describe-addon \\ --cluster-name \\ --addon-name aws-efs-csi-driver \\ --region \\ --query 'addon.status' 6. 값 `values-multinode.yaml`(또는 오버레이)에서 수동 정적 PV 모드를 설정합니다. persistence: bootstrap: createPV: false volumeName: tableau-bootstrap-pv storageClass: efs-bootstrap 7. `image.repository`, `image.tag`를 확인합니다. 암호/라이선스는 필요에 따라 설정됩니다. 8. Helm 차트를 설치합니다. PV `claimRef`와 동일한 네임스페이스에 차트를 설치합니다. helm install tableau-server ./helm/tableau-server \\ -n tableau \\ -f ./helm/tableau-server/values-multinode.yaml 9. 저장소 및 포드를 확인합니다. kubectl get pv,pvc -n tableau kubectl get pods -n tableau -w 10. 데이터 PVC 상태 데이터 PVC는 EBS 볼륨이 연결될 때까지 잠시 `Pending`으로 표시될 수 있습니다. 모든 PVC는 `Bound`, `Running`을 거쳐 최종적으로 `READY 1/1`로 전환되어야 합니다. 11. 토폴로지(선택 사항) 설치 후 후크가 사용되지 않도록 설정된 경우 `clustercontroller` 노드를 설정하고 보류 중인 변경 내용을 적용해야 할 수 있습니다(이 문서 뒷부분의 설치 후 토폴로지 자동화(후크) 참조). 여러 Tableau 노드가 있는 경우 `tsm pending-changes apply` 명령을 실행하면 인덱스 및 검색 서버 배포 또는 조정 서비스 집합에 대한 경고가 발생할 수 있습니다. [인덱스 및 검색 서버](https://help.tableau.com/current/server/ko-kr/server_process_index-and-search.htm)와 [Tableau Server 조정 서비스](https://help.tableau.com/current/server/ko-kr/server_process_coordination.htm)에 설명된 대로 이러한 경고를 해결하십시오. ### 사용자 지정 설치 1. 값을 사용자 지정 cp ./helm/tableau-server/values.yaml ./helm/tableau-server/my-values.yaml \# Edit ./helm/tableau-server/my-values.yaml with your configuration 2. 사용자 지정 값을 사용하여 설치 helm install tableau-server ./helm/tableau-server -f ./helm/tableau-server/my-values.yaml ## 구성 ### 배포 모드 #### 단일 노드 배포 단일 노드 배포는 Tableau Server를 단일 컨테이너로 실행합니다. `values-single.yaml`을 사용하거나 다음과 같이 설정합니다. deploymentMode: "single" primary: replicaCount: 1 worker: replicaCount: 0 #### 다중 노드 배포 다중 노드 배포는 하나의 주 작업자와 하나 이상의 작업자를 실행합니다. `worker.replicaCount`를 사용하여 작업자 수를 설정합니다. 1, 2 또는 클러스터 용량 및 Tableau 토폴로지에서 허용하는 더 높은 값을 사용합니다. 이 차트는 `replicaCount: N`에 대해 `tableau-server-worker-0 … tableau-server-worker-(N-1)`개를 만듭니다. `values-multinode.yaml`을 사용(기본 예에서는 두 개의 작업자를 사용함)하거나, 다음과 같이 명시적으로 설정합니다. deploymentMode: "multinode" primary: replicaCount: 1 worker: replicaCount: 3 # example: three workers 토폴로지 정렬: `values-multinode.yaml`은 샘플 `config.configJson` 토폴로지(`node1`, `node2`, `node3` 등의 노드 ID)와 함께 제공됩니다. `worker.replicaCount`를 변경하거나 서비스를 다시 정렬하는 경우 TSM 노드의 수와 역할이 배포 환경과 일치하도록 토폴로지(및 관련 Tableau 프로세스 할당)를 업데이트해야 합니다. 클러스터링 및 프로세스 레이아웃에 대한 자세한 내용은 Tableau Server 도움말을 참조하십시오. ### 키 구성 옵션 #### 이미지 구성 image: repository: tableau\_server\_image tag: "latest" pullPolicy: IfNotPresent pullSecrets: \[\] #### 라이선스 및 암호 secrets: licenseKey: "YOUR-LICENSE-KEY" tsmRemotePassword: "password" tableauUsername: "admin" tableauPassword: "password" 또는 환경 변수를 사용하여 설정할 수 있습니다. env: LICENSE\_KEY: "YOUR-LICENSE-KEY" TSM\_REMOTE\_PASSWORD: "password" TABLEAU\_USERNAME: "admin" TABLEAU\_PASSWORD: "password" 별도의 파일(예: `secrets.yaml`)을 사용하고 `-f` 스위치와 함께 전달하는 것이 좋습니다. `secrets.yaml`: secrets: licenseKey: "YOUR-LICENSE-KEY" tsmRemotePassword: "YOUR-TSM-PASSWORD" tableauUsername: "YOUR-ADMIN-USER" tableauPassword: "YOUR-ADMIN-PASSWORD" `secrets.yaml`을 사용한 설치/업그레이드 예: helm upgrade --install tableau-server ./helm/tableau-server \\ -n default \\ -f ./helm/tableau-server/values-multinode.yaml \\ -f ./helm/tableau-server/secrets.yaml **참고:** 기존 Kubernetes Secret(예: s`ecrets.existingSecret`)를 참조하는 것은 현재 지원되지 않습니다. 지원되는 유일한 방법은 별도의 암호 값 파일과 함께 차트 값을 사용하는 것입니다. #### 외부 PostgreSQL 리포지토리 Helm 차트는 전용 값 키를 사용하는 외부 리포지토리를 기본적으로 사용하도록 설정하지 않습니다. 다음 단계를 수행하여 외부 리포지토리를 사용하도록 설정하는 것이 좋습니다. 1. 차트를 배포하고 주 차트가 정상적인지 확인합니다. 2. 주 포드에서 Tableau `tsm external repository` 명령을 실행합니다. 3. 보류 중인 변경 내용을 적용합니다. 워크플로우 예(명령 검색 및 적용): \# Discover command syntax for your Tableau version kubectl exec -n default tableau-server-primary-0 -- sh -lc 'tsm topology external-services repository enable --help' \# After enabling external repository with Tableau-supported args/options: kubectl exec -n default tableau-server-primary-0 -- sh -lc 'tsm pending-changes apply -iw --ignore-prompt' kubectl exec -n default tableau-server-primary-0 -- sh -lc 'tsm status -v' 참고: - SSL 모드, 장애 조치 옵션, 자격 증명 필드 등 외부 리포지토리 구성은 Tableau 버전에 따라 다릅니다. 자세한 내용은 [Tableau Server 외부 리포지토리](https://help.tableau.com/current/server/ko-kr/server_external_repo.htm) 및 [tsm topology](https://help.tableau.com/current/server/ko-kr/cli_topology_tsm.htm)를 참조하십시오. - 고객 배포의 경우, 데이터베이스 자격 증명을 Kubernetes Secret에 저장하고 셸 기록에 일반 텍스트를 사용하지 마십시오. #### 영구 저장소 persistence: enabled: true storageClass: "standard" accessMode: ReadWriteOnce size: 100Gi # Bootstrap volume (required for multi-node) bootstrap: enabled: true storageClass: "standard" accessMode: ReadWriteMany size: 1Gi createPV: false 정적 EFS CSI를 사용하는 클러스터(예: `mounttargetip`)의 경우, Helm은 부트스트랩 PV와 PVC를 모두 관리할 수 있습니다. persistence: bootstrap: enabled: true storageClass: "efs-bootstrap" accessMode: ReadWriteMany size: 1Gi createPV: true permissionsFix: enabled: true pv: name: "tableau-bootstrap-pv" csi: driver: efs.csi.aws.com volumeHandle: "fs-xxxxxxxx" volumeAttributes: mounttargetip: "10.x.x.x" `permissionsFix.enabled`는 Tableau 프로세스(UID/GID 999:998)가 기본적으로 `root:root`로 마운트되는 공유 EFS 마운트에 `bootstrap.json`을 쓸 수 있도록 `chown/chmods /docker/config/bootstrap`을 수행하는 초기화 컨테이너를 추가합니다. `createPV: true`인 경우, 차트는 값(예: `tableau-bootstrap-pv`)을 기반으로 부트스트랩 PV를 만들고 `tableau-server-bootstrap` PVC를 여기에 바인딩합니다. 부트스트랩 PV를 수동으로 관리하는 경우 `tableau-bootstrap-pv`를 먼저 만들고 `createPV: false` 및 `volumeName: tableau-bootstrap-pv:`를 사용하여 Helm을 설치합니다. apiVersion: v1 kind: PersistentVolume metadata: name: tableau-bootstrap-pv spec: capacity: storage: 1Gi volumeMode: Filesystem accessModes: - ReadWriteMany persistentVolumeReclaimPolicy: Retain storageClassName: efs-bootstrap csi: driver: efs.csi.aws.com volumeHandle: fs-xxxxxxxx volumeAttributes: mounttargetip: 10.x.x.x kubectl apply -f tableau-bootstrap-pv.yaml kubectl get pv tableau-bootstrap-pv #### 리소스 제한 primary: resources: limits: cpu: "4" memory: "8Gi" requests: cpu: "2" memory: "4Gi" worker: resources: limits: cpu: "4" memory: "8Gi" requests: cpu: "2" memory: "4Gi" #### 서비스 구성 service: primary: type: ClusterIP # or NodePort, LoadBalancer ports: http: 80 https: 8080 tsm: 8850 #### Ingress ingress: enabled: true className: "nginx" hosts: - host: tableau.example.com paths: - path: / pathType: Prefix tls: - secretName: tableau-tls hosts: - tableau.example.com #### Ingress 설치 실행서(예: NGINX Ingress 컨트롤러) 1. 클러스터에 Ingress 컨트롤러를 설치합니다(Ingress 차트를 사용하도록 설정하기 전에 필요). 2. 값 파일에서 Ingress 값을 설정합니다. ingress: enabled: true className: "nginx" annotations: nginx.ingress.kubernetes.io/proxy-body-size: "64m" nginx.ingress.kubernetes.io/proxy-read-timeout: "3600" nginx.ingress.kubernetes.io/proxy-send-timeout: "3600" hosts: - host: tableau.example.com paths: - path: / pathType: Prefix tls: - secretName: tableau-tls hosts: - tableau.example.com 3. tableau.example.com을 Ingress/LoadBalancer 끝점으로 연결하는 DNS 레코드를 만듭니다. 4. 릴리스 네임스페이스에서 TLS 암호를 만들거나 cert-manager를 사용합니다. 5. 차트를 배포/업그레이드하고 Ingress를 확인합니다. helm upgrade --install tableau-server ./helm/tableau-server -n default -f ./helm/tableau-server/values.yaml kubectl get ingress -n default kubectl describe ingress tableau-server 자세한 내용은 다음을 참조하십시오. - [Kubernetes Ingress 개념](https://kubernetes.io/docs/concepts/services-networking/ingress/) - [ingress-nginx 배포 가이드](https://kubernetes.github.io/ingress-nginx/deploy/) - [cert-manager 시작하기](https://cert-manager.io/docs/tutorials/getting-started-aks-letsencrypt/) #### 상태 검사 차트는 시작, 실행 상태 및 준비 상태 프로브를 지원합니다. 시작 프로브는 실행 상태/준비 상태가 실행되기 전에 최초 초기화가 오랜 기간 소요되는 것(예: failureThreshold: 200 x periodSeconds)을 허용합니다. healthChecks: startup: enabled: true initialDelaySeconds: 300 periodSeconds: 15 timeoutSeconds: 30 failureThreshold: 200 liveness: enabled: true initialDelaySeconds: 300 periodSeconds: 30 timeoutSeconds: 10 failureThreshold: 3 readiness: enabled: true initialDelaySeconds: 300 periodSeconds: 10 timeoutSeconds: 5 failureThreshold: 3 다중 노드 작업자 포드의 경우 작업자가 제한된 프로세스 집합(예: 관리 에이전트 + 클러스터 컨트롤러만 해당)을 실행할 때 잘못된 프로브 실패를 방지하기 위해 차트는 기본적으로 `worker.healthChecks.enabled: false`로 설정합니다. ### 사용법 #### Tableau Server 액세스 설치 후에는 서비스 구성을 기반으로 Tableau Server에 액세스합니다. - **ClusterIP**: 포트 전달 또는 Ingress 사용 - **NodePort**: `:`를 통해 액세스 - **LoadBalancer**: 제공된 외부 IP를 통한 액세스 #### TSM 명령 사용 \# Get pod name POD\_NAME=$(kubectl get pods -l app.kubernetes.io/component=primary -o jsonpath='{.items\[0\].metadata.name}') # Run tabcmd kubectl exec -it $POD\_NAME -- tsm status kubectl exec -it $POD\_NAME -- tsm configuration get #### tabcmd 사용 \# Get pod name POD\_NAME=$(kubectl get pods -l app.kubernetes.io/component=primary -o jsonpath='{.items\[0\].metadata.name}') # Run tabcmd kubectl exec -it $POD\_NAME -- tabcmd login -u admin -p password kubectl exec -it $POD\_NAME -- tabcmd sites #### Tableau Server 로그 보기 \# Primary node logs kubectl logs -l app.kubernetes.io/component=primary -f # Worker node logs (multi-node) kubectl logs -l app.kubernetes.io/component=worker -f # All logs kubectl logs -l app.kubernetes.io/instance=tableau-server -f #### 셸 액세스 \# Get pod name POD\_NAME=$(kubectl get pods -l app.kubernetes.io/component=primary -o jsonpath='{.items\[0\].metadata.name}') # Open shell kubectl exec -it $POD\_NAME -- /bin/bash ### 업그레이드 #### Tableau Server Helm 차트 업그레이드 helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/values.yaml #### 새 값으로 업그레이드 helm upgrade tableau-server ./helm/tableau-server -f ./helm/tableau-server/new-values.yaml ### 설치 후 토폴로지 자동화(후크) 다중 노드 설치의 경우 이 차트는 다음과 같은 설치 후/업그레이드 후 후크 작업을 실행할 수 있습니다. - 작업자 노드가 TSM에 등록될 때까지 대기 - 작업자 `clustercontroller` 프로세스 할당 설정 - 변경 사항이 보류 중인 경우 `tsm pending-changes apply -iw --ignore-prompt` 실행 구성: hooks: autoApplyWorkerTopology: enabled: true kubectlImage: "bitnami/kubectl:latest" timeoutSeconds: 3600 기본값: - `values.yaml`에서 사용하지 않도록 설정 - `values-multinode.yaml`에서 `hooks.autoApplyWorkerTopology.enabled` 확인(릴리스에 따라 `true` 또는 `false` 일 수 있으며, 최초 작업자 `clustercontroller` 설치에 대해 사용하도록 설정) 후크 실행 확인: kubectl get jobs -n default kubectl get pods -n default -l job-name=tableau-server-hook-topology kubectl logs -n default job/tableau-server-hook-topology 후크가 사용되지 않도록 설정되었거나 실패하는 경우 수동 대체 - 각 작업자 TSM 노드(작업자가 N개인 경우 일반적으로 node2부터 node(1+N)까지)에 대해 `tsm topology set-process` 실행(`tsm topology list-nodes -v`로 ID 확인): kubectl exec -n default tableau-server-primary-0 -- sh -lc ' tsm topology set-process -n node2 -pr clustercontroller -c 1 tsm topology set-process -n node3 -pr clustercontroller -c 1 # Add one line per additional worker node, e.g. for four workers: # tsm topology set-process -n node4 -pr clustercontroller -c 1 # tsm topology set-process -n node5 -pr clustercontroller -c 1 tsm pending-changes apply -iw --ignore-prompt tsm topology list-nodes -v tsm status -v **참고**: `tsm pending-changes apply`에 `-iw`를 사용하십시오. `-ig` 옵션은 이 환경에서 유효하지 않습니다. ### 설치 제거 helm uninstall tableau-server **경고**: 설치를 제거하면 영구 볼륨을 포함한 모든 리소스가 삭제됩니다. 제거하기 전에 데이터를 백업하십시오. #### 유효성 검사 단계 차트를 릴리스하기 전에 또는 변경할 때 다음 명령을 실행합니다. 1. Lint: helm lint helm/tableau-server -f helm/tableau-server/values-single.yaml helm lint helm/tableau-server -f helm/tableau-server/values-multinode.yaml 2. 템플릿(시범 실행): helm template tableau-server helm/tableau-server -f helm/tableau-server/values-single.yaml helm template tableau-server helm/tableau-server -f helm/tableau-server/values-multinode.yaml 3. 설치 테스트(선택 사항): 1. 테스트 네임스페이스에서 values-single 또는 values-multinode와 함께 `helm install`을 실행합니다. 2. `kubectl rollout status`를 실행하고(StatefulSet의 경우 포드가 Ready 상태 될 때까지 대기) 및 기본 성능 검사(예: `tsm status` 또는 서비스에 대한 HTTP 연결)를 수행합니다. 자세한 문제 해결은 [Tableau Server Helm 차트 - 문제 해결](https://help.tableau.com/current/server/ko-kr/server-helm-troubleshooting.htm)을 참조하십시오. ## 추가 리소스 - [Tableau Server 설명서](https://help.tableau.com/current/server-linux/ko-kr/) - [Herm 설명서](https://helm.sh/docs/) - [Helm 차트 업그레이드](https://helm.sh/docs/helm/helm_upgrade/) [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Server Helm 차트 - 예제 **중요**: 이 설명서에서는 Helm 및 Helm 차트에 대한 지식이 있다고 가정하며 상세한 설명적 예를 제공하지 않습니다. 설명서는 Tableau Server와 Helm 및 Helm 차트에 익숙한 고객을 대상으로 작성되었습니다. ## 소개 이 문서에서는 다양한 구성 및 시나리오에서 Helm 차트를 사용하여 Tableau Server를 배포하는 예제를 제공합니다. ## Helm 차트 다운로드 및 배포 Helm 차트는 Tableau Server 컨테이너 설정 도구(`tableau-server-container-setup-tool-.tar.gz`)의 일부로 제공되며, [Tableau Server 다운로드](http://tableau.com/ko-kr/support/releases/server/latest) 페이지에서 다운로드할 수 있습니다. 추출 후 필요한 Helm 차트 파일은 `helm/tableau` 디렉터리에 위치합니다. ## 예제 1: NodePort를 사용하는 단일 노드 deploymentMode: "single" service: primary: type: NodePort secrets: licenseKey: "YOUR-LICENSE-KEY" ## 예제 2: LoadBalancer를 사용하는 다중 노드(작업자 3개) 다중 노드 배포의 경우 `worker.replicaCount ≥ 1`을 사용합니다. 여기서 숫자는 작업자 수입니다. 아래 예제에서는 3개의 작업자를 사용합니다. deploymentMode: "multinode" primary: replicaCount: 1 worker: replicaCount: 3 service: primary: type: LoadBalancer persistence: bootstrap: enabled: true accessMode: ReadWriteMany secrets: licenseKey: "YOUR-LICENSE-KEY" ### 예제 3: Ingress 및 TLS를 사용하는 프로덕션 deploymentMode: "single" ingress: enabled: true className: "nginx" hosts: - host: tableau.company.com paths: - path: / pathType: Prefix tls: - secretName: tableau-tls hosts: - tableau.company.com service: primary: type: ClusterIP persistence: storageClass: "fast-ssd" size: 500Gi primary: resources: limits: cpu: "8" memory: "16Gi" requests: cpu: "4" memory: "8Gi" ## 추가 리소스 - [Tableau Server Helm 차트 - 개요](https://help.tableau.com/current/server/ko-kr/server-in-container_helm-chart.htm) - [Tableau Server Helm 차트 - 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm) - [Tableau Server Helm 차트 - 배포](https://help.tableau.com/current/server/ko-kr/server-helm-deploy.htm) - [Tableau Server Helm 차트 - 문제 해결](https://help.tableau.com/current/server/ko-kr/server-helm-troubleshooting.htm) - [Tableau Server Helm 차트 - 예제](#) - [Tableau Server 설명서](https://help.tableau.com/current/server-linux/ko-kr/) [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Server Helm 차트 - 참조 **중요**: 이 설명서에서는 Helm 및 Helm 차트에 대한 지식이 있다고 가정하며 상세한 설명적 예를 제공하지 않습니다. 설명서는 Tableau Server와 Helm 및 Helm 차트에 익숙한 고객을 대상으로 작성되었습니다. ## 소개 이 항목에서는 Helm 차트를 사용하여 Kubernetes에 Tableau Server를 배포하기 위한 참조 정보를 제공합니다. ### 값 속성 표 아래 표에는 `values.yaml`의 모든 리프 속성이 나열되어 있습니다. - **값**: 마침표로 구분된 키 경로 - **선택 사항**: 차트 렌더링에서 속성을 생략할 수 있는지 여부 - **예상 값**: 유효한 유형 또는 허용되는 값 - 범위: 해당하는 경우 숫자 또는 시맨틱 범위 | 값 | 기본값 | 설명 | 선택 사항 | 예상 값 | 범위 | | --- | --- | --- | --- | --- | --- | | deploymentMode | single | 배포 패턴 선택기 | true | `single` 또는 `multinode` | 해당 없음 | | image.repository | "" | Tableau 이미지 리포지토리 | false | 컨테이너 이미지 리포지토리 문자열 | 비어 있지 않은 문자열 | | image.tag | "" | Tableau 이미지 태그 | false | 이미지 태그 문자열 | 비어 있지 않은 문자열 | | image.pullPolicy | IfNotPresent | 이미지 가져오기 정책 | true | `Always,IfNotPresent,Never` | 해당 없음 | | image.pullSecrets | \[\] | 이미지 가져오기 암호 참조 | true | 암호 이름으로 구성된 문자열 배열 | 해당 없음 | | serviceAccount.create | true | 전용 ServiceAccount 만들기 | true | 부울 | 해당 없음 | | serviceAccount.name | "" | ServiceAccount 이름 재정의 | true | 문자열 | DNS 레이블 | | serviceAccount.annotations | {} | ServiceAccount 주석 | true | 맵\[문자열\]문자열 | 해당 없음 | | securityContext.runAsUser | 999 | 컨테이너 UID | true | 정수 | \>=0 | | securityContext.runAsGroup | 998 | 컨테이너 GID | true | 정수 | \>=0 | | podSecurityContext.runAsUser | 999 | 포드 수준 UID | true | 정수 | \>=0 | | podSecurityContext.runAsGroup | 998 | 포드 수준 GID | true | 정수 | \>=0 | | podSecurityContext.fsGroup | 998 | 공유 볼륨 FS 그룹 | true | 정수 | \>=0 | | podSecurityContext.fsGroupChangePolicy | OnRootMismatch | FS 그룹 소유권 정책 | true | `OnRootMismatch` 또는 `Always` | 해당 없음 | | primary.replicaCount | 1 | 주 StatefulSet 복제본 | true | 정수 | \>=1 | | primary.hostname | primary | 주 호스트 이름 힌트 | true | 문자열 | 비어 있지 않음 | | primary.resources.limits.cpu | "16" | 주 CPU 제한 | true | Kubernetes CPU 수량 | \>0 | | primary.resources.limits.memory | "64Gi" | 주 메모리 제한 | true | Kubernetes 메모리 수량 | \>0 | | primary.resources.requests.cpu | "8" | 주 CPU 요청 | true | Kubernetes CPU 수량 | \>0 | | primary.resources.requests.memory | "32Gi" | 주 메모리 요청 | true | Kubernetes 메모리 수량 | \>0 | | primary.nodeSelector | {} | 주 노드 선택기 | true | 맵\[문자열\]문자열 | 해당 없음 | | primary.tolerations | \[\] | 주 용인 | true | 용인 개체로 구성된 배열 | 해당 없음 | | primary.affinity | {} | 주 선호도 규칙 | true | 선호도 개체 | 해당 없음 | | worker.replicaCount | 1 | 작업자 StatefulSet 복제본 | true | 정수 | \>=0 | | worker.hostname | worker | 작업자 호스트 이름 힌트 | true | 문자열 | 비어 있지 않음 | | worker.resources.limits.cpu | "16" | 작업자 CPU 제한 | true | Kubernetes CPU 수량 | \>0 | | worker.resources.limits.memory | "64Gi" | 작업자 메모리 제한 | true | Kubernetes 메모리 수량 | \>0 | | worker.resources.requests.cpu | "8" | 작업자 CPU 요청 | true | Kubernetes CPU 수량 | \>0 | | worker.resources.requests.memory | "32Gi" | 작업자 메모리 요청 | true | Kubernetes 메모리 수량 | \>0 | | worker.nodeSelector | {} | 작업자 노드 선택기 | true | 맵\[문자열\]문자열 | 해당 없음 | | worker.tolerations | \[\] | 작업자 용인 | true | 용인 개체로 구성된 배열 | 해당 없음 | | worker.affinity | {} | 작업자 선호도 규칙 | true | 선호도 개체 | 해당 없음 | | worker.healthChecks.enabled | false | 작업자 프로브 사용 | true | 부울 | 해당 없음 | | env.ACCEPTEULA | "1" | Tableau EULA 동의 | true | "`1`" 또는 "`0`" | 해당 없음 | | env.LICENSE\_KEY | "" | env를 통한 라이선스 키 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | env.TABLEAU\_HOSTNAME | "" | 명시적 Tableau 호스트 이름 | true | 문자열 | DNS 이름/FQDN | | env.TSM\_ONLY | "0" | TSM 전용 모드 실행 | true | "`1`" 또는 "`0`" | 해당 없음 | | env.TSM\_REMOTE\_UID | "" | TSM 원격 UID | true | 숫자 문자열 | \>=0 | | env.TSM\_REMOTE\_USERNAME | "" | TSM 원격 사용자 이름 | true | 문자열 | 해당 없음 | | env.TSM\_REMOTE\_PASSWORD | "" | env를 통한 TSM 원격 비밀번호 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | env.TABLEAU\_USERNAME | "" | env를 통한 Tableau 관리자 사용자 이름 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | env.TABLEAU\_PASSWORD | "" | env를 통한 Tableau 관리자 비밀번호 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | env.ALWAYS\_WRITE\_BOOTSTRAP\_FILE | "0" | 주에서 부트스트랩 파일 쓰기 | true | "`1`" 또는 "`0`" | 해당 없음 | | env.BOOTSTRAP\_INSTALL | "0" | 작업자 부트스트랩 설치 모드 | true | "`1`" 또는 "`0`" | 해당 없음 | | env.WAIT\_FOR\_BOOTSTRAP\_FILE | "0" | 작업자 부트스트랩 설치 모드 | true | "`1`" 또는 "`0`" | 해당 없음 | | env.HTTP\_PROXY | "" | 부트스트랩 파일 대기 | true | URL 문자열 | 해당 없음 | | env.HTTPS\_PROXY | "" | HTTPS 프록시 URL | true | URL 문자열 | 해당 없음 | | env.NO\_PROXY | "" | HTTPS 프록시 URL | true | 쉼표로 구분된 호스트/CIDR | 해당 없음 | | env.PORT\_RANGE\_MIN | 8600 | 동적 포트 범위 최소값 | true | 숫자 문자열 | 1~65535 | | env.PORT\_RANGE\_MAX | 9000 | 동적 포트 범위 최대값 | true | 숫자 문자열 | 1~65535, 최소값 이상 | | env.COORDINATION\_SERVICE\_CLIENT\_PORT | "" | ZK 클라이언트 포트 재정의 | true | 숫자 문자열 | 1~65535 | | env.COORDINATION\_SERVICE\_PEER\_PORT | "" | ZK 피어 포트 재정의 | true | 숫자 문자열 | 1~65535 | | env.LICENSE\_SERVICE\_VENDOR\_DAEMON\_PORT | "" | ZK 리더 포트 재정의 | true | 숫자 문자열 | 1~65535 | | env.COORDINATION\_SERVICE\_LEADER\_PORT | "" | 라이선스 데몬 포트 재정의 | true | 숫자 문자열 | 1~65535 | | env.AGENT\_FILE\_TRANSFER\_PORT | "" | 에이전트 파일 전송 포트 재정의 | true | 숫자 문자열 | 1~65535 | | env.CONTROLLER\_PORT | "" | 컨트롤러 포트 재정의 | true | 숫자 문자열 | 1~65535 | | persistence.enabled | true | 데이터 PVC 사용 | true | 부울 | 해당 없음 | | persistence.storageClass | "" | 데이터 PVC 저장소 클래스 | true | 문자열 | 기존 StorageClass | | persistence.accessMode | ReadWriteOnce | 데이터 PVC 액세스 모드 | true | `ReadWriteOnce,ReadOnlyMany,ReadWriteMany` | 해당 없음 | | persistence.size | 100Gi | 데이터 PVC 크기 | true | Kubernetes 수량 | \>0 | | persistence.bootstrap.enabled | true | 부트스트랩 PVC 사용(다중 노드) | true | 부울 | 해당 없음 | | persistence.bootstrap.storageClass | "" | 부트스트랩 PVC 저장소 클래스 | true | 문자열 | 기존 StorageClass | | persistence.bootstrap.accessMode | ReadWriteMany | 부트스트랩 PVC 액세스 모드 | true | 일반적으로 `ReadWriteMany` | 해당 없음 | | persistence.bootstrap.size | 1Gi | 부트스트랩 PVC 크기 | true | Kubernetes 수량 | \>0 | | persistence.bootstrap.createPV | false | 차트에서 정적 PV를 만들도록 허용 | true | 부울 | 해당 없음 | | persistence.bootstrap.volumeName | "" | 명시적 부트스트랩 PV 이름 바인딩 | true | 문자열 | 기존 PV 이름 | | persistence.bootstrap.pv.name | "" | `createPV=true`인 경우 PV 이름 | true | 문자열 | DNS-1123 | | persistence.bootstrap.pv.capacity | 1Gi | PV 용량 | true | Kubernetes 수량 | \>0 | | persistence.bootstrap.pv.reclaimPolicy | Retain | PV 회수 정책 | true | `Retain,Delete,Recycle` | 해당 없음 | | persistence.bootstrap.pv.volumeMode | 파일 시스템 | PV 볼륨 모드 | true | `Filesystem` 또는 `Block` | 해당 없음 | | persistence.bootstrap.pv.csi.driver | efs.csi.aws.com | 부트스트랩 PV용 CSI 드라이버 | true | CSI 드라이버 이름 | 해당 없음 | | persistence.bootstrap.pv.csi.volumeHandle | "" | EFS/FileSystem 핸들 | true | 공급자 관련 ID | `createPV=true`인 경우 비어 있지 않음 | | persistence.bootstrap.pv.csi.volumeAttributes | {} | CSI 볼륨 특성 맵 | true | 맵\[문자열\]문자열 | 해당 없음 | | persistence.bootstrap.permissionsFix.enabled | false | 부트스트랩 사용 권한 초기화 사용 | true | 부울 | 해당 없음 | | persistence.bootstrap.permissionsFix.image | busybox:1.36 | 사용 권한 수정 이미지 | true | 유효한 이미지 참조 | 해당 없음 | | persistence.bootstrap.permissionsFix.runAsUser | 0 | 사용 권한 수정 초기화의 UID | true | 정수 | \>=0 | | persistence.bootstrap.permissionsFix.fsOwner | 999 | 부트스트랩 디렉터리의 소유권 변경 UID | true | 정수 | \>=0 | | persistence.bootstrap.permissionsFix.fsGroup | 998 | 부트스트랩 디렉터리의 소유권 변경 GID | true | 정수 | \>=0 | | persistence.bootstrap.permissionsFix.dirMode | "2775" | 부트스트랩 디렉터리의 모드 변경 모드 | true | 문자열 8진수 모드 | 0000~7777 | | config.configJson | JSON 블록 | Tableau `config.json` 콘텐츠 | true | 유효한 JSON 문자열 | 해당 없음 | | config.regInfoJson | JSON 블록 | Tableau 등록 JSON | true | 유효한 JSON 문자열 | 해당 없음 | | config.tabsvcYml | YAML 블록 | Tableau `tabsvc.yml` 콘텐츠 | true | 유효한 YAML 문자열 | 해당 없음 | |   |   | 차트 암호를 통한 라이선스 키 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | secrets.tsmRemotePassword | "" | 암호를 통한 TSM 원격 비밀번호 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | secrets.tableauUsername | "" | 암호를 통한 Tableau 관리자 사용자 이름 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | secrets.tableauPassword | "" | 암호를 통한 Tableau 관리자 비밀번호 | true | 문자열 | 사용되는 경우 비어 있지 않음 | | service.primary.type | ClusterIP | 주 서비스 유형 | true | `ClusterIP,NodePort,LoadBalancer` | 해당 없음 | | service.primary.ports.http | 80 | 주 HTTP 포트 | true | 정수 | 1~65535 | | service.primary.ports.gateway | 8080 | 주 게이트웨이 포트 | true | 정수 | 1~65535 | | service.primary.ports.ssl | 8443 | 주 SSL 포트 | true | 정수 | 1~65535 | | service.primary.ports.tsm | 8850 | 주 TSM 포트 | true | 정수 | 1~65535 | | service.primary.ports.dynamic.start | 8600 | 동적 포트 시작값 | true | 정수 | 1~65535 | | service.primary.ports.dynamic.end | 9000 | 동적 포트 끝값 | true | 정수 | 1~65535, 시작값 이상 | | service.primary.annotations | {} | 주 서비스 주석 | true | 맵\[문자열\]문자열 | 해당 없음 | | service.worker.ports.http | ClusterIP | 작업자 서비스 유형 | true | `ClusterIP,NodePort,LoadBalancer` | 해당 없음 | | service.worker.ports.http | 80 | 작업자 HTTP 포트 | true | 정수 | 1~65535 | | service.worker.ports.gateway | 8080 | 작업자 게이트웨이 포트 | true | 정수 | 1~65535 | | service.worker.ports.ssl | 8443 | 작업자 SSL 포트 | true | 정수 | 1~65535 | | service.worker.ports.tsm | 8850 | 작업자 TSM 포트 | true | 정수 | 1~65535 | | service.worker.ports.dynamic.start | 8600 | 작업자 동적 시작값 | true | 정수 | 1~65535 | | service.worker.ports.dynamic.end | 9000 | 작업자 동적 끝값 | true | 정수 | 1~65535, 시작값 이상 | | service.worker.annotations | {} | 작업자 서비스 주석 | true | 맵\[문자열\]문자열 | 해당 없음 | | ingress.enabled | false | Ingress 사용 | true | 부울 | 해당 없음 | | ingress.className | "" | Ingress 클래스 이름 | true | 문자열 | 기존 클래스 | | ingress.annotations | {} | Ingress 주석 | true | 맵\[문자열\]문자열 | 해당 없음 | | ingress.hosts | \[{host: tableau.example.com, paths:\[...\]}\] | Ingress 호스트/경로 구성 | true | 호스트/경로 개체로 구성된 배열 | 해당 없음 | | ingress.tls | \[\] | Ingress TLS 항목 | true | TLS 개체로 구성된 배열 | 해당 없음 | | healthChecks.startup.enabled | true | 시작 프로브 사용 | true | 부울 | 해당 없음 | | healthChecks.startup.initialDelaySeconds | 300 | 시작 프로브 지연 | true | 정수 | \>=0 | | healthChecks.startup.periodSeconds | 15 | 시작 프로브 기간 | true | 정수 | \>=1 | | healthChecks.startup.timeoutSeconds | 30 | 시작 프로브 시간 초과 | true | 정수 | \>=1 | | healthChecks.startup.failureThreshold | 200 | 시작 실패 임계값 | true | 정수 | \>=1 | | healthChecks.liveness.enabled | true | 실행 상태 프로브 사용 | true | 부울 | 해당 없음 | | healthChecks.liveness.initialDelaySeconds | 300 | 실행 상태 프로브 지연 | true | 정수 | \>=0 | | healthChecks.liveness.periodSeconds | 30 | 실행 상태 프로브 기간 | true | 정수 | \>=1 | | healthChecks.liveness.timeoutSeconds | 10 | 실행 상태 프로브 시간 초과 | true | 정수 | \>=1 | | healthChecks.liveness.successThreshold | 1 | 실행 상태 성공 임계값 | true | 정수 | \>=1 | | healthChecks.liveness.failureThreshold | 3 | 실행 상태 실패 임계값 | true | 정수 | \>=1 | | healthChecks.readiness.enabled | true | 준비 상태 프로브 사용 | true | 부울 | 해당 없음 | | healthChecks.readiness.initialDelaySeconds | 300 | 준비 상태 프로브 지연 | true | 정수 | \>=0 | | healthChecks.readiness.periodSeconds | 10 | 준비 상태 프로브 기간 | true | 정수 | \>=1 | | healthChecks.readiness.timeoutSeconds | 5 | 준비 상태 프로브 시간 초과 | true | 정수 | \>=1 | | healthChecks.readiness.successThreshold | 1 | 준비 상태 성공 임계값 | true | 정수 | \>=1 | | healthChecks.readiness.failureThreshold | 3 | 준비 상태 실패 임계값 | true | 정수 | \>=1 | | podDisruptionBudget.enabled | false | PodDisruptionBudget 사용 | true | 부울 | 해당 없음 | | podDisruptionBudget.minAvailable | 1 | 사용 가능한 최소 포드 | true | 정수 또는 퍼센트 문자열 | \>=0 | | labels | {} | 추가 공통 레이블 | true | 맵\[문자열\]문자열 | 해당 없음 | | annotations | {} | 추가 공통 주석 | true | 맵\[문자열\]문자열 | 해당 없음 | | podLabels | {} | 추가 포드 레이블 | true | 맵\[문자열\]문자열 | 해당 없음 | | podAnnotations | {} | 추가 포드 주석 | true | 맵\[문자열\]문자열 | 해당 없음 | | hooks.autoApplyWorkerTopology.enabled | false | 설치/업그레이드 후 토폴로지 후크 사용 | true | 부울 | 해당 없음 | | hooks.autoApplyWorkerTopology.kubectlImage | bitnami/kubectl:latest | 후크 작업 kubectl 이미지 | true | 유효한 이미지 참조 | 해당 없음 | | hooks.autoApplyWorkerTopology.timeoutSeconds | 3600 | 작업자를 기다리는 동안 후크 시간 초과 | true | 60 이상의 정수 | \>=60 | ## 추가 리소스 - [Tableau Server Helm 차트 - 개요](https://help.tableau.com/current/server/ko-kr/server-in-container_helm-chart.htm) - [Tableau Server Helm 차트 - 필수 요건](https://help.tableau.com/current/server/ko-kr/server-helm-prerequisites.htm) - [Tableau Server Helm 차트 - 배포](https://help.tableau.com/current/server/ko-kr/server-helm-deploy.htm) - [Tableau Server Helm 차트 - 예제](https://help.tableau.com/current/server/ko-kr/server-helm-examples.htm) - [Tableau Server Helm 차트 - 문제 해결](https://help.tableau.com/current/server/ko-kr/server-helm-troubleshooting.htm) - [Tableau Server 설명서](https://help.tableau.com/current/server-linux/ko-kr/) [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Server Helm 차트 - 필수 요건 **중요**: 이 설명서에서는 Helm 및 Helm 차트에 대한 지식이 있다고 가정하며 상세한 설명적 예를 제공하지 않습니다. 설명서는 Tableau Server와 Helm 및 Helm 차트에 익숙한 고객을 대상으로 작성되었습니다. 이 항목에서는 Helm 차트를 사용하여 Tableau Server 배포하는 데 필요한 필수 요건에 대해 설명합니다. ## Helm 차트 다운로드 및 배포 Helm 차트는 Tableau Server 컨테이너 설정 도구(`tableau-server-container-setup-tool-.tar.gz`)의 일부로 제공되며, [Tableau Server 다운로드](http://tableau.com/ko-kr/support/releases/server/latest) 페이지에서 다운로드할 수 있습니다. 추출 후 필요한 Helm 차트 파일은 `helm/tableau` 디렉터리에 위치합니다. ## 필요한 도구 - `kubectl` Kubernetes 클러스터에 액세스하도록 구성된 CLI - `helm` CLI 버전 3.x 이상 - Kubernetes 클러스터 액세스(1.19 이상) ## 클러스터 요구 사항 - 16GB RAM 및 4개의 CPU 코어가 있는 하나 이상의 노드(8개 코어 권장) - 동적 PersistentVolume 프로비저닝을 위해 구성된 StorageClass - LoadBalancer 서비스 또는 Ingress 리소스를 만들 수 있는 기능 ## 필요한 정보 시작하기 전에 다음을 준비하십시오. - Tableau Server의 **라이선스 키** - 초기 계정을 위한 **TSM 관리자의 `username` 및** `**password**` - 액세스를 위한 Tableau Server **호스트 이름** ## Amazon EKS(Elastic Kubernetes Service) 필수 요건 ### `efs-bootstrap` StorageClass 기본적으로 `efs-bootstrap`은 EKS에서 만들지 않습니다. 다중 노드 부트스트랩 공유의 경우 Helm 설치 전에 만들어야 합니다. 다중 노드 배포의 경우 포드 일정을 예약하려면 먼저 부트스트랩 저장소를 프로비저닝해야 합니다. `efs-bootstrap` StorageClass가 EFS 볼륨을 동적으로 프로비저닝하지 않는 경우 다음 중 하나를 수행해야 합니다. - 정적 부트스트랩 PV를 미리 만들고 `tableau-server-bootstrap`에 바인딩합니다. 또는 - `persistence.bootstrap.createPV: true`를 설정하고 `valid persistence.bootstrap.pv.csi.volumeHandle`(실제 EFS ID, fs-...)을 제공합니다. 이렇게 하지 않으면 포드는 바인딩되지 않은 PVC와 함께 보류 중 상태로 유지됩니다. 1. 클러스터에 EFS CSI 드라이버가 설치되어 있는지 확인합니다. kubectl get csidriver efs.csi.aws.com EKS에서 관리하는 부가기능이 설치되어 있지 않은 경우에도 `CSIDriver` 개체가 존재할 수 있습니다. 부가기능이 있는지 명시적으로 확인합니다. `ResourceNotFoundException` 오류(부가기능 없음)가 발생하거나, 이후 포드가 `driver name efs.csi.aws.com not found in the list of registered CSI drivers` 등의 마운트 오류로 실패하는 경우, EKS 부가기능을 설치하고 상태가 ACTIVE가 될 때까지 기다린 후 노드 플러그인 포드를 확인하십시오. 다중 노드 부트스트랩은 EFS 지원 볼륨(ReadWriteMany)을 사용하기 때문에 이 작업이 필요합니다. 추가 노드에 EFS CSI 노드 플러그인이 없으면 부트스트랩 PVC는 바인딩될 수 있지만 마운트가 실패하고 포드가 `Init/Pending` 상태로 유지됩니다. 다음 오류와 함께 EFS 마운트가 실패합니다. is not authorized to perform: elasticfilesystem:DescribeMountTargets 또는 Failed to resolve "fs-....efs..amazonaws.com" 다음 수정 단계 중 하나를 사용하십시오. - **EKS 노드 역할에 대한 IAM 수정**(기본 설정): 마운트 대상 및 AZ 검색이 작동하도록 EFS 및 EC2에 읽기 권한을 부여합니다. 노드 그룹에서 노드 인스턴스 역할 이름을 확인합니다. aws eks list-nodegroups --cluster-name aws eks describe-nodegroup \\ \--cluster-name \\ \--nodegroup-name \\ \--query "nodegroup.nodeRole" \\ \--output text - `attach-role-policy`의 **IAM \*\*역할 이름\*\* 사용**(ARN의 마지막 세그먼트): aws iam attach-role-policy \\ \--role-name \\ \--policy-arn arn:aws:iam::aws:policy/AmazonElasticFileSystemClientReadWriteAccess aws iam attach-role-policy \\ \--role-name \\ \--policy-arn arn:aws:iam::aws:policy/AmazonEC2ReadOnlyAccess - 관련된 일반 사용 권한: - elasticfilesystem:DescribeMountTargets, elasticfilesystem:DescribeFileSystems - `ec2:DescribeAvailabilityZones`(종종 마운트 오류에 `DescribeAvailabilityZones`이 나타나는 경우에 필요) - **명시적 마운트 대상 IP**: 환경에서 DNS/검색이 제한된 경우 부트스트랩 PV CSI 볼륨 특성에 `mounttargetip`을 설정합니다. - 키 값(`createPV: true` 경로): persistence: bootstrap: pv: csi: volumeAttributes: mounttargetip: "10.x.x.x" - 수동 PV 경로 spec: csi: driver: efs.csi.aws.com volumeHandle: fs-xxxxxxxx volumeAttributes: mounttargetip: 10.x.x.x 2. `efs-bootstrap` StorageClass(예시)를 만듭니다. apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: efs-bootstrap provisioner: efs.csi.aws.com reclaimPolicy: Retain volumeBindingMode: Immediate allowVolumeExpansion: true 3. 부트스트랩 프로비저닝 경로 하나를 선택합니다(필수). - **동적 EFS 프로비저닝 경로**: 액세스 지점으로 구성된 EFS CSI의 동적 StorageClass를 사용합니다(예: `provisioningMode: efs-ap, fileSystemId`, 사용 중인 플랫폼 표준에 따라 permissions/basePath 매개 변수 사용). - **정적 PV 경로**: `csi.driver: efs.csi.aws.com` 및 `csi.volumeHandle: fs-...`를 사용하여 수동으로 `tableau-bootstrap-pv`를 만듭니다. 그리고 다음을 설정합니다. - `persistence.bootstrap.createPV: false` - `persistence.bootstrap.volumeName: tableau-bootstrap-pv` - **Helm에서 생성한 정적 PV 경로**: 다음을 설정합니다. - `persistence.bootstrap.createPV: true` - `persistence.bootstrap.pv.csi.volumeHandle: fs-...` ## EKS가 아닌 클러스터의 필수 요건 ### `ReadWriteMany` StorageClass EKS에서 호스팅되지 않는 클러스터의 경우(또는 EFS를 사용하지 않는 경우) 다중 노드 부트스트랩 공유에 대한 중요한 요구 사항은 부트스트랩 볼륨에 대해 `ReadWriteMany (RWX)` 액세스 모드를 지원하는 StorageClass를 제공하는 것입니다. 포드 일정을 예약하려면 먼저 부트스트랩 저장소를 프로비저닝할 수 있어야 하기 때문에 이 작업이 필요합니다. 자체 호스팅되는 일반적인 Kubernetes용 RWX 저장소 백엔드에는 다음이 포함됩니다. - NFS(가장 일반적이고 테스트가 가장 쉬움) - CephFS - Longhorn(설치된 경우) - GlusterFS - NetApp/기타 엔터프라이즈 저장소 선택한 백엔드에 해당하는 CSI 드라이버가 설치되어 있는지 확인해야 합니다. 사용자 지정 RWX StorageClass를 사용하도록 Tableau Server를 구성하려면 Helm 값(예: `values-multinode.yaml`)을 업데이트하여 `persistence.bootstrap.storageClass` 값을 사용 중인 StorageClass 이름으로 설정합니다. persistence: # ... other persistence settings ... # Bootstrap volume (required for multi-node) bootstrap: enabled: true storageClass: "my-rwx-storage" # <--- Replace with your StorageClass name accessMode: ReadWriteMany size: 1Gi createPV: false ## 추가 리소스 - [Tableau Server Helm 차트 - 개요](https://help.tableau.com/current/server/ko-kr/server-in-container_helm-chart.htm) - [Tableau Server Helm 차트 - 배포](https://help.tableau.com/current/server/ko-kr/server-helm-deploy.htm) - [Tableau Server Helm 차트 - 문제 해결](https://help.tableau.com/current/server/ko-kr/server-helm-troubleshooting.htm) - [Herm 설명서](https://helm.sh/docs/) - [Tableau Server 설명서](https://help.tableau.com/current/server-linux/ko-kr/) [주요 콘텐츠로 건너뛰기](#main-content) # HTTP 401 - 권한 없음 **401- 권한 없음 오류**가 수신되는 경우 이유는 다음 중 하나일 수 있습니다.  - SSPI를 통해 Active Directory를 사용하도록 Tableau Server를 구성했을 수 있습니다. 웹 서버에서 SSPI를 사용하는 경우 신뢰할 수 있는 인증을 설정할 필요가 없습니다. 뷰를 내장할 수 있으며 이러한 뷰에는 허가된 Tableau 사용자이며 Active Directory의 멤버인 사용자만 액세스할 수 있습니다. 자세한 내용은 [tsm authentication sspi ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMSspi)를 참조하십시오. **참고:** SSPI는 Windows용 Tableau Server에만 구성할 수 있습니다. - Tableau Server 배포 후 **302- 리디렉션 오류**가 표시되는 경우 클라이언트에 대한 URL을 구성할 때 기록한 신뢰할 수 있는 티켓 코드가 두 부분으로 구성되는 티켓 URL 형식에 따라 계정에 업데이트되지 않은 것일 수 있습니다. 자세한 내용은 아래에서 [Tableau Server에서 티켓 가져오기](https://help.tableau.com/current/server/ko-kr/trusted_auth_webrequ.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # HTTP 404 - 파일을 찾을 수 없음 프로그램 코드에서 존재하지 않는 Tableau Server URL을 참조하는 경우 이 오류가 발생할 수 있습니다. 예를 들어 웹 페이지에서 찾을 수 없는 잘못된 URL을 검색하려고 할 때 웹 서버에서 이러한 URL을 생성한 것일 수 있습니다. 이 오류의 또 다른 원인은 [Tableau Server에 신뢰할 수 있는 IP 주소 또는 호스트 이름 추가](https://help.tableau.com/current/server/ko-kr/trusted_auth_trustIP.htm)에 지정된 대로 신뢰할 수 있는 웹 서버를 입력하지 않은 경우입니다. 이미 신뢰할 수 있는 웹 서버를 입력한 경우 IP 주소 또는 호스트 이름이 올바른지 확인하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # HTTP 응답 헤더 Tableau Server는 [OWASP 보안 헤더 프로젝트](https://owasp.org/www-project-secure-headers/#div-headers)에 지정된 응답 헤더 중 일부를 지원합니다. 이 항목에서는 Tableau Server에서 다음과 같은 응답 헤더를 구성하는 방법에 대해 설명합니다. - HSTS(HTTP Strict Transport Security) - Referrer-Policy - X-Content-Type-Options - X-XSS-Protection Tableau Server는 CSP(콘텐츠 보안 정책) 표준도 지원합니다. CSP 구성은 이 항목에서 다루지 않습니다. 자세한 내용은 [콘텐츠 보안 정책](https://help.tableau.com/current/server/ko-kr/security_csp.htm)을 참조하십시오. ## 응답 헤더 구성 모든 응답 헤더는 [tsm configuration set](https://help.tableau.com/current/server/ko-kr/cli_configuration_tsm.htm#TSMSet) 명령으로 구성됩니다. 응답 헤더 구성을 마쳤으면 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 실행합니다. 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## HSTS(HTTP Strict Transport Security) HSTS는 Tableau Server에 연결하는 클라이언트가 HTTPS를 사용하여 연결하도록 요구합니다. 자세한 내용은 OWASP 항목 [HSTS(HTTP Strict Transport Security)](https://owasp.org/www-project-secure-headers/#div-headers)를 참조하십시오. ### 옵션 gateway.http.hsts 기본값: `false` HSTS(HTTP Strict Transport Security) 헤더가 있으면 HTTPS를 사용하도록 설정된 도메인에서 브라우저가 HTTPS를 사용합니다. gateway.http.hsts\_options 기본값: `"max-age=31536000"` 기본적으로 HSTS 정책은 1년(31536000초) 동안 설정됩니다. 이 기간은 브라우저가 HTTPS를 통해 서버에 액세스하는 시간을 지정합니다. ## Referrer-Policy 2019.2부터 Tableau Server에는 Referrer-Policy HTTP 헤더 동작을 구성하는 기능이 포함되어 있습니다. 이 정책은 모든 "보안" 연결에 대한 원본 URL을 포함하는 기본 동작에서 사용하도록 설정됩니다(`no-referrer-when-downgrade` 정책). 이전 버전에서는 Referrer-Policy 헤더가 Tableau Server가 전송하는 응답에 포함되지 않았습니다. Referrer-Policy가 지원하는 다양한 정책 옵션에 대한 자세한 내용은 OWASP 항목 [Referrer-Policy](https://owasp.org/www-project-secure-headers/#div-headers)를 참조하십시오. ### 옵션 gateway.http.referrer\_policy\_enabled 기본값: `true` Tableau Server가 전송한 응답에서 Referrer-Policy 헤더를 제외하려면 이 값을 `false`로 설정하십시오. gateway.http.referrer\_policy 기본값: `no-referrer-when-downgrade` 이 옵션은 Tableau Server에 대한 리퍼러 정책을 정의합니다. OWASP 페이지의 [Referrer-Policy](https://owasp.org/www-project-secure-headers/#div-headers) 테이블에 나열된 정책 값 문자열 중 하나를 지정할 수 있습니다. ## X-Content-Type-Options X-Content-Type-Options 응답 HTTP 헤더는 Content-Type 헤더의 MIME 유형이 브라우저에 의해 변경되지 않도록 지정합니다. MIME 유형이 지정되지 않은 경우에는 브라우저가 페이로드 특성을 평가하여 MIME 유형을 결정하려고 시도할 수 있습니다. 그런 다음 결과에 따라 콘텐츠를 표시합니다. 이 프로세스를 "스니핑"이라고 합니다. MIME 유형을 잘못 해석하면 보안 취약점이 발생할 수 있습니다. 자세한 내용은 OWASP 항목 [X-Content-Type-Options](https://owasp.org/www-project-secure-headers/#div-headers)를 참조하십시오. ### 옵션 gateway.http.x\_content\_type\_nosniff 기본값: `true` 이 옵션을 사용하면 X-Content-Type-Options HTTP 헤더가 기본적으로 'nosniff'로 설정됩니다. ## X-XSS-Protection HTTP X-XSS-Protection 응답 헤더가 브라우저로 전송되어 XSS(사이트 간 스크립팅) 보호 기능을 사용하도록 설정합니다. 사용자가 브라우저에서 XXS 보호 기능을 해제한 경우 X-XSS-Protection 응답 헤더가 구성을 재정의합니다. 자세한 내용은 OWASP 항목 [X-XSS-Protection](https://owasp.org/www-project-secure-headers/#div-headers)을 참조하십시오. ### 옵션 gateway.http.x\_xss\_protection 기본값: `true` 이 옵션을 사용하면 X-XSS-Protection 응답 헤더가 기본적으로 사용되도록 설정됩니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Hyper 스풀링 인시던트 Hyper 쿼리가 디스크로 스풀링되면 _Hyper 스풀링_ 인시던트가 경고로 로깅됩니다. 일반적으로 이 인시던트는 가용 메모리가 부족해 Tableau Server 데이터 엔진 프로세스가 디스크 임시 쓰기를 통해 스풀링으로 전환될 때 발생합니다. 이 내용은 [Tableau Server 데이터 엔진](https://help.tableau.com/current/server/ko-kr/data_engine2_intro.htm) 항목의 메모리 사용량 섹션에 보다 자세히 설명되어 있습니다. ## 이 작업을 수행할 수 있는 사용자 Resource Monitoring Tool 관리자 또는 **서버/환경 관리** 역할이 있는 Resource Monitoring Tool 사용자 [주요 콘텐츠로 건너뛰기](#main-content) # Hyper 쿼리 처리(베타) **참고:** Hyper 쿼리 처리는 베타 릴리스이므로 일반 릴리스 전에 이름이 변경될 수 있습니다. 이제 CDP(Customer Data Platform) 커넥터가 Hyper 쿼리 처리 엔진으로 구동됩니다. 이 엔진은 빠른 데이터 쿼리 처리를 통해 대화형 분석을 지원하고 데이터에 간편하게 연결할 수 있도록 하여 데이터를 빠르게 탐색할 수 있도록 합니다. Hyper 쿼리 처리 엔진은 Tableau에서 라이브 연결 및 Tableau 데이터 추출을 통해 Customer Data Platform 데이터를 쿼리할 때 쿼리 속도를 높여줍니다. > [!IMPORTANT] > > **베타 기능:** Hyper 쿼리 처리 베타 기능은 무료로 추가 기능을 제공합니다. 고객은 재량에 따라 이 서비스의 평가판에 참여할 수 있습니다. 베타 서비스 사용에는 해당하는 베타 서비스 약관([계약 및 약관](https://www.salesforce.com/company/legal/agreements/))이 적용됩니다. ## Tableau Server에서 Hyper 쿼리 처리 사용 Hyper 쿼리 처리를 사용하려면 다음 단계를 완료합니다. 1\. Salesforce CDP에 연결합니다. 2\. 화면의 지침에 따라 hyper jdbc 드라이버를 설치합니다. `-Salesforce-cdp-hyper-beta-1.15.0.jar`를 사용하거나 [여기](https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases)에서 .jar 파일을 다운로드합니다. 3\. 다운로드한 파일을 시스템에 따라 다음 디렉터리 경로로 이동합니다. Windows - `C:\Program Files\Tableau\Drivers` macOS - `/Users/[user]/Library/Tableau/Drivers` 4\. 드라이버를 올바른 경로로 이동한 후 다시 연결합니다. Customer Data Platform 커넥터를 Tableau Server에서 사용할 수 있습니다. **참고:** Hyper 쿼리 처리 지원은 베타 릴리스입니다. Tableau Server에서 사용할 수 있습니다. Tableau Desktop 및 Tableau Online은 2022년 12월부터 지원됩니다. 이 날짜는 변경될 수 있습니다. ### 참고 항목 - Tableau 도움말: [Tableau Server를 Customer Data Platform에 연결](https://help.tableau.com/current/server-linux/ko-kr/config_oauth_sfdc_cdp.htm) - Salesforce 도움말: [Customer Data Platform에서 Tableau 설정](https://help.salesforce.com/s/articleView?id=sf.c360_a_set_up_tableau_connected_app.htm&type=5&language=ko_KR) - Salesforce 도움말: [Tableau에서 Customer Data Platform 활성화](https://help.salesforce.com/s/articleView?id=sf.c360_a_enable_tableau_connector.htm&type=5&language=ko_KR) - Salesforce 도움말: [Tableau의 Customer Data Platform 데이터 사용](https://help.salesforce.com/s/articleView?id=sf.c360_a_using_customer_360_aud_data_in_tableau.htm&type=5&language=ko_KR) [주요 콘텐츠로 건너뛰기](#main-content) # ID 마이그레이션 관련 문제 해결 ## 백업을 복원할 수 없음 기본 스키마로 ID 서비스를 사용하는 Tableau Server 버전(버전 2022.1~2022.1.7, 2022.3~2022.3.9 및 2023.1~2023.15)으로 업그레이드한 후 Tableau Server 백업을 복원하면 다음 오류가 발생할 수 있습니다. _“Tableau Server에 기본적으로 새 ID 서비스 테이블이 사용되기 때문에 백업을 복원할 수 없습니다.”_ 이 문제는 Tableau Server가 ID 서비스를 채우는 데 필요한 프로세스인 ID 마이그레이션을 실행해야 할 때 발생할 수 있습니다. ID 서비스는 Tableau Server 버전 2022.1부터 여러 버전에 도입된 ID 스키마로, 사용자를 프로비저닝하고 인증하는 데 사용됩니다. 잠재적 문제를 방지하기 위해 Tableau Server 백업이 복원 중인 버전과 다른 ID 스키마를 사용하는 것을 감지하면 복원 프로세스를 진행할 수 없습니다. 이 문제를 해결하려면 아래에 설명된 단계를 수행합니다. **중요:** 아래 설명된 절차는 Tableau Server 버전 2022.1.0~2022.1.7, 2022.3.0~2022.3.9 및 2023.1.0~2023.15를 실행하는 경우에만 적용됩니다. ### 1단계: `legacy-identity-mode`를 사용하도록 설정한 후 백업 복원 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행하여 레거시 ID 저장소 모드를 사용하도록 Tableau Server 2022.1 이상을 설정합니다. ``` tsm authentication legacy-identity-mode enable tsm pending-changes apply ``` ID 서비스를 채우려면 Tableau Server에서 레거시 ID 저장소 모드를 사용해야 합니다. tsm 명령에 대한 자세한 내용은 [`tsm authentication legacy-identity-mode`](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#tsm_identity_mig_legacy)를 참조하십시오. 3. 다음 명령을 실행하여 백업을 다시 복원하고 마이그레이션이 시작될 수 있도록 합니다. ``` tsm maintenance restore --file tsm start ``` **중요:** 백업이 복원된 후 마이그레이션이 시작되면 ID 서비스가 ID 정보로 채워집니다. 백업 복원에 대한 일반적인 내용은 [백업에서 복원](https://help.tableau.com/current/server/ko-kr/db_restore.htm)을 참조하십시오. ### 2단계: ID 마이그레이션 확인 및 완료 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭하여 마이그레이션이 시작되었는지 확인합니다. Tableau Server의 사용자 페이지에 있는 전용 ID 마이그레이션 페이지를 사용하여 진행률을 모니터링하고 관리할 수 있습니다. 자세한 내용은 [ID 마이그레이션 관리](https://help.tableau.com/current/server/ko-kr/identity_migration_manage.htm)를 참조하십시오. 3. [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)에 설명된 대로 모든 ID 충돌을 해결하거나 승인하여 아래의 이미지와 같이 모든 실패 탭에 '0'이 표시되도록 합니다. ![실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_failures_acknowledge.png) 4. 다음 작업 중 _하나_를 수행합니다. - ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 제목 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다. ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_overview_runnow.png) - 또는 다음 예약 시간에 마이그레이션 작업이 실행될 때까지 기다려도 됩니다. 5. 마이그레이션이 완료되면 ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다. ![100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_complete.png) ### 3단계: ID 서비스를 사용하도록 Tableau Server 구성 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행합니다. ``` tsm authentication legacy-identity-mode disable tsm pending-changes apply ``` **참고:** 위의 명령을 실행한 후 설명된 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. 이 페이지에는 `tsm authentication legacy-identity-mode`를 사용하도록 설정한 경우에만 액세스할 수 있습니다. ID 서비스를 사용하도록 Tableau Server를 구성한 후에 사용자가 Tableau Server에 로그인하면 Tableau Server가 구성된 ID 저장소의 식별자를 사용하여 사용자 ID를 검색합니다. 이 식별자에서 UUID(범용 고유 식별자)가 반환되고 일치하는 기존 Tableau Server 사용자 ID를 찾는 데 사용됩니다. 그런 다음에는 사용자 세션이 생성되고 인증 워크플로우가 완료됩니다. ### 4단계: ID 풀이 사용하도록 설정되어 있는지 확인 1. 다음 명령을 실행합니다. ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다. ## ID 마이그레이션 페이지의 “예기치 않은 오류” ID 마이그레이션 페이지에서 모든 사용자 ID를 해결하거나 확인한 후에 “예기치 않은 오류” 메시지가 표시됩니다. 이 메시지는 한 번에 1,000명이 넘는 사용자를 해결하거나 확인하려고 할 때 표시될 수 있습니다. 이 문제를 해결하려면 1,000명 이하의 사용자 ID를 선택하여 해결하거나 확인한 다음 다시 시도하십시오. ID 충돌 관리에 대한 자세한 내용은 [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오. ## 마이그레이션 진행률이 응답하지 않거나 멈춘 것으로 보임 마이그레이션 상태 또는 마이그레이션 진행률 표시기가 응답하지 않거나 멈춘 것으로 보이는 경우 마이그레이션 실패 아래에서 모든 사용자 충돌이 해결되었고 승인되었는지 검증합니다. ![ID 마이그레이션 진행률 표시줄이 37% 완료에서 멈췄습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_overview_stuck.png) 이 문제를 해결하려면 모든 실패 탭에서 하나 이상의 사용자 ID를 선택하고 동작 드롭다운 메뉴에서 승인을 클릭하여 모든 충돌이 해결되고 승인되었는지 확인합니다. 모든 실패 탭에 '0'이 표시될 때까지 이 작업을 수행합니다. ID 충돌 관리에 대한 자세한 내용은 [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오. ![두 가지 마이그레이션 실패 요약을 비교합니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_complete_compare.png) **참고:** 모든 ID 충돌을 해결한 후 모든 마이그레이션 작업을 실행해야 합니다. 그래야 Tableau Server에 ID 서비스를 사용하도록 설정할 수 있습니다. 이제 마이그레이션 개요 제목 옆의 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택하여 마이그레이션 작업을 실행할 수 있습니다. 마이그레이션 개요에 100% 완료가 표시되면 ID 서비스를 사용하도록 Tableau Server를 구성할 수 있습니다. 자세한 내용은 [3단계: ID 마이그레이션 시작](https://help.tableau.com/current/server/ko-kr/identity_migration.htm#step3)를 참조하십시오. ## "ID 마이그레이션이 진행 중입니다" 팝업이 지속됨 ID 서비스가 아직 사용하도록 설정되지 않았기 때문에 ID 마이그레이션을 완료했는데도 "ID 마이그레이션이 진행 중입니다"라는 알림이 계속 표시됩니다. ID 마이그레이션을 완료하려면 Tableau Server가 ID 풀 기능을 사용하는 ID 구조를 사용할 수 있도록 [4단계: ID 마이그레이션 완료](https://help.tableau.com/current/server/ko-kr/identity_migration.htm#step4)를 참조하여 ID 서비스를 사용하도록 설정해야 합니다. ## ID 마이그레이션 페이지가 사라짐 ID 마이그레이션이 완료되고 Tableau Server가 ID 서비스를 사용하도록 구성되면 전용 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. ID 마이그레이션 페이지는 ID 마이그레이션에만 필요하거나 `tsm authentication legacy-identity-mode`를 사용하는 경우에만 필요합니다. ## 사용자가 로그인할 수 없음 ID 마이그레이션이 완료되고 ID 서비스를 사용하도록 설정한 후 일부 사용자가 Tableau Server에 로그인할 수 없습니다. 대부분의 경우 이 문제는 ID가 충돌하고 나중에 ID 마이그레이션 중에 **확인된** 사용자에게 발생합니다. 확인된 사용자 ID는 ID 서비스로 마이그레이션되지 않으며 이후 AD(Active Directory) 또는 LDAP 그룹 동기화 중에 무시됩니다. 확인된 사용자 ID와 연결된 사용자가 Tableau Server에 다시 액세스해야 하는 경우 해당 사용자를 Tableau Server에 수동으로 추가해야 합니다. 사용자가 수동으로 추가된 후 후속 AD 또는 LDAP 그룹 동기화를 통해 사용자 ID가 인식되고 예상대로 동기화됩니다. ## ID 마이그레이션 되돌리기 특정 사용자가 Tableau Server에 로그인할 수 없는 것과 같이 ID 서비스로 인한 문제가 있다고 생각되면 [`tsm authentication legacy-identity-mode`](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#tsm_identity_mig_legacy) 명령을 사용하여 레거시 ID 저장소 모드를 사용하도록 되돌릴 수 있습니다. 되돌린 후에는 ID 마이그레이션 이후에 추가된 새 사용자와 마이그레이션 전의 Tableau Server에만 로그인할 수 있었던 사용자 모두 문제 없이 Tableau Server에 로그인할 수 있게 됩니다. ID 서비스에서 레거시 ID 저장소 모드로 되돌린 후 ID 마이그레이션 페이지에서 문제가 있는 사용자 ID의 마이그레이션을 실행할 수 있습니다. ID 충돌 관리에 대한 자세한 내용은 [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # ID 마이그레이션 관리 관리자는 Tableau Server의 사용자 페이지에서 사용할 수 있는 전용 ID 마이그레이션 페이지에서 ID 마이그레이션을 모니터링하고 관리할 수 있습니다. 예를 들어 마이그레이션 작업 실행 시기를 변경할 수 있습니다. 이 페이지는 마이그레이션 프로세스 중에 사용할 수 있습니다. ![ID 마이그레이션 개요 페이지입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_main.png) 마이그레이션 작업은 Tableau Server 사용 중단 또는 방해 없이 백그라운드에서 실행되도록 설계되었습니다. 그러나 필요한 경우 마이그레이션 작업 실행 빈도, 실행 시기 및 실행 기간에 영향을 미치는 조정을 수행할 수 있습니다. 일반적으로 마이그레이션은 Tableau Server 배포의 크기와 마이그레이션 중에 변경한 기본 설정에 따라 3분에서 10일이 걸릴 수 있습니다. 예를 들어 사용자 수가 10,000명인 경우 마이그레이션에 약 30분이 소요될 수 있습니다. **참고:** 마이그레이션 작업이 실행되는 동안 모든 인증 및 사용자 관련 기능은 정상적으로 작동합니다. ## ID 마이그레이션 작업 관리 ID 마이그레이션의 다음 측면을 관리할 수 있습니다. ID 충돌 해결 마이그레이션 중에 발생할 수 있는 ID 충돌을 검토하려면 [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오. 일별 마이그레이션 작업 일정 변경 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭합니다. 1. 마이그레이션 개요 머리글 옆에서 일정 편집 단추를 클릭합니다. 2. 일정 편집 대화 상자에서 작업 실행 시기 및 빈도를 변경합니다. **참고:** 이 대화 상자에서 우선 순위 및 실행 옵션은 무시해도 됩니다. ![마이그레이션 빈도를 편집하기 위한 옵션이 있는 일정 편집 대화 상자입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_schedule.png) 3. 마치면 업데이트를 클릭합니다. 마이그레이션 작업 시작 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭합니다. 1. 아무 탭에서 한 명 이상의 사용자를 선택합니다. 2. 동작 메뉴에서 필요한 작업에 따라 마이그레이션 다시 시도 또는 확인을 선택합니다. ![마이그레이션 다시 시도 또는 승인 옵션이 있는 ID 마이그레이션 동작 드롭다운 메뉴입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_actions.png) 3. 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭합니다. 4. 지금 실행을 선택합니다. ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 지금 실행 옵션이 하이라이트되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_runnow.png) ID 마이그레이션 일시 중지 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭합니다. 1. 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭합니다. 2. 사용 안 함을 선택합니다. ID 마이그레이션 다시 시작 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭합니다. 1. 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭합니다. 2. 사용을 선택합니다. ## ID 마이그레이션 설정 변경 ID 마이그레이션으로 인해 Tableau Server에 발생할 수 있는 부하를 줄이기 위해 마이그레이션은 아래에 나열된 기본 설정으로 실행되도록 구성됩니다. ### 마이그레이션 설정
유형tsm 명령기본값절차
작업 일정해당 없음오전 3:00, 완료될 때까지 매일ID 마이그레이션 페이지에서 구성 가능함. 위의 일별 마이그레이션 작업 일정 변경 참조.
사용자 ID 요청/초(속도)tsm authentication identity-migration configure -–rate최대 5

필요한 경우 tsm authentication identity-migration 명령을 사용하여 아래의 단계에 따라 위에 나열된 마이그레이션 설정을 변경할 수 있습니다.

  1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.

  2. tsm authentication identity-migration에 설명된 명령을 하나 또는 둘 다 실행합니다.

    예를 들어 개별 작업 런타임 및 속도를 기본값에서 변경하려면 다음 명령을 실행하면 됩니다.

    tsm authentication identity-migration configure --job-run-time 180 --rate 3

개별 작업 런타임tsm authentication identity-migration configure -–job-run-time120분
ID 마이그레이션 사용tsm configuration set -k features.IdentityMigrationBackgroundJobfalse

ID 마이그레이션을 사용하도록 설정하면 Tableau Server는 ID 서비스를 사용하여 사용자 ID 정보를 저장하고 관리할 수 있습니다.

  1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.

  2. 다음 명령을 실행합니다.

    tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

참고: ID 풀과 같은 특정 기능을 사용하려면 ID 마이그레이션 및 ID 서비스 사용이 전제되어야 합니다. tsm 명령에 대한 자세한 내용은 features.IdentityMigrationBackgroundJob을 참조하십시오.

### ID 마이그레이션 사용 안 함 Tableau Server 버전 2021.4.21, 2022.1.17, 2022.3.9 및 2023.1.5로 업그레이드한 경우 ID 마이그레이션을 사용하지 않도록 설정해야 할 수 있습니다. ID 마이그레이션을 사용하지 않도록 설정하면 Tableau Server는 ID 서비스를 사용하여 사용자 ID 정보를 저장하고 관리할 수 없습니다. 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행합니다. `tsm configuration set -k features.IdentityMigrationBackgroundJob -v false` **참고:** [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)과 같은 특정 기능을 사용하려면 ID 마이그레이션 및 ID 서비스 사용이 전제되어야 합니다. ## ID 마이그레이션 완료 및 ID 서비스 구성 모든 사용자 충돌을 해결하고 마이그레이션 작업을 실행한 후에는 ID 서비스를 사용하도록 Tableau Server를 구성해야 ID 마이그레이션 프로세스가 완료됩니다. ### 1단계: ID 마이그레이션 확인 및 완료 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭하여 마이그레이션이 시작되었는지 확인합니다. Tableau Server의 사용자 페이지에 있는 전용 ID 마이그레이션 페이지를 사용하여 진행률을 모니터링하고 관리할 수 있습니다. 자세한 내용은 [ID 마이그레이션 관리](#)를 참조하십시오. 3. [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)에 설명된 대로 모든 ID 충돌을 해결하거나 승인하여 아래의 이미지와 같이 모든 실패 탭에 '0'이 표시되도록 합니다. ![실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_failures_acknowledge.png) 4. 다음 작업 중 _하나_를 수행합니다. - ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 제목 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다. ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_overview_runnow.png) - 또는 다음 예약 시간에 마이그레이션 작업이 실행될 때까지 기다려도 됩니다. 5. 마이그레이션이 완료되면 ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다. ![100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_complete.png) ### 2단계: ID 서비스를 사용하도록 Tableau Server 구성 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 실행 중인 Tableau Server 버전에 따라 다음 명령을 실행합니다. - Tableau Server 버전 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상의 경우: ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false ``` - Tableau Server 버전 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5의 경우: ``` tsm authentication legacy-identity-mode disable ``` **참고:** 위의 명령 중 하나를 실행한 후 설명된 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. 이 페이지에는 `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled`가 `true`이거나 `tsm authentication legacy-identity-mode`를 사용하도록 설정한 경우에만 액세스할 수 있습니다. ID 서비스를 사용하도록 Tableau Server를 구성한 후에 사용자가 Tableau Server에 로그인하면 Tableau Server가 구성된 ID 저장소의 식별자를 사용하여 사용자 ID를 검색합니다. 이 식별자에서 UUID(범용 고유 식별자)가 반환되고 일치하는 기존 Tableau Server 사용자 ID를 찾는 데 사용됩니다. 그런 다음에는 사용자 세션이 생성되고 인증 워크플로우가 완료됩니다. ### 3단계: ID 풀을 사용하도록 설정 1. 다음 명령을 실행합니다. ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # ID 마이그레이션 정보 버전 2022.1부터 Tableau Server는 ID 서비스를 사용하여 ID 정보를 저장하고 관리합니다. ID 마이그레이션은 [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)을 구성하고 사용하기 위한 필수 요건입니다. > [!WARNING] > > **중요:** ID 풀 기능을 사용할 계획이 없다면 ID 마이그레이션을 실행하지 않는 것이 좋습니다. ID 풀을 사용할 계획 없이 ID 마이그레이션을 실행하면 Tableau Server 배포에 이점이 제공되지 않습니다. 기존 배포에서 Tableau Server를 버전 2022.1 이상으로 업그레이드하고 Tableau 2021.4 이하의 백업을 복원하는 경우 Tableau Server 업그레이드 후 ID 마이그레이션을 시작하여 새 ID 서비스를 채울 수 있습니다. ID 마이그레이션 중에 모든 Tableau Server 사용자의 보조 ID 서비스 테이블이 채워지며 ID 서비스를 통한 사용자 인증에 사용됩니다. 마이그레이션은 백그라운드에서 실행되므로 사용자의 Tableau Server 사용이 중단되거나 방해를 받지 않습니다. 관리자는 Tableau Server의 사용자 페이지에서 사용할 수 있는 전용 **ID 마이그레이션** 페이지에서 마이그레이션을 모니터링하고 관리할 수 있습니다. 예를 들어 마이그레이션 실행 시기를 변경하거나 잠재적 마이그레이션 충돌을 해결할 수 있습니다. 이 페이지는 마이그레이션 프로세스 중에 사용할 수 있습니다. ## 기존 배포의 단계 요약 신규 및 기존 배포의 경우 마이그레이션이 완료된 후 ID 구조 개선 사항을 활용하고 ID 풀을 구성하려면 ID 서비스를 사용하도록 Tableau Server를 구성해야 합니다. > [1단계: 시작하기 전에](#step1) > > [2단계: 새 스키마 및 로그인 기능을 사용하도록 설정](#step2) > > [3단계: ID 마이그레이션 시작](#step3) > > [4단계: ID 마이그레이션 완료](#step4) > > [5단계: ID 서비스를 사용하도록 Tableau Server 구성](#step5) > > [6단계: ID 풀을 사용하도록 설정](#step6) ### 주요 용어 - **ID 서비스** - Tableau Server 2022.1 이상에서 인증 및 프로비저닝을 포함한 사용자 ID 관리를 담당하는 서비스입니다. 이 서비스는 ID 서비스 테이블과 레거시 “system\_users” 테이블로 사용자 ID를 나타내는 ID 스키마를 사용합니다. - **ID 풀** - 프로비저닝 및 인증 정보를 사용하여 Tableau Server에 대한 사용자 액세스를 지원하는 ID 관리 도구입니다. ID 풀을 사용하면 Tableau Server의 사용자 ID 저장 및 관리를 위한 ID 서비스를 기반으로 중앙 집중식의 유연한 ID 관리 워크플로우를 구축할 수 있습니다. - **레거시 ID 저장소 모드** - Tableau Server 2021.4 이하에 사용되는 제한적인 ID 스키마입니다. 사용자 ID가 레거시 “system\_users” 테이블로만 표시됩니다. - **ID 마이그레이션** - 기존 Tableau Server 사용자 ID를 평가하고 업스트림 외부 ID 저장소에서 추가 ID 정보를 쿼리(해당하는 경우)하며 추가 ID 정보를 ID 서비스로 가져오는 감사 프로세스입니다. - **외부 ID 저장소** - Tableau Server의 외부 및 업스트림 ID 저장소 유형으로, 모든 ID 정보가 외부 디렉터리 서비스(AD(Active Directory) 또는 LDAP)에 의해 저장되고 관리됩니다. 구성된 경우 Tableau Server가 외부 디렉터리를 동기화하므로 ID 정보의 복사본이 Tableau Server에 유지됩니다. - **로컬 ID 저장소** - Tableau Server가 제공하는 ID 저장소 유형입니다. 구성된 경우 Tableau Server는 ID 정보를 위해 구성된 외부 디렉터리 없이 Tableau Server 리포지토리에서 ID 정보를 저장하고 관리합니다. - **시스템 사용자** - Tableau Server 사용자입니다. 사용자는 ID 서비스(“system\_users\_identities” 테이블 사용)와 레거시 ID 저장소 모드에서 로그인 레코드(“system\_users”)에 해당합니다. “system\_users” 레코드에는 다수의 사용자 ID가 연결될 수 있고 이를 사용하여 여러 사이트에 로그인할 수 있습니다. “system\_users” 레코드와 사이트 간의 링크는 “users” 테이블에 정의됩니다. ### ID 마이그레이션의 목적 Tableau Server 백업을 만들면 백업을 만든 Tableau Server 버전에 사용된 ID 스키마에 ID 정보가 저장됩니다. 백업에 사용된 ID 스키마의 ID 정보를 ID 서비스에 사용되는 ID 스키마에 채우려면 마이그레이션이 필요합니다. **Tableau Server 2021.4 이하의 ID 스키마** !["system\_users"와 "domains"라는 레이블이 지정된 두 개의 상자가 있는 응용 프로그램 서비스의 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_tables_legacy.png) 레거시 ID 저장소 모드에 사용되는 ID 스키마는 “system\_users”와 “domains”이라는 2개의 테이블로 구성됩니다. **Tableau Server 2022.1 이상의 ID 스키마** ![ID 서비스의 데이터베이스 테이블을 설명하는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_tables.png) ID 서비스에 사용되는 ID 스키마에는 레거시 “system\_users” 테이블과 추가 ID 정보를 캡처하는 보조 ID 서비스 테이블(\*\_identity\_stores 및 \*identities)이 포함됩니다. 추가 테이블은 외부 ID 저장소의 업스트림 변경에 의해 발생할 수 있는 문제를 줄이는 데 도움이 됩니다. ### ID 마이그레이션 중에 발생할 수 있는 문제 사용자 ID에 대한 정보를 마이그레이션하면 레거시 “system\_users” 테이블에 저장된 ID 정보가 ID 서비스 테이블로 보완됩니다. ID 정보를 보완하는 ID 서비스 테이블의 유형은 Tableau Server에 구성된 ID 저장소 유형, 즉 로컬, AD(Active Directory) 또는 LDAP(Lightweight Directory Access Protocol)에 따라 다릅니다. - **AD** ID 저장소 유형의 경우 ID 서비스 테이블에는 모호하지 않은 특성 또는 동일한 데이터베이스 레코드에 저장되지 않은 특성만 상속됩니다. 예를 들어 sAMAccountNAme 및 userPrincipalName(UPN)은 복잡한 일련의 규칙으로 인해 동일한 이름의 레거시 “systems\_users” 테이블 레코드에 저장될 수 있습니다. 대부분의 경우 마이그레이션 중에 사용자 ID를 올바르게 해석하고 성공적으로 마이그레이션할 수 있지만 마이그레이션에서 모호한 결과가 생성되는 경우 전용 ID 마이그레이션 페이지를 사용하여 모호성을 수동으로 확인하거나 충돌을 수동으로 해결해야 합니다. 자세한 내용은 [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오. - **LDAP** ID 저장소 유형의 경우 AD ID 저장소 유형과 마찬가지로 모호하지 않은 특성만 ID 서비스 테이블에 상속됩니다. 대부분의 경우 마이그레이션 중에 사용자 ID를 올바르게 해석하고 성공적으로 마이그레이션할 수 있지만 마이그레이션에서 모호한 결과가 생성되는 경우 전용 ID 마이그레이션 페이지를 사용하여 모호성을 수동으로 확인하거나 충돌을 수동으로 해결해야 합니다. 자세한 내용은 [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오. - **로컬** ID 저장소 유형의 경우 ID 서비스 테이블에는 사용자 및 도메인 필드가 직접 상속됩니다. 즉, 추가 정보 또는 수동 해결이 필요하지 않습니다. Tableau Server에 이 유형의 ID 저장소가 구성된 경우 사용자 ID 마이그레이션은 Tableau Server 백업 복원 프로세스 후에 진행됩니다. ## ID 마이그레이션 수행 ### 1단계: 시작하기 전에 시작하기 전에 아래에서 Tableau Server 버전 및 업그레이드 방법(해당하는 경우)을 확인하여 ID 마이그레이션의 이후 단계를 결정하십시오.
업그레이드 전업그레이드 후업그레이드 방법다음 단계
해당 없음Tableau Server 버전: 2022.1.0 이상, 2022.3.0 이상, 2023.1 이상신규 설치2단계로 이동합니다.
Tableau Server 버전: 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5Tableau Server 버전: 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상해당 없음

로그인에 새 스키마, 즉 wgserver.authentication.legacy_identity_mode.enabled -v false를 사용하도록 설정했습니까?

  • 설정하지 않았다면 2단계로 이동합니다.

  • 설정했다면 6단계로 이동합니다.

Tableau Server 버전: 2021.4.x 이하Tableau Server 버전: 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상해당 없음2단계로 이동합니다.
Tableau Server 버전: 2021.4.x 이하Tableau Server 버전: 2022.1.0~2022.1.7, 2022.3.0~2022.3.9 또는 2023.1.0~2023.1.51) Tableau Server를 새 컴퓨터에 설치한 다음 2) tsm maintenance(backup 및 restore) 명령을 사용하여 Tableau Server를 백업하고 복원하는 방법으로 Tableau Server의 블루/그린 업그레이드 또는 수동 업그레이드를 수행하는 경우 몇 가지 추가 단계를 수행해야 마이그레이션이 시작됩니다.ID 마이그레이션 관련 문제 해결로 이동합니다.
여기에 설명된 방법을 사용하여 Tableau Server의 “현재 위치” 단일 서버 또는 다중 노드 업그레이드를 수행하는 경우 추가 단계를 수행하지 않아도 마이그레이션이 시작됩니다. 버전 2022.1 이상으로의 Tableau Server 업그레이드가 완료된 후 마이그레이션이 시작됩니다.2단계로 이동합니다.
1) Tableau Server를 새 컴퓨터에 설치한 다음 2) tsm settings(export 및 import) 명령을 사용하여 구성 및 토폴로지 정보를 내보내고 가져오는 방법으로 Tableau Server를 수동 업그레이드하는 경우에도 마이그레이션을 시작하는 데 추가 단계를 수행할 필요가 없습니다. 이 경우 마이그레이션은 새 Tableau Server 컴퓨터에서 가져오기 프로세스가 완료된 후 시작됩니다.2단계로 이동합니다.
### 2단계: 새 스키마 및 로그인 기능을 사용하도록 설정 ID 마이그레이션을 시작하기 전에 tsm 명령 [features.NewIdentityMode](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#identity_mode_new)를 사용하여 새 ID 스키마를 사용하도록 설정해야 하며, ID 마이그레이션 프로세스가 진행되는 동안 Tableau Server에 계속 로그인을 허용하려면 [wgserver.authentication.legacy\_identity\_mode.enabled](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#legacy_identity_mode) 옵션 또는 [tsm authentication legacy-identity-mode ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#tsm_identity_mig_legacy) 명령을 사용하여 로그인을 허용해야 합니다. 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행합니다. ``` tsm configuration set -k features.NewIdentityMode -v true ``` 3. 실행 중인 Tableau Server 버전에 따라 다음 명령을 실행합니다. - Tableau Server 버전 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상의 경우: ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v true tsm pending-changes apply ``` - Tableau Server 버전 2022.1.0~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5의 경우: ``` tsm authentication legacy-identity-mode enable tsm pending-changes apply ``` **참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다. ### 3단계: ID 마이그레이션 시작 **참고:** Tableau Server 버전 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5로 업그레이드한 경우 ID 마이그레이션이 기본적으로 시작되며 아래 [4단계: ID 마이그레이션 완료](#step4)로 건너뛸 수 있습니다. ID 마이그레이션을 시작하려면 tsm 명령 [features.IdentityMigrationBackgroundJob](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#identity_migration)을 사용하여 ID 마이그레이션 기능을 사용하도록 설정해야 합니다. 1. 다음 명령을 실행합니다. ``` tsm configuration set -k features.IdentityMigrationBackgroundJob -v true ``` ID 마이그레이션이 시작되면 ID 마이그레이션 페이지로 연결되는 알림이 Tableau Server에 표시됩니다. ID 마이그레이션 페이지에서는 해결해야 하는 ID 마이그레이션 및 ID 충돌 상태를 모니터링할 수 있습니다. ### 4단계: ID 마이그레이션 완료 **참고**: 새로 설치하는 경우 이 단계를 건너뛰십시오. ID 마이그레이션을 완료하려면 모든 ID 충돌을 해결하거나 확인해야 합니다. 그렇게 해야 Tableau Server에서 ID 서비스를 사용하도록 설정할 수 있습니다. 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭하여 마이그레이션이 시작되었는지 확인합니다. Tableau Server의 사용자 페이지에 있는 전용 ID 마이그레이션 페이지를 사용하여 진행률을 모니터링하고 관리할 수 있습니다. 자세한 내용은 [ID 마이그레이션 관리](https://help.tableau.com/current/server/ko-kr/identity_migration_manage.htm)를 참조하십시오. 3. [ID 마이그레이션 충돌 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm)에 설명된 대로 모든 ID 충돌을 해결하거나 승인하여 아래의 이미지와 같이 모든 실패 탭에 '0'이 표시되도록 합니다. ![실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_failures_acknowledge.png) 4. 다음 작업 중 _하나_를 수행합니다. - ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 제목 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다. ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_overview_runnow.png) - 또는 다음 예약 시간에 마이그레이션 작업이 실행될 때까지 기다려도 됩니다. 5. 마이그레이션이 완료되면 ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다. ![100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_complete.png) ### 5단계: ID 서비스를 사용하도록 Tableau Server 구성 ID 마이그레이션이 완료되면 ID 서비스를 사용하도록 Tableau Server를 구성합니다. 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 실행 중인 Tableau Server 버전에 따라 다음 명령을 실행합니다. - Tableau Server 버전 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상의 경우: ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false ``` - Tableau Server 버전 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5의 경우: ``` tsm authentication legacy-identity-mode disable ``` **참고:** 위의 명령 중 하나를 실행한 후 설명된 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. 이 페이지에는 `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled`가 `true`이거나 `tsm authentication legacy-identity-mode`를 사용하도록 설정한 경우에만 액세스할 수 있습니다. ID 서비스를 사용하도록 Tableau Server를 구성한 후에 사용자가 Tableau Server에 로그인하면 Tableau Server가 구성된 ID 저장소의 식별자를 사용하여 사용자 ID를 검색합니다. 이 식별자에서 UUID(범용 고유 식별자)가 반환되고 일치하는 기존 Tableau Server 사용자 ID를 찾는 데 사용됩니다. 그런 다음에는 사용자 세션이 생성되고 인증 워크플로우가 완료됩니다. ### 6단계: ID 풀을 사용하도록 설정 ID 마이그레이션을 완료하고 ID 서비스를 사용하도록 설정한 후 [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_migration_manage.htm) 구성을 준비하기 위해 ID 풀 기능을 사용하도록 설정합니다. 1. 다음 명령을 실행합니다. ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # ID 마이그레이션 충돌 해결 ID 마이그레이션 중에 Tableau Server에서 ID 서비스 사용을 위해 마이그레이션할 수 없는 특정 사용자 ID가 발생할 수 있습니다. 사용자 ID를 마이그레이션할 수 없는 경우 관리자가 수동으로 해결해야 하는 ID 충돌이 됩니다. 사용자 ID를 올바르게 마이그레이션하려면 ID 마이그레이션을 완료하기 전에 전용 ID 마이그레이션 페이지를 사용하여 모든 ID 충돌을 해결해야 합니다. ## 1단계: ID 충돌 해결 충돌 유형에 따라 몇 가지 방법으로 ID 충돌을 해결할 수 있습니다. 충돌 유형과 관계없이 모든 사용자 ID를 해결해야 아래의 [2단계](#step2)로 진행하고 ID 마이그레이션을 완료할 수 있습니다. ID 충돌이 발생하면 ID 마이그레이션 중에 충돌이 유형으로 그룹화됩니다. 이 유형은 마이그레이션에서 사용자 ID를 자동으로 마이그레이션할 수 없는 이유를 좁히는 데 도움이 됩니다. ID 충돌이 발생하는 이유는 몇 가지 있습니다. 예를 들어 마이그레이션 중에 외부 ID 저장소에서 2개 이상의 사용자 ID와 일치하는 Tableau Server 사용자가 식별된 경우 ID 충돌이 발생할 수 있습니다. ID 충돌이 식별된 경우 다음 옵션 중 하나를 사용하여 해결할 수 있습니다. - **마이그레이션 다시 시도** - 이 옵션은 선택한 사용자 ID를 큐로 다시 이동하여 다시 마이그레이션합니다. 마이그레이션 작업이 다시 실행된 후에는 ID 충돌이 자체적으로 해결되거나 원래 ID 충돌이 다시 발생하거나 새 ID 충돌이 발생할 수 있습니다. - **승인** - 이 옵션은 선택한 사용자 ID를 승인됨 탭으로 이동합니다. 사용자 ID를 확인하면 1) 이러한 사용자의 사용자 ID와 일치하는 사용자 ID가 ID 저장소에 없으므로 마이그레이션되지 않을 것이고 2) 아래의 [3단계](#step3)에서 ID 서비스를 사용하도록 설정한 후 이러한 사용자는 Tableau Server에 로그인할 수 없게 됨을 이해하는 것입니다. - **재평가** - 충돌이 이미 확인된 경우 확인됨 탭에서 이 옵션은 선택한 사용자 ID를 충돌 상태로 되돌립니다. 이 옵션은 원래 충돌을 보거나 충돌을 해결하거나 ID 충돌을 다시 확인할 수 있는 기회를 제공합니다. ### 빠른 참조: ID 충돌
충돌 유형적용되는 구성충돌 이유동작
모든 실패전체이 탭은 일치 항목 없음, 모호함, 중복, 로컬에 없음 및 알 수 없음 탭에 분류된 모든 ID 충돌을 캡처합니다.마이그레이션 다시 시도 또는 승인
일치 항목 없음AD, LDAP사용자 ID와 일치하는 사용자가 외부 ID 저장소에 없습니다.마이그레이션 다시 시도 또는 승인
모호함AD, LDAP지정된 사용자 ID와 일치할 수 있는 항목이 외부 ID 저장소에 2개 이상 있습니다.마이그레이션 다시 시도, 확인 또는 제안된 사용자 ID 중 1개 선택
중복AD하나의 AD 계정을 사용하여 사용자 ID가 2개가 만들어졌습니다. 이는 ID 서비스에서 지원되지 않는 레거시 기능의 아티팩트입니다.마이그레이션 다시 시도 또는 승인
로컬에 없음로컬ID 저장소에 연결된 사용자 ID가 로컬에 없습니다. 이 충돌은 지원되지 않는 수동 변경이 수행된 경우 발생합니다.마이그레이션 다시 시도 또는 승인
알 수 없음전체이 충돌은 내부 Tableau Server 오류 또는 이 표에 나열되지 않은 이유로 인한 ID 충돌을 나타낼 수 있습니다.마이그레이션 다시 시도 또는 승인
승인됨전체이 탭은 마이그레이션되지 않을 모든 사용자 ID를 캡처합니다. 이러한 사용자는 Tableau Server가 ID 서비스를 사용하도록 구성된 후 Tableau Server에 로그인할 수 없게 됩니다.마이그레이션 다시 시도 또는 승인
충돌을 해결하려면 아래 단계를 수행합니다. 1. Tableau Server에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭합니다. 1. 모든 실패 탭 또는 충돌 관련 탭 중 하나에서 사용자 ID를 1개 이상 선택합니다. 2. 동작 드롭다운 메뉴에서 마이그레이션 다시 시도 또는 승인을 클릭합니다. “마이그레이션 다시 시도”를 선택하면 사용자 ID에서 다른 충돌 유형이 생성될 수 있습니다. 이 경우 아래 이미지와 같이 모든 실패 탭에 '0'이 표시될 때까지 필요에 따라 충돌을 해결합니다. ![실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_failures_acknowledge.png) **참고:** 승인된 사용자 ID는 앞으로 AD(Active Directory) 및 LDAP 그룹 동기화에서 무시됩니다. 이러한 사용자 ID와 연결된 사용자가 나중에 Tableau Server에 액세스해야 하는 경우 자세한 내용은 [ID 마이그레이션 문제 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_troubleshoot.htm#acknowledged)을 참조하십시오. ## 2단계: ID 마이그레이션 완료 ID 마이그레이션을 완료하려면 모든 ID 충돌을 해결하고 모든 마이그레이션 작업을 실행해야 합니다. 그래야 Tableau Server에서 ID 서비스를 사용하도록 설정할 수 있습니다. 1. 다음 작업 중 _하나_를 수행합니다. - ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다. ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_overview_runnow.png) - 또는 기다려서 다음 예약 시간에 마이그레이션을 실행할 수 있습니다. 2. ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다. ![100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_complete.png) ## 3단계: ID 서비스를 사용하도록 Tableau Server 구성 ID 마이그레이션이 완료된 후에는 ID 서비스를 사용하도록 Tableau Server를 구성합니다. 이 서비스는 사용자 프로비저닝 및 인증 프로세스를 위한 더 안전하고 변경 불가능한 ID 구조를 제공합니다. 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 실행 중인 Tableau Server 버전에 따라 다음 명령을 실행합니다. - Tableau Server 버전 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상의 경우: ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false ``` - Tableau Server 버전 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5의 경우: ``` tsm authentication legacy-identity-mode disable ``` **참고:** 위의 명령 중 하나를 실행한 후 설명된 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. 이 페이지에는 `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled`가 `true`이거나 `tsm authentication legacy-identity-mode`를 사용하도록 설정한 경우에만 액세스할 수 있습니다. ID 서비스를 사용하도록 Tableau Server를 구성한 후에 사용자가 Tableau Server에 로그인하면 Tableau Server가 구성된 ID 저장소의 식별자를 사용하여 사용자 ID를 검색합니다. 이 식별자에서 UUID(범용 고유 식별자)가 반환되고 일치하는 기존 Tableau Server 사용자 ID를 찾는 데 사용됩니다. 그런 다음에는 사용자 세션이 생성되고 인증 워크플로우가 완료됩니다. ## 4단계: ID 풀이 사용하도록 설정되어 있는지 확인 1. 다음 명령을 실행합니다. ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # ID 저장소 Tableau Server에는 사용자 및 그룹 정보를 관리하기 위한 ID 저장소가 필요합니다. ID 저장소에는 로컬 저장소와 외부 저장소의 두 가지 종류가 있습니다. Tableau Server를 설치할 때 로컬 ID 저장소나 외부 ID 저장소 중 하나를 구성해야 합니다. ID 저장소 구성 옵션에 대한 자세한 내용은 [identityStore 엔터티](https://help.tableau.com/current/server/ko-kr/entity_identity_store.htm) 및 [외부 ID 저장소 구성 참조](https://help.tableau.com/current/server/ko-kr/ldap_config.htm)를 참조하십시오. 단일 ID 저장소 모델의 유연성을 개선하는 방법에 대한 자세한 내용은 [ID 풀을 사용하여 사용자 프로비저닝 및 인증](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)을 참조하십시오. ## 로컬 ID 저장소 Tableau Server를 로컬 ID 저장소로 구성하면, 모든 사용자 및 그룹 정보가 Tableau Server 리포지토리에 저장되고 관리됩니다. 로컬 ID 저장소 시나리오에는 사용자 및 그룹에 대한 외부 출처가 없습니다. ## 외부 ID 저장소 Tableau Server를 외부 저장소로 구성할 경우 모든 사용자 및 그룹 정보가 외부 디렉터리 서비스에 의해 저장되고 관리됩니다. 사용자 및 그룹의 로컬 복사본이 Tableau Server 리포지토리에 존재해야 하므로 Tableau Server와 외부 ID 저장소가 동기화되어야 하지만 외부 ID 저장소는 모든 사용자 및 그룹 데이터에 대한 신뢰할 수 있는 원본입니다. Tableau Server ID 저장소가 외부 LDAP 디렉터리와 통신하도록 구성된 경우 Tableau Server에 추가하는 모든 사용자(초기 admin 계정 포함)가 디렉터리에 계정이 있어야 합니다. Tableau Server가 외부 LDAP 디렉터리를 사용하도록 구성된 경우 먼저 외부 디렉터리에서 Tableau Server 리포지토리로 사용자 ID를 시스템 사용자로 가져와야 합니다. 사용자가 Tableau Server에 로그인하면 사용자 인증을 담당하는 외부 디렉터리로 자격 증명이 전달됩니다. Tableau Server는 이 인증을 수행하지 않습니다. 그러나 ID 저장소에 저장된 Tableau 사용자 이름은 Tableau Server에 대한 권한 및 사용 권한과 연결됩니다. 그러므로 인증이 확인된 후에는 Tableau Server에서 Tableau 리소스에 대한 사용자 액세스(권한 부여)를 관리합니다. Active Directory가 외부 사용자 저장소의 예입니다. Tableau Server는 Active Directory와 함께 사용하도록 최적화되어 있습니다. 예를 들어, [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm#tsm-ui-steps)를 사용하여 Active Directory 도메인에 가입된 컴퓨터에 Tableau Server를 설치하는 경우 설치 프로그램이 대부분의 Active Directory 설정을 검색하고 구성합니다. 반면, TSM CLI를 사용하여 Tableau Server를 설치하는 경우 사용자가 모든 Active Directory 설정을 지정해야 합니다. 이 경우 [LDAP - Active Directory](https://help.tableau.com/current/server/ko-kr/entity_identity_store.htm#LDAP) 템플릿을 사용하여 ID 저장소를 구성해야 합니다. Active Directory에 설치하는 경우 Active Directory 도메인에 가입된 컴퓨터에 Tableau Server를 설치해야 합니다. 또한 배포하기 전에 [외부 ID 저장소가 있는 배포의 사용자 관리](https://help.tableau.com/current/server/ko-kr/users_manage_ad.htm)를 검토하는 것이 좋습니다. 다른 모든 외부 저장소의 경우 Tableau Server는 ID 저장소와 통신하는 범용적인 방법으로 LDAP를 지원합니다. 예를 들어 유연한 스키마를 사용하는 OpenLDAP는 다양한 LDAP 서버 구현 중 하나입니다. Tableau Server는 OpenLDAP 서버를 쿼리하도록 구성될 수 있습니다. 이렇게 하려면 디렉터리 관리자가 스키마에 대한 정보를 제공해야 합니다. 설치 중에 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm#tsm-cli-steps)를 사용하여 다른 LDAP 디렉터리에 대한 연결을 구성해야 합니다. ## LDAP 바인드 LDAP를 사용하여 사용자 저장소를 쿼리하려는 클라이언트는 세션을 인증하고 설정해야 합니다. 이 과정은 바인딩을 통해 수행됩니다. 바인딩 방법은 다양합니다. 단순 바인딩은 사용자 이름과 암호를 사용하여 인증합니다. 단순 바인딩을 사용하여 Tableau Server에 연결하는 조직의 경우 SSL로 암호화된 연결을 구성하는 것이 좋습니다. 그렇지 않으면 자격 증명이 일반 텍스트 형식으로 전송됩니다. Tableau Server가 지원하는 또 다른 바인딩 형식은 GSSAPI 바인딩입니다. GSSAPI에서는 Kerberos를 사용하여 인증합니다. Tableau Server 사용 사례에서 Tableau Server는 클라이언트이고 외부 사용자 저장소는 LDAP 서버입니다. ### LDAP 및 GSSAPI(Kerberos) 바인딩 keytab 파일을 사용하여 LDAP 서버에 인증하는 GSSAPI를 사용하여 LDAP 디렉터리에 바인딩하는 것이 좋습니다. Tableau Server 서비스용으로 특별하게 만들어진 keytab 파일이 필요합니다. 또한 SSL/TLS를 사용하여 LDAP 서버와의 채널을 암호화하는 것이 좋습니다. 자세한 내용은 [LDAP 외부 ID 저장소에 암호화된 채널 구성](https://help.tableau.com/current/server/ko-kr/config_encrypt_ldap.htm)을 참조하십시오. Active Directory 환경에 설치하고 Tableau Server를 설치하려는 컴퓨터가 이미 도메인에 가입된 경우 컴퓨터에 이미 구성 파일과 keytab 파일이 있을 수 있습니다. 이 경우 Kerberos 파일은 운영 체제 기능 및 인증을 위한 것입니다. 엄밀히 말하자면, 이러한 파일을 GSSAPI 바인딩에 사용할 수 있지만 사용하지 않는 것이 좋습니다. 대신 Active Directory 관리자에게 연락하여 Tableau Server 서비스용 keytab 파일을 요청하십시오. 자세한 내용은 [Keytab 요구 사항 이해](https://help.tableau.com/current/server/ko-kr/kerberos_keytab.htm)를 참조하십시오. 운영 체제에 도메인 인증을 위해 올바르게 구성된 keytab이 있다고 가정할 경우 GSSAPI 바인딩용 Kerberos keyfile만 있으면 Tableau Server의 기본 설치를 수행할 수 있습니다. 사용자 인증에 Kerberos를 사용할 계획인 경우 설치가 완료된 후 [사용자 인증을 위한 Kerberos 구성](https://help.tableau.com/current/server/ko-kr/config_kerberos.htm) 및 [데이터 원본에 대한 Kerberos 위임](https://help.tableau.com/current/server/ko-kr/kerberos_delegation.htm) 작업을 수행하십시오. ### LDAP over SSL 기본적으로 임의의 LDAP 서버에 대한 단순 바인딩을 사용하는 LDAP는 암호화되지 않습니다. LDAP 서버와의 바인딩 세션을 설정하는 데 사용되는 사용자 자격 증명은 Tableau Server와 LDAP 서버 간에서 일반 텍스트로 전달됩니다. Tableau Server와 LDAP 서버 간의 채널을 암호화하는 것이 가장 좋습니다. 조직에서 Active Directory가 아닌 LDAP 디렉터리를 사용하는 경우 [LDAP 외부 ID 저장소에 암호화된 채널 구성](https://help.tableau.com/current/server/ko-kr/config_encrypt_ldap.htm)을 참조하십시오. ## 클라이언트 인증 Tableau Server의 기본 사용자 인증은 로컬 및 외부 사용자 저장소 모두에서 사용자 이름 및 암호 로그인 방식입니다. 로컬 사용 사례에서 사용자 암호는 해시 처리된 암호로 리포지토리에 저장됩니다. 외부 사용 사례에서는 Tableau Server가 자격 증명을 외부 사용자 저장소에 전달하고 자격 증명의 유효성 여부에 대한 응답을 기다립니다. 외부 사용자 저장소는 Kerberos 또는 SSPI(Active Directory만 해당) 같은 다른 종류의 인증도 처리할 수 있지만 개념은 여전히 동일합니다. Tableau Server는 자격 증명이나 사용자를 외부 저장소에 위임하고 응답을 기다립니다. 사용자 이름-암호 로그인을 사용하지 않도록 Tableau Server를 구성할 수 있습니다. 이러한 시나리오에서는 신뢰할 수 있는 인증, OpenID 또는 SAML과 같은 다른 인증 방법을 사용할 수 있습니다. [인증](https://help.tableau.com/current/server/ko-kr/security_auth.htm)을 참조하십시오. 일부 경우 Tableau Server의 사용자 이름 + DN 형식으로 바인딩 작업을 허용하도록 LDAP 외부 디렉터리를 업데이트해야 합니다. [로그인 시 사용자 바인딩 동작](https://help.tableau.com/current/server/ko-kr/users_manage_ad.htm#User)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # ID 저장소 변경 인프라 또는 비즈니스 변경에 따라 Tableau Server의 ID 저장소를 변경해야 할 수 있습니다. ID 저장소에는 로컬 저장소와 외부 저장소의 두 가지 종류가 있습니다. Tableau Server를 설치할 때 로컬 ID 저장소나 외부 ID 저장소 중 하나를 구성합니다. Tableau Server를 로컬 ID 저장소로 구성하면, 모든 사용자 및 그룹 정보가 Tableau Server 리포지토리에 저장되고 관리됩니다. 로컬 ID 저장소 시나리오에는 사용자 및 그룹에 대한 외부 출처가 없습니다. Tableau Server를 외부 저장소로 구성할 경우 모든 사용자 및 그룹 정보가 외부 디렉터리 서비스에 의해 저장되고 관리됩니다. 사용자 및 그룹의 로컬 복사본이 Tableau Server 리포지토리에 존재해야 하므로 Tableau Server와 외부 ID 저장소가 동기화되어야 하지만 외부 ID 저장소는 모든 사용자 및 그룹 데이터에 대한 신뢰할 수 있는 원본입니다. 외부 ID 저장소의 예는 OpenLDAP 및 Active Directory입니다. Tableau ID 저장소에 대한 자세한 내용은 [ID 저장소](https://help.tableau.com/current/server/ko-kr/plan_identity_store.htm)를 참조하십시오. 로컬 저장소에서 외부 저장소로 변경하거나 외부 저장소에서 로컬 저장소로 변경할 수 있습니다. 두 경우 모두 ID 저장소 유형을 변경하려면 다음 단계를 완료해야 합니다. 1. Tableau Server를 제거했다가 다시 설치합니다. 전체 제거와 새로 설치를 위한 절차는 이 항목의 끝 부분에 있습니다. 2. 콘텐츠 및 사용 권한을 복원합니다. 이러한 단계에서 "복원"이라는 용어는 사용자가 만드는 백업을 `TSM maintenance restore` 명령을 사용하여 복원하는 것을 나타내지 않습니다. 대상 Tableau Server와 다른 ID 저장소를 사용하는 Tableau Server 인스턴스에서 만들어진 백업(`.tsbak`)을 복원할 수 없습니다. 백업은 원래 Tableau Server 구성으로 돌아가야 하는 경우 안전을 위한 최상의 방법입니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/Road-sign-alert.png) ## 경고 Tableau Server의 설치 유형을 변경하는 프로세스는 복잡해서 많은 시간이 필요할 수 있습니다. 데이터 손실이나 콘텐츠 또는 사용자의 분리를 방지하려면 이 프로세스를 신중히 계획해야 합니다. 모든 경우에 통합 문서 및 데이터 원본에 적용된 사용자 필터는 변경 후에 수동으로 업데이트해야 합니다. 가장 중요한 작업은 Tableau Server를 다시 설치한 후 콘텐츠 및 사용 권한을 새 ID 저장소로 이동할 방법을 결정하는 것입니다. ## 콘텐츠 및 사용 권한 복원 방법 다음 목록에 Tableau Server를 다시 설치한 후 콘텐츠 및 사용 권한을 복원할 때 사용할 수 있는 두 가지 방법이 설명되어 있습니다. 환경의 요구 사항에 가장 적합한 방법을 선택하십시오. - **방법 1: 사이트 내보내기 및 가져오기 사용** - 이 방법에서는 기존 배포의 각 사이트를 내보내는 작업부터 시작합니다. 그런 다음 새 서버를 설치하고 새 ID 저장소 유형을 사용하도록 구성합니다. 다음으로 새 서버의 기본 사이트에 새 사용자를 만듭니다. 마지막으로 모든 원래 사이트를 가져옵니다. 가져오기 단계에서 원래 ID를 기본 사이트에 만든 새 사용자에게 매핑할 수 있습니다. **참고:** Tableau Server 인스턴스 간에 사이트를 마이그레이션하는 경우 대상 사이트는 원본 사이트의 Tableau Server 버전보다 높거나 같은 Tableau Server 버전에 있어야 합니다. 원본 사이트와 대상 사이트 모두 지원되는 Tableau Server 버전에 있어야 합니다. 이 방법에서는 각 사이트의 모든 콘텐츠 및 사용 권한을 내보내므로 ID 저장소 변경이 완료된 후 콘텐츠 및 사용 권한의 정확도가 높은 복제본이 필요한 조직에 적합합니다. 일부 조직에서는 인증 변경으로 인해 ID 저장소 변경이 필요합니다. 이러한 경우 종종 새 모델에서 다른 사용자 이름 구문이 필요합니다. 이 방법에는 원래 사용자 이름을 새 이름에 매핑하는 프로세스가 포함되므로 이러한 시나리오에 적합한 유연성을 제공합니다. - **방법 2: 새로 설치, 사용자가 콘텐츠를 다시 게시** - 이 방법에서는 새 버전의 Tableau Server를 설치하고 설치 중에 새 ID 저장소 유형을 선택합니다. 사이트도 새로 만듭니다. 그런 다음 사용자를 만들고 액세스 권한을 부여한 후 통합 문서 및 데이터 원본을 다시 게시합니다. 다른 방법과 달리 이 방법에서는 기존 Tableau Server 인프라를 재사용하지 않습니다. 이 방법은 데이터를 능숙하게 사용하는 자율적 사용자가 있는 소규모 배포에 가장 적합합니다. 콘텐츠가 활발하게 이동되지 않으므로 관리 측면에서는 이 방법이 가장 간단합니다. 그러나 콘텐츠의 재게시를 전적으로 사용자에게 맡기게 되므로 대규모 조직 또는 중앙 집중식 콘텐츠 감독이 요구되는 조직에서는 성공적이지 못할 수 있습니다. ## 사용자 필터 사용자 필터는 도메인에 한정됩니다. 따라서 Tableau Server의 도메인이 변경되거나 인증 유형이 변경되면 필터가 더 이상 예상대로 작동하지 않습니다. 사용자 필터는 Tableau Server에서 생성되지만 사용자가 설정한 후에는 필터가 통합 문서 및 데이터 원본에 저장됩니다. 어떠한 ID 저장소 변경 방법도 통합 문서 또는 데이터 원본의 콘텐츠를 수정하지 않습니다. ID 저장소를 변경할 계획이라면 Tableau Desktop에서 모든 통합 문서 및 데이터 원본의 사용자 필터를 수정하는 최종 작업을 포함시켜야 합니다. ## 사용자 이름 및 Tableau ID 저장소 방법 1을 사용하는 경우 Tableau Server가 Tableau ID 저장소에 사용자 이름을 저장하는 방식을 이해하는 것이 좋습니다. Tableau의 모든 사용자 ID는 리포지토리에 저장됩니다. 이 리포지토리는 Tableau Server의 다양한 서비스를 통해 콘텐츠 사용 권한 및 사이트 멤버십을 조정합니다. 일반적으로 Active Directory에 대해 구성된 ID 저장소는 사용자 이름을 `domain\username` 형식으로 저장합니다. 일부 조직에서는 UPN(`jsmith@domain.lan`)을 사용합니다. 이와 달리 로컬 ID 저장소로 Tableau Server를 구성한 조직에서는 일반적으로 표준적인 잘린 사용자 이름(예: `jsmith`)을 만듭니다. 모든 경우 이러한 사용자 이름은 리터럴 문자열이며 Tableau ID 저장소에서 고유해야 합니다. ID 저장소 유형을 변경하는 경우 대상 인증, SSO 또는 사용자 프로비저닝 솔루션에 따라 특정 사용자 이름 형식을 사용해야 할 수 있습니다. 그러므로 모든 사용 권한, 콘텐츠 및 사용자를 유지하려면 ID 저장소 유형을 변경한 후 다음 중 하나에 해당해야 합니다. - 새 사용자 이름이 원래 사용자 이름과 일치합니다. 또는 - 원래 사용자 이름이 새 형식에 맞게 업데이트되었습니다. 인증 변경으로 인해 ID 저장소 변경이 필요한 경우 대상 인증 체계에서 원래 사용자 이름과 다른 사용자 이름 구문이 사용될 수 있습니다. 방법 1에는 원래 사용자 이름을 새 사용자 이름에 매핑하는 프로세스가 포함됩니다. 원래 사용자 이름 형식이 새 인증 유형에서도 작동할 가능성이 있습니다. 예를 들어 로컬 ID 저장소 배포에서 UPN 이름을 사용한 경우 동일한 사용자 이름을 Active Directory 배포에 사용할 수 있습니다. 또한 사용자가 계속해서 `domain\username` 형식을 사용하여 Tableau Server에 로그인하는 경우 이 형식을 로컬 ID 저장소에 사용할 수 있습니다. 로컬 ID 저장소에서 외부 Active Directory 저장소로 변경하는 경우 [외부 ID 저장소가 있는 배포의 사용자 관리](https://help.tableau.com/current/server/ko-kr/users_manage_ad.htm) 항목을 검토하여 프로세스를 계획하십시오. ## 방법 1: 사이트 내보내기 및 가져오기 사용 내보내기와 가져오기 작업에 동일한 버전의 Tableau Server를 사용해야 합니다. 1. 서버의 모든 사이트를 내보냅니다. [사이트 내보내기 또는 가져오기](https://help.tableau.com/current/server/ko-kr/sites_exportimport.htm)를 참조하십시오. 2. [백업, 제거 및 다시 설치](#Back). 3. Tableau Server에 새 사용자를 만듭니다. 원래 서버의 각 사용자에 해당하는 새 사용자를 만들어야 합니다. 4. 1단계에서 내보낸 사이트를 가져옵니다. [사이트 내보내기 또는 가져오기](https://help.tableau.com/current/server/ko-kr/sites_exportimport.htm)를 참조하십시오. 가져오기 중에 새 사용자를 원래 사용자에 매핑하라는 메시지가 표시됩니다. ## 방법 2: 새로 설치 - 사용자가 콘텐츠 다시 게시 ID 저장소 변경 과정에서 콘텐츠를 이동할 계획이 없는 경우에도 서버를 백업하는 것이 좋습니다. 1. [백업, 제거 및 다시 설치](#Back). 2. 사용자, 사이트 및 그룹을 만듭니다. 3. 사용자에게 새 Tableau Server를 알리고, 자격 증명을 제공하고, 사용자가 콘텐츠를 다시 게시할 수 있도록 허용합니다. ## 백업, 제거 및 다시 설치 두 방법 모두에 다음 단계가 포함됩니다.  1. Tableau Server를 백업합니다. 2. Tableau Server를 제거합니다. 3. 새 ID 저장소 유형으로 Tableau Server를 다시 설치합니다. ### 1단계: Tableau Server 백업 계속하기 전에 서버를 백업하는 것이 좋습니다. [TSM CLI(명령줄 인터페이스)를 사용하여 백업 만들기](https://help.tableau.com/current/server/ko-kr/db_backup.htm#tsm-cli-steps)절차를 따릅니다. `backup` 명령을 `–d` 옵션과 함께 실행합니다. `–d` 옵션은 날짜 스탬프를 추가합니다. 완료되면 Tableau Server 설치에 사용되지 않은 안전한 위치에 백업 파일(`.tsbak`)을 복사합니다. ### 2단계: Tableau Server 제거 컴퓨터에서 Tableau Server를 완전히 제거합니다. [컴퓨터에서 Tableau Server 제거](https://help.tableau.com/current/server/ko-kr/remove_tableau.htm)를 참조하십시오. ### 3단계: 새 인증 유형으로 Tableau Server 다시 설치 1. Tableau 고객 포털로 이동하여 Tableau 사용자 이름과 암호로 로그인한 다음 Tableau Server를 다운로드합니다. 2. Tableau Server를 설치합니다. 자세한 내용은 [Tableau Server 설치 및 구성](https://help.tableau.com/current/server/ko-kr/install_config_top.htm)을 참조하십시오. 설치 중에 새 ID 저장소 유형을 선택합니다. [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # ID 풀 설정 및 관리 ID 풀을 만들고 관리하려면 Tableau REST OpenAPI를 사용하여 프로그래밍 방식으로 [ID 풀 메서드](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods)를 호출해야 합니다. ID 풀에 사용자를 추가하거나 관리하려면 직접 또는 Tableau REST API를 통해 Tableau Server UI(사용자 인터페이스)를 사용할 수 있습니다. ID 풀 설정 프로세스는 다음 단계로 요약됩니다. 1. **Tableau Server를 구성하고 세션을 설정**합니다. 2. 새 로컬 ID 저장소 인스턴스를 설정하여 **사용자를 프로비저닝**합니다. **참고:** Tableau Server 설치 중에 TSM에서 구성한 외부 ID 저장소 또는 기존 로컬 ID 저장소를 사용하려면 이 단계를 건너뛸 수 있습니다. 3. OIDC(OpenID Connect)를 사용하여 Tableau Server 사용자 인증을 위한 **인증을 설정**합니다. 4. 구성한 ID 저장소와 OIDC 인증을 사용하는 **ID 풀을 만듭니다**. 5. Tableau Server UI 또는 REST API를 통해 **ID 풀에 사용자를 추가**하여 사용자가 Tableau Server에 로그인할 수 있도록 합니다. 설정이 완료되면 ID 풀에 대한 [테스트](#test), [관리](#manage) 및 [문제 해결](#troubleshoot)을 수행할 수 있습니다. **참고:** Salesforce Developer의 Postman 작업 영역에서 Postman 모음인 [ID 풀](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/folder/12721794-b229dea8-ee9c-4fbb-80d1-7e9153c207ee)을 사용하여 이 항목에 설명된 방법에 대해 알아보고 개발하고 테스트할 수 있습니다. ## 필수 요건 ID 풀을 시작하기 전에 다음 요구 사항을 충족해야 합니다. - OIDC IdP(ID 공급자)(예: Okta) 통합이 이미 구성되어 있음 - Tableau Server 2023.1 이상을 실행하고 있음 - [ID 마이그레이션](https://help.tableau.com/current/server/ko-kr/identity_migration.htm)을 수행한 경우 - 이 작업은 새 Tableau Server 배포와 Tableau Server 업그레이드 모두에 필요합니다. ## 시작하기 ### 1단계: Tableau Server 구성 및 세션 설정 ID 풀 설정과 관련된 변경을 지원하려면 일회성으로 TSM을 구성하고 세션 및 호스트 변수를 선언해야 합니다. **Tableau Server 구성 방법** 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행합니다. 1. `tsm configuration set -k gateway.external_url -v http://` 2. `tsm pending-changes apply` 예를 들어 다음 명령을 실행하여 Tableau Server(http://myco)를 구성할 수 있습니다. `tsm configuration set -k gateway.external_url -v http://myco` `tsm pending-changes apply` 자세한 내용은 [gateway.external\_url](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#gateway_external_url)을 참조하십시오. **참고:** 버전 2025.3부터 이를 사용하도록 설정하는 경우 지정된 URL은 SLO(싱글 로그아웃)에 사용되는 끝점입니다. 3. (선택 사항) 다음 명령을 실행하여 초기 풀(TSM 구성됨)에 대한 설명을 추가합니다. 1. `tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v ""` 2. `tsm pending-changes apply` 예를 들어 다음 명령을 실행하여 "Sign-in for MyCo employees(MyCo 직원용 로그인)"라는 설명을 추가할 수 있습니다. `tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v "Sign-in for MyCo employees"` `tsm pending-changes apply` 자세한 내용은 [wgserver.authentication.identity\_pools.default\_pool\_description](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#initial_pool_description)을 참조하십시오. 4. (선택 사항) 다음 명령을 실행하여 SLO(싱글 로그아웃) 및 초기 풀(TSM 구성됨)을 사용하도록 설정합니다. `tsm authentication openid enable-slo` `tsm authentication openid get-slo-redirect-url` 5. Tableau Server에 사이트 관리자로 로그인하고 다음을 수행합니다. 1. 브라우저의 개발자 도구로 이동하고 응용 프로그램 쿠키로 이동합니다. 2. workgroup\_session\_id 값을 기록합니다. 예를 들어 Chrome에서 작업 중인 경우 Tableau Server 홈 페이지의 아무 위치를 오른쪽 클릭하고 검사를 오른쪽 클릭하여 선택합니다. 상단 탐색 패널에서 Application을 클릭하고 왼쪽 탐색 패널에서 Cookies를 클릭합니다. Cookies 아래에서 Tableau Server 이름(예: like http://myco.com)을 클릭하고 가운데 패널의 workgroup\_session\_id 값을 기록합니다. 6. Tableau REST OpenAPI를 사용하여 ID 풀을 요청하는 데 사용 중인 스크립트 또는 API 개발자 도구에서 다음을 수행합니다. 1. workgroup\_session\_id 값을 전역 변수로 추가합니다. 2. 또한 포트 80, 호스트(사용하는 Tableau Server URL) 및 프로토콜(HTTP 또는 HTTPS)을 전역 변수에 추가합니다. 예를 들어 다음 표는 Tableau Server(http://myco)에 필요한 전역 변수를 보여줍니다. | 전역 변수 | 값 | | --- | --- | | 작업 그룹 세션 ID | XXX\_2abcDefDwGVzPu1hCQ|FJk5Z6OroPCLEDTKkwDxaeA0YzrIY04f|ca608d3c-fc01-4e40-ae5e-9b2131e4e7xx | | 포트 | 80 | | 호스트 | http://myco | | 프로토콜 | HTTP | ### 2단계: ID 저장소 설정 Tableau Server 사용자를 가져오거나 프로비저닝하려면 ID 저장소를 구성해야 합니다. ID 풀을 설정할 때 신규 또는 기존 [로컬 ID 저장소](https://help.tableau.com/current/server-linux/ko-kr/plan_identity_store.htm#local-identity-store)를 사용할 수 있습니다. 또는 Tableau Server 설치 중에 외부 ID 저장소가 구성된 경우 [외부 ID 저장소](https://help.tableau.com/current/server-linux/ko-kr/plan_identity_store.htm#external-identity-store)로 AD(Active Directory) 또는 LDAP(Lightweight Directory Access Protocol) 중 하나를 사용할 수 있습니다. **참고:** Tableau Server 설치 중에 TSM에서 구성한 AD 또는 LDAP 인스턴스가 아닌 새 AD 또는 LDAP 인스턴스(일명, 초기 풀(TSM 구성됨))는 ID 풀에 구성할 수 없습니다. **ID 저장소 설정 방법** 새 로컬 ID 저장소를 설정하려면 아래 절차를 따르십시오. 기존 로컬 ID 저장소 또는 Tableau Server 설치 중에 구성한 ID 저장소를 사용하려는 경우 [3단계: 인증 설정](#step3)으로 건너뜁니다. 1. Tableau REST API에 [Sign In](https://help.tableau.com/current/api/rest_api/ko-kr/REST/rest_api_ref_authentication.htm#sign_in) 요청을 전송하여 자격 증명 토큰을 생성합니다. #### 예 ##### URI `POST https://myco/api/3.19/auth/signin` 2. 자격 증명 토큰이 생성되면 자격 증명 토큰을 모든 후속 API 요청의 헤더에 추가합니다. 3. Tableau REST API OpenAPI를 통해 [ID 저장소 구성](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_RegisterIdentityStoreTAG) 끝점을 호출하여 ID 저장소를 구성합니다. 4. 요청에서 다음을 지정합니다. 1. Type. 유형 값은 로컬 ID 저장소 유형의 경우 항상 0입니다. Tableau Server 설치 중에 TSM에서 구성한 ID 저장소 또는 기존 로컬 ID 저장소를 사용하려는 경우 새 로컬 ID 저장소 인스턴스를 설정할 필요가 없습니다. 대신 아래의 3단계: 인증 설정으로 건너뜁니다. 2. Name. 이름은 고유해야 합니다. 3. Display name. 이는 선택 사항입니다. #### 예 ##### URI https://myco/api/-/authn-service/identity-stores/ ##### 요청 본문(JSON) ``` { "type": "0", "name": "Local identity store #1", "display_name": "Local identity store #1" } ``` ##### 응답 본문 _없음_ ### 3단계: 인증 설정 OIDC(OpenID Connect) 인증 방법을 구성하여 사용자를 인증할 수 있습니다. **참고**: OIDC는 현재 ID 풀에 사용하는 ID 저장소 유형과 관계없이 ID 풀에 구성 가능한 유일한 인증 방법입니다. **정방향 프록시 구성(선택 사항)** 조직에서 정방향 프록시 서버를 사용하고 Tableau Server가 Windows에 설치되어 있는 경우 프록시를 통해 IdP로 OIDC 요청을 라우팅하도록 Tableau Server를 구성해야 할 수 있습니다. 프록시를 구성하려면 인증을 설정한 후 ['서버에서 OpenID 연결이 올바로 구성되지 않았습니다.' 로그인 오류](#proxy)에 설명된 단계를 따릅니다. **인증 설정 방법** 1. ID 저장소를 설정한 후 Tableau REST API OpenAPI를 사용하여 [인증 구성 만들기](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_RegisterAuthConfiguration) 끝점을 호출합니다. 2. 요청에서 다음을 지정합니다. 1. 인증 유형. 인증 유형 값은 "`OIDC`"입니다. 2. iFrame. iFrame 기본값은 "`false`"입니다. 3. OIDC 클라이언트 ID, 클라이언트 암호, 구성 URL, ID 클레임, 클라이언트 인증 및 사용자 이름 클레임이 필요합니다. - 클라이언트 ID, 클라이언트 암호는 OIDC IdP에서 제공합니다. - 구성 URL도 IdP에서 제공합니다. URL은 일반적으로 다음 형식을 사용할 수 있습니다. `https:///.well-known/openid-configuration`. - ID 클레임의 기본값은 "`sub`"입니다. 자세한 내용은 [sub 클레임 변경](https://help.tableau.com/current/server/ko-kr/openid_auth_requirements.htm#sub)을 참조하십시오. - 클라이언트 인증의 기본값은 "`CLIENT_SECRET_BASIC`"입니다. - 사용자 이름 클레임의 기본값은 "`email`"입니다. 자세한 내용은 [기본값: 이메일 클레임을 사용하여 사용자 매핑](https://help.tableau.com/current/server/ko-kr/openid_auth_requirements.htm#email)을 참조하십시오. **사용자 이름 클레임 정보** Tableau에서 사용자 이름 클레임은 ID 일치 목적으로 사용됩니다. Tableau Server에 사용자를 추가할 때 식별자를 제공하면 사용자 이름 클레임에 제공된 값과 일치하는 값을 찾는 데 식별자가 사용됩니다. 식별자를 제공하지 않으면 Tableau Server에 설정된 사용자 이름으로 기본 설정됩니다. **참고:** - AD를 ID 저장소로 사용하는 ID 풀에 이 인증 구성을 사용하려는 경우 할당된 사용자의 사용자 이름 클레임에 AD sAMAccountName 값이 있어야 합니다. - LDAP를 ID 저장소로 사용하는 ID 풀에 이 인증 구성을 사용하려는 경우 할당된 사용자의 사용자 이름 클레임에 LDAP username 값이 있어야 합니다. #### 예 ##### URI https://myco/api/-/authn-service/auth-configurations/ ##### 요청 본문(JSON) ``` { "auth_type": "OIDC", "iframed_idp_enabled": true, "oidc": { "client_id": "Xxx1hotzhjv4tyCd08", "client_secret": "XxXd2NCxY-BiLu_zcIwr2lJZLziT_7sw9Fi6XX3", "config_url": "https://admin.okta.com/.well-known/openid-configuration", "custom_scope": "", "id_claim": "sub", "username_claim": "email", "client_authentication": "CLIENT_SECRET_BASIC", "essential_acr_values": "", "voluntary_acr_values": "", "prompt": "login,consent", "connection_timeout": 100, "read_timeout": 100, "ignore_domain": false, "ignore_jwk": false } } ``` ##### 응답 본문 _없음_ ### 4단계: ID 풀 만들기 Tableau Server 설치 중에 구성한 ID 저장소에 따라 ID 풀을 만들 때 다음과 같은 ID 저장소 및 인증 방법 조합 중 단 하나를 사용할 수 있습니다. - AD ID 저장소+ OIDC 인증 - LDAP ID 저장소+ OIDC 인증 - 로컬 ID 저장소 + OIDC 인증 처음 2개 조합은 초기 풀(TSM 구성됨)이 AD 또는 LDAP를 사용하도록 구성되어 있어야 합니다. **ID 풀을 만드는 방법** 아래에 설명된 절차는 마지막 조합인 '로컬 ID 저장소 + OIDC 인증'으로 ID 풀을 생성합니다. 1. OIDC 인증을 구성한 후 Tableau REST API OpenAPI를 사용하여 [ID 풀 만들기](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_RegisterIdentityPool) 끝점을 호출합니다. 2. 요청에서 다음을 지정합니다. 1. ID 풀의 이름과 설명. ID 풀 이름과 설명은 Tableau Server 방문 페이지의 모든 사용자에게 표시됩니다. 2. ID 저장소 인스턴스 ID 및 인증 유형 인스턴스 ID **참고:** - ID 저장소 인스턴스 ID와 인증 유형 인스턴스 ID를 확인하려면 [ID 저장소 나열](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_ListIdentityStoresTAG) 및 [인증 구성 나열](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_ListAuthConfigurations) 끝점을 호출하면 됩니다. - Tableau Server 설치 중에 TSM에서 구성한 ID 저장소를 사용하는 ID 풀을 만들려는 경우 ID 저장소 인스턴스 값은 항상 `'1'`입니다. #### 예 ##### URI https://myco/api/-/authn-service/identity-pools/ ##### 요청 본문(JSON) ``` { "name": "MyCo contractors", "identity_store_instance": "2", "auth_type_instance": "0", "is_enabled": true, "description": "Sign-in for MyCo contractors" } ``` #### 예제 응답 본문 _없음_ 3. ID 풀을 만든 후 IdP 구성으로 이동하여 로그인 리디렉션 URI를 `http:///authn-service/authenticate/oidc//login.`으로 설정합니다. 예를 들어 `http://myco/authn-service/authenticate/oidc/XXtgfe21-74d2-3h78-bdg6-g2g6h1234567/login`입니다. **참고:** ID 풀의 ID를 확인하려면 [ID 풀 나열](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods/operation/AuthnService_ListIdentityPools) 끝점을 호출하면 됩니다. **참고:** - 조직에 필요한 수의 ID 풀을 만들 수 있습니다. - 초기 풀(TSM 구성됨)에 따라 다른 ID 저장소 유형 및 인증 방법이 지원됩니다. 자세한 내용은 [인증](https://help.tableau.com/current/server/ko-kr/security_auth.htm)을 참조하십시오. ### 5단계: ID 풀에 사용자 추가 Tableau Server를 직접 사용하여 ID 풀에 사용자를 추가할 수 있습니다. Tableau Server에 로그인하려면 사용자가 초기 풀(TSM 구성됨)에 속해 있거나 ID 풀에 사용자를 추가해야 합니다. 사용자를 ID 풀에 추가하는 워크플로우는 ID 풀에 구성된 ID 저장소에 따라 변경될 수 있습니다. **사용자 추가 방법** 아래의 절차는 Tableau Server UI를 통해 ID 풀에 사용자를 추가하는 방법을 설명합니다. 그러나 Tableau REST API를 통해 [ID 풀에 사용자 추가](https://help.tableau.com/current/api/rest_api/ko-kr/REST/rest_api_ref_identity_pools.htm#add_user_to_idpool) 끝점을 호출하여 ID 풀에 사용자를 추가할 수도 있습니다. 1. Tableau Server UI에 관리자로 로그인합니다. 2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택합니다. 3. 사용자 추가 단추를 클릭하고 새 사용자 만들기 또는 파일에서 사용자 가져오기를 선택합니다. **새 사용자 만들기**의 경우: 1. 새 사용자를 추가할 ID 풀을 선택하고 다음을 클릭합니다. 1. AD 또는 LDAP ID 저장소로 구성된 ID 풀을 선택한 경우 사용자 이름을 입력하고 사이트 멤버십과 사이트 역할을 할당합니다. 작업을 마치면 사용자 가져오기 단추를 클릭합니다. 2. 로컬 ID 저장소로 구성된 ID 풀을 선택한 경우 사용자 이름을 입력합니다. 대화 상자가 확장되고 표시 이름, 식별자(대부분의 경우), 이메일 주소를 추가하고 사이트 및 사이트 역할을 설정할 수 있게 됩니다. 작업을 마치면 사용자 만들기 단추를 클릭합니다. 사용자 이름과 사이트 멤버십 및 사이트 역할 할당 방법에 대한 자세한 내용은 [사용자의 사이트 역할 설정](https://help.tableau.com/current/server/ko-kr/users_site_roles.htm)을 참조하십시오. **Tableau의 사용자 이름 및 식별자 정보** 사용자 이름은 시스템 사용자를 나타내는 정보입니다. 식별자는 사용자 이름 정보를 보완하는 데 사용되며 외부 ID 저장소에서 사용자 이름 대신 사용할 수 있습니다. Tableau에서 사용자 이름은 Tableau에 로그인할 때 사용되는 변경 불가능한 값이고, 식별자는 Tableau의 ID 구조에서 사용자와 일치하는 사용자 이름을 찾는 데 사용되는 변경 가능한 값입니다. 식별자를 사용하면 사용자 이름에서 벗어남으로써 Tableau를 보다 유연하게 사용할 수 있습니다. 외부 ID 저장소에서 사용자 이름이 변경되는 경우 Tableau Server 관리자는 식별자를 업데이트하여 사용자를 올바른 사용자 이름에 연결할 수 있습니다. 기존 사용자를 ID 풀에 추가할 때 식별자를 설정하는 기능을 사용하는 것이 좋을 수 있습니다. 예를 들어 로컬 ID 저장소로 구성된 ID 풀의 기존 사용자를 AD ID 저장소로 구성된 ID 풀에 추가하려는 경우 사용자 이름을 입력하여 해당 사용자에게 연결된 식별자를 검색할 수 있습니다. 반대로, AD ID 저장소로 구성된 ID 풀의 기존 사용자를 로컬 ID 저장소로 구성된 ID 풀에 추가하려는 경우에는 선택적으로 식별자를 입력할 수 있습니다. 로컬 ID 저장소와 로컬 인증으로 구성된 초기 풀(TSM 구성됨)에 사용자를 추가할 때는 예외가 적용됩니다. 이 경우 해당 사용자에 대한 식별자를 설정할 수 없습니다. **파일에서 사용자 가져오기**의 경우: 1. 다음 열이 나열된 순서로 포함된 .csv 파일을 업로드합니다. `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier` **참고:** 사용자 이름과 비밀번호만 필수 열입니다. 그러나 ID 풀 이름을 지정하지 않으면 사용자가 초기 풀(TSM 구성됨)에 추가됩니다. 자세한 내용은 [CSV 파일 가져오기 지침](https://help.tableau.com/current/server/ko-kr/csvguidelines.htm)을 참조하십시오. 예를 들어 Henry Wilson과 Fred Suzuki를 General Contractors(일반 계약자) ID 풀에 추가하려는 경우 .csv에는 다음 값이 포함될 수 있습니다. `henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson` `freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki` **참고:** ID 풀을 1개 이상 만든 경우 이러한 ID 풀의 멤버인 사용자에 대한 로그인 옵션을 포함하도록 Tableau Server 방문 페이지가 업데이트됩니다. 자세한 내용은 [ID 풀을 사용하여 사용자 프로비저닝 및 인증](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)을 참조하십시오. ## ID 풀 테스트 ID 풀을 설정한 후 Tableau Server에서 로그아웃하고 ID 풀에 속하는 사용자로 다시 로그인하여 ID 풀을 테스트하는 것이 좋습니다. 로그인 프로세스를 완료하여 OIDC 인증이 올바르게 구성되었는지 확인하십시오. **참고:** [1단계: Tableau Server 구성 및 세션 설정](#step1)에서 초기 풀(TSM 구성됨)에 대한 선택적 설명을 구성했거나 Tableau Server에 대한 [서버 설정(일반 및 사용자 지정)](https://help.tableau.com/current/server/ko-kr/maintenance_set.htm) 노트가 있는 경우 이 설명은 초기 풀(TSM 구성됨)을 사용하여 로그인하는 사용자로 한정되며 로그인 사용자 지정 노트는 Tableau Server에 로그인하는 모든 사용자에게 적용된다는 점을 참고하십시오. ## ID 풀 관리 서버 수준 및 사이트 수준 사용자 페이지에서 ID 풀의 사용자를 관리할 수 있습니다. 사용자 페이지에서는 ID 풀에 속하는 사용자와 ID 풀에 대한 요약 세부 정보를 볼 수 있습니다. 인증 구성 또는 ID 풀을 업데이트하고 로컬 ID 저장소 또는 ID 풀을 삭제하는 등의 다른 모든 ID 풀 관리 작업에는 [ID 풀 메서드](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#tag/Identity-Pools-Methods)에 설명된 Tableau REST API OpenAPI를 사용합니다. ## ID 풀 문제 해결 ### ID 풀의 제한 사항 ID 풀은 Tableau Server에서만 사용할 수 있습니다. **참고:** ID 풀은 현재 서버 수준 구성에만 사용할 수 있습니다. ID 풀의 범위를 사이트로 지정할 수는 없습니다. ### Tableau Server 방문 페이지에 IdP 오류가 표시됨 Tableau Server 방문 페이지에서 기본 로그인 옵션 아래의 ID 풀 로그인 옵션 옆에 IdP 관련 오류 메시지가 표시될 수 있습니다. 이 OIDC 인증 관련 문제는 1) Tableau Server가 외부 URL을 IdP로 보내도록 구성되지 않음 및 2) 전역 변수가 선언되지 않는다는 두 조건 중 하나 이상이 참일 때 발생할 수 있습니다. 이 문제를 해결하려면 위의 [1단계: Tableau Server 구성 및 세션 설정](#step1)에 설명된 절차를 완료하십시오. ### Tableau Server 랜딩 페이지에 ID 풀이 표시되지 않음 ID 풀 기능이 사용되지 않도록 설정된 경우 다음 TSM 명령을 사용하여 다시 사용하도록 설정할 수 있습니다. tsm configuration set -k features.IdentityPools -v true tsm configuration set -k features.NewIdentityMode -v true tsm configuration set -k wgserver.authentication.legacy\_identity\_mode.enabled -v false tsm pending-changes apply **참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다. ## '서버에서 OpenID 연결이 올바로 구성되지 않았습니다.' 로그인 오류 Tableau Server에 로그인한 사용자에게 다음 오류가 표시됩니다. _'서버에서 OpenID 연결이 올바로 구성되지 않았습니다. 도움이 필요한 경우 Tableau Server 관리자에게 문의하십시오.'_ 조직에서 정방향 프록시 서버를 사용하고 Tableau Server가 Windows에 설치되어 있는 경우 프록시를 통해 IdP로 OIDC 요청을 라우팅하도록 Tableau Server를 구성해야 할 수 있습니다. 이 문제를 해결하려면 TSM을 사용하여 Tableau Server의 프록시 설정을 구성합니다. 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행하여 프록시를 사용하도록 설정합니다. 1. `tsm configuration set -k tomcat.useSystemProxies -v true` 3. 다음 명령을 실행하여 프록시 호스트 및 포트를 설정하고 Tableau Server를 다시 시작합니다. 1. `tsm configuration set -k tomcat.http.proxyHost -v ` 2. `tsm configuration set -k tomcat.http.proxyPort -v ` 3. `tsm pending-changes apply` **참고:** - `` 및 ``를 현재 환경의 프록시 정보로 바꿉니다. ``에 'http://'를 포함하지 마십시오. - HTTPS 프록시의 경우 `tomcat.https.proxyHost` 및 `tomcat.https.proxyPort` 키-값 쌍을 대신 사용할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # ID 풀을 사용하여 사용자 프로비저닝 및 인증 Tableau Server 버전 2023.1에서 도입된 ID 풀은 프로비저닝 및 인증 정보를 사용하여 Tableau Server에 대한 사용자 액세스를 지원하는 ID 관리 도구입니다. ID 풀을 사용하면 Tableau Server의 사용자 ID 저장 및 관리를 위한 [ID 서비스](https://help.tableau.com/current/server/ko-kr/identity_migration.htm)를 기반으로 중앙 집중식의 유연한 ID 관리 워크플로우를 구축할 수 있습니다. ID 풀은 Tableau Server 설치 중에 TSM(Tableau 서비스 관리자)을 사용하여 설정하는 사용자 프로비저닝 및 인증 구성을 대체하지 않습니다. 대신, ID 풀은 AD(Active Directory) 또는 LDAP(Lightweight Directory Access Protocol)으로 TSM이 구성된 조직에서 추가 사용자 프로비저닝 및 인증 옵션을 필요로 하는 경우 이를 보완하고 지원하도록 설계되었습니다. ID 풀은 Tableau Server 설치 후 Tableau Server 관리자가 외부 사용자, 파트너 또는 계약업체와 같은 사용자를 Tableau Server 배포에 추가할 때 사용할 수 있는 추가 인증 방법을 제공합니다. ID 풀은 다음 사용 사례에 최적화되었습니다. - **외부 사용자:** 내부 AD에 외부 사용자를 추가하는 것을 꺼리는 대기업. 예를 들어 조직에 정규직과 계약직이라는 2가지 직원 유형이 있다고 하겠습니다. 정규직은 AD(Active Directory)와 SAML 인증을 통해 프로비저닝되고 인증은 조직의 IdP인 Okta를 통해 관리됩니다. 계약직은 일반적으로 임시 그룹 멤버십이 할당되는 사용자로 구성되거나 AD 외부에서 사용자를 프로비저닝하고 개별적으로 인증하는 다른 조직에 소속됩니다. ID 풀을 사용하면 AD 외부에 있는 Tableau Server 사용자를 추가할 수 있습니다. - **다수의 ID 저장소:** 여러 ID 저장소에서 사용자를 가져오는 SaaS 응용 프로그램을 호스트하는 조직. 예를 들어 조직에서 단일 사이트의 Tableau 콘텐츠를 외부 조직과 공유한다고 하겠습니다. 이 경우 로컬 ID 저장소로 구성된 서로 다른 ID 풀을 사용하면 이러한 사용자를 분리하여 각 조직에서 보다 쉽게 사용자를 식별하고 관리할 수 있습니다. - **내부 조직 간의 보안 경계:** 보안 경계가 구분되어 있는 다수의 하위 조직을 인수한 조직. 예를 들어 새로 추가된 조직의 사용자를 로컬 ID 저장소가 구성되어 있는 ID 풀에 추가하여 ID 저장소를 결합하는 것과 관련된 복잡성을 해결할 수 있습니다. ## ID 풀이란? ID 풀에는 사용자를 프로비저닝하기 위한 ID 저장소, OIDC(OpenID Connect) 인증 및 할당된 사용자라는 3가지 기본적인 구성 요소가 포함됩니다. - **ID 저장소:** 로컬 ID 저장소 또는 외부 ID 저장소를 [ID 저장소](https://help.tableau.com/current/server/ko-kr/plan_identity_store.htm)로 사용하여 사용자를 가져오거나 프로비저닝할 수 있습니다. - 로컬 ID 저장소인 경우 새 로컬 ID 저장소 또는 기존 로컬 ID 저장소를 사용하도록 ID 풀을 구성할 수 있습니다. **참고:** 로컬 인증은 지원되지 않습니다. - 외부 ID 저장소의 경우 Tableau Server 설치 중에 TSM에서 구성한 외부 ID 저장소(AD 또는 LDAP)와 동일한 ID 저장소만 ID 풀에 사용할 수 있습니다. 다른 외부 ID 저장소를 사용하도록 ID 풀을 구성할 수는 없습니다. Tableau Server 설치 중에 TSM에서 설정한 프로비저닝 및 인증 구성을 기본값 또는 "초기 풀(TSM 구성됨)"이라고 합니다. - **인증:** ID 풀에 지원되는 유일한 인증 방법은 [OIDC](https://help.tableau.com/current/server/ko-kr/security_auth.htm#oidc)입니다. - **사용자:** 사용자가 Tableau Server에 로그인하려면 초기 풀(TSM 구성됨)에 포함된 사용자이거나 1개 이상의 ID 풀의 멤버여야 합니다. ## ID 풀 사용 시기 Tableau Server 관리자는 ID 풀을 사용하여 사용자 프로비저닝 위치와 Tableau Server에 대한 인증 방법에 따라 사용자를 ID 동질 집단으로 분할할 수 있습니다. Tableau Server 설치 중에 TSM에서 설정하는 ID 저장소와 인증 구성, 즉 초기 풀(TSM 구성됨)은 변경되지 않지만 ID 풀은 Tableau Server에서 구성이 가능합니다. **참고:** ID 풀은 현재 서버 수준 구성에만 사용할 수 있습니다. ID 풀의 범위를 사이트로 지정할 수는 없습니다. ## ID 풀에 대한 추가 정보 ### 초기 풀(TSM 구성됨)과 ID 풀 비교 위에서 설명한 대로 Tableau Server 설치 중에 TSM에서 설정한 프로비저닝 및 인증 구성의 조합을 "초기 풀(TSM 구성됨)"이라고 합니다. 초기 풀(TSM 구성됨)은 Tableau Server 설치 프로세스의 필수 구성 요소이며 수정할 수 없습니다. 그러나 ID 풀은 선택 사항이고 Tableau Server에서 직접 필요한 수의 ID 풀을 만들 수 있습니다. ### 사용자의 로그인 경험에 영향을 미치는 ID 풀 기본적으로 Tableau Server에 대한 ID 풀을 만들지 않은 경우에는 사용자가 Tableau Server 방문 페이지로 이동하고 Tableau Server에 로그인하는 방식이 변경되지 않습니다. ID 풀을 1개 이상 만들면 Tableau Server 방문 페이지에 다수의 로그인 옵션이 표시됩니다. 페이지 상단에 표시되는 기본 로그인 옵션은 초기 풀(TSM 구성됨)에 속하는 사용자가 로그인할 때 사용할 수 있는 방법입니다. 기본 로그인 옵션 아래에는 보조 로그인 옵션이 있습니다. 각 옵션은 ID 풀을 나타내며 만들어진 순서로 표시됩니다. 이러한 풀에 할당된 사용자는 소속 ID 풀에 대한 옵션을 사용하여 로그인해야 합니다. 올바른 로그인 옵션으로 사용자를 안내하려면 ID 풀을 만들 때 설명을 추가하는 것이 좋습니다. **참고:** 풀 멤버십과 관계없이 Tableau Server에 대해 구성된 모든 풀이 모든 사용자에게 표시됩니다. ### Tableau의 사용자 이름 및 식별자 사용자 이름은 시스템 사용자를 나타내는 정보입니다. 식별자는 사용자 이름 정보를 보완하는 데 사용되며 외부 ID 저장소에서 사용자 이름 대신 사용할 수 있습니다. Tableau에서 사용자 이름은 Tableau에 로그인할 때 사용되는 변경 불가능한 값이고, 식별자는 Tableau의 ID 구조에서 사용자와 일치하는 사용자 이름을 찾는 데 사용되는 변경 가능한 값입니다. 식별자를 사용하면 사용자 이름에서 벗어남으로써 Tableau를 보다 유연하게 사용할 수 있습니다. 외부 ID 저장소에서 사용자 이름이 변경되는 경우 Tableau Server 관리자는 식별자를 업데이트하여 사용자를 올바른 사용자 이름에 연결할 수 있습니다. 기존 사용자를 ID 풀에 추가할 때 식별자를 설정하는 기능을 사용하는 것이 좋을 수 있습니다. 예를 들어 로컬 ID 저장소로 구성된 ID 풀의 기존 사용자를 AD ID 저장소로 구성된 ID 풀에 추가하려는 경우 사용자 이름을 입력하여 해당 사용자에게 연결된 식별자를 검색할 수 있습니다. 반대로, AD ID 저장소로 구성된 ID 풀의 기존 사용자를 로컬 ID 저장소로 구성된 ID 풀에 추가하려는 경우에는 선택적으로 식별자를 입력할 수 있습니다. 로컬 ID 저장소와 로컬 인증으로 구성된 초기 풀(TSM 구성됨)에 사용자를 추가할 때는 예외가 적용됩니다. 이 경우 해당 사용자에 대한 식별자를 설정할 수 없습니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # identityStore 엔터티 Tableau Server에는 사용자 및 그룹 정보를 저장하기 위한 ID 저장소가 필요합니다. ID 저장소를 처음 구성한다면 먼저 [인증](https://help.tableau.com/current/server/ko-kr/security_auth.htm) 및 [ID 저장소](https://help.tableau.com/current/server/ko-kr/plan_identity_store.htm) 항목을 검토하십시오. Tableau Server에서 ID 저장소를 설치한 후에는 서버를 다시 설치하지 않는 한 변경할 수 없습니다. **중요:** 모든 엔터티 옵션은 대/소문자를 구분합니다. ## 시작하기 전에 다음 정보를 검토하십시오. - 로컬 ID 저장소를 사용하지 않는 경우 일부 LDAP 버전을 사용하게 됩니다. 이 경우 디렉터리/LDAP 관리자와 협력하여 LDAP 스키마 및 바인딩 요구 사항에 맞게 Tableau Server를 구성하십시오. - Tableau Server 구성은 Active Directory에 최적화되어 있습니다. Active Directory에 설치하는 경우 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm#tsm-ui-steps)를 사용하여 ID 저장소를 구성하는 것이 좋습니다. - LDAP 바인딩은 사용자 인증과 독립적입니다. 예를 들어 단순 바인딩을 사용하여 LDAP 디렉터리에 인증하도록 Tableau Server를 구성하고, 설치 후에 Kerberos를 사용하여 사용자를 인증하도록 Tableau Server를 구성할 수 있습니다. - 단순 바인딩을 사용할 때 보안되지 않는 연결을 통해 LDAP에 연결하지 마십시오. 기본적으로 단순 바인딩을 사용하는 LDAP는 일반 텍스트로 데이터를 전송합니다. 단순 바인딩을 사용하여 트래픽을 암호화하려면 LDAPS를 사용하십시오. 자세한 내용은 [LDAP 외부 ID 저장소에 암호화된 채널 구성](https://help.tableau.com/current/server/ko-kr/config_encrypt_ldap.htm)을 참조하십시오. - Tableau Server 서비스에서 LDAP 바인딩에 Kerberos 인증을 사용하려면 아래 섹션에 설명된 대로 GSSAPI 바인딩에 사용할 keytab 파일이 필요합니다. 자세한 내용은 [Keytab 요구 사항 이해](https://help.tableau.com/current/server/ko-kr/kerberos_keytab.htm)를 참조하십시오. Kerberos의 컨텍스트에서 Tableau Server 기본 설치 중에는 GSSAPI 바인딩만 있으면 됩니다. 서버를 설치한 후 [사용자 인증을 위한 Kerberos 구성](https://help.tableau.com/current/server/ko-kr/config_kerberos.htm) 및 [데이터 원본에 대한 Kerberos 위임](https://help.tableau.com/current/server/ko-kr/kerberos_delegation.htm)을 수행할 수 있습니다. - 이 항목에서는 _LDAP_(디렉터리 서비스에 연결하기 위한 프로토콜)와 _LDAP 서버_(디렉터리 서비스의 구현)를 구분합니다. 예를 들어 `slapd`는 OpenLDAP 프로젝트의 일부인 LDAP 서버입니다. - 서버를 초기화하기 전에 LDAP 구성의 유효성을 검사합니다. 자세한 내용은 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)을 참조하십시오. - 초기 구성의 일부로만 JSON 구성 파일을 가져옵니다. JSON 구성 파일을 가져와 Tableau Server를 초기화한 후 LDAP를 변경해야 하는 경우 JSON 파일을 다시 가져오려고 하지 마십시오. 대신 기본 tsm 명령이나 `tsm configuration set` 명령을 사용하여 개별 키를 변경합니다. 자세한 내용은 [외부 ID 저장소 구성 참조](https://help.tableau.com/current/server/ko-kr/ldap_config.htm)를 참조하십시오. ## 구성 템플릿 이 섹션의 JSON 템플릿은 ID 저장소가 여러 개 있는 시나리오에서 Tableau Server를 구성하는 데 사용됩니다. 로컬 ID 저장소를 구성하는 경우가 아니라면 LDAP 환경과 관련된 구성 파일 템플릿을 선택하고 편집해야 합니다. [Tableau Identity Store Configuration Tool](https://tagyoureit.github.io/tableau-identitystore-config-tool/)을 사용하여 LDAP JSON 구성 파일을 생성하는 것이 좋습니다. 이 도구 자체는 Tableau에서 지원되지 않습니다. 그러나 파일을 수동으로 만드는 대신 이 도구로 만든 JSON 파일을 사용해도 서버의 지원되는 상태가 변경되지는 않습니다. 편집할 ID 저장소 구성 템플릿을 선택합니다. - 로컬 - LDAP - Active Directory - OpenLDAP - GSSAPI 바인딩 - OpenLDAP - 단순 바인딩 구성 파일, 엔터티 및 키에 대한 자세한 설명은 [구성 파일 예제](https://help.tableau.com/current/server/ko-kr/config_file_example.htm)를 참조하십시오. ### 로컬 조직에 아직 사용자 인증에 사용할 Active Directory 또는 LDAP 서버가 없는 경우 ID 저장소 유형을 로컬로 구성합니다. ID 저장소 유형으로 로컬을 선택한 경우 Tableau Server를 사용하여 사용자를 만들고 관리합니다. Tableau Server에서 로컬 ID 저장소를 구성하는 다른 방법은 설치 GUI를 실행하고 설치 과정 중에 "로컬"을 선택하는 것입니다. 자세한 내용은 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)을 참조하십시오. { "configEntities": { "identityStore": { "\_type": "identityStoreType", "type": "local" } } } ![](/tableau/current/ko-kr/server/ko-kr/Img/Road-sign-alert.png) ### 중요 아래 LDAP 구성 템플릿은 예제입니다. 제시된 템플릿은 조직에서 LDAP 연결을 구성하지 않습니다. 성공적으로 배포하려면 디렉터리 관리자와 협력하여 LDAP 템플릿 값을 편집해야 합니다. 또한 configEntities에서 참조되는 모든 파일은 로컬 컴퓨터에 위치해야 합니다. UNC 경로를 지정하지 마십시오. ### LDAP - Active Directory Tableau Server 구성은 Active Directory에 최적화되어 있습니다. Active Directory에 설치하는 경우 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm#tsm-ui-steps)를 사용하여 ID 저장소를 구성합니다. Active Directory에 대한 암호화된 연결이 필요합니다. [LDAP 외부 ID 저장소에 암호화된 채널 구성](https://help.tableau.com/current/server/ko-kr/config_encrypt_ldap.htm)을 참조하십시오. 어떤 이유로든 TSM 웹 인터페이스에서 ID 저장소를 Active Directory와 통신하도록 구성할 수 없는 경우 이 JSON 템플릿을 사용하여 Tableau Server를 Active Directory에 연결하도록 구성합니다. 이 템플릿은 GSSAPI(Kerberos) 바인딩을 사용하여 Tableau Server 서비스를 Active Directory에 인증합니다. Tableau Server는 Active Directory 스키마를 지원합니다. 따라서 `"directoryServiceType"` 옵션을 `"activedirectory"`로 설정한 경우 `"identityStoreSchemaType"` 옵션에 스키마 정보를 제공할 필요가 없습니다. { "configEntities":{ "identityStore": { "\_type": "identityStoreType", "type": "activedirectory", "domain": "your-domain.lan", "nickname": "YOUR-DOMAIN-NICKNAME", "directoryServiceType": "activedirectory", "bind": "gssapi", "kerberosKeytab": "", "kerberosConfig": "/etc/krb5.conf", "kerberosPrincipal": "your-principal@YOUR.DOMAIN" } } } GSSAPI를 사용하여 Active Directory에 바인딩하는 것이 좋지만, 단순 바인딩 및 LDAPS로 연결할 수도 있습니다. 단순 바인딩으로 연결하려면 `bind` 항목을 `simple`로 변경하고 Kerberos 항목 3개를 제거한 다음 `port`/`sslPort`, `username` 및 `password` 옵션을 추가합니다. 다음 예제에서는 단순 바인딩 json을 사용하는 Active Directory를 보여 줍니다. { "configEntities":{ "identityStore": { "\_type": "identityStoreType", "type": "activedirectory", "domain": "your-domain.lan", "nickname": "YOUR-DOMAIN-NICKNAME", "directoryServiceType": "activedirectory", "hostname": "optional-ldap-server", "sslPort": "636", "bind": "simple", "username": "username", "password": "password" } } } ### OpenLDAP - GSSAPI 바인딩 GSSAPI 바인딩을 사용하여 OpenLDAP를 구성하려면 아래의 템플릿을 사용합니다. 조직에서 Active Directory를 실행하는 경우에는 이 템플릿을 사용하지 마십시오. Active Directory에 설치하는 경우 위의 템플릿(LDAP - Active Directory)을 사용하십시오. 대부분의 경우 GSSAPI(Kerberos)와 함께 OpenLDAP를 사용하는 조직은 keytab 파일을 사용하여 자격 증명을 저장합니다. 다음 예에서는 keytab 파일이 인증 자격 증명에 사용됩니다. 하지만 `username` 및 `password` 엔터티로 자격 증명을 제공할 수 있으며, keytab 파일과 사용자 이름 및 암호 쌍을 동시에 지정할 수도 있습니다. 이 경우 Tableau Server는 keytab 파일을 사용하려고 시도하지만 어떤 이유로 인증이 실패하면 대체 인증으로 사용자 이름 및 암호 자격 증명을 사용합니다. { "configEntities":{ "identityStore": { "\_type": "identityStoreType", "type": "activedirectory", "domain": "your-domain.lan", "nickname": "YOUR-DOMAIN-NICKNAME", "directoryServiceType": "openldap", "bind": "gssapi", "kerberosKeytab": "", "kerberosConfig": "/etc/krb5.conf", "kerberosPrincipal": "your-principal@YOUR.DOMAIN", "identityStoreSchemaType": { "userBaseFilter": "(objectClass=inetOrgPerson)", "userUsername": "user", "userDisplayName": "displayname", "userEmail": "email", "userCertificate": "certificate", "userThumbnail": "thumbnail", "userJpegPhoto": "photo", "groupBaseFilter": "(objectClass=groupofNames)", "groupName": "groupname", "groupEmail": "groupemail", "groupDescription": "groupdescription", "member": "member", "distinguishedNameAttribute": "", "serverSideSorting": "", "rangeRetrieval": "", "userClassNames": \["inetOrgPerson","someClass2"\], "groupClassNames": \["groupOfUniqueNames1","groupOfUniqueNames2"\] } } } } ### OpenLDAP - 단순 바인딩 { "configEntities":{ "identityStore": { "\_type": "identityStoreType", "type": "activedirectory", "domain": "my.root", "nickname": "", "hostname": "optional-ldap-server", "port": "389", "directoryServiceType": "openldap", "bind": "simple", "username": "cn=username,dc=your,dc=domain", "password": "password", "identityStoreSchemaType": { "userBaseFilter": "(objectClass=inetOrgPerson)", "userUsername": "user", "userDisplayName": "displayname", "userEmail": "email", "userCertificate": "certificate", "userThumbnail": "thumbnail", "userJpegPhoto": "photo", "groupBaseFilter": "(objectClass=groupofNames)", "groupName": "groupname", "groupEmail": "groupemail", "groupDescription": "groupdescription", "member": "member", "distinguishedNameAttribute": "", "serverSideSorting": "", "rangeRetrieval": "", "userClassNames": \["inetOrgPerson","someClass2"\], "groupClassNames": \["groupOfUniqueNames1","groupOfUniqueNames2"\] } } } } ## 구성 템플릿 참조 ### 공유 ID 저장소 옵션 type 사용자 ID 정보를 저장하려는 위치입니다. `local` 또는 `activedirectory`입니다. (LDAP 서버에 연결하려는 경우 `activedirectory`를 선택합니다.) domain Tableau Server가 설치된 컴퓨터의 도메인입니다. nickname 도메인 애칭입니다. Windows 환경에서는 NetBIOS 이름이라고도 합니다. `nickname` 옵션은 모든 LDAP 엔터티에 필요합니다. 조직에 애칭/NetBIOS가 필요하지 않은 경우 빈 키를 전달합니다(예: `"nickname": ""`). ### LDAP GSSAPI 바인딩 옵션 directoryservicetype 연결하려는 디렉터리 서비스 유형입니다. `activedirectory` 또는 `openldap`입니다. kerberosConfig 로컬 컴퓨터의 Kerberos 구성 파일 경로입니다. Active Directory 환경에 설치하는 경우 도메인에 가입된 컴퓨터에 존재할 수 있는 기존 Kerberos 구성 파일이나 keytab 파일을 사용하지 않는 것이 좋습니다. [ID 저장소](https://help.tableau.com/current/server/ko-kr/plan_identity_store.htm)를 참조하십시오. kerberosKeytab 로컬 컴퓨터의 Kerberos keytab 파일 경로입니다. Tableau Server 서비스 전용 키가 포함된 keytab 파일을 만들고 컴퓨터의 다른 응용 프로그램과 keytab 파일을 공유하지 않는 것이 좋습니다. kerberosPrincipal 호스트 컴퓨터에서 Tableau Server의 서비스 사용자 이름입니다. keytab에 이 사용자에 대한 사용 권한이 있어야 합니다. 시스템의 기존 keytab을 사용하지 마십시오. 새 서비스 사용자 이름(SPN)을 등록하는 것이 좋습니다. 지정된 keytab에 포함된 사용자를 확인하려면 `klist -k` 명령을 실행합니다. 자세한 내용은 [Keytab 요구 사항 이해](https://help.tableau.com/current/server/ko-kr/kerberos_keytab.htm)를 참조하십시오. ### LDAP 단순 바인드 옵션 directoryservicetype 연결하려는 디렉터리 서비스 유형입니다. `activedirectory` 또는 `openldap`입니다. hostname LDAP 서버의 호스트 이름입니다. 이 값에 호스트 이름 또는 IP 주소를 입력할 수 있습니다. 여기에서 지정하는 호스트는 주 도메인의 사용자/그룹 쿼리에만 사용됩니다. 사용자/그룹 쿼리가 주 도메인이 아닌 다른 도메인에 있는 경우 Tableau Server는 이 값을 사용하지 않고 DNS를 쿼리하여 적절한 도메인 컨트롤러를 식별합니다. port 이 옵션을 사용하여 LDAP 서버의 비보안 포트를 지정합니다. 일반 텍스트는 주로 389입니다. sslPort 이 옵션을 사용하여 LDAPS를 사용하도록 설정합니다. LDAP 서버의 보안 포트를 지정합니다. LDAPS는 주로 포트 636입니다. LDAPS를 사용하려면 hostname 옵션도 지정해야 합니다. 자세한 내용은 [LDAP 외부 ID 저장소에 암호화된 채널 구성](https://help.tableau.com/current/server/ko-kr/config_encrypt_ldap.htm)을 참조하십시오. username 디렉터리 서비스에 연결하는 데 사용할 사용자 이름입니다. 지정하는 계정에는 디렉터리 서비스에 쿼리할 수 있는 사용 권한이 있어야 합니다. Active Directory의 경우 사용자 이름(예: `jsmith`)을 입력합니다. LDAP 서버의 경우 연결에 사용할 사용자의 DN(고유 이름)을 입력합니다. 예를 들어 `cn=username,dc=your-local-domain,dc=lan`을 입력할 수 있습니다. password LDAP 서버에 연결하는 데 사용할 사용자의 암호입니다. ### 공유 LDAP 옵션 다음 옵션은 일반 LDAP, OpenLDAP 또는 Active Directory 구현에서 설정할 수 있습니다. bind Tableau Server 서비스에서 LDAP 디렉터리 서비스로의 통신을 인증하기 위해 사용하려는 방법입니다. GSSAPI(Kerberos)의 경우 `gssapi`를 입력합니다. domain Active Directory 환경에서 Tableau Server가 설치되어 있는 도메인을 지정합니다. 예를 들어 "example.lan"을 지정합니다. AD가 아닌 LDAP인 경우: 이 값에 입력하는 문자열이 사용자 관리 도구의 "도메인" 열에 표시됩니다. 임의의 문자열을 입력할 수 있지만 키를 비워 둘 수 없습니다. root LDAP만 해당합니다. Active Directory에는 지정하지 마십시오. LDAP 루트에서 dc 구성 요소를 사용하지 않거나 더 복잡한 루트를 지정하려는 경우 LDAP 루트를 설정해야 합니다. "o=my,u=root" 형식을 사용하십시오. 예를 들어 `example.lan` 도메인의 경우 루트는 `"o=example,u=lan"`입니다. membersRetrievalPageSize 이 옵션은 LDAP 쿼리가 반환하는 결과의 최대 수를 결정합니다. 예를 들어 Tableau Server가 50,000명의 사용자를 포함하는 LDAP 그룹을 가져오는 시나리오를 가정합니다. 이렇게 많은 수의 사용자를 단일 작업에서 가져오려고 하는 것은 좋은 방법이 아닙니다. 이 옵션을 1500으로 설정하면 Tableau Server는 첫 번째 응답에서 처음 1500명의 사용자를 가져옵니다. 해당 사용자를 처리한 후 Tableau Server는 LDAP 서버에서 다음 1500명의 사용자를 요청하는 식으로 계속 작업합니다. 이 옵션은 LDAP 서버의 요구 사항을 충족시키기 위해서만 수정하는 것이 좋습니다. ### `identityStoreSchemaType` 옵션 LDAP 서버에 대한 LDAP 연결을 구성하는 경우 `identityStoreSchemaType` 개체에 LDAP 서버와 관련된 스키마 정보를 입력할 수 있습니다. **중요** Active Directory에 연결되는 경우(`"directoryServiceType": "activedirectory"`) 이러한 옵션을 구성하지 마십시오. userBaseFilter Tableau Server 사용자에게 사용할 필터입니다. 예를 들어 개체 클래스 특성 및 조직 단위 특성을 지정할 수 있습니다. userUsername LDAP 서버의 사용자 이름에 해당하는 특성입니다. userDisplayName LDAP 서버의 사용자 표시 이름에 해당하는 특성입니다. userEmail LDAP 서버의 사용자 이메일 주소에 해당하는 특성입니다. userCertificate LDAP 서버의 사용자 인증서에 해당하는 특성입니다. userThumbnail LDAP 서버의 사용자 축소판 이미지에 해당하는 특성입니다. userJpegPhoto LDAP 서버의 사용자 프로필 이미지에 해당하는 특성입니다. groupBaseFilter Tableau Server 사용자 그룹에게 사용할 필터입니다. 예를 들어 개체 클래스 특성 및 조직 단위 특성을 지정할 수 있습니다. groupName LDAP 서버의 그룹 이름에 해당하는 특성입니다. groupEmail LDAP 서버의 그룹 이메일 주소에 해당하는 특성입니다. groupDescription LDAP 서버의 그룹 설명에 해당하는 특성입니다. member 그룹의 사용자 목록을 설명하는 특성입니다. distinguishedNameAttribute 사용자의 고유 이름을 저장하는 특성입니다. 이 특성은 선택 사항이지만 LDAP 쿼리의 성능을 크게 향상시킵니다. serverSideSorting LDAP 서버가 쿼리 결과의 서버 측 정렬을 사용하도록 구성되어 있는지 여부입니다. LDAP 서버가 서버 측 정렬을 지원하는 경우 이 옵션을 `true`로 설정합니다. 잘못 구성하면 오류가 발생할 수 있으므로 LDAP 서버가 이 기능을 지원하는지 잘 모르겠으면 `false`를 입력하십시오. rangeRetrieval LDAP 서버가 요청에 대해 쿼리 결과 범위를 반환하도록 구성되어 있는지 여부입니다. 즉, 많은 사용자가 있는 그룹은 한 번에 전부 요청되는 대신 작은 집합으로 요청됩니다. 범위 검색을 지원하는 LDAP 서버는 대규모 쿼리에서 더 나은 성능을 제공합니다. LDAP 서버가 범위 검색을 지원하는 경우 이 옵션을 `true`로 설정합니다. 잘못 구성하면 오류가 발생할 수 있으므로 LDAP 서버가 범위 검색을 지원하는지 잘 모르겠으면 `false`를 입력하십시오. groupClassNames 기본적으로 Tableau Server는 "group" 문자열을 포함하는 LDAP 그룹 개체 클래스를 찾습니다. LDAP 그룹 개체가 기본 클래스 이름과 맞지 않으면 이 값을 설정하여 기본값을 재정의하십시오. 여러 클래스 이름을 쉼표로 구분하여 입력할 수 있습니다. 이 옵션에는 문자열 목록을 사용하며, 각 클래스를 따옴표로 묶고 쉼표로 구분(공백 없이)한 후 대괄호로 묶어 전달해야 합니다. 예: `["basegroup","othergroup"]`. userClassNames 기본적으로 Tableau Server는 “user” 및 “inetOrgPerson” 문자열을 포함하는 LDAP 사용자 개체 클래스를 찾습니다. LDAP 사용자 개체가 이러한 기본 클래스 이름을 사용하지 않으면 이 값을 설정하여 기본값을 재정의하십시오. 여러 클래스 이름을 쉼표로 구분하여 입력할 수 있습니다. 이 옵션에는 문자열 목록을 사용하며, 각 클래스를 따옴표로 묶고 쉼표로 구분(공백 없이)한 후 대괄호로 묶어 전달해야 합니다. 예: `["userclass1",userclass2”]`. ## JSON 파일 가져오기 JSON 파일 편집을 마친 후 다음 명령으로 파일을 전달하고 설정을 적용합니다. `tsm settings import -f path-to-file.json` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Impala에 대한 외부 OAuth 구성 Tableau Desktop 및 Tableau Server의 Tableau 2025.3과 Tableau Cloud 2026.1부터 OAuth 2.0/OIDC를 사용하여 외부 ID 공급자의 ID를 Impala에 페더레이션할 수 있습니다. ID 공급자에 따라 통합을 구성하는 데 여러 단계가 필요할 수 있습니다. 다음은 개요 수준의 정보입니다. ## Impala에서 IDP 구성 Impala에서 IdP를 구성하는 방법에 대한 자세한 내용은 Cloudera 설명서에서 [OAuth 인증 구성(영문)](https://docs.cloudera.com/cdp-private-cloud-base/7.1.9/impala-secure/topics/impala-oauth.html "Impala에서 OAuth를 구성하기 위한 Cloudera 문서 링크")을 참조하십시오. ## IdP 구성 1. Tableau Desktop용 IDP 및 Tableau Server 또는 Tableau Cloud에서 OAuth 클라이언트를 만듭니다. Desktop 클라이언트에는 [`PKCE`](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) 활성화가 필요하고 `http://localhost` 리디렉션을 사용해야 합니다. 2. Tableau OAuth 구성 파일을 만듭니다. 이를 수행하는 방법에 대한 자세한 내용은 [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "GitHub의 OAuth 설명서")의 [OAuth 구성 및 사용(영문)](https://tableau.github.io/connector-plugin-sdk/docs/oauth) 및 [여기](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "GitHub의 OAuth 예시")에서 예를 참조하십시오. 다른 IDP의 사례도 유용합니다. 1. Tableau OAuth 구성 ID 앞에 '`custom_`'을 붙여야 합니다. **참고:** OAuth 구성 ID는 최대 36자로 제한합니다. 이보다 긴 ID를 사용하면 오류가 발생하지는 않지만 작동하지도 않습니다. 2. IDP가 동적 localhost 포트를 지원하는 경우 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`을 사용하지 않도록 설정합니다. IDP가 지원하지 않는 경우 구성 파일과 IDP의 허용 목록에 여러 localhost 콜백 URL을 추가해야 합니다. 3. 데스크톱 호스트의 각 응용 프로그램과 연결된 `OAuthConfigs` 폴더(Tableau Desktop, Tableau Prep Builder, Tableau Bridge)와 사이트 설정 페이지를 통해 OAuth를 사용할 각 Tableau Server 및 Tableau Cloud 사이트에 새 Tableau OAuth 구성 파일을 설치합니다. 자세한 내용은 [Desktop의 사용자 지정 OAuth 구성](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop) 및 [사이트 수준 OAuth 클라이언트](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients)를 참조하십시오. ## Impala에 연결 사용자는 OAuth를 사용하여 로그인을 선택하고 이전에 설치한 OAuth 공급자를 선택해야 합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/impala_oauth_connect.png) [주요 콘텐츠로 건너뛰기](#main-content) # JDBC 커넥터에서 Kerberos 서비스 계정 인증 사용 버전 2020.2부터 Tableau Server는 JDBC 커넥터에서 Kerberos 인증을 지원합니다. Tableau Server가 Kerberos 서비스 계정을 사용하여 데이터베이스에 액세스하도록 구성할 수 있습니다. 이 시나리오에서 Tableau Server는 서비스 계정('서비스 계정' 서비스 계정이라고도 함)을 사용하여 데이터베이스에 연결합니다. 이 시나리오를 "서비스 계정 인증"이라고 합니다. 자세한 내용은 ['서비스 계정' 서비스 계정](https://help.tableau.com/current/server/ko-kr/runas.htm)을 참조하십시오. Tableau Server의　'서비스 계정' 인증을 사용하려면 먼저 통합 인증을 사용하는 통합 문서 또는 데이터 원본을 Tableau Desktop에서 만들어야 합니다. Tableau Server에 게시할 때 '서비스 계정' 인증을 사용하는 옵션이 나타납니다. 웹 작성을 사용하여 데이터 원본을 만들 때 통합 인증을 선택하는 경우 '서비스 계정' 인증이 기본 작동입니다. ## 지원되는 데이터 원본 Tableau는 다음 데이터 원본에서 JDBC Kerberos 위임을 지원합니다. - Oracle - PostgreSQL JDBC 기반 커넥터를 사용하여 Oracle 데이터 원본에 대한 '서비스 계정' 인증을 구성하는 경우 이 항목의 절차를 따르십시오. 그렇지 않고 Tableau Server에서 실행 중인 커넥터가 네이티브 드라이버를 사용하는 경우 이 항목의 단계를 수행할 필요가 없습니다. 대신 ['서비스 계정' 서비스 계정 변경](https://help.tableau.com/current/server/ko-kr/runas_acct.htm) 항목에 설명된 대로 '서비스 계정' 서비스 계정을 만드는 단계를 수행합니다. ## 요구 사항 Kerberos 위임에는 Active Directory가 필요합니다. - LDAP - Active Directory를 사용하도록 Tableau Server 정보 저장소를 구성해야 합니다. - MIT KDC는 지원되지 않습니다. ## 구성 프로세스 이 섹션에서는 Kerberos RunAs 인증을 사용하도록 설정하는 프로세스의 예를 제공합니다. 1. ‘서비스 계정’ 서비스 계정에 대한 keytab 파일을 만듭니다. 다음 예제에서는 JDK에 제공되는 ktab 도구를 사용합니다. 이 도구는 [AdoptOpenJDK](https://adoptopenjdk.net/)에서 다운로드할 수 있습니다. ktab을 사용하여 keytab을 만드는 경우 UPN 형식(예: `service@EXAMPLE.COM`)의 로그온 사용자를 사용합니다. 서비스 사용자 이름(예: `HTTP/service.example.com@EXAMPLE.COM`)을 사용해서는 안 됩니다. ktpass 유틸리티를 사용하여 keytab을 생성할 수도 있으며, 이 경우 두 사용자 이름 형식 중 하나를 사용할 수 있습니다. /bin/ktab -k E:/tmp/tabsrv.keytab -a tabsrv@EXAMPLE.COM Tableau Server는 ‘서비스 계정’ 서비스 계정 및 관련 keytab을 사용하여 인증하고 데이터베이스에 직접 연결합니다. 2. keytab 파일을 Tableau Server 데이터 디렉터리에 복사하고 '서비스 계정' 서비스 계정이 keytab 파일을 액세스하고 읽을 수 있는지 확인합니다. 기본적으로 Tableau Server 데이터 디렉터리는 `C:\ProgramData\Tableau`에 위치합니다. 분산 배포에서 Tableau Server를 실행하는 경우 클러스터의 각 노드에서 이 단계를 수행합니다. 3. 다음 TSM 명령을 실행하여 '서비스 계정' 서비스 계정과 keytab 파일에 대한 경로를 설정합니다. tsm configuration set -k native\_api.datasource\_runas\_principal -v tabsrv@EXAMPLE.COM tsm configuration set -k native\_api.datasource\_runas\_keytab\_path -v kerberos.keytab 일부 경우 TSM이 `--force-keys`에 관한 오류를 반환할 수 있습니다. 이 오류가 발생하면 `--force-keys` 매개 변수를 인수에 추가하고 명령을 다시 실행합니다. 4. krb5.conf 파일을 만들고 모든 Tableau Server 노드의 `C:\Windows`에 설치합니다. 조직의 컴퓨터에 이미 krb5.ini 파일이 배포되어 있는 경우 해당 파일을 복사하여 Tableau Server에 사용합니다. 자세한 내용은 MIT Kerberos 설명서 항목 [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)를 참조하십시오. Kerberos 구성 파일의 위치를 변경하려면 다음 TSM 명령을 실행합니다. tsm configuration set -k native\_api.kerberos\_config\_path --force-keys -v "C:\\temp\\krb5.ini" 다음은 krb5.conf 파일의 예입니다. Tableau Support는 krb5.conf 만들기와 관련된 지원을 제공할 수 없습니다. \[libdefaults\] forwardable = true default\_realm = EXAMPLE.COM default\_tkt\_enctypes = rc4-hmac default\_tgs\_enctypes = rc4-hmac \[realms\] EXAMPLE.COM = { kdc = kdc.example.com admin\_server = kdc.example.com } \[domain\_realm\] .example.com = EXAMPLE.COM example.com = EXAMPLE.COM 5. 다음 TSM 명령을 실행하여 변경 사항을 Tableau Server에 적용합니다. `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # JDBC 커넥터에서 Kerberos 위임 사용 버전 2020.2부터 Tableau Server는 JDBC 커넥터에서 Kerberos 위임을 지원합니다. Kerberos 위임을 사용하면 Viewer(뷰어) 대신 쿼리를 실행하기 위해 통합 문서 Viewer(뷰어)의 Kerberos 자격 증명을 Tableau Server가 사용하도록 설정할 수 있습니다. 이 방법은 다음과 같은 상황에 유용합니다. - 데이터에 액세스하는 사용자를 알아야 합니다. 해당 Viewer(뷰어)의 이름은 데이터 원본의 액세스 로그에 표시됩니다. - 데이터 원본에 행 수준 보안이 설정되어 있습니다. 이 경우 다양한 사용자들이 다양한 행에 액세스할 수 있습니다. ## 지원되는 데이터 원본 Tableau는 다음 데이터 원본에서 JDBC Kerberos RunAs 인증을 지원합니다. - Oracle - PostgreSQL JDBC 기반 커넥터를 사용하여 Oracle 데이터 원본에서 위임에 구성하는 경우 이 항목의 절차를 따르십시오. 그렇지 않고 Tableau Server에서 실행 중인 커넥터가 네이티브 드라이버를 사용하는 경우 [Kerberos 위임 사용](https://help.tableau.com/current/server/ko-kr/kerberos_delegation.htm) 도움말 항목의 절차를 따르십시오. ## 요구 사항 Kerberos 위임에는 Active Directory가 필요합니다. - LDAP - Active Directory를 사용하도록 Tableau Server 정보 저장소를 구성해야 합니다. - MIT KDC는 지원되지 않습니다. **참고**: 운영 체제로 작동하기 위해 '서비스 계정' 계정을 사용하도록 설정할 필요가 없습니다. ## 구성 프로세스 이 섹션에서는 Kerberos 위임을 사용하도록 설정하는 프로세스의 예를 제공합니다. 1. Tableau Server가 데이터베이스 호출을 시작한 사용자를 대신하여 위임하려면 Kerberos 서비스 티켓이 필요합니다. 지정된 데이터베이스에 위임하는 데 사용할 도메인 계정을 만들어야 합니다. 이 계정을 '서비스 계정' 서비스 계정이라고 합니다. 이 항목에서 '서비스 계정' 계정으로 구성된 예제 사용자는 `tabsrv@EXAMPLE.COM`입니다. 이 계정은 Active Directory에서 위임으로 구성되어야 합니다. 1. 사용자 도메인에 연결된 Windows Server에서 Active Directory 사용자 및 컴퓨터를 엽니다. 2. ‘서비스 계정’ 서비스 계정의 **속성** 페이지에서 **위임** 탭을 클릭한 다음 **지정한 서비스에 대한 위임용으로만 이 사용자 트러스트** 및 **모든 인증 프로토콜 사용**을 선택합니다. 2. ‘서비스 계정’ 서비스 계정에 대한 keytab 파일을 만듭니다. 다음 예제에서는 JDK에 제공되는 ktab 도구를 사용합니다. 이 도구는 [AdoptOpenJDK](https://adoptopenjdk.net/)에서 다운로드할 수 있습니다. ktab을 사용하여 keytab을 만드는 경우 UPN 형식(예: `service@EXAMPLE.COM`)의 로그온 사용자를 사용합니다. 서비스 사용자 이름(예: `HTTP/service.example.com@EXAMPLE.COM`)을 사용해서는 안 됩니다. ktpass 유틸리티를 사용하여 keytab을 생성할 수도 있으며, 이 경우 두 사용자 이름 형식 중 하나를 사용할 수 있습니다. /bin/ktab -k E:/tmp/tabsrv.keytab -a tabsrv@EXAMPLE.COM Tableau Server는 ‘서비스 계정’ 서비스 계정 및 관련 keytab을 사용하여 인증하고 데이터베이스에 직접 연결합니다. 3. keytab 파일을 Tableau Server 데이터 디렉터리에 복사하고 '서비스 계정' 서비스 계정이 keytab 파일을 액세스하고 읽을 수 있는지 확인합니다. 기본적으로 Tableau Server 데이터 디렉터리는 `C:\ProgramData\Tableau`에 위치합니다. 분산 배포에서 Tableau Server를 실행하는 경우 클러스터의 각 노드에서 이 단계를 수행합니다. 4. krb5.conf 파일을 만들고 모든 Tableau Server 노드의 `C:\Windows`에 설치합니다. 조직의 컴퓨터에 이미 krb5.ini 파일이 배포되어 있는 경우 해당 파일을 복사하여 Tableau Server에 사용합니다. 자세한 내용은 MIT Kerberos 설명서 항목 [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)를 참조하십시오. Kerberos 구성 파일의 위치를 변경하려면 다음 TSM 명령을 실행합니다. tsm configuration set -k native\_api.kerberos\_config\_path --force-keys -v "C:\\temp\\krb5.ini" 다음은 krb5.conf 파일의 예입니다. Tableau Support는 krb5.conf 만들기와 관련된 지원을 제공할 수 없습니다. \[libdefaults\] forwardable = true default\_realm = EXAMPLE.COM default\_tkt\_enctypes = rc4-hmac default\_tgs\_enctypes = rc4-hmac \[realms\] EXAMPLE.COM = { kdc = kdc.example.com admin\_server = kdc.example.com } \[domain\_realm\] .example.com = EXAMPLE.COM example.com = EXAMPLE.COM 5. 다음 TSM 명령을 실행하여 Kerberos 위임을 사용하도록 설정하고 위임 서비스 계정을 설정한 다음 keytab 파일을 서비스 계정에 연결합니다. tsm configuration set -k wgserver.delegation.enabled -v true tsm configuration set -k native\_api.datasource\_impersonation\_runas\_principal -v tabsrv@EXAMPLE.COM tsm configuration set -k native\_api.datasource\_impersonation\_runas\_keytab\_path -v kerberos.keytab tsm configuration set -k native\_api.protocol\_transition\_a\_d\_short\_domain -v false tsm configuration set -k native\_api.protocol\_transition\_uppercase\_realm -v true 일부 경우 TSM이 `--force-keys`에 관한 오류를 반환할 수 있습니다. 이 오류가 발생하면 `--force-keys` 매개 변수를 인수에 추가하고 명령을 다시 실행합니다. 6. 다음 TSM 명령을 실행하여 변경 사항을 Tableau Server에 적용합니다. `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # JMX 포트 사용 Tableau 지원 부서에서는 Tableau Server의 문제 해결에 도움이 될 수 있도록 서버의 JMX 포트 사용 여부를 물을 수 있습니다. 이러한 포트는 JConsole과 같은 도구를 사용한 모니터링 및 문제 해결에 사용됩니다. 버전 2022.1 이상에서는 JMX 포트를 안전하게 사용할 수 있으며 권장되는 방법입니다. 버전 2022.1 이전에서는 포트를 비보안 상태로만 사용할 수 있습니다. ## 보안 JMX 포트 사용 Tableau Server 버전 2022.1부터 JMX 포트를 안전하게 사용할 수 있습니다. 이 절차에서는 보안 JMX를 사용하는 방법을 설명합니다. 이전 버전에서 JMX를 사용하려면 아래의 [비보안 JMX 포트 사용](#EnableUnsecureJMX)을 참조하십시오. Tableau Server에서 보안 JMX를 사용하려면: 1. TSM이 설치된 컴퓨터에 대한 관리자 액세스 권한이 있는 사용자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행합니다. tsm maintenance jmx enable 명령을 실행할 때 여러 옵션을 제공할 수 있습니다. 명령을 실행할 때 아무 옵션도 제공하지 않으면 지정한 답변에 따라 옵션에 대한 메시지가 표시됩니다. 예: C:\\Windows\\system32>tsm maintenance jmx enable We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX? (y/n): y JMX access is readonly by default. Would you like to add readwrite access? (y/n): n Would you like to enable SSL? (y/n): y Would you like to require client authentication (mTLS)? (y/n): n Enabling JMX with the specified settings. This will perform a server restart. Do you want to continue? (y/n): y Starting enable JMX asynchronous job. 명령 및 옵션에 대한 자세한 내용은 [tsm maintenance jmx enable](https://help.tableau.com/current/server/ko-kr/cli_maintenance_tsm.htm#jmx_enable)을 참조하십시오. 비보안 JMX 포트 사용 2022.1.0 이전 버전의 Tableau Server에서는 JMX 포트를 사용할 때 비보안 상태로만 사용할 수 있습니다. **중요** 비보안 JMX 포트를 사용하면 보안 위험이 발생할 수 있습니다. 보안 JMX를 사용하는 것이 좋습니다. 이를 지원하는 Tableau Server 버전이 없는 경우 위험을 인지하고 JMX 포트에 대한 액세스를 시나리오에 적합한 소수의 클라이언트로 제한하여 위험을 완화하십시오. 일반적으로 호스트의 방화벽 규칙, 외부의 보안 기기 또는 라우팅 규칙을 사용하여 액세스를 제한합니다. Tableau Server에서 비보안 JMX 포트를 사용하려면: 1. [서버를 중지합니다.](https://help.tableau.com/current/server/ko-kr/cli_stop_tsm.htm#stop) 2. 다음 명령을 입력합니다. ``` tsm configuration set -k service.jmx_enabled -v true ``` 3. 보류 중인 변경 내용을 적용합니다. ``` tsm pending-changes apply ``` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. 4. 조정 서비스 및 TSM 관리자 컨트롤러를 다시 시작합니다. `net stop appzookeeper_0` `net start appzookeeper_0` `net stop tabadmincontroller_0` `net start tabadmincontroller_0` **참고:** 명령 프롬프트에서 관리자로 다음 명령을 실행해야 합니다. 컴퓨터의 구성 방식에 따라 `C:\Windows\System32` 폴더에서 명령을 실행해야 할 수 있습니다. tabadmincontroller를 다시 시작하는 데 몇 분 정도 걸릴 수 있습니다. 다음 단계에서 컨트롤러가 완전히 다시 시작되기 전에 보류 중인 변경 사항을 적용하려고 하면 TSM이 컨트롤러에 연결할 수 없게 됩니다. `tsm status -v` 명령을 사용하여 컨트롤러가 실행 중인지 확인할 수 있습니다. Tableau Server 관리 컨트롤러가 "is running(실행 중)"으로 표시되어야 합니다. 5. [서버를 시작](https://help.tableau.com/current/server/ko-kr/cli_start_tsm.htm#start)합니다. ## JMX 포트 확인 방법 기본적으로 JMX 포트는 사용 가능한 포트 범위 내에서 동적으로 할당됩니다. 포트 할당이 수행되는 방법과 동적 매핑을 재정의하는 방법에 대한 자세한 내용은 [Tableau 서비스 관리자 포트](https://help.tableau.com/current/server/ko-kr/ports.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos Kerberos는 KDC(키 배포 센터)라고 하는 신뢰할 수 있는 제3자 네트워크 서비스를 통해 컴퓨터의 신원을 확인한 후 _티켓_을 교환하는 방식으로 컴퓨터 사이에 안전한 연결을 제공하는 3방향 인증 프로토콜입니다. 이러한 티켓은 컴퓨터와 서비스 사이에서 상호 인증을 제공하며, 상대 쪽이 이쪽에 액세스할 수 있는 권한이 있는지 확인합니다. Tableau Server는 Active Directory Kerberos 환경에서 Kerberos 인증을 지원하며, 이러한 환경에서는 Tableau Server에 대한 인증이 Kerberos로 처리됩니다. **참고**:  - Tableau Server에서 Kerberos는 사용자 인증용으로 지원됩니다. 통합 문서 등 Tableau Server 콘텐츠와 관련된 내부 사용 권한 및 권한 부여는 처리하지 않습니다. - ID 풀은 조직에 필요할 수 있는 추가 사용자 프로비저닝 및 인증 옵션을 보완하고 지원하도록 설계된 도구이며 OIDC(OpenID Connect) 인증만 지원합니다. 자세한 내용은 [ID 풀을 사용하여 사용자 프로비저닝 및 인증](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)을 참조하십시오. ## Kerberos 작동 방식 Active Directory 환경에서 Tableau Server에 Kerberos를 구성한 경우 AD 도메인 컨트롤러가 Kerberos KDC(키 배포 센터)의 역할을 수행하고 도메인의 다른 노드에 TGT(티켓 허용 티켓)을 발행합니다. KDC로 인증된 사용자는 Tableau Server에 연결할 때 추가로 인증할 필요가 없습니다. 다음은 인증 작업 흐름을 보여 주는 다이어그램입니다. ![Tableau Server 사용자의 인증 프로세스를 설명하는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/kerb_client_server.png)
중앙에 흰색 숫자 1이 있는 파란색 원입니다.사용자가 Active Directory 도메인에 로그인합니다.중앙에 흰색 숫자 2가 있는 파란색 원입니다.Kerberos KDC가 사용자를 인증하고 사용자 컴퓨터에 TGT(티켓 허용 티켓)를 보냅니다.
중앙에 흰색 숫자 3이 있는 파란색 원입니다.사용자가 Tableau Desktop 또는 웹 브라우저에서 Tableau Server에 연결합니다.중앙에 흰색 숫자 4가 있는 파란색 원입니다.

Tableau Server가 사용자를 인증합니다.

## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos SSO를 위한 Tableau 클라이언트 지원 이 문서에서는 특정 Tableau 클라이언트 및 운영 체제에 따라 Tableau Server에서 Kerberos SSO(Single Sign-On)를 사용하기 위한 몇 가지 요구 사항과 주의 사항에 대해 설명합니다. 이 문서에서 다루는 Tableau 클라이언트에는 일반적인 웹 브라우저, Tableau Desktop 및 Tableau Mobile 앱이 포함됩니다. ## 일반 브라우저 클라이언트 지원 브라워저 기반 Kerberos SSO(Single Sign-On)를 사용하려면 다음 조건이 충족되어야 합니다. - Tableau Server에 Kerberos가 설정되어 있어야 합니다. - Tableau Server에 로그인하려면 사용자에게 사용자 이름과 암호가 있어야 합니다. **참고:** Kerberos SSO가 실패하는 경우 이를 대비한 대체 설정이 있으면 사용자는 자신의 사용자 이름 및 비밀번호 자격 증명을 대신 사용할 수 있습니다. - 사용자가 클라이언트 컴퓨터 또는 휴대기기에서 Kerberos를 통해 Active Directory에 인증해야 합니다. 즉, 사용자에게 Kerberos TGT(티켓 허용 티켓)가 있어야 합니다. ## Tableau Desktop 및 브라우저 클라이언트 Windows 또는 Mac의 경우 다음과 같은 버전의 Tableau Desktop 또는 브라우저에서 Kerberos SSO를 사용하여 Tableau Server에 로그인할 수 있습니다. 명시된 경우 추가 구성이 필요합니다. Windows - Tableau Desktop 10.3 이상이 지원됩니다. - Internet Explorer - 지원, 구성이 필요할 수 있음 - [참고 1](#note1) 확인 - Chrome - 지원, 구성이 필요할 수 있음 - [참고 1](#note1) 확인 - Firefox - 구성 필요 - [참고 2](#note2) 확인 - Safari - 지원 안 함 Mac OS X - Tableau Desktop 10.3 이상 - Safari - 지원 - Chrome - [참고 3](#note3) 확인 - Firefox - [참고 2](#note2) 확인 - Internet Explorer - 지원 안 함 ## Tableau Mobile 앱 클라이언트 iOS 또는 Andoid 기기에서 다음과 같은 Tableau Mobile 또는 모바일 브라우저 버전을 사용하여 Tableau Server에 Kerberos 인증을 사용할 수 있습니다. iOS - Tableau Mobile 앱 - [참고 4](#note4) 확인 - Safari - [참고 4](#note4) 확인 - Chrome - 지원 안 함 Android - [참고 5](#note5) 확인 - Tableau Mobile 앱 - Chrome ## 운영 체제 및 브라우저별 참고 사항 다음 참고 사항은 특정 운영 체제 및 클라이언트 조합에 대한 구성 요구 사항 또는 문제점을 설명합니다. ### 참고 1: Windows 데스크톱의 Internet Explorer 또는 Chrome Kerberos SSO는 Internet Explorer 및 Chrome 모두에서 지원되지만 다음과 같이 Windows 인터넷 옵션을 구성해야 합니다. 1. Windows 통합 인증을 사용하도록 설정합니다. 2. Tableau Server URL이 로컬 인트라넷 영역에 있는지 확인합니다. 일부 경우 Internet Explorer가 인트라넷 영역을 감지하고 이 설정을 구성할 수 있습니다. Tableau Server URL이 감지 및 구성되지 않는 경우에는 수동으로 이 URL을 로컬 인트라넷 영역에 추가해야 합니다. Windows 통합 인증을 사용하도록 설정하려면 1. Windows 제어판에서 **인터넷 옵션**을 엽니다. 2. **고급** 탭에서 아래로 **보안** 섹션까지 스크롤합니다. 3. **Windows 통합 인증 사용**을 선택합니다. 4. **적용**을 클릭합니다. Tableau Server URL이 로컬 인트라넷 영역에 있는지 확인하거나 추가하려면 1. Windows 제어판에서 **인터넷 옵션**을 엽니다. 2. **보안** 탭에서 **로컬 인트라넷**을 선택한 후 **사이트**를 클릭합니다. 3. **로컬 인트라넷** 대화 상자에서 **고급**을 클릭합니다. **웹 사이트** 필드에서 내부 Tableau Server URL을 찾습니다. 일부 조직에서는 IT 관리자가 와일드카드(\*)를 사용하여 내부 URL을 지정합니다. 예를 들어 다음 URL에는 로컬 인트라넷 영역의 내부 `example.lan` 네임스페이스에 속한 모든 서버가 포함됩니다. `https://*.example.lan` 다음 이미지는 `https://tableau.example.lan`의 특정 URL을 보여 줍니다. ![영역에서 웹 사이트를 추가하거나 제거하기 위한 로컬 인트라넷 대화 상자입니다.](/tableau/current/ko-kr/server/ko-kr/Img/kerberos_intranet_zone.png) 4. Tableau Server URL 또는 와일드카드 URL이 **웹 사이트** 필드에 지정되지 않은 경우 **영역에 웹 사이트 추가** 필드에 Tableau Server URL을 입력하고 **추가**를 클릭한 다음 **확인**을 클릭합니다. Tableau Server URL이 이미 웹 사이트에 나열된 경우 대화 상자를 닫을 수 있습니다. ### 참고 2: Windows 또는 Mac OS X 데스크톱의 Firefox Windows 또는 Mac에서 Firefox를 사용하여 Kerberos SSO를 통해 Tableau Server에 로그인할 수 있습니다. 이렇게 하려면 다음 단계를 완료하여 Kerberos를 지원하도록 Firefox를 구성해야 합니다. 1. Firefox에서 주소 표시줄에 `about:config`를 입력합니다. 2. 고급 설정 변경과 관련된 경고가 나타나면 **고급 기능 사용 동의**를 클릭합니다. 3. 검색 상자에 `negotiate`를 입력합니다. ![Firefox의 Tableau Server 구성 페이지 예입니다.](/tableau/current/ko-kr/server/ko-kr/Img/kerberos_firefox.png) 4. **network.negotiate-auth.allow-non-fqdn**을 두 번 클릭한 다음 값을 **true**로 설정합니다. 5. **network.negotiate-auth.trusted-uris**를 두 번 클릭하고 Tableau Server의 FQDN(정규화된 도메인 이름)을 입력합니다. 예를 들어 `tableau.example.com`을 입력합니다. ### 참고 3: Mac OS X 데스크톱의 Chrome Chrome 설명서에 따르면, Mac에서 다음 명령을 사용하여 터미널 창에서 Chrome을 시작하면 Kerberos SSO를 사용할 수 있습니다. `open -a "Google Chrome.app" --args --auth-server-whitelist="tableauserver.example.com"` 여기서, `tableauserver.example.com`은 사용자 환경에 있는 Tableau Server의 URL입니다. 하지만 테스트에서 일관성 없는 결과가 발견되었습니다. 따라서 Mac에서 Kerberos SSO를 사용하려면 Safari 또는 Firefox를 사용하는 것이 좋습니다. 자세한 내용은 Chromium Projects 사이트에서 [HTTP authentication](http://www.chromium.org/developers/design-documents/http-authentication)(HTTP 인증)의 _Integrated Authentication_(통합 인증) 섹션을 참조하십시오. **참고**: 사용자는 여전히 Mac OS X의 Chrome을 사용하여 Tableau Server에 로그인할 수 있지만 사용자 이름 및 암호를 입력하라는 메시지가 나타날 수 있습니다(SSO가 작동하지 않을 수 있음). ### 참고 4: iOS의 모바일 Safari 또는 Tableau Mobile iOS에 Kerberos가 구성되어 있는 경우 Kerberos SSO가 지원됩니다. iOS 기기에 Kerberos 인증 구성 프로필이 설치되어 있어야 합니다. 이러한 구성 프로필은 대개 회사 IT 그룹에서 설치합니다. Tableau 지원 팀은 iOS 기기의 Kerberos 구성을 지원하지 않습니다. _Tableau Mobile 배포 가이드_에서 [인증 항목](https://help.tableau.com/current/mobile/mobile-admin/ko-kr/admin_mobile_sso.htm#kerberos-ios-and-tableau-server-only)을 참조하십시오. ### 참고 5: Android 플랫폼 Kerberos SSO는 Android 운영 체제의 Tableau Mobile 앱에서 지원되지 않습니다. Kerberos에 SSO가 사용자 이름 및 비밀번호 인증을 수락하지 못하는 경우를 대비한 대체 설정이 있는 경우 Android 기기와 Tableau Mobile 앱 또는 지원되는 모바일 브라우저를 사용하면 계속해서 Tableau Server에 연결할 수 있습니다. 이 시나리오에서는 Kerberos로 인증하는 대신 사용자가 Tableau Server에 액세스할 때 자격 증명을 입력하라는 메시지가 표시됩니다. ### 자세한 정보 - _Tableau Mobile 배포 가이드_: [Tableau Mobile에 대한 인증 및 액세스 제어](https://help.tableau.com/current/mobile/mobile-admin/ko-kr/admin_mobile_sso.htm) - [Tableau Server 기술 사양](https://www.tableau.com/ko-kr/products/techspecs#paragraph-id--211678)에서 _웹 브라우저_를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos 구성 Tableau Server에서 Kerberos를 사용하도록 구성할 수 있습니다. 이렇게 하면 조직에 있는 모든 응용 프로그램에 SSO(Single Sign-On) 환경을 제공할 수 있습니다. Kerberos를 사용하도록 Tableau Server를 구성하려면 먼저 환경이 [Kerberos 요구 사항](https://help.tableau.com/current/server/ko-kr/kerberos_requ.htm)을 충족하는지 확인해야 합니다. **참고:** Tableau Server에 대한 싱글 사인온용 Kerberos 제한 위임은 지원되지 않습니다. 데이터 소스용 제한 위임은 지원됩니다. 자세한 내용은 [Kerberos 요구 사항](https://help.tableau.com/current/server/ko-kr/kerberos_requ.htm)에서 SSO(Single-Sign On)를 참조하십시오. Kerberos를 구성하려면 먼저 Kerberos를 사용하도록 설정한 다음 사용자 인증을 위한 Keytab 파일을 지정해야 합니다. 지정한 Keytab 파일에는 사용자 인증을 위한 Tableau Server의 서비스 공급자 이름이 구성되어 있어야 합니다. 데이터 원본에 Kerberos 인증을 사용하는 경우 해당 자격 증명은 Tableau Server에서 Kerberos를 구성하는 동안 지정하는 단일 Keytab 파일에 포함되어야 합니다. 재해 복구 계획의 일부로, Tableau Server에서 떨어진 안전한 위치에 keytab 파일의 백업을 보관하는 것이 좋습니다. Tableau Server에 추가하는 keytab 파일은 클라이언트 파일 서비스에 의해 저장되고 다른 노드에 배포됩니다. 그러나 파일은 복구 가능한 형식으로 저장되지 않습니다. 자세한 내용은 [Tableau Server 클라이언트 파일 서비스](https://help.tableau.com/current/server/ko-kr/server_process_cfs.htm)를 참조하십시오. 1. 브라우저에서 TSM을 엽니다. https://:8850. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm)을 참조하십시오. 2. 구성 탭에서 ID 및 액세스를 클릭한 다음 인증 방법을 클릭합니다. 3. 인증 방법의 드롭다운 메뉴에서 Kerberos를 선택합니다. 4. Kerberos에서 SSO(Single Sign-On)에 Kerberos 사용을 선택합니다. 5. keytab 파일을 서버에 복사하려면 파일 선택을 클릭한 다음 컴퓨터의 파일을 찾아 선택합니다. ![Kerberos 구성 스크린샷](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-kerberos.png) 6. 구성 정보를 입력한 후 보류 중인 변경 내용 저장을 클릭합니다. 7. 페이지 맨 위에서 보류 중인 변경 내용을 클릭합니다. ![보류 중인 변경 내용이 있음을 나타내는 Tableau Server Manager 툴바입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-pending-changes-btn.png) 8. 변경 내용 적용 후 다시 시작을 클릭합니다. 1. 분산 클러스터 배포 환경에서 Tableau Server를 실행하는 경우 각 노드에 Keytab 파일을 수동으로 배포한 다음 사용 권한을 설정해야 합니다. Keytab 파일을 클러스터의 각 노드에서 동일한 디렉터리에 복사하십시오. 각 노드에 Keytab 파일을 복사하고 파일에 사용 권한을 설정한 후 한 노드에서 다음 TSM 명령을 실행합니다. 구성이 각 노드로 전파됩니다. 2. 다음 명령을 입력하여 Keytab 파일의 위치와 이름을 지정합니다. `tsm authentication kerberos configure --keytab-file ` 3. 다음 명령을 입력하여 Kerberos를 사용하도록 설정합니다. `tsm authentication kerberos enable` 4. `tsm pending-changes apply`를 실행하여 변경 내용을 적용합니다. 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## SSO 구성 확인 Tableau Server를 다시 시작한 후 다른 컴퓨터의 웹 브라우저에서 URL 창에 Tableau Server 이름을 입력하여 Kerberos 구성을 테스트합니다. ![비어 있는 웹 브라우저 창의 주소 표시줄에 "http://tableau\_server"가 표시되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/saml_browser.png) Tableau Server에 자동으로 인증되어야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos 데이터베이스 위임과 함께 SAML SSO 사용 Windows AD(Active Directory) 환경에서는 Kerberos 데이터베이스 위임을 통해 Tableau Server에 대한 SAML SSO(Single Sign-On)를 사용하도록 설정할 수 있습니다. 이렇게 하면 권한이 있는 사용자가 Tableau Server에 직접 액세스하고 게시된 통합 문서 및 데이터 원본에 정의된 기초 데이터에도 액세스할 수 있습니다. ## 프로세스 개요 ![SAML을 통한 Tableau Server 인증과 Kerberos를 통한 기초 데이터 액세스에 대한 개념 이미지](/tableau/current/ko-kr/server/ko-kr/Img/saml-auth-kerb-db-delegation.png "Kerberos를 통해 작동하는 SAML의 개념 이미지") 일반적인 시나리오: 1. Tableau 분석가가 Tableau Server에 대시보드를 게시합니다. 이 대시보드에는 Kerberos 자격 증명을 수락하도록 구성된 Hadoop 클러스터에 대한 연결이 포함되어 있습니다. 통합 문서 게시자는 검토를 위해 동료에게 링크를 보냅니다. 2. 동료가 링크를 클릭하면 Tableau Server가 SAML SSO 프로세스를 통해 사용자를 인증합니다. Tableau Server는 사용자의 인증 스키마를 살펴보고 허용되는 경우 Tableau Server keytab을 사용하여 사용자 대신 기초 데이터베이스에 액세스합니다. 그런 다음 사용자에게 보기 권한이 있는 Hadoop 데이터로 대시보드를 채웁니다. ## SAML 및 Kerberos를 사용하도록 Tableau Server 구성 SAML 및 Kerberos를 개별적으로 사용하도록 설정하는 프로세스를 완료하면 SAML 및 Kerberos를 기본적으로 함께 사용할 수 있습니다. 1. [서버 전체 SAML 구성](https://help.tableau.com/current/server/ko-kr/config_saml.htm)에 설명된 대로 SAML을 사용하도록 Tableau Server를 구성합니다. 2. [Kerberos 위임 사용](https://help.tableau.com/current/server/ko-kr/kerberos_delegation.htm) 및 관련 문서에 설명된 대로 Kerberos 자격 증명을 수락하도록 Tableau Server 및 기초 데이터베이스를 구성합니다. [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos 문제 해결 이 항목의 문제 해결 제안 사항은 서버의 SSO(Single Sign-On) 관련 문제와 위임된 데이터 원본 관련 문제로 나뉩니다. ## Tableau Server에 대한 Single Sign-On Kerberos SSO 환경에서 웹 브라우저 또는 Tableau Desktop에서 Tableau Server에 로그인하는 사용자에게 Tableau Server가 자동으로 (Single Sign-On을 사용하여) 로그인할 수 없다는 메시지가 표시될 수 있습니다. 이것은 Tableau Server 사용자 이름 및 암호를 제공해야 한다는 의미입니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/kerb_auth_failed.png) ### 클라이언트 컴퓨터에서 로그인 오류 문제 해결 - **사용자 이름 및 암호 입력** — Tableau Server에 대한 사용자의 일반 액세스 권한을 확인하려면 사용자의 이름 및 암호를 입력하여 로그인합니다. 이러한 자격 증명이 실패하면 사용자가 Tableau Server의 사용자가 아닐 수 있습니다. Kerberos SSO가 작동하려면 사용자가 Tableau Server에 액세스할 수 있어야 하며 Active Directory에 의해 TGT(티켓 권한 부여 티켓)가 부여되어야 합니다(이 목록의 뒷부분에 있는 **TGT** 항목에 설명되어 있음). - **다른 사용자의 SSO 자격 증명 확인** — 다른 사용자 계정을 사용하여 Tableau Server에 SSO로 연결합니다. 모든 사용자에게 문제가 발생하는 경우 Kerberos 구성에 문제가 있는 것일 수 있습니다. - **서버 컴퓨터 이외의 컴퓨터 사용** — localhost에 있는 Tableau Server에 로그인한 경우 Kerberos SSO가 작동하지 않습니다. 클라이언트는 Tableau Server 컴퓨터가 아닌 컴퓨터에서 연결해야 합니다. - **IP 주소가 아닌 서버 이름 사용** — Tableau Server 이름으로 IP 주소를 입력하는 경우 Kerberos SSO가 작동하지 않습니다. 또한, Tableau Server 액세스에 사용하는 서버 이름은 Kerberos 구성에 사용된 이름과 일치해야 합니다(아래에서 **[키 테이블](#keytable)** 항목 참조). - **클라이언트에 TGT가 있는지 확인** — 클라이언트 컴퓨터에는 Active Directory 도메인의 TGT(티켓 권한 부여 티켓)가 있어야 합니다. 대리인이 티켓을 부여하는 제한 위임은 지원되지 않습니다. 클라이언트 컴퓨터에 TGT가 있는지 확인하려면 다음을 수행합니다. - Windows에서 명령 프롬프트를 열고 `klist tgt`를 입력합니다. - Mac에서 터미널 창을 열고 `klist`를 입력합니다. 출력에는 Tableau Server에 인증을 시도하는 사용자/도메인에 대한 TGT가 표시되어야 합니다. 다음과 같은 경우 클라이언트 컴퓨터에 TGT가 없을 수 있습니다. - 클라이언트 컴퓨터가 VPN 연결을 사용합니다. - 클라이언트 컴퓨터가 작업에 사용되지 않는 비작업 컴퓨터와 같이 도메인에 참여하지 않은 컴퓨터입니다. - 사용자가 로컬(비도메인) 계정으로 컴퓨터에 로그인했습니다. - 컴퓨터가 Active Directory를 네트워크 계정 서버로 사용하지 않는 Mac 컴퓨터입니다. - **브라우저 버전 및 설정 확인** — 웹 브라우저 로그인의 경우 브라우저가 Kerberos를 지원하는지 확인하고 필요한 경우 올바르게 구성되었는지 확인합니다. - Internet Explorer(IE)와 Chrome은 Windows에서 별도의 설정 없이 즉시 사용할 수 있습니다. - Safari는 Mac에서 별도의 설정 없이 즉시 사용할 수 있습니다. - Firefox에는 추가 구성이 필요합니다. 자세한 내용은 [Kerberos SSO를 위한 Tableau 클라이언트 지원](https://help.tableau.com/current/server/ko-kr/kerberos_browser.htm)을 참조하십시오. ### 서버에서 로그인 오류 문제 해결 클라이언트 컴퓨터에서 문제를 해결할 수 없는 경우 그 다음으로 Tableau Server를 실행하는 컴퓨터에서 문제를 해결해봐야 합니다. 관리자는 요청 ID를 사용하여 Tableau Server의 Apache 로그에서 사용자의 로그인 시도를 찾을 수 있습니다. - **로그 파일** - Apache error.log에서 실패한 로그인 시도의 정확한 시간/날짜를 통해 오류를 확인합니다. - ziplog 아카이브에서 이 로그는 \\httpd 폴더 안에 있습니다. - Tableau Server에서 이 로그는 \\data\\tabsvc\\logs\\httpd\\ 폴더에 있습니다. - **키 테이블 항목** — error.log 항목에 “No key table entry matching HTTP/..@” 메시지가 포함됩니다. 예를 들면 다음과 같습니다. `[Fri Oct 24 10:58:46.087683 2014] [:error] [pid 2104:tid 4776] [client 10.10.1.62:56789] gss_acquire_cred() failed: Unspecified GSS failure. Minor code may provide more information (, No key table entry found matching HTTP/servername.domain.com@)` 이 오류는 다음과 같은 항목의 불일치로 인해 발생합니다. - **Tableau Server URL** - 클라이언트 컴퓨터가 서버에 액세스하기 위해 사용한 URL 사용자가 Tableau Desktop 또는 브라우저 주소 표시줄에 입력하는 이름입니다. 짧은 이름(`http://servername`) 또는 정규화된 도메인 이름(`http://servername.domain.com`)이 될 수 있습니다. ![인터넷 브라우저 주소 표시줄에 표시되는 Tableau Server 이름의 예입니다.](/tableau/current/ko-kr/server/ko-kr/Img/kerb_servername_1.png) ![Tableau Server의 로그인 대화 상자에 표시되는 Tableau Server 이름의 예입니다.](/tableau/current/ko-kr/server/ko-kr/Img/kerb_servername_2.png) - 서버 IP 주소에 대한 **DNS 역조회**. IP 주소를 사용하여 DNS 이름을 조회합니다. 명령 프롬프트에서 다음을 입력합니다. `ping servername` 서버에 대한 ping을 실행해 반환된 IP 주소를 사용하여 다음과 같이 DNS 역조회를 수행합니다. `nslookup ` nslookup 명령은 IP 주소에 대한 네트워크 정보를 반환합니다. 응답의 _Non-authoritative answer_ 부분에서 FQDN(정규화된 도메인 이름)이 다음과 같은 구성된 값과 일치하는지 확인합니다.  - Kerberos .keytab 파일 - 서버에 대한 서비스 사용자 이름(SPN) 이러한 값 구성에 대한 자세한 내용은 [Keytab 요구 사항 이해](https://help.tableau.com/current/server/ko-kr/kerberos_keytab.htm)를 참조하십시오. ### Kerberos 구성 스크립트 확인 환경 변수에 대한 keytab 파일을 생성하는 데 사용한 ktpass 명령을 수정해야 할 수도 있습니다. 기술 자료 문서 [Unable to Generate Kerberos Script Configuration for Tableau Server](https://kb.tableau.com/articles/issue/unable-to-generate-kerberos-script-configuration-for-tableau-server?lang=ko-kr)(Tableau Server용 Kerberos 스크립트 구성을 생성할 수 없음)의 문제 해결 단계를 검토하십시오. ## 데이터 원본 SSO ### 위임된 데이터 원본 액세스 실패 vizqlserver 로그 파일에서 "workgroup-auth-mode"를 확인합니다. - ziplog 아카이브에서 이 로그는 \\vizqlserver\\Logs 폴더 안에 있습니다. - Tableau Server에서 이 로그는 \\data\\tabsvc\\vizqlserver\\Logs 폴더에 있습니다. 로그 파일에서 "workgroup-auth-mode"를 찾습니다. 여기에 "kerberos-impersonate" not "as-is"가 표시되어야 합니다. ### Kerberos 위임 다중 도메인 구성 Tableau Server는 다른 Active Directory 도메인의 사용자를 위임할 수 있습니다. 데이터베이스가 MIT Kerberos를 사용하는 경우 데이터베이스 사용자 매핑에 맞게 Kerberos 계정을 조정해야 할 수 있습니다. 즉, 연결하는 사용자가 속한 각 Kerberos 영역에 대한 규칙으로 krb5.conf를 업데이트해야 합니다. 섹션에서 `auth_to_local` 태그를 `[realms]` 사용하여 계정 이름을 로컬 사용자 이름에 매핑합니다. 예를 들어 Kerberos 계정이 `jsmith@EXAMPLE.LAN`인 사용자 `EXAMPLE\jsmith`를 고려합니다. 이 경우 Tableau Server는 위임된 사용자 `jsmith@EXAMPLE`을 지정합니다. Tableau Server는 Active Directory 레거시 도메인 별칭을 Kerberos 영역으로 사용하게 됩니다. 대상 데이터베이스에 사용자 `jsmith@EXAMPLE.LAN`을 데이터베이스 사용자 `jsmith`에 매핑하는 다음과 같은 규칙이 이미 있을 수 있습니다. `EXAMPLE.LAN = {    RULE:[1:$1@$0](https://help.tableau.com/current/server/ko-kr/.*@EXAMPLE.LAN)s/@.*//    DEFAULT }` 위임을 지원하려면 jsmith@EXAMPLE를 데이터베이스 사용자에 매핑하는 또 다른 규칙을 추가해야 합니다. `EXAMPLE.LAN = {    RULE:[1:$1@$0](https://help.tableau.com/current/server/ko-kr/.*@EXAMPLE.LAN)s/@.*//    RULE:[1:$1@$0](https://help.tableau.com/current/server/ko-kr/.*@EXAMPLE)s/@.*//    DEFAULT }` 자세한 내용은 MIT Kerberos 설명서 항목에서 [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)를 참조하십시오. ### 교차 도메인 제한 위임 KDC가 Windows 2012 이전의 Windows Server에서 실행되고 있는 일부 교차 도메인 시나리오에서 위임이 실패할 수 있습니다. 이 경우 다음과 같은 오류가 나타날 수 있습니다. - SQL Server 네트워크 인터페이스: 시스템이 인증 요청을 처리하는 도메인 컨트롤러에 연결할 수 없습니다. 나중에 다시 시도하세요. - SQL Server Native Client: SSPI 컨텍스트를 생성할 수 없습니다. - 도메인 컨트롤러가 `KRB-ERR-POLICY error with a status STATUS_CROSSREALM_DELEGATION_FAILURE (0xc000040b)`를 반환합니다. 교차 도메인은 Tableau Server가 데이터 원본과 다른 도메인에서 다른 서비스 계정으로 실행되고 있는 시나리오를 나타냅니다. 예: - Tableau Server는 DomainA 서비스 계정을 사용하여 DomainA에서 실행됩니다. - SQL Server는 DomainB 서비스 계정을 사용하여 DomainB에서 실행됩니다. 기존 제한 위임은 두 서버가 모두 동일한 도메인에 있는 경우에만 작동합니다. 사용자는 다른 도메인에서 들어올 수 있습니다. 위에 나와 있는 오류가 표시되는 경우 이 시나리오를 사용하도록 설정하려면 Active Directory 관리자가 계정 위임 시 구성한 모든 기존 제한 위임을 제거해야 합니다. 위임 제거는 Active Directory 관리 도구를 사용하거나 Active Directory 속성 `msDS-AllowedToDelegateTo.`와 연결된 값을 제거하여 수행할 수 있습니다. 교차 도메인 위임과 함께 기존 단일 도메인 위임을 유지하려면 둘 모두 리소스 기반 제한 위임을 사용하여 구성해야 합니다. Kerberos 및 제한 위임에 대한 자세한 내용은 Microsoft 항목 [Kerberos 제한 위임 개요(영어)](https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2012-R2-and-2012/jj553400\(v=ws.11\))를 참조하십시오. ### 웹 작성 Kerberos 위임을 지원하지 않는 웹 작성 시나리오는 두 가지입니다. "웹에서 데이터에 연결" 및 "웹에서 데이터 원본 만들기" 기능은 아직 위임을 지원하지 않습니다. 구체적으로, 웹 작성에서 Kerberos를 사용하는 데이터 원본을 만드는 경우 데이터 원본은 '서비스 계정' 서비스 계정 인증을 사용하게 됩니다. Kerberos 위임을 사용하여 데이터 원본을 만들려면 Tableau Desktop을 사용하여 게시해야 합니다. '서비스 계정' 서비스 계정에 대한 자세한 내용은 ['서비스 계정' 서비스 계정으로 데이터 액세스](https://help.tableau.com/current/server/ko-kr/runas_access.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos 요구 사항 Active Directory 환경에서 실행되는 Tableau Server에 대해 Kerberos 인증을 구성할 수 있습니다. ## 일반 요구 사항 - 외부 부하 분산 장치/프록시 서버: ELB(외부 부하 분산 장치) 또는 프록시 서버가 있는 환경에서 Tableau Server에 Kerberos를 사용하려는 경우 먼저 ELB나 프록시 서버를 설정한 후 Tableau Server 구성 유틸리티에서 Kerberos를 구성해야 합니다. 자세한 내용은 [Tableau Server에 대한 프록시 및 부하 분산 장치 구성](https://help.tableau.com/current/server/ko-kr/proxy.htm)을 참조하십시오. - iOS 브라우저 지원: 사용자의 Kerberos ID를 지정하는 구성 프로필이 설치되어 있으면 iOS 사용자가 Mobile Safari에서 Kerberos 인증을 사용할 수 있습니다. Tableau Mobile 도움말에서 [Kerberos를 지원하도록 iOS 기기 구성](https://help.tableau.com/current/mobile/mobile-admin/ko-kr/admin_mobile_sso.htm)을 참조하십시오. Kerberos SSO의 브라우저 지원에 대한 자세한 내용은 [Kerberos SSO를 위한 Tableau 클라이언트 지원](https://help.tableau.com/current/server/ko-kr/kerberos_browser.htm)을 참조하십시오. - Tableau Server는 데이터 원본 인증에 대한 제한 위임을 지원합니다. 이 시나리오에서 Tableau 데이터 액세스 계정에는 대상 데이터베이스 SPN에 대한 권한이 부여됩니다. 비제한 위임은 지원되지 않습니다. - 지원되는 데이터 원본(SQL Server, MSAS, PostgreSQL, Hive/Impala 및 Teradata)에 Kerberos 인증이 구성되어 있어야 합니다. - 사용자 인증을 위한 Tableau Server의 서비스 공급자 이름으로 구성된 Keytab 파일이 필요합니다. 자세한 내용은 [Keytab 요구 사항 이해](https://help.tableau.com/current/server/ko-kr/kerberos_keytab.htm#kerb)를 참조하십시오. - Tableau Server 2021.2.25, 2021.3.24, 2021.4.19, 2022.1.15, 2022.3.7 및 2023.1.3(이상)부터 keytab 파일이 AES-128 또는 AES-256 암호로 생성되었는지 확인하십시오. RC4 및 3DES 암호화는 더 이상 지원되지 않습니다. 자세한 내용은 Tableau 기술 자료의 ["Tableau Server가 자동으로 인증할 수 없습니다."](https://kb.tableau.com/articles/Issue/tableau-server-could-not-authenticate-you-automatically-error-occurs-when-attempting-to-automatically-login-using-kerberos-sso-after-tableau-server-upgrade?lang=ko-kr)를 참조하십시오. ## Active Directory 요구 사항 Active Directory 환경에서 Tableau Server를 Kerberos와 함께 실행하려면 다음 요구 사항을 충족해야 합니다. - Tableau Server가 인증에 AD(Active Directory)를 사용해야 합니다. - Kerberos를 사용하여 Tableau Server에 연결하려면 도메인이 AD 2003 이상 도메인이어야 합니다. - 스마트 카드 지원: 사용자가 스마트 카드를 사용하여 워크스테이션에 로그인한 경우 스마트 카드가 지원되며, 이 로그인으로 Active Directory에서 사용자에게 Kerberos TGT를 부여합니다. - SSO(Single-Sign On): 컴퓨터에 로그인할 때 사용자에게 Active Directory의 Kerberos TGT(티켓 허용 티켓)가 부여되어야 합니다. 이는 도메인으로 결합된 Windows 컴퓨터의 표준 동작이며 네트워크 계정 서버로 AD를 사용하는 Mac 컴퓨터의 표준 동작입니다. Mac 컴퓨터와 Active Directory를 사용하는 방법에 대한 자세한 내용은 Apple Knowledge Base에서 [네트워크 계정 서버에 Mac 연결하기](https://support.apple.com/guide/mac-help/join-your-mac-to-a-network-account-server-mh27627/mac)를 참조하십시오. ### Kerberos 위임 Kerberos 위임 시나리오의 요구 사항은 다음과 같습니다. - 도메인이 AD 2003 이상인 경우 단일 도메인 Kerberos 위임이 지원됩니다. 사용자, Tableau Server 및 백엔드 데이터베이스는 동일한 도메인에 있어야 합니다. - 도메인이 AD 2008인 경우 제한적인 교차 도메인이 지원됩니다. 이 경우 다음 조건이 충족되면 다른 도메인의 사용자를 위임할 수 있습니다. Tableau Server와 백엔드 데이터베이스는 동일한 도메인에 있어야 하며 Tableau Server가 상주하는 도메인과 사용자의 도메인 간에 양방향 트러스트가 필요합니다. - 도메인이 2012 이상인 경우 전체 교차 도메인 위임이 지원됩니다. AD 2012 R2는 제한 위임을 구성할 수 있는 대화 상자를 제공하므로 수동 구성을 해야 하는 비 R2 2012보다 선호됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # Kerberos 위임 사용 Kerberos 위임을 사용하면 Viewer(뷰어) 대신 쿼리를 실행하기 위해 통합 문서 Viewer(뷰어)의 Kerberos 자격 증명을 Tableau Server가 사용하도록 설정할 수 있습니다. 이 방법은 다음과 같은 상황에 유용합니다. - 데이터에 액세스하는 사용자를 알아야 합니다. 해당 Viewer(뷰어)의 이름은 데이터 원본의 액세스 로그에 표시됩니다. - 데이터 원본에 행 수준 보안이 설정되어 있습니다. 이 경우 다양한 사용자들이 다양한 행에 액세스할 수 있습니다. ## 지원되는 데이터 원본 Tableau는 다음 데이터 원본에서 Kerberos 위임을 지원합니다. - Cloudera: Hive/Impala - Denodo - Hortonworks - MSAS - Oracle - PostgreSQL - Spark - SQL Server - Teradata - Vertica - TIBCO ## 요구 사항 Kerberos 위임에는 Active Directory가 필요합니다. - Active Directory를 사용하도록 [Tableau Server ID 저장소](https://help.tableau.com/current/server/ko-kr/plan_identity_store.htm)를 구성해야 합니다. - Tableau Server가 설치된 컴퓨터는 Active Directory 도메인에 가입해야 합니다. - MIT Kerberos KDC는 지원되지 않습니다. - 도메인 계정을 Tableau Server에서 '서비스 계정' 서비스 계정으로 구성해야 합니다. 자세한 내용은 ['서비스 계정' 서비스 계정 변경](https://help.tableau.com/current/server/ko-kr/runas_acct.htm)을 참조하십시오. 사용자가 Tableau Server 및 데이터 원본과 다른 Active Directory 도메인에 있는 경우 도메인 신뢰 관계를 구성해야 합니다. [Active Directory 배포를 위한 도메인 신뢰 요구 사항](https://help.tableau.com/current/server/ko-kr/runas_domain.htm)을 참조하십시오. - 위임이 구성됩니다. 대상 데이터베이스 SPN(서비스 사용자 이름)에 '서비스 계정' 서비스 계정에 대한 위임 권한을 부여합니다. '서비스 계정' 서비스 계정은 시작한 원본 사용자를 대신하여 리소스에 액세스하는 권한을 위임받습니다. - Tableau Server 2020.2 이상에서 with an JDBC 기반 커넥터를 사용하는 Oracle 데이터 원본으로 위임을 구성하는 경우 [JDBC 커넥터에서 Kerberos 위임 사용](https://help.tableau.com/current/server/ko-kr/kerberos_delegation_jdbc.htm)을 참조하십시오. Tableau 2020.2부터 Oracle 커넥터는 JDBC를 사용합니다. ## 웹 작성 및 사용자 Kerberos 인증 특정 대상에 대해 데이터에 연결을 구성할 때 기본 인증 방법으로 통합 인증 또는 Windows 인증을 선택할 수 있습니다. 그러나 웹 작성 시나리오의 경우 기본 동작은 대신 Kerberos 서비스 계정("서비스 계정" 계정)을 사용하는 것입니다. Kerberos 위임을 사용하는 웹 작성 시나리오에서 사용자 자격 증명을 사용하도록 설정하려면 TSM을 사용하여 추가로 구성해야 합니다. 다음 명령을 실행합니다. tsm configuration set -k native\_api.WebAuthoringAuthModeKerberosDelegation -v true tsm pending-changes apply 이렇게 구성한 후 웹 작성을 통한 통합 인증을 선택하면 Kerberos 위임이 기본 작업이 됩니다. 그러나 이 설정은 콘텐츠 작성자가 서비스 계정에 액세스하는 것을 차단하지 않습니다. Creator는 Tableau Desktop 또는 기타 방법을 사용하여 '서비스 계정' 서비스 계정과 연결되는 콘텐츠를 계속 게시할 수 있습니다. '서비스 계정' 서비스 계정에 대한 자세한 내용은 ['서비스 계정' 서비스 계정으로 데이터 액세스](https://help.tableau.com/current/server/ko-kr/runas_access.htm)를 참조하십시오. ## 구성 프로세스 이 섹션에서는 Kerberos 위임을 사용하도록 설정하는 프로세스의 예를 제공합니다. 또한 이 시나리오에는 구성 요소 간의 관계를 쉽게 이해할 수 있는 이름이 사용됩니다. 1. Tableau Server의 모든 노드에서 '서비스 계정 사용자'가 운영 체제의 일부로 작동하도록 구성합니다. 자세한 내용은 [운영 체제로 작동할 '서비스 계정' 서비스 계정 설정](https://help.tableau.com/current/server/ko-kr/runas_os.htm)을 참조하십시오. 2. Tableau Server가 데이터베이스 호출을 시작한 사용자를 대신하여 위임하려면 Kerberos 서비스 티켓이 필요합니다. 지정된 데이터베이스에 위임하는 데 사용할 도메인 계정을 만들어야 합니다. 이 계정을 '서비스 계정' 서비스 계정이라고 합니다. 이 항목에서 위임/’서비스 계정’ 계정으로 구성된 예제 사용자는 `tabsrv@example.com`입니다. 계정은 사용자 도메인에 연결된 Windows Server의 Active Directory 사용자 및 컴퓨터로 구성되어야 합니다. - ‘서비스 계정’ 서비스 계정의 **속성** 페이지를 열고 **위임** 탭을 클릭한 다음 **지정한 서비스에 대한 위임용으로만 이 사용자 트러스트** 및 **모든 인증 프로토콜 사용**을 선택합니다. 3. 다음 TSM 명령을 실행하여 Kerberos 위임을 사용하도록 설정합니다. `tsm configuration set -k wgserver.delegation.enabled -v true` 4. 다음 TSM 명령을 실행하여 변경 사항을 Tableau Server에 적용합니다. `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. 5. (선택 사항) MIT Kerberos 사용자 형식을 사용하도록 Tableau Server를 구성합니다. 기본적으로 Tableau Server는 Active Directory 짧은 이름을 사용하여 Kerberos 사용자를 생성합니다. 예를 들어 Tableau Server가 `EXAMPLE.COM`(짧은 이름 `EXAMPLE`)의 사용자에 대한 Kerberos 위임을 수행하는 경우 사용자 이름은 `user@example`입니다. 데이터베이스가 Linux에서 실행되는 경우 krb5.conf에서 `auth_to_local` 매핑을 조정해야 할 수 있습니다. krb5.conf 파일 편집에 대한 자세한 내용은 [Kerberos 위임 다중 도메인 구성](https://help.tableau.com/current/server/ko-kr/kerberos_trouble.htm#multi)을 참조하십시오. 또는 다음 명령을 실행하여 Kerberos 사용자에 대해 전체 도메인 이름을 사용하도록 Tableau Server를 구성할 수 있습니다. tsm configuration set -k native\_api.protocol\_transition\_a\_d\_short\_domain -v false --force-keys tsm configuration set -k native\_api.protocol\_transition\_uppercase\_realm -v true --force-keys tsm pending-changes apply 6. 데이터 연결에 대해 위임을 사용하도록 설정합니다. - **SQL Server** - Tableau 커뮤니티에서 [SQL Server에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/question/0D54T00000CWcplSAD/enabling-kerberos-delegation-for-sql-server)을 참조하십시오. - **MSAS** - Tableau 커뮤니티에서 [MSAS에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/question/0D54T00000G54sYSAR/enabling-kerberos-delegation-for-msas)을 참조하십시오. - **PostgreSQL** - Tableau 커뮤니티에서 [PostgreSQL에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/question/0D54T00000G54ssSAB/enabling-kerberos-delegation-for-postgresql)을 참조하십시오. - **Teradata** - Tableau 커뮤니티에서 [Teradata에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/question/0D54T00000G54tCSAR/enabling-kerberos-delegation-for-teradata)을 참조하십시오. - **Oracle** - Tableau 커뮤니티에서 [Oracle에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/news/a0A4T000002O42jUAC/enable-kerberos-delegation-for-oracle)을 참조하십시오. - **Cloudera** - Tableau 커뮤니티에서 [Hive/Impala에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/question/0D54T00000CWdINSA1/enable-delegation-for-hiveimpala)을 참조하십시오. - **Vertica** - Tableau 커뮤니티에서 [Vertica에서 Kerberos 위임 사용(영문)](https://community.tableau.com/s/question/0D54T00000CWd5sSAD/enabling-kerberos-delegation-for-vertica)을 참조하십시오. - **TIBCO** - TIBCO 데이터 시각화 관리 가이드에서 [TDV와 함께 사용하도록 Kerberos 구성(영문)](https://docs.tibco.com/pub/tdv/8.8.0/doc/html/en-US/StudioHelp/index.html#Administration/Configuring_Kerberos_for_Use_with_TDV.html)을 참조하십시오. ## 참고 항목 [Kerberos 문제 해결](https://help.tableau.com/current/server/ko-kr/kerberos_trouble.htm) ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # kerberosSettings 엔터티 Kerberos 인증을 구성하기 전에 [Kerberos 요구 사항](https://help.tableau.com/current/server/ko-kr/kerberos_requ.htm)을 검토하십시오. 아래의 구성 파일 템플릿을 사용하여 json 파일을 만듭니다. 옵션을 적절한 값으로 채운 후 다음 명령으로 json 파일을 전달하고 설정을 적용합니다. `tsm settings import -f /path/to/file.json` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 구성 템플릿 이 구성 템플릿을 사용하여 Kerberos 설정을 구성합니다. **중요:** 모든 엔터티 옵션은 대/소문자를 구분합니다. 구성 파일, 엔터티 및 키에 대한 자세한 설명은 [구성 파일 예제](https://help.tableau.com/current/server/ko-kr/config_file_example.htm)를 참조하십시오. Kerberos 인증의 초기 구성을 마친 후 [tsm authentication kerberos ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMKerb) 하위 범주를 사용하여 추가 값을 설정합니다. { "configEntities": { "kerberosSettings": { "\_type": "kerberosSettingsType", "enabled": "true", "keytabFile": "/path/to/keytab\_file" } } } ## 구성 파일 참조 다음 목록에는 `"kerberosSettings"` 엔터티 집합과 함께 포함할 수 있는 모든 옵션이 나열되어 있습니다. 옵션 값 enabled 옵션: `true` 또는 `false` Kerberos 인증을 사용하도록 설정합니다. keytabFile 필수 항목입니다. 올바른 Kerberos keytab 파일의 경로입니다. dBClasses 전역 자격 증명에 대한 쉼표로 구분된 데이터베이스 클래스 목록입니다. Cloudera 데이터 원본에 연결하는 경우 필요할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Keytab 요구 사항 이해 Kerberos 인증은 keytab 파일이라는 특수 형식의 파일에 저장된 자격 증명을 사용합니다. Tableau Server 배포를 위해 keytab 파일을 생성해야 할 수도 있습니다. 이 항목에서는 Tableau Server가 일반적인 조직의 다양한 서비스에 액세스하는 데 사용하는 keytab 파일에 대해 설명합니다. 다음 서비스에 통합하기 위해 Tableau Server용 keytab을 생성해야 할 수도 있습니다. - Windows Active Directory의 사용자 인증(SSO) - 데이터 원본 위임 - 운영 체제 - 디렉터리 서비스 **중요:** Tableau Server 2021.2.25, 2021.3.24, 2021.4.19, 2022.1.15, 2022.3.7 및 2023.1.3(이상)부터 keytab 파일이 AES-128 또는 AES-256 암호로 생성되었는지 확인하십시오. RC4 및 3DES 암호화는 더 이상 지원되지 않습니다. 자세한 내용은 Tableau 기술 자료의 ["Tableau Server가 자동으로 인증할 수 없습니다."](https://kb.tableau.com/articles/Issue/tableau-server-could-not-authenticate-you-automatically-error-occurs-when-attempting-to-automatically-login-using-kerberos-sso-after-tableau-server-upgrade?lang=ko-kr)를 참조하십시오. 조직에 ID, 인증 및/또는 보안을 처리하는 IT 전문가가 있는 경우 해당 전문가와 협력하여 Tableau Server 배포를 위한 적절한 keytab을 생성하기 위한 계획을 수립해야 합니다. ## Windows Active Directory의 사용자 인증(SSO) Active Directory를 Tableau Server의 ID 저장소로 사용하고 사용자가 Kerberos SSO로 인증하도록 하려면 Tableau Server용 keytab 파일을 생성해야 합니다.
Tableau 실행 위치...keytab 수동 생성 여부
Active Directory 도메인의 Windows예
Active Directory 도메인의 Linux예
Active Directory가 아닌 환경의 Windows 또는 LinuxKerberos SSO는 지원되는 시나리오가 아닙니다.
다음 추천 항목을 따르십시오(Tableau Server의 Windows 및 Linux 버전인 경우). - 디렉터리에 Tableau Server용 서비스 계정을 만듭니다. - 특별히 Tableau Server 서비스 계정을 위한 keytab을 만듭니다. 컴퓨터 계정/OS에서 인증에 사용하는 keytab 파일을 다시 사용하지 마십시오. 위의 시나리오에서 디렉터리 인증에 사용하는 것과 동일한 keytab을 Kerberos SSO용으로 사용할 수 있습니다. - Active Directory에서 Tableau Server 서비스를 위한 SPN(서비스 사용자 이름)을 만들어야 합니다. - 다음 섹션의 배치 파일을 사용하여 SPN 및 keytab 파일을 만듭니다. - SPN을 만들었으면 [Kerberos 구성](https://help.tableau.com/current/server/ko-kr/config_kerberos.htm)에 설명된 대로 keytab 파일을 업로드합니다. ### 배치 파일: Active Directory에서 SPN 설정 및 keytab 만들기 배치 파일을 사용하여 SPN(서비스 사용자 이름)을 설정하고 keytab 파일을 만들 수 있습니다. 이러한 작업은 Active Directory에서 실행되는 Tableau Server(Windows 또는 Linux 기반)에 대해 Kerberos SSO를 사용하도록 설정하는 프로세스의 일부입니다. 이전 버전의 Tableau Server(2018.2 이전)에서는 Tableau Server 구성 유틸리티에서 구성 스크립트를 생성했습니다. 구성 스크립트를 생성하려면 다음 배치 파일의 내용을 복사하여 텍스트 파일에 붙여 넣으십시오. 배치 파일은 Tableau Server를 위한 SPN(서비스 사용자 이름)을 만들고 파일에 지정한 사용자에 대한 keytab 파일을 만듭니다. 파일 내용에 나와 있는 지침을 따르십시오. 파일 사용자 지정을 마쳤으면 .bat 파일로 저장합니다. 이 파일은 도메인 관리자가 Active Directory 도메인에서 실행해야 하며, 관리자에게 파일에 지정한 계정의 서비스 계정 비밀번호를 묻는 메시지가 표시됩니다. 이 배치 파일은 Windows [set](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/set_1), [setspn](http://technet.microsoft.com/en-us/library/cc731241\(WS.10\).aspx) 및 [ktpass](https://docs.microsoft.com/ko-kr/windows-server/administration/windows-commands/ktpass) 명령을 사용합니다. **참고**: 아래 배치 파일에는 설명이 포함되어 있습니다. 하지만 Kerberos와 keytab 파일 생성에 대한 경험이 없는 경우 계속 진행하기 전에 Microsoft 블로그 게시물 [All you need to know about Keytab files](https://blogs.technet.microsoft.com/pie/2018/01/03/all-you-need-to-know-about-keytab-files/)(Keytab 파일에 대해 알아야 할 모든 것)를 읽는 것이 좋습니다. 조직의 환경적 세부 정보에 ktpass 명령의 추가 구성이 필요할 수 있습니다. 예를 들어, `/crypto` 매개 변수에 대해 설정할 항목을 결정해야 합니다. KDC에 필요한 단일 `/crypto` 값을 지정하는 것이 좋습니다. `/crypto` 매개 변수로 지원되는 값의 전체 목록에 대해서는 Microsoft 문서 [ktpass](https://docs.microsoft.com/ko-kr/windows-server/administration/windows-commands/ktpass)를 참조하십시오. ### SPN 및 keytab 배치 파일 내용 **Tableau Server 2022.3, 2022.1.8, 2021.4.12, 2021.3.17, 2021.2.18, 2021.1.20 및 2020.4.23 이상의 경우** ``` @echo off setlocal EnableDelayedExpansion REM ******* REM This script generates the Service Principal Names (SPNs) and keytab files required for REM Kerberos SSO with Apache. REM This script executes set, setspn, and ktpass commands included in any Windows Server REM Operating System from 2003 on. REM Before running this script you must enter configuration information for the setspn and REM ktpass commands. REM Elements that require your configuration information are enclosed in as such: REM ! -- and --!. REM After you customize this file, save it as a .bat file, and run on a domain-joined REM computer. REM This script must be run by a Domain admin. REM ********** REM The following set command will prompt the domain admin for credentials of the REM Tableau Server service account. REM This account must be a valid domain user account. REM If the password contains a literal \" (blackslash - double quote), all backslashes REM immediately before the double quote must be REM duplicated when typed for the password to work, e.g. if password contains REM \" replace with \\", if passwords contains \\" replace with \\\\" set /p adpass= "Enter password for the Tableau Server service account." set adpass=!adpass:"=\"! REM ********** REM The following setspn commands create the SPN in the domain. REM More information on setspn can be found here: REM http://technet.microsoft.com/en-us/library/cc731241(WS.10).aspx REM Enter the canonical FQDN and the host names for Tableau Server followed by the REM Tableau Server service account name. REM Use this syntax: HTTP/hostname domain\service_account_name. REM The example below shows syntax for a computer named "tableau01" in the "example.lan" REM domain, with service account, "tab-serv-account": REM setspn -s HTTP/tableau01 example\tab-serv-account REM setspn -s HTTP/tableau01.example.lan example\tab-serv-account REM DNS and AD are not case sensitive, but the keytab files are. Verify that host names REM match letter case as stored in DNS. REM Use Windows Server's DNS Manager utility to verify host name case. REM ********** echo Creating SPNs... setspn -s HTTP/!--replace with canonical host name and service account --! setspn -s HTTP/!--replace with canonical FQDN and service account --! REM ********** REM The following commands create the keytab file in the same directory where the REM bat file is run. More information on ktpass can be found here: REM https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/ktpass REM Note: keytab files are case-sensitive. REM The realm following the FQDN should be all uppercase. REM Syntax is: REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! REM /pttype KRB5_NTPRINCIPAL /crypto !--cipher--! /out keytabs\kerberos.keytab REM Best practice: specify the /crypto value that is required by your KDC. REM Options for /crypto = {DES-CBC-CRC|DES-CBC-MD5|AES256-SHA1|AES128-SHA1|All} REM Do not specify /crypto All because it will result in a keytab that contains ciphers that are not supported REM and cause errors. REM When using AES256-SHA1 OR AES128-SHA1, the /mapuser option must be included REM in the ktpass command to ensure the keytab file is mapped properly to the user. For example: REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /mapuser /crypto AES256-SHA1 /out keytabs\kerberos.keytab REM The following example shows the ktpass syntax with the example.lan configuration from above: REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab REM ********** echo Creating Keytab files in %CD%\keytabs mkdir keytabs ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab ``` **Tableau Server 이전 버전의 경우** ``` @echo off setlocal EnableDelayedExpansion REM ******* REM This script generates the Service Principal Names (SPNs) and keytab files required for REM Kerberos SSO with Apache. REM This script executes set, setspn, and ktpass commands included in any Windows Server REM Operating System from 2003 on. REM Before running this script you must enter configuration information for the setspn and REM ktpass commands. REM Elements that require your configuration information are enclosed in as such: REM ! -- and --!. REM After you customize this file, save it as a .bat file, and run on a domain-joined REM computer. REM This script must be run by a Domain admin. REM ********** REM The following set command will prompt the domain admin for credentials of the REM Tableau Server service account. REM This account must be a valid domain user account. REM If the password contains a literal \" (blackslash - double quote), all backslashes REM immediately before the double quote must be REM duplicated when typed for the password to work, e.g. if password contains REM \" replace with \\", if passwords contains \\" replace with \\\\" set /p adpass= "Enter password for the Tableau Server service account." set adpass=!adpass:"=\"! REM ********** REM The following setspn commands create the SPN in the domain. REM More information on setspn can be found here: REM http://technet.microsoft.com/en-us/library/cc731241(WS.10).aspx REM Enter the canonical FQDN and the host names for Tableau Server followed by the REM Tableau Server service account name. REM Use this syntax: HTTP/hostname domain\service_account_name. REM The example below shows syntax for a computer named "tableau01" in the "example.lan" REM domain, with service account, "tab-serv-account": REM setspn -s HTTP/tableau01 example\tab-serv-account REM setspn -s HTTP/tableau01.example.lan example\tab-serv-account REM DNS and AD are not case sensitive, but the keytab files are. Verify that host names REM match letter case as stored in DNS. REM Use Windows Server's DNS Manager utility to verify host name case. REM ********** echo Creating SPNs... setspn -s HTTP/!--replace with canonical host name and service account --! setspn -s HTTP/!--replace with canonical FQDN and service account --! REM ********** REM The following commands create the keytab file in the same directory where the REM bat file is run. More information on ktpass can be found here: REM https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/ktpass REM Note: keytab files are case-sensitive. REM The realm following the FQDN should be all uppercase. REM Syntax is: REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! REM /pttype KRB5_NTPRINCIPAL /crypto !--cipher--! /out keytabs\kerberos.keytab REM Best practice: specify the /crypto value that is required by your KDC. REM Options for /crypto = {DES-CBC-CRC|DES-CBC-MD5|RC4-HMAC-NT|AES256-SHA1|AES128-SHA1|All} REM Specifying /crypto All will result in passwords stored with RC4 cipher, which is REM no longer considered secure. REM When using AES256-SHA1 OR AES128-SHA1, the /mapuser option must be included REM in the ktpass command to ensure the keytab file is mapped properly to the user. For example: REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /mapuser /crypto AES256-SHA1 /out keytabs\kerberos.keytab REM The following example shows the ktpass syntax with the example.lan configuration from above: REM ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab REM ********** echo Creating Keytab files in %CD%\keytabs mkdir keytabs ktpass /princ HTTP/!--FQDN--!@!--Kerberos_Realm--! /pass !adpass! /ptype KRB5_NT_PRINCIPAL /crypto DES-CBC-CRC /out keytabs\kerberos.keytab ``` ## 운영 체제 조직에서 인증을 위해 Kerberos를 사용하는 경우 Tableau Server가 실행되고 있는 컴퓨터는 실행 중인 Kerberos 영역으로 인증되어야 합니다.
Tableau 실행 위치...keytab 수동 생성 여부
Active Directory 도메인의 Windows아니요
Active Directory 도메인의 Linux예
Active Directory가 아닌 환경의 Windows 또는 Linux예
Windows에서 Tableau Server를 실행 중이고 컴퓨터가 Active Directory에 조인된 경우 운영 체제의 keytab 파일을 관리하거나 생성할 필요가 없습니다. Kerberos 영역(MIT KDC 또는 Active Directory)에서 Linux 기반 Tableau Server를 실행하는 경우 컴퓨터 운영 체제에 맞는 keytab 파일을 생성해야 합니다. 컴퓨터용으로 만드는 keytab은 특별히 OS 인증용입니다. 이 항목의 뒷부분에서 설명하는 다른 서비스에 사용할 keytab 파일을 OS 인증에 사용하지 마십시오. ## 디렉터리 서비스 조직에서 LDAP 또는 Active Directory와 같은 디렉터리 서비스를 사용하여 사용자 ID를 관리하는 경우 Tableau Server에는 디렉터리에 대한 읽기 전용 액세스가 필요합니다. 또는 로컬 ID 저장소를 설치하여 모든 계정을 관리하도록 Tableau Server를 구성할 수 있습니다. 이 경우 keytab이 필요 없습니다. 다음 표에는 keytab 요구 사항이 요약되어 있습니다.
Tableau 실행 위치...디렉터리 서비스keytab 수동 생성 여부
AD 도메인의 WindowsActive Directory아니요
WindowsLDAP(GSSAPI 바인딩)예
LinuxActive Directory 또는 LDAP(GSSAPI 바인딩)예
Windows 또는 LinuxActive Directory 또는 LDAP(단순 바인딩)아니요
Windows 또는 Linux로컬 ID 저장소keytab이 필요하지 않습니다.
이 시나리오를 위해 수동으로 keytab을 생성해야 하는 경우 디렉터리에 대한 GSSAPI 바인드용으로 keytab을 사용합니다. 다음 추천 항목을 따르십시오. - 디렉터리에 Tableau Server용 서비스 계정을 만듭니다. - 특별히 Tableau Server 서비스 계정을 위한 keytab을 만듭니다. 컴퓨터 계정/OS에서 인증에 사용하는 keytab 파일을 다시 사용하지 마십시오. - Tableau Server ID 저장소에 대한 json 구성의 일부로 keytab 파일을 업로드합니다. 자세한 내용은 [identityStore 엔터티](https://help.tableau.com/current/server/ko-kr/entity_identity_store.htm)를 참조하십시오. 재해 복구 계획의 일부로, Tableau Server에서 떨어진 안전한 위치에 keytab 및 conf 파일의 백업을 보관하는 것이 좋습니다. Tableau Server에 추가하는 keytab 및 conf 파일은 클라이언트 파일 서비스에 의해 저장되고 다른 노드에 배포됩니다. 그러나 파일은 복구 가능한 형식으로 저장되지 않습니다. 자세한 내용은 [Tableau Server 클라이언트 파일 서비스](https://help.tableau.com/current/server/ko-kr/server_process_cfs.htm)를 참조하십시오. ## 데이터 원본 위임 Kerberos 위임을 사용하여 Active Directory의 데이터 원본에 액세스할 수도 있습니다. 이 시나리오에서는 사용자가 모든 지원되는 인증 메커니즘(SAML, 로컬 인증, Kerberos 등)을 사용하여 Tableau Server에 인증할 수 있지만 Kerberos를 통해 활성화된 데이터 원본만 액세스할 수 있습니다. 다음 추천 항목을 따르십시오. - Tableau Server(Windows 또는 Linux)의 컴퓨터 계정은 Active Directory 도메인에 속해야 합니다. - Kerberos 위임에 사용하는 keytab 파일은 Kerberos 사용자 인증(SSO)에 사용하는 것과 동일한 keytab 파일일 수 있습니다. - keytab은 Active Directory의 Kerberos 위임을 위한 서비스 사용자에게 매핑되어야 합니다. - 여러 데이터 원본에 대해 동일한 keytab을 사용할 수 있습니다. 자세한 내용은 다음 구성 항목을 참조하십시오. - Linux 기반 Tableau Server: [Kerberos 위임 사용](https://help.tableau.com/current/server-linux/ko-kr/kerberos_delegation.htm) - Windows 기반 Tableau Server: [Kerberos 위임 사용](https://help.tableau.com/current/server/ko-kr/kerberos_delegation.htm) [주요 콘텐츠로 건너뛰기](#main-content) # LDAP 외부 ID 저장소에 암호화된 채널 구성 외부 LDAP ID 저장소에 연결하도록 구성된 Tableau Server는 LDAP 디렉터리를 쿼리하고 세션을 설정해야 합니다. 세션을 설정하는 과정을 _바인딩_이라고 합니다. 바인딩 방법은 다양합니다. Tableau Server는 LDAP 디렉터리에 바인딩하는 두 가지 방법을 지원합니다. - 단순 바인딩: 사용자 이름과 비밀번호를 사용하여 인증하는 방식으로 세션을 설정합니다. 기본적으로 단순 바인딩을 사용하는 LDAP는 암호화되지 않습니다. 단순 바인딩으로 LDAP를 구성하는 경우LDAP over SSL/TLS를 사용하는 것이 좋습니다. - **GSSAPI 바인딩:** GSSAPI에서는 Kerberos를 사용하여 인증합니다. keytab 파일로 구성된 경우 GSSAPI 바인딩 중에 인증 보안이 유지됩니다. 그러나 LDAP 서버에 대한 후속 트래픽은 암호화되지 않습니다. LDAP over SSL/TLS를 구성하는 것이 좋습니다. Active Directory 도메인에 가입된 컴퓨터의 Windows에서 Tableau Server를 실행하는 경우 GSAPI를 구성할 필요가 없습니다. Tableau Server GUI 설치 프로그램은 Kerberos를 사용하여 자동으로 Active Directory 연결을 감지하고 구성합니다. 자세한 내용은 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)을 참조하십시오. Active Directory 통신을 위해 단순 바인딩을 사용하여 LDAP를 실행하지 마십시오. 이 항목에서는 Tableau Server와 LDAP 디렉터리 서버 간의 통신을 위한 단순 LDAP 바인딩의 채널을 암호화하는 방법에 대해 설명합니다. ## 인증서 요구 사항 - 암호화에 사용할 수 있는 유효한 PEM 인코딩 x509 SSL/TLS 인증서가 있어야 합니다. 인증서 파일의 확장명은 .crt여야 합니다. - 자체 서명 인증서는 지원되지 않습니다. - 설치하는 인증서는 SSL/TLS에 사용할 키 사용 필드에 `Key Encipherment`를 포함해야 합니다. Tableau Server는 LDAP 서버에 대한 채널을 암호화할 때만 이 인증서를 사용합니다. 만료, 신뢰, CRL 및 기타 특성은 유효성이 검사되지 않습니다. - 분산 배포에서 Tableau Server를 실행하는 경우 수동으로 SSL 인증서를 클러스터의 각 노드에 복사해야 합니다. Tableau Server 응용 프로그램 서버 프로세스가 구성된 노드에만 인증서를 복사하십시오. 클러스터 환경의 다른 공유 파일과 달리 LDAP에 사용되는 SSL 인증서는 클라이언트 파일 서비스에 의해 자동으로 배포되지 않습니다. - PKI 또는 자사 인증서를 사용하는 경우 CA 루트 인증서를 Java 신뢰 저장소에 업로드합니다. ### Tableau 키 저장소로 인증서 가져오기 컴퓨터에 아직 LDAP 서버용으로 구성된 인증서가 설치되지 않은 경우 LDAP 서버용 SSL 인증서를 구해 Tableau 시스템 키 저장소로 가져와야 합니다. "keytool" Java 도구를 사용하여 인증서를 가져옵니다. 기본 설치에서 이 도구는 Tableau Server의 `C:\Program Files\Tableau\Tableau Server\packages\repository.\jre\bin\keytool.exe`에 설치됩니다. 관리자로 다음 명령을 실행하여 인증서를 가져옵니다(환경의 ``를 바꿔야 함). `"C:\Program Files\Tableau\Tableau Server\packages\repository.\jre\bin\keytool.exe" -importcert -file "C:\Program Files\Tableau\Tableau Server\.crt" -alias "" -keystore "C:\ProgramData\Tableau\Tableau Server\tableauservicesmanagerca.jks" -storepass changeit -noprompt` Java 키 저장소의 비밀번호는 `changeit`입니다. (Java 키 저장소의 비밀번호를 변경하지 마십시오.) ## LDAPS 암호화 방법 Tableau Server는 단순 바인딩을 위해 LDAP 채널을 암호화할 수 있도록 LDAPS를 지원합니다. 보안 LDAP 또는 LDAPS는 구성이 필요한 표준 암호화된 채널입니다. 특히 Tableau Server의 TLS 인증서 외에도 대상 LDAP 서버의 호스트 이름 및 보안 LDAP 포트를 설정해야 합니다. ## 단순 바인딩을 위한 암호화된 채널 구성 조직에서 Active Directory가 아닌 LDAP 디렉터리를 사용하는 경우 여기에 있는 절차에 따라 LDAP 단순 바인딩을 위한 암호화된 채널을 구성합니다. 이 섹션에서는 LDAP 단순 바인딩을 위해 암호화된 채널을 사용하도록 Tableau Server를 구성하는 방법에 대해 설명합니다. ### 구성 시기 Tableau Server를 초기화하기 전 또는 [초기 노드 설정 구성](https://help.tableau.com/current/server/ko-kr/config_general.htm)의 “TSM CLI 사용” 탭에 언급된 대로 초기 노드를 구성할 때 LDAP 단순 바인딩을 위한 암호화된 채널을 사용하도록 Tableau Server를 구성해야 합니다. ### Tableau Server를 새로 설치하는 경우 조직에서 Active Directory 이외의 LDAP 디렉터리를 사용하는 경우 TSM GUI 설치 프로그램을 사용하여 Tableau Server 설치의 일부로 ID 저장소를 구성할 수 없습니다. 대신 JSON 항목 파일을 사용하여 LDAP ID 저장소를 구성해야 합니다. 자세한 내용은 [identityStore 엔터티](https://help.tableau.com/current/server/ko-kr/entity_identity_store.htm)를 참조하십시오. identityStore 엔터티를 구성하기 전에 이 항목의 앞부분에서 설명된 대로 유효한 SSL/TLS 인증서를 Tableau 키 저장소로 가져옵니다. LDAPS를 구성하려면 identityStore JSON 파일에서 hostname 및 sslPort 옵션을 설정해야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft 365에서 Tableau 콘텐츠 액세스 Microsoft 365용 Tableau 앱은 Teams, Word 및 PowerPoint에서 사용할 수 있습니다.Teams 앱으로 뷰(비주얼리제이션) 및 메트릭과 상호 작용하고 메시지, 채널 및 회의에서 이를 공유할 수 있습니다.Word 및 PowerPoint 추가 기능을 사용하면 문서 및 슬라이드에 뷰와 메트릭의 이미지 스냅샷을 추가하고 해당 스냅샷을 새로 고쳐 최신 상태로 유지할 수 있습니다. Microsoft 365에서 Tableau 앱을 사용하려면 관리자가 앱을 배포하고 Tableau 사이트에 연결해야 합니다.관리자 권한으로 Tableau 앱을 설치하는 방법에 대한 자세한 내용은 [Microsoft 365용 Tableau 앱 설정](https://help.tableau.com/current/server/ko-kr/teams_set_up.htm)을 참조하십시오. 참고: Tableau 또는 Microsoft 365에서 언어를 영어(미국) 이외의 Tableau 지원 언어로 설정한 경우 해당 언어가 아닌 영어 텍스트가 표시될 수 있습니다. ## Teams 앱 사용 관리자가 앱을 사전 설치하지 않았지만 조직에 배포한 경우 사용자가 직접 앱을 설치할 수 있습니다.설치하는 방법에 대한 자세한 내용은 Microsoft Teams 설명서에서 [Microsoft Teams에 앱 추가](https://support.microsoft.com/en-us/office/add-an-app-to-microsoft-teams-b2217706-f7ed-4e64-8e96-c413afd02f77)를 참조하십시오. Teams 앱에는 Tableau, Pulse 및 구성의 세 가지 탭이 있습니다.Tableau 탭에 즐겨찾기로 추가한 뷰가 표시됩니다.Pulse 탭에는 팔로우하는 메트릭과 해당 메트릭에 대한 인사이트 요약이 표시됩니다.참고로, Pulse 탭은 Tableau Cloud 사이트에만 나타납니다.구성 탭에서는 콘텐츠 검색 시 Microsoft Teams가 확인할 사이트를 설정할 수 있으며, Tableau 관리자인 경우 사이트 구성을 추가하거나 제거할 수 있습니다. 즐겨 찾는 뷰나 팔로우한 메트릭이 없으면 앱에 콘텐츠가 표시되지 않습니다.Tableau 사이트에 직접 로그인하여 뷰를 즐겨찾기로 추가하고 메트릭을 팔로우할 수 있습니다.자세한 내용은 [즐겨찾기 표시](https://help.tableau.com/current/pro/desktop/ko-kr/favorites.htm) 및 [메트릭 팔로우](https://help.tableau.com/current/online/ko-kr/pulse_explore_metrics.htm#follow-metrics)를 참조하십시오.다른 유형의 콘텐츠를 즐겨찾기로 추가할 수 있지만 뷰 외에 즐겨 찾는 콘텐츠는 Tableau 앱에 표시되지 않습니다.통합 문서의 모든 뷰를 표시하려면 각 개별 뷰를 즐겨찾기에 추가해야 합니다. ### Teams의 콘텐츠 탐색 Tableau 또는 Pulse 탭에서 뷰 또는 메트릭에 대한 카드를 클릭하여 전체 대화형 버전을 엽니다.대화형 뷰 또는 메트릭을 사용하면 데이터에 대한 세부 정보를 보고 다양한 차원 또는 시간 범위에 따라 데이터를 필터링할 수 있습니다. #### 콘텐츠 검색 뷰 또는 메트릭의 이름을 알고 있으면 Tableau 앱에서 검색할 수 있습니다.또한 검색 표시줄에 뷰의 URL을 입력하여 특정 콘텐츠 또는 사용자 지정 뷰에 액세스할 수도 있습니다. 1. Tableau 또는 Pulse 탭에서 검색 아이콘을 선택합니다. ![Tableau 앱 검색 입력 지점](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_search.png) 2. 뷰 또는 메트릭의 이름을 입력합니다. 3. 뷰 또는 메트릭 이름 옆에 있는 열기 단추를 선택하여 대화형 버전으로 이동합니다. #### 메트릭 팔로우 각 메트릭은 고유한 필터 집합을 나타냅니다.기존 메트릭을 필터링할 때, 해당 필터로 필터링된 메트릭이 아직 존재하지 않는 경우 새 메트릭을 만듭니다.새 메트릭을 팔로우하면 Pulse 탭과 인사이트 요약에서 해당 메트릭을 볼 수 있습니다. 1. 메트릭에서 팔로우(이 메트릭 구독) 아이콘을 선택합니다. ![메트릭의 팔로우 아이콘](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_follow.png) 단추를 다시 선택하면 메트릭 팔로우를 취소할 수 있습니다. #### 콘텐츠 공유 1. 뷰 또는 메트릭에서 공유 아이콘을 선택합니다. ![공유 아이콘](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_share.png) 2. 공유할 사람, 그룹 채팅 또는 채널을 선택합니다. 3. 공유를 선택합니다. #### 사이트 전환 1. Tableau 또는 Pulse 탭의 이동 경로 메뉴에서 사이트 이름을 선택합니다.둘 이상의 사이트가 Tableau 앱에 연결되어 있는 경우 사이트 목록이 표시됩니다. ![사이트 전환 옵션](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_switch_site.png) 2. 전환하려는 사이트를 선택합니다. ### 채널 및 회의에 Tableau 콘텐츠 추가 #### 채널 탭에 콘텐츠 고정 1. Tableau 콘텐츠를 고정하려는 채널에서 + 아이콘을 선택하여 탭을 추가합니다. ![채널 탭 옵션 추가](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_channel_tab.png) 2. 앱 목록에서 Tableau 앱을 선택합니다. 3. 고정할 콘텐츠를 선택합니다.사용자 지정 뷰를 고정하려면 검색 단추를 선택하고 뷰 URL을 입력합니다.하나의 뷰와 탭당 최대 5개의 메트릭을 고정할 수 있습니다.더 많은 Tableau 콘텐츠를 고정하려면 탭을 하나 더 추가합니다. ![고정할 Tableau 뷰 및 메트릭](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_pin_content.png) 4. 저장을 선택합니다. 5. 필요한 경우 탭의 이름을 바꾸려면 탭의 드롭다운 메뉴를 선택한 다음 이름 바꾸기를 선택합니다. ![Tableau 탭의 이름 바꾸기 옵션](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_rename_tab.png) #### 회의에 Tableau 콘텐츠 추가 먼저 회의를 만든 다음 Tableau 콘텐츠를 추가해야 합니다.회의를 만드는 동안 타사 앱을 추가할 수 없습니다. 1. 일정 앱에서 Tableau 콘텐츠를 추가하려는 회의를 찾은 다음 편집을 선택합니다. 2. 기타 옵션을 선택합니다. 3. 툴바에서 앱을 선택합니다. 4. 앱 목록에서 Tableau 앱을 선택합니다. 5. 고정할 콘텐츠를 선택합니다. 6. 저장을 선택합니다. 7. 회의에 대한 변경 내용을 저장합니다. 8. 회의를 시작한 후 Tableau 탭을 선택합니다.그러면 사이드 패널에 Tableau 콘텐츠가 열리고, 이는 나만 볼 수 있습니다. 9. 사이드 패널에서 스테이지에 공유 단추를 선택합니다.그러면 회의의 다른 사용자가 콘텐츠를 볼 수 있습니다.공유하는 콘텐츠는 화면 공유와 유사하게, 본인이 보는 그대로 다른 사람들에게 표시된다는 점을 유의하십시오.데이터에 행 수준 보안이 적용된 경우 회의에 참가한 모든 사람이 나의 데이터 뷰를 볼 수 있습니다. ### 메시지에서 Tableau 콘텐츠 공유 뷰 또는 메트릭의 URL을 알고 있으면 메시지에 URL을 붙여 넣어 해당 콘텐츠를 빠르게 공유할 수 있습니다.Tableau 메시지 확장 프로그램은 링크를 카드 형태로 변환하여 콘텐츠 제목과 축소판을 표시하며, 전체 대화형 뷰 또는 메트릭을 열 수 있는 단추를 제공합니다.전송하려는 콘텐츠의 URL을 모르는 경우 공유할 콘텐츠를 검색하면 됩니다. 1. 메시지에서 +(동작 및 앱) 아이콘을 선택합니다. 2. Tableau 앱을 선택합니다. 3. Tableau 사이트에서 공유하려는 뷰 또는 메트릭을 검색합니다. 4. 뷰 또는 메트릭을 선택합니다.이 콘텐츠에 대한 카드를 생성하는 데 잠시 시간이 소요됩니다. ![Teams 메시지의 메트릭 카드](/tableau/current/ko-kr/server/ko-kr/Img/teams_app_metric.png) 5. 메시지를 보냅니다. ## Word 및 PowerPoint 추가 기능 사용 Tableau 추가 기능은 Microsoft Word 및 PowerPoint의 홈 탭에 나타납니다.추가 기능에 액세스하는 방법에 대한 자세한 내용은 Microsoft 설명서에서 [Office 추가 기능 사용 시작](https://support.microsoft.com/ko-kr/office/start-using-your-office-add-in-82e665c4-6700-4b56-a3f3-ef5441996862)을 참조하십시오.참고로, Tableau 앱을 사용하려면 Microsoft 365 관리자가 먼저 앱을 배포하고 Tableau 사이트에 연결해야 합니다. ### 문서 및 슬라이드에 비주얼리제이션 또는 메트릭 추가 Tableau 추가 기능을 사용하면 비주얼리제이션 또는 메트릭의 이미지 스냅샷을 문서와 슬라이드에 추가할 수 있습니다.참고로, Tableau Pulse 메트릭은 Tableau Cloud에만 사용할 수 있습니다. 이러한 이미지는 이미지가 추가된 시간과 추가한 사용자를 보여 주며, Tableau Cloud 또는 Tableau Server의 콘텐츠에 링크로 연결됩니다.이미지는 모든 사용자에 대해 동일하므로 데이터에 행 수준 보안이 적용된 경우, 이미지를 추가한 사용자와 관련된 데이터 뷰가 이미지에 표시됩니다.다른 사용자가 Tableau Cloud 또는 Tableau Server에서 이미지 링크를 열면 해당 사용자의 자격 증명이 적용된 대화형 뷰 또는 메트릭이 표시됩니다. 1. 홈 탭에서 Tableau 추가 기능을 선택합니다. 2. Insert Viz Image(비주얼리제이션 이미지 삽입) 또는 Insert Pulse Image(Pulse 이미지 삽입)을 선택합니다. ![Microsoft 365 추가 기능의 비주얼리제이션 또는 메트릭 삽입 옵션](/tableau/current/ko-kr/server/ko-kr/Img/microsoft_365_add_in.png) 3. 추가하려는 뷰 또는 메트릭의 이름을 검색하거나, 즐겨 찾는 뷰 또는 팔로우하는 메트릭에서 선택합니다. 4. 뷰 또는 메트릭의 미리 보기에서 Insert Image(이미지 삽입)을 선택합니다. 추가하려는 콘텐츠의 Tableau 사이트 URL이 있는 경우 Insert Content from URL(URL에서 콘텐츠 삽입)을 대신 선택할 수 있습니다. #### 사용자 지정 뷰를 사용하여 필터링된 데이터 표시 데이터의 필터링된 뷰를 추가하려면 사용자 지정 뷰를 삽입하면 됩니다. 1. Tableau Server 또는 Tableau Cloud에서 뷰를 엽니다. 2. 뷰를 필터링하여 스냅샷에 포함할 데이터를 표시한 다음 사용자 지정 뷰를 만듭니다.자세한 내용은 [사용자 지정 뷰 사용](https://help.tableau.com/current/server/ko-kr/customview.htm)을 참조하십시오. 3. Word 또는 PowerPoint에서 Tableau 추가 기능을 엽니다. 4. Insert Content from URL(URL에서 콘텐츠 삽입)을 선택한 다음 사용자 지정 뷰의 URL에 붙여 넣습니다. ### 비주얼리제이션 또는 메트릭 새로 고침 이미지는 이미지를 추가하는 시점에 생성된 스냅샷입니다.이미지가 더 이상 최신 데이터를 나타내지 않는 경우 이미지를 새로 고쳐야 합니다. 1. 홈 탭에서 Tableau 추가 기능을 선택합니다. 2. 데이터 새로 고침을 선택합니다.Tableau 추가 기능은 문서 또는 슬라이드에 있는 모든 Tableau 이미지를 식별합니다. 3. 새로 고치려는 콘텐츠를 선택한 다음 Refresh Selected(선택 항목 새로 고침)를 선택합니다. [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft 365용 Tableau 앱 설정 Microsoft 365용 Tableau 앱을 사용하면 사용자가 작업 흐름을 중단하지 않고도 데이터를 보고 이해할 수 있습니다.Teams 앱을 사용하면 사용자가 Tableau 뷰(비주얼리제이션) 및 메트릭과 상호 작용하고 팔로우하는 메트릭에 대한 Tableau Pulse 요약문 및 알림을 받을 수 있습니다.Word 및 PowerPoint 추가 기능을 사용하면 사용자가 문서 및 슬라이드에 뷰와 메트릭의 이미지 스냅샷을 추가하고 해당 스냅샷을 새로 고쳐 최신 상태로 유지할 수 있습니다. Tableau 관리자가 앱을 설치하고 기존 Tableau 사이트를 Microsoft 365 배포판과 연결하도록 구성해야 합니다.Microsoft 앱 마켓플레이스에서 직접 Tableau Cloud용 앱을 설치할 수 있습니다.Tableau Server용 앱을 설치하려면 앱을 다운로드하고 테스트용으로 로드해야 합니다. Microsoft 365용 Tableau 앱 사용에 대한 자세한 내용은 [Microsoft 365에서 Tableau 콘텐츠 액세스](https://help.tableau.com/current/server/ko-kr/teams_explore.htm)를 참조하십시오.이 문서에서는 앱 설정에 대해 설명합니다. 참고: Tableau 또는 Microsoft 365에서 언어를 영어(미국) 이외의 Tableau 지원 언어로 설정한 경우 해당 언어가 아닌 영어 텍스트가 표시될 수 있습니다. ## 참고 항목 - [GitHub의 Tableau 앱 FAQ](https://github.com/tableau/tableau-app-msft-teams) - [GitHub의 릴리스 정보](https://github.com/tableau/tableau-app-msft-teams/blob/main/ReleaseNotes.md) - [YouTube의 시작하기 자습서](https://www.youtube.com/watch?v=nsa123RgCO0) ## 필수 요건 Microsoft 365용 Tableau 앱을 설정하려면 다음 앱, 계정과 구성이 필요합니다. - Tableau Cloud 또는 Tableau Server 버전 2023.1 이상 - Tableau Cloud의 사이트 관리자 계정 또는 Tableau Server의 서버 관리자 계정 - Microsoft 365 for Enterprise 구독 - Microsoft Teams, Word 및 PowerPoint - Microsoft 365 관리자 계정 - 사용자 매핑 특성 중 하나를 기반으로 서로 매핑된 Tableau 및 Microsoft 365 둘 모두의 사용자 라이선스 - 허용 목록에 추가된 IP 주소 범위 `4.152.0.0/15` 및 `20.2.0.0/16`(Tableau Cloud 사이트에서 IP 필터링을 사용하도록 설정한 경우에만 해당) ### 사용자 매핑 특성 Tableau에서 SSO(Single Sign-On)를 허용하려면 Microsoft 365의 사용자 계정을 Tableau의 사용자 계정에 매핑해야 합니다.Microsoft Teams SDK 또는 사용자의 Microsoft Entra 프로필에 있는 특성을 사용하여 이 매핑을 설정할 수 있습니다. #### Microsoft Teams SDK 특성 | 특성 | 설명 | | --- | --- | | [Preferred\_Username](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/authentication/tab-sso-code#:~:text=user%27s%20display%20name.-,preferred_username,-%3A%20The%20app%20user%27s) | Microsoft Teams 사용자의 이메일 주소입니다.경우에 따라 이 값은 Microsoft Entra에 정의된 이메일과 다를 수 있습니다. | | [User Principal Name](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/plan-connect-userprincipalname#what-is-userprincipalname) | 사용자가 Microsoft Entra에 로그인하는 기본 방법입니다. | #### Microsoft Entra 프로필 특성 | 특성 | 설명 | | --- | --- | | [Primary Email](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mail,-String) | `user.mail` 특성에 해당하며 사용자의 이메일 주소를 나타냅니다. | | [Mail Nickname](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mailNickname,-String) | `user.mailNickname` 특성에 해당하며 사용자의 별칭을 나타냅니다. | | [Employee ID](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=a%20user.-,employeeId,-String) | `user.employeeId` 특성에 해당하며 조직에서 할당한 직원 식별자를 나타냅니다. | | [On-Premise Distinguished Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesDistinguishedName,-String) | `user.onPremiseDistinguishedName` 특성에 해당하며 온프레미스 Active Directory에서 동기화된 DN(고유 이름)을 나타냅니다. | | [On-Premise User Principal Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesUserPrincipalName,-String) | `user.onPremiseUserPrincipalName` 특성에 해당하며 온프레미스 Active Directory에서 동기화된 userPrincipalName을 나타냅니다. | | [On-premise SAM Account Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%2C%20le\).-,onPremisesSamAccountName,-String) | `user.onPremiseSamAccountName` 특성에 해당하며 온프레미스 Active Directory에서 동기화된 samAccountName을 나타냅니다. | | [Extension Attribute X](https://learn.microsoft.com/en-us/graph/extensibility-overview?tabs=http) | Microsoft Entra를 사용하면 사용자의 Entra 프로필에 최대 15개를 여분 특성으로 추가할 수 있습니다.Tableau 사용자 이름이 Microsoft Entra에 없는 경우 각 Entra 사용자에 대해 Tableau 사용자 이름을 저장하기 위한 확장 특성을 사용하십시오. | ### Tableau Server의 추가 필수 요건 Tableau 앱은 API 호출을 사용하여 Tableau Server와 통신하고 대화형 콘텐츠를 내장합니다.이러한 호출은 Tableau Server에 연결할 수 있어야 합니다. - Tableau Server가 방화벽의 보호를 받는 경우 IP 범위 4.152.0.0/15 및 20.2.0.0/16에서 들어오는 HTTP 요청을 허용해야 합니다. - 사용자가 Microsoft 365에 액세스하는 것과 동일한 방식으로 Tableau Server에 액세스할 수 있어야 합니다. - 사용자가 Microsoft 365에 액세스하기 위해 VPN에 있어야 하는 경우 동일한 VPN에서 Tableau Server에 액세스할 수 있어야 합니다. - 사용자가 공용 인터넷에서 Microsoft 365에 액세스할 수 있으면 공용 인터넷에서 Tableau Server에 액세스할 수 있어야 합니다. - 사용자가 모바일 앱을 통해 Microsoft 365에 액세스할 수 있는 경우 휴대기기에서 Tableau Server에 액세스할 수 있어야 합니다. ## Tableau Server용 앱 설치 Tableau Server용 앱을 설치하려면 먼저 앱 매니페스트를 편집하여 호스트 이름을 사용자 지정해야 합니다.그런 다음 Microsoft Teams 앱, Word 및 PowerPoint 추가 기능 또는 둘 다를 설치하도록 선택할 수 있습니다.Tableau Cloud용 앱을 설치하려면 [Tableau Cloud 설정 가이드](https://help.tableau.com/current/online/ko-kr/teams_set_up.htm)를 참조하십시오. ### 앱 매니페스트 다운로드 및 편집 1. GitHub에서 [앱 매니페스트를 다운로드](https://github.com/tableau/tableau-app-msft-teams/raw/main/appManifest/tableau-app-for-teams-server.zip)합니다. 2. 매니페스트 파일 `tableau-server-app-for-teams.zip`에서 파일의 압축을 풉니다. 3. 텍스트 편집기에서 `manifest.json` 파일을 엽니다. 4. `manifest.json`에서 `*.online.tableau.com`을 검색하고 해당 도메인을 Tableau Server 환경의 호스트 이름으로 바꿉니다.Tableau Server URL이 `https://analytics.company.com`인 경우 호스트 이름은 `analytics.company.com`입니다. 5. `manifest.json`에 변경 내용을 저장합니다. 6. `tableau-app-for-teams-server` 폴더의 파일을 압축하여 변경 내용을 포함하는 zip 파일을 만듭니다. ### Teams 앱 배포 #### Microsoft Teams에 앱 매니페스트 업로드 조직의 앱 정책에 따라 Microsoft Teams 앱을 설치할 수 있는지 여부가 결정됩니다.앱을 설치하려면 Microsoft 365 관리자 계정이 필요할 수 있습니다. 1. [Microsoft Teams 관리 센터](https://admin.teams.microsoft.com)를 엽니다. 2. 탐색 패널에서 Teams apps(Teams 앱) > Manage apps(앱 관리)를 선택합니다. 3. Actions(동작) > Upload new app(새 앱 업로드)를 선택합니다. 4. 편집한 `tableau-server-app-for-teams.zip` 파일을 업로드합니다.앱을 관리할 수 있는 링크가 포함된 확인 메시지가 전송됩니다. #### 사용자를 위해 앱을 설치하고 고정 앱을 설치하여 사용자 전부 또는 일부가 앱을 사용할 수 있도록 설정할 수 있습니다.앱을 고정하여 사용자의 앱 표시줄에 표시할 수도 있습니다. 1. [Microsoft Teams 관리 센터](https://admin.teams.microsoft.com)를 엽니다. 2. 탐색 패널에서 Teams apps(Teams 앱) > Setup policies(정책 설정)를 선택합니다. 3. Installed apps(설치된 앱)에서 Add apps(앱 추가)를 선택한 다음 Tableau 앱을 추가합니다. 4. 필요한 경우 Pinned apps(고정된 앱)에서 Add apps(앱 추가)를 선택한 다음 Tableau 앱을 추가합니다. 5. 변경 내용을 저장합니다. Tableau 앱을 추가한 후 사용자가 앱을 사용할 수 있게 되기까지 최대 24시간이 소요될 수 있습니다. ### Word 및 PowerPoint 추가 기능 설치 Microsoft Teams용 앱을 설치해도 Word 및 PowerPoint 추가 기능은 설치되지 않습니다.추가 기능은 Microsoft 365 관리 센터에서 별도로 설치해야 합니다. 1. [Microsoft 365 관리 센터](https://admin.cloud.microsoft.com)를 엽니다. 2. 탐색 패널에서 Agents(에이전트) > All agents(모든 에이전트)를 선택합니다. 3. Upload custom agent(사용자 지정 에이전트 업로드)를 선택합니다. 4. 편집한 `tableau-server-app-for-teams.zip` 파일을 업로드합니다. 5. 모든 사용자 또는 특정 사용자를 위해 앱을 게시할지 그리고 앱을 사전 설치할지 여부를 선택합니다. 6. 사용 권한을 수락합니다. 7. 배포를 검토하고 완료합니다. 배포를 완료하며 사용자가 추가 기능을 사용할 수 있게 되기까지 최대 72시간이 소요될 수 있습니다. ## Tableau 앱 구성 Tableau 앱을 설치한 후 Microsoft Teams에서 앱을 설정하라는 메시지를 표시합니다.앱을 Tableau 사이트에 연결하도록 사이트 정보를 구성해야 합니다. ### 1.연결된 앱 만들기 Microsoft 365용 Tableau 앱은 연결된 앱을 사용하여 SSO(Single Sign-On)로 사용자를 인증합니다.Tableau Cloud 또는 Tableau Server에서 이 연결된 앱을 만들어야 합니다. 1. Tableau Cloud 또는 Tableau Server에서 직접 신뢰를 사용하여 연결된 앱을 만드십시오.자세한 내용은 [Tableau Cloud에 대해 직접 신뢰를 사용하여 연결된 앱 구성](https://help.tableau.com/current/online/ko-kr/connected_apps_direct.htm) 또는 [Tableau Server에 대해 직접 신뢰를 사용하여 연결된 앱 구성](https://help.tableau.com/current/server/ko-kr/connected_apps_direct.htm#create-a-connected-app)을 참조하십시오. - 연결된 앱의 도메인 허용 목록을 지정된 도메인으로만 제한하는 경우 다음 도메인을 허용 목록에 추가합니다. - `tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net` - `teams.microsoft.com` - `*.teams.microsoft.com` - 사용자가 다른 Microsoft 플랫폼에서 앱에 액세스하는 경우 [Microsoft 365 URL](https://learn.microsoft.com/en-us/microsoft-365/enterprise/urls-and-ip-address-ranges?view=o365-worldwide) 목록의 다른 도메인을 추가합니다. 2. 연결된 앱을 사용하도록 설정합니다. 3. 연결된 앱 암호를 생성합니다. 4. 연결된 앱의 클라이언트 ID, 암호 ID 및 암호 값을 복사합니다.이러한 값을 저장합니다.Microsoft 365에서 Tableau 사이트를 구성하기 위해 필요합니다. ### 2.Tableau 앱에 사이트 구성 추가 Microsoft Teams에서 Tableau 앱을 열 때 아직 앱을 구성하지 않은 경우 Tableau 앱을 열 때 설정 화면이 나타납니다.Word 및 PowerPoint에서 사이트 구성 옵션에 액세스하려면 추가 기능 패널 아래쪽에 있는 설정 단추를 선택합니다. 1. Label(레이블)에 사이트 이름을 지정합니다.이 이름은 Microsoft 365 앱 사용자에게 표시됩니다.레이블을 입력하지 않으면 앱에 사이트 이름이 표시됩니다.이 필드는 선택 항목입니다. 2. Tableau Site Name(Tableau 사이트 이름)에 이름을 입력합니다. 이 이름이 사이트의 URL에 나타납니다.예를 들어 URL `https://us-west-2b.online.tableau.com/#/site/mysitename/home`인 경우 `mysitename`을 입력합니다.앱을 Tableau Server에 연결하고 기본 사이트를 사용하려는 경우 이 필드를 비워 둡니다. 3. Base URL(기본 URL)에는 사이트 URL에서 `tableau.com`으로 끝나는 부분을 입력합니다. 예를 들어 `https://us-west-2b.online.tableau.com`입니다. 4. User Mapping Attribute(사용자 매핑 특성)에 대해서는 SSO(Single Sign-On)로 사용자를 인증하는 데 사용되는 Microsoft Entra 특성을 선택합니다. 5. Connected App ID(연결된 앱 ID), Connected App Secret ID(연결된 앱 암호 ID) 및 Connected App Secret Value(연결된 앱 암호 값)에 연결된 앱을 만들 때 복사해둔 값을 붙여 넣습니다. 6. Add Site Config(사이트 구성 추가)를 선택합니다. Tableau 앱은 구성 세부 정보를 저장하기 전에 연결을 테스트합니다.앱이 Tableau에 연결할 수 없는 경우 사이트 구성이 추가되지 않습니다.이 오류는 연결된 앱을 인증할 수 없거나, 연결된 앱을 사용하도록 설정하지 않았거나, 사이트 정보가 잘못되었거나, 사용 중인 계정이 Tableau 관리자 계정이 아니기 때문에 발생할 수 있습니다.또한 앱이 방화벽으로 보호되기 때문에 Tableau Server에 연결할 수 없다는 의미일 수도 있습니다. ## 사이트 구성 추가 또는 삭제 사이트 구성을 추가한 후 다른 사이트를 추가하거나 기존 사이트 구성을 삭제할 수 있습니다. 1. Microsoft Teams용 Tableau 앱에서 Configuration(구성) 탭을 선택합니다.또는 Word나 PowerPoint 추가 기능 패널에서 **Settings(설정)** 단추를 선택합니다. 2. Configuration(구성)에서 Tableau Site Config(Tableau 사이트 구성) 탭을 선택합니다. 3. 사이트를 추가하려면 Add Site Details(사이트 세부 정보 추가)를 선택합니다.또는 사이트를 제거하려면 해당 사이트에 대한 삭제 아이콘을 선택합니다.이러한 옵션을 표시하려면 현재 연결된 Tableau 사이트의 사이트 관리자여야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft Azure 가상 컴퓨터 유형 및 크기 선택 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Microsoft Azure는 많은 유형의 VM 이미지를 다양한 크기로 제공합니다. Tableau Server의 성공적인 배포에서 중요한 요소 중 하나는 작업 부하에 적합한 VM 이미지를 선택하는 것입니다. 광범위한 Microsoft Azure VM 이미지 중에서 이미지를 선택할 수 있습니다. 사용 가능한 모든 VM 이미지 유형 및 크기의 전체 목록을 보려면 Microsoft Azure 웹 사이트에서 [Virtual Machine 시리즈](https://azure.microsoft.com/ko-kr/pricing/details/virtual-machines/series/) 페이지를 참조하십시오. Tableau Server를 실행할 수 있는 이미지를 선택해야 합니다. VM 이미지는 Tableau Server [하드웨어 지침](http://www.tableau.com/ko-kr/products/techspecs#server)(최소 8코어 및 128GB RAM)을 충족해야 합니다. Azure [Premium Storage](https://docs.microsoft.com/ko-kr/azure/storage/common/storage-premium-storage)를 지원하는 인스턴스를 선택하는 것이 좋습니다. 64비트 Tableau Server에는 최소 4코어 CPU(Azure vCPU 8개에 해당) 및 64 GB RAM이 필요합니다. 하지만 단일 프로덕션 Microsoft Azure VM의 경우 총 8개 CPU 코어(Azure vCPU 16개) 및 128GB RAM을 사용할 것을 강력하게 권장합니다. ## 개발, 테스트 및 프로덕션 환경을 위한 일반적인 VM 유형 및 크기 - D 시리즈 – D13, D14, D16 - DS 시리즈 – DS13, DS14 **참고:** DS 시리즈 VM과 Premium Storage를 사용하는 것이 좋습니다. Premium Storage는 데이터베이스 및 다른 고성능 응용 프로그램에 가장 적합한 저장소입니다. 일반적으로 D16s\_v3 또는 DS13\_V2 인스턴스를 선택하는 것이 좋습니다. 테스트 및 개념 검증이 목적인 경우 오직 4코어 가상 컴퓨터(예: DS13\_V2)를 사용해도 괜찮을 수 있습니다. 단일 볼륨에서 높은 디스크 처리량을 제공하는 데 충분한 IOPS(초당 입/출력 작업 수)를 확보하려면 RAID 0 구성에서 2~3개 디스크를 사용하십시오. 디스크 2개를 단일 볼륨으로 스트라이프하면 리포지토리를 호스팅하지 않는 추가 노드에 충분한 성능을 제공할 수 있습니다. Tableau Server를 단일 컴퓨터에서 실행하는 경우 단일 볼륨(RAID 0)으로 스트라이프된 드라이브 3개를 사용하면 해당 컴퓨터에서 더 많은 디스크 작업이 수행되므로 디스크 성능이 향상됩니다. ## 단일 프로덕션 인스턴스의 권장 사양
구성 요소/리소스Microsoft Azure

CPU

16 vCPU 코어

운영 체제
 2021.3.0 ~ 2023.3.02023.3.1 ~ 2026.2.x
Windows Server 2016
Windows Server 2019(x64)
Windows Server 2022참고: 2023.3.1 이전 버전에서 Windows Server 2022는 지원되지 않습니다. 2023년 4월부터 Windows 기반의 모든 2023.3.1 이전 Tableau Server 버전에 대한 설치 프로그램은 Windows 2022에서의 설치를 차단합니다.

메모리

128GB 이상 RAM(vCPU당 4GB RAM)

저장소

2개 볼륨:

운영 체제용 30~50GiB 볼륨

Tableau Server용 100GiB 이상의 볼륨

저장소 유형

Premium Storage P20(512GB)++

자세한 내용은 Microsoft Azure 웹 사이트에서 VM의 고성능 Premium Storage 및 관리 디스크를 참조하십시오.

디스크 지연 시간

Windows의 Avg. Transfer disk/sec 성능 카운터로 측정 시 20ms보다 작거나 같아야 합니다.

[주요 콘텐츠로 건너뛰기](#main-content) # Microsoft Azure 기반 Tableau Server 문제 해결 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Microsoft Azure VM(가상 컴퓨터) 기반 Tableau Server에서 문제가 발생하거나 설치 후 Tableau Server에 액세스하는 데 문제가 발생하는 경우 다음 문제 해결 팁을 검토하십시오. - **RDP를 사용하여 VM에 연결할 수 없음** 다음 문제가 하나 이상 있는 경우 RDP를 사용하여 VM에 연결하지 못할 수 있습니다. - 올바른 자격 증명을 사용하고 있는지 확인합니다. - **다른 사용자** 옵션을 선택하고 자격 증명을 입력합니다. - Microsoft Azure VM에서 유효한 사용자 이름을 사용하고 있는지 확인합니다. 예를 들어 **myuser**라는 관리자 계정으로 인스턴스를 만든 경우 RDP 대화 상자에서 **.\\myuser**를 사용자 이름으로 입력합니다. - **원격 브라우저에서 서버에 액세스할 수 없음** 다음 문제가 하나 이상 있는 경우 원격 브라우저를 사용하여 서버에 액세스하지 못할 수 있습니다. - 인스턴스에 로그인하고 서버가 실행 중인지 확인합니다. - 인스턴스에서 브라우저를 열고 서버에 로컬로 액세스합니다(예: http://localhost 또는 http://localhost:port. 여기서 port는 서버의 수신 포트로 구성된 포트 번호임). - Microsoft Azure 대시보드에서 인스턴스에 대한 HTTP 트래픽을 허용하도록 끝점을 구성했는지 확인합니다. **참고:** Windows ping 유틸리티를 사용하여 인스턴스에 대한 연결을 테스트할 수 없습니다. ping 유틸리티를 공용 인터넷에서 사용하는 경우 항상 시간 초과가 보고됩니다. - **Tableau Server 라이선스가 취소됨 오류 메시지가 표시됨** 라이선스를 비활성화하지 않고 인스턴스를 종료한 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 [Tableau Server를 호스팅하는 가상 컴퓨터를 재부팅한 후 "Tableau Server is unlicensed" 오류 발생](https://kb.tableau.com/articles/issue/error-tableau-server-is-unlicensed-after-rebooting-virtual-aws-machine-hosting-tableau-server?lang=ko-kr)을 참조하십시오. - **Tableau Server가 모든 CPU 코어를 사용하지 않음** Tableau Server 코어 기반 라이선스를 사용할 때 다음과 같은 증상이 하나 이상 발생할 수 있습니다. - Tableau Server 설치 시 설치 프로그램에 Tableau Server를 실행 중인 컴퓨터에서 표시되는 것보다 적은 수의 코어가 나타날 수 있습니다. - Tableau Server의 라이선스 페이지에서 사용 중인 라이선스 아래에 표시되는 코어 수가 예상보다 적게 표시됩니다. - `tsm licenses list`를 실행할 경우 Tableau Server가 보고하는 코어 수가 예상보다 적을 수 있습니다. 자세한 내용은 [Tableau Server에서 일부 코어가 인식 안 됨](http://kb.tableau.com/articles/issue/not-all-cores-recognized-by-tableau-server?lang=ko-kr)을 참조하십시오. - **Windows를 실행하는 Microsoft Azure VM에 설치된 Tableau Server의 성능이 저하됨** Windows Azure 가상 컴퓨터에 Tableau Server를 설치한 후 성능 저하 또는 시스템 안정성 저하와 관련된 문제가 발생할 수 있습니다. - Azure를 실행하는 가상 컴퓨터가 Tableau Server의 최소 요구 사항을 충족하는지 확인합니다. - 성능을 최적화하려면 Tableau Server를 지연 시간이 짧은 디스크에 설치해야 합니다. 지연 시간이 짧은 디스크를 사용하여 Azure 가상 컴퓨터를 구성하는 방법에 대한 자세한 내용은 Microsoft Azure 웹 사이트에서 [VM의 고성능 Premium Storage 및 관리 디스크](https://docs.microsoft.com/ko-kr/azure/storage/common/storage-premium-storage)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft Azure 기반 Tableau Server 배포 옵션 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 자체 배포를 사용하거나, Azure 빠른 시작을 통해 Linux를 실행하는 단일 VM에 배포하거나, Azure Marketplace VM의 미리 구성된 배포를 통해 Microsoft Azure 기반 Tableau Server를 배포할 수 있습니다. 다음 표에는 각 옵션의 차이점이 나와 있습니다.
Tableau ServerAzure VM 자체 배포Azure Quick StartAzure Marketplace VM
프로덕션 지원성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.빨간색 X 아이콘입니다.
VM을 바꾸지 않고 Tableau 업그레이드성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.
Linux에서 설치성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.
Windows에서 설치성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
스케일업성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
스케일아웃(노드 추가)성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.
Active Directory 지원성공을 나타내는 확인 표시 아이콘입니다.빨간색 X 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
BYOL 라이선스성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.성공을 나타내는 확인 표시 아이콘입니다.
각 배포 옵션에 대한 자세한 내용이 아래에 설명되어 있습니다. - **Azure VM에 자체 배포** – 가장 유연한 배포 옵션이며 Tableau Server를 환경에 맞게 사용자 지정할 수 있습니다. 단기간 동안만 실행할 시스템(테스트 또는 평가용)을 시작하는 경우 Azure Marketplace VM의 Tableau Server를 대신 사용하십시오. Tableau Server를 Azure VM에 자체 배포하는 옵션은 간소화된 구성으로 시작해서 나중에 확장해야 하는 개발, 테스트 및 프로덕션 환경에 권장됩니다. 자체 배포에 대한 자세한 내용은 [단일 Microsoft Azure 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_azure_single_server.htm)를 참조하십시오. 분산 환경의 배포에 대한 자세한 내용은 [분산 환경의 Microsoft Azure 기반 Tableau Server 자체 배포](https://help.tableau.com/current/server/ko-kr/ts_azure_multiple_server.htm)를 참조하십시오. - **Azure 기반 Tableau Server 빠른 시작** – Azure Resource Manager 템플릿을 사용하여 CentOS, RHEL(Redhat Enterprise Linux) 또는 Ubuntu Server를 실행하는 독립 실행형 Azure VM에 모든 필요한 인프라 요소와 함께 Tableau Server를 설치합니다. 이 배포 전략을 사용하면 빠르게 라이브로 전환하고 전체 비용을 절감할 수 있습니다. Azure 기반 Tableau Server 빠른 시작은 단순하게 시작하지만 나중에 스케일업 또는 스케일아웃해야 할 수 있는 개발, 테스트 및 프로덕션 환경에 권장됩니다. 자체 라이선스(BYOL)를 사용하거나 [영업 팀에 문의](https://www.tableau.com/ko-kr/about/contact#contact_sales)하여 제품 키를 확인할 수 있습니다. VM을 바꾸지 않고도 Tableau Server를 업그레이드할 수 있습니다. 빠른 시작을 사용하여 Tableau Server를 설치하는 것에 대한 자세한 내용은 Microsoft 웹 사이트에서 [Tableau Server Linux 단일 노드(영문)](https://azure.microsoft.com/ko-kr/resources/templates/tableau-server-single-node/)를 참조하십시오. - **Azure Marketplace VM** – 미리 구성된 서버 이미지에 따라 Microsoft Azure에 Tableau Server를 설치하고 실행할 수 있는 가장 빠른 방법 중 하나는 Azure Marketplace를 통하는 것입니다. 이 옵션은 Windows를 실행하는 Azure VM에 Tableau Server를 설치합니다. Azure Marketplace의 Tableau Server는 BYOL(Bring Your Own License) 모델을 통해서만 제공됩니다. Azure VM에서 Tableau Server를 설치하고 실행한 후 Tableau Server 라이선스를 구매하고 연결된 제품 키를 활성화할 수 있습니다. Tableau Server Azure Marketplace VM은 단기간의 테스트 및 개념 검증 환경에만 권장됩니다. Azure Marketplace VM을 설치하려면 1. Azure Portal Marketplace로 이동하고 “Tableau Server”를 검색합니다. 2. Tableau Server를 선택하고 이미지를 만듭니다. 3. 구독 정보를 입력하고 리소스 그룹 및 배포 위치를 선택합니다. 4. 가상 컴퓨터 크기를 선택합니다. 5. 디스크 유형, 저장소 계정, 서브넷 등의 선택적 기능을 구성합니다. 6. 서버 구성의 유효성을 검사합니다. 7. Tableau Server를 배포합니다. Tableau Server의 라이선스 옵션에 대한 자세한 내용은 [라이선스 개요](https://help.tableau.com/current/server/ko-kr/license_server_overview.htm)를 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft Azure 기반 Tableau Server 토폴로지 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Microsoft Azure에 Tableau Server를 배포하는 경우 Tableau Desktop과 Microsoft Azure VM(가상 컴퓨터) 기반 Tableau Server 간의 통합 수준 및 정도를 선택할 수 있습니다. Tableau Desktop과 데이터 원본에서 데이터를 추출하는 Tableau Desktop 기능을 사용하여 데이터와 Tableau Server 사이를 연결하는 역할로 사용할 수 있습니다. 필요에 따라 또는 Microsoft Azure에 이미 많은 양의 데이터가 있는 경우 Tableau Server와 함께 전체 범위의 Microsoft Azure 서비스를 활용하도록 선택할 수 있습니다. 다음 다이어그램에서는 Tableau Desktop 및 Tableau Server와의 데이터 원본 통합을 보여 줍니다. ![Tableau Desktop과 클라우드 기반 가상 컴퓨터를 통해 원시 데이터에서 사용자 액세스까지의 데이터 변환 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_cloud_topology.png) 다음 다이어그램에서 모든 데이터는 Microsoft Azure에서 호스팅됩니다. 안전하고 확장 가능한 방식으로 관리되는 구조화 데이터 및 비구조화 데이터를 모두 분석할 수 있습니다. Microsoft Azure에만 있는 데이터, Microsoft Azure 외부에 있는 관리되지 않는 데이터 또는 이 둘의 조합을 활용할 수 있습니다. 두 유형의 데이터가 동일하게 지원되므로, 이러한 유연성은 온프레미스 데이터에서 클라우드로의 이동을 지원하는 조직의 역량을 크게 향상시킵니다. ![Azure의 데이터를 사용하여 데이터 수집, 저장, 분석 및 시각화 프로세스를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tableau_azure_data_sources.png) [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft Azure에 Tableau Server 설치 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 Microsoft Azure VM(가상 컴퓨터)에 Tableau Server를 설치하면 로컬 환경에서도 Tableau Server의 고급 기능을 사용할 수 있습니다. 고가의 서버를 여러 대 구입하고 유지 관리할 필요 없이 스케일업 및 스케일아웃을 수행할 수 있는 유연성이 필요한 경우 Microsoft Azure VM에서 Tableau Server를 실행하는 것이 탁월한 선택입니다. 예를 들어 Tableau Server를 고가용성으로 구성하고, 다수의 조직에서 사용되는 모든 공통 엔터프라이즈 응용 프로그램(예: Active Directory)을 통합할 수 있습니다. Linux에서 Tableau Server를 사용하려고 하십니까? [Microsoft Azure에 Tableau Server 설치](https://help.tableau.com/current/server-linux/ko-kr/ts_azure_welcome.htm "새 브라우저 탭에서 항목이 열림")를 참조하십시오. Tableau Server는 다수의 기본 Azure 기능을 활용할 수 있습니다. - [Azure SQL Database](https://docs.microsoft.com/ko-kr/azure/sql-database/): Microsoft SQL Server 엔진을 사용하는 관계형 DBaaS(Database-as-a-Service)입니다. - [Azure Synapse Analytics](https://docs.microsoft.com/ko-kr/azure/sql-data-warehouse/): (이전 명칭: Azure SQL Data Warehouse) MPP(대규모 병렬 처리) 클라우드 기반 분산 데이터베이스 시스템입니다. - [Azure HDInsight의 Apache Spark](https://docs.microsoft.com/ko-kr/azure/hdinsight/hdinsight-apache-spark-overview): 빅 데이터 분석 응용 프로그램을 위한 오픈 소스 병렬 처리 프레임워크입니다. - [Azure Active Directory](https://docs.microsoft.com/ko-kr/azure/active-directory/): 클라우드 기반 디렉터리 및 ID 관리 서비스입니다. 또한 다음과 같은 Microsoft 기능을 사용하여 Tableau Server에서 사용할 데이터를 저장할 수 있습니다. Tableau는 다음과 같은 Microsoft 데이터 원본에 데이터를 연결할 수 있게 해 주는 기본 데이터 [커넥터](https://help.tableau.com/current/pro/desktop/ko-kr/help.htm#exampleconnections_overview.htm)를 제공합니다. - [Azure Synapse Analytics](https://help.tableau.com/current/pro/desktop/ko-kr/examples_azure_sql_dw.htm): 엔터프라이즈용 클라우드 데이터 웨어하우스입니다. - [Microsoft Access](https://help.tableau.com/current/pro/desktop/ko-kr/examples_access.htm): Microsoft Office에 포함된 관계형 데이터베이스 관리 시스템입니다. - [Microsoft Analysis Services](https://help.tableau.com/current/pro/desktop/ko-kr/examples_msas.htm): Microsoft SQL Server의 OLAP(온라인 분석 및 트랜잭션 처리) 및 데이터 마이닝 도구입니다. - [Microsoft Excel](https://help.tableau.com/current/pro/desktop/ko-kr/examples_excel.htm): Microsoft Office에 포함된 스프레드시트입니다. - [Microsoft PowerPivot](https://help.tableau.com/current/pro/desktop/ko-kr/examples_powerpivot.htm): Microsoft Excel 추가 기능으로, 여러 원본의 데이터를 단일의 통합 문서로 가져오고, PivotTables 및 PivotCharts를 만들고, 데이터를 분석할 때 사용할 수 있습니다. - [Microsoft SQL Server](https://help.tableau.com/current/pro/desktop/ko-kr/examples_sqlserver.htm): SQL(구조적 쿼리 언어)을 사용하는 관계형 데이터베이스 관리 시스템입니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Microsoft Azure에 Tableau Server를 설치하는 최상의 방법 ## 아카이브된 콘텐츠 공용 클라우드에서의 배포는 계속 지원되지만 타사 공용 클라우드 배포에 대한 콘텐츠는 더 이상 업데이트되지 않습니다. 최신 Tableau Server 배포 콘텐츠는 Tableau Server 도움말의 [배포](https://help.tableau.com/current/server/ko-kr/install.htm) 섹션을 참조하십시오. 액세스 권한이 있는 고객에게는 Tableau Cloud이 권장됩니다. 자세한 내용은 다음을 참조하십시오. - [Tableau Cloud 수동 마이그레이션 가이드](https://help.tableau.com/current/guides/migration/ko-kr/emg_intro.htm) - [관리자를 위한 Tableau Cloud 평가판](https://help.tableau.com/current/server-linux/ko-kr/install.htm) - [Tableau Cloud: 관리자로 시작하기](https://www.tableau.com/ko-kr/learn/get-started/online-admin) ## 소개 클라우드에서 Tableau Server를 원활하게 설치하려면 다음과 같은 최상의 방법을 따르십시오. - Tableau Server [배포 계획](https://help.tableau.com/current/server/ko-kr/plan.htm) 섹션을 숙지합니다. - [시작하기 전에 준비할 사항](https://help.tableau.com/current/server/ko-kr/ts_azure_prerequisites.htm)을 숙지합니다. - Tableau Server [보안 강화 검사 목록](https://help.tableau.com/current/server/ko-kr/security_harden.htm)을 숙지합니다. - 클라우드 사용 경험이 없다면 Microsoft Azure 기반 Tableau Server를 배포하기 전에 [Azure 체험 계정](https://azure.microsoft.com/ko-kr/free/)을 통해 클라우드 작업 방식에 익숙해지십시오. - Microsoft Azure의 [네트워크 토폴로지](https://docs.microsoft.com/ko-kr/azure/architecture/reference-architectures/hybrid-networking/)를 읽고 아키텍처가 구성된 방식을 이해하십시오. ## 비용 절감 Microsoft Azure는 사용한 시간만큼 지불하는 클라우드 기반 서비스를 제공합니다. 비용은 실행한 서비스와 서비스 사용 기간으로 결정됩니다. 다양한 인스턴스 유형 및 크기 조합이 가능하며, 조합에 따라 비용이 달라집니다. 서비스 요금에 대한 자세한 내용은 [Azure 요금](https://azure.microsoft.com/ko-kr/pricing/calculator/)을 참조하십시오. [Microsoft Azure 요금 계산기](https://azure.microsoft.com/ko-kr/pricing/calculator/)를 사용하여 총 월별 비용을 예측할 수 있습니다. 또한 [Microsoft Azure TCO(총 소유 비용) 계산기](https://azure.microsoft.com/ko-kr/pricing/tco/calculator/)를 사용하여 온프레미스와 클라우드를 비교할 수 있습니다. 사용 비용을 지속적으로 모니터링하고 관리하려면 월별 Microsoft Azure 비용이 미리 정의된 지출 한도에 도달한 경우 알림을 제공하도록 Microsoft Azure 청구 알림을 설정할 수 있습니다. 자세한 내용은 Microsoft Azure 웹 사이트에서 [Microsoft Azure 구독에 대한 청구 또는 크레딧 경고 설정](https://docs.microsoft.com/ko-kr/azure/billing/billing-set-up-alerts)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # mutualSSLSettings 엔터티 상호 SSL을 구성하기 전에 [Tableau Server에서 들어오고 나가는 외부 HTTP 트래픽에 대해 SSL 구성](https://help.tableau.com/current/server/ko-kr/ssl_config.htm)을 검토하십시오. `mutualSSLSettings` 엔터티는 SSL 및 상호 SSL 구성을 결합합니다. 상호 SSL을 사용하려면 외부 SSL을 사용하도록 설정하고 올바르게 구성해야 합니다. TSM 엔터티는 JSON 및 키-값 쌍을 사용합니다. 아래의 구성 파일 템플릿을 사용하여 .json 파일을 만듭니다. 환경에 적합한 키의 값을 제공하고 다음 명령을 사용하여 .json 파일을 Tableau Server에 전달합니다. `tsm settings import -f ` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 구성 템플릿 이 템플릿을 사용하여 상호 SSL 설정을 구성하십시오. **중요:** 모든 엔터티 옵션은 대/소문자를 구분합니다. 구성 파일, 엔터티 및 키에 대한 자세한 설명은 [구성 파일 예제](https://help.tableau.com/current/server/ko-kr/config_file_example.htm)를 참조하십시오. { "configEntities": { "mutualSSLSettings": { "\_type": "mutualSSLSettingsType", "sslEnabled": true, "proxyLogin": false, "clientCertRequired": true, "caCertFile": "required", "keyFileName": "required", "keyPassphrase": "", "chainFile": "", "revocationFile": "", "redirect": false, "fallbackToPassword": true, "protocols": "", "cipherSuite": "", "forceHttpsForPublicEmbed": false } } } ## 구성 파일 참조 sslEnabled SSL을 사용하도록 설정합니다. 이것은 상호 SSL을 사용하기 위한 필수 요건입니다. clientCertRequired(MutualSSL) 상호 SSL 인증을 사용하려면 true로 설정합니다. 사용하지 않으려면 false로 설정합니다. caCertFile(MutualSSL) 필수 항목입니다. 양방향 SSL을 위한 CA 발급 인증서 파일을 지정합니다. 파일 경로는 Tableau Server에서 읽을 수 있어야 합니다. certFileName 서버 인증서의 인증서 체인을 형성하는 PEM 인코딩된 CA 인증서의 연결을 포함하는 파일을 지정합니다. 또한 편의를 위해 CA 인증서가 서버 인증서에 직접 추가되는 경우 참조된 파일은 caCertFile과 동일할 수 있습니다. keyFileName 키가 인증서와 결합되지 않은 경우 이 구성 키를 사용하여 키 파일을 가리킵니다. RSA 및 DSA 개인 키가 모두 있는 경우 DSA 암호의 사용을 허가하는 등, 두 개인 키를 병렬로 구성할 수 있습니다. keyPassphrase 선택 사항입니다. 인증서 파일의 암호입니다. 입력한 암호는 유휴 시간 중에 암호화됩니다. **참고:** 암호를 사용하여 인증서 키 파일을 만든 경우 SAML에 SSL 인증서 키를 재사용할 수 없습니다. revocationFile SSL CA 인증서 해지 목록(.crl) 파일의 파일 경로를 지정합니다. Redirect 기본값: true. Tableau Server에서 http 요청을 적절한 끝점에 https 요청으로 리디렉션해야 하는지 여부를 지정합니다. clientCertMapping(MutualSSL) 인증서의 사용자 이름을 검색하는 방법을 지정합니다. 허용되는 값: `ldap`, `upn`, `cn` - 로컬 인증을 사용하는 서버인 경우 기본 설정은 `upn`(사용자 계정 이름)입니다. - Tableau Server 인증이 AD(Active Directory)를 사용하도록 구성된 경우 기본값은 `ldap`(Lightweight Directory Access Protocol)입니다. 이 값을 사용하면 서버가 사용자의 유효성을 검사하기 위해 AD로 이동하게 되며 인증서 내의 이름을 무시합니다. 두 인증 유형에서 인증서의 주체 DN에 있는 CN을 사용하려면 `cn`을 설정합니다. 자세한 내용은 [상호 인증 중에 클라이언트 인증서를 사용자에게 매핑](https://help.tableau.com/current/server/ko-kr/ssl_mutual_mapping_username.htm)을 참조하십시오. fallbackToPassword(MutualSSL) 상호 SSL 인증이 실패한 경우 사용자 이름 및 암호를 사용하여 Tableau Server에 로그인하는 옵션을 사용자에게 제공하려면 true로 설정합니다. 이 대체 인증 옵션을 허용하지 않으려면 false로 설정합니다. protocols 허용하거나 허용하지 않을 TLS(Transport Layer Security) 프로토콜 버전을 나열합니다. 기본값: `"all -SSLv2 -SSLv3"` 하지만 다음 설정을 사용하는 것이 좋습니다. `"all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1"` 자세한 내용은 [tsm security external-ssl enable](https://help.tableau.com/current/server/ko-kr/cli_security_tsm.htm#external-ssl-enable)을 참조하십시오. 일반적인 정보는 Apache 온라인 설명서를 참조하십시오. cipherSuite SSL에 대해 허용하거나 허용하지 않으려는 암호를 나열합니다. 기본값: `"HIGH:MEDIUM:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED"` 암호 목록 형식은 [OpenSSL ciphers(OpenSSL 암호)](https://www.openssl.org/docs/man1.0.2/man1/ciphers.html) 페이지를 참조하십시오. 이 옵션을 변경할 때는 주의를 기울이십시오. 기본값은 충분히 안전한 것으로 간주되지 않는 암호를 허용하지 않습니다. proxyLogin 기본값: false. Tableau Server가 로그인에만 SSL용 프록시를 사용하도록 지정합니다. 이 값은 서버가 로그인 API에 대해 Tableau Desktop에 보고하는 프로토콜을 제어합니다. forceHTTPForPublicEmbed 기본값: false. 내장된 뷰의 코드에서 SSL을 사용하도록 강제합니다. [주요 콘텐츠로 건너뛰기](#main-content) # OAuth 2.0 신뢰를 사용하여 연결된 앱 구성 Tableau Server 관리자는 하나 이상의 EAS(외부 권한 부여 서버)를 등록하여 Tableau Server와 EAS 간의 신뢰 관계를 OAuth 2.0 표준 프로토콜을 사용하여 설정할 수 있습니다. **중요:** - 이 항목의 일부 절차에는 타사 소프트웨어 및 서비스를 사용한 구성이 필요합니다. Tableau는 Tableau Server에서 EAS 기능을 사용하도록 설정하는 절차를 확인하기 위해 최선을 다했습니다. 그러나 타사 소프트웨어 및 서비스에서 변경되었거나 조직에 따라 다를 수 있습니다. 문제가 발생하는 경우 신뢰할 수 있는 구성 세부 정보 및 지원은 타사 설명서를 참조하십시오. - EAS를 통한 내장 기능을 사용하려면 HTTP 트래픽에 SSL을 사용하도록 Tableau Server를 구성해야 합니다. - 세션 토큰이 유효하려면 외부 응용 프로그램의 시계와 외부 응용 프로그램을 호스트하는 서버의 시계가 UTC(협정 세계시)로 설정되어야 합니다. 두 클록이 다른 표준 시간대를 사용하는 경우 연결된 앱을 신뢰할 수 없게 됩니다. ## OAuth 2.0 신뢰와 Tableau 연결된 앱이 작동하는 방식 Tableau Server 사이트와 외부 응용 프로그램 간의 신뢰 관계는 JWT(JSON Web Token) 표준의 인증 토큰을 통해 설정되고 검증됩니다. 내장된 Tableau 콘텐츠를 외부 응용 프로그램에 로드하면 인증 코드 흐름인 OAuth 흐름이 사용됩니다. 사용자가 IdP에 로그인하면 자동으로 Tableau Server에 로그인됩니다. 아래에 설명된 단계에 따라 EAS를Tableau Server 에 등록합니다. ### 연결된 앱의 주요 구성 요소 연결된 앱의 다음 구성 요소는 외부 응용 프로그램의 JWT와 함께 작동하여 사용자를 인증하고 내장된 콘텐츠를 표시합니다. - **EAS(외부 권한 부여 서버):** 일반적으로 사용자와 외부 응용 프로그램 간의 인터페이스 역할을 하는 서버로, 주로 IdP가 이 역할을 수행합니다. 서버는 보호된 Tableau 콘텐츠에 대한 사용자 액세스를 인증하고 권한을 부여합니다. - **발급자 URL:** EAS 인스턴스를 고유하게 식별하는 URL입니다. ### 연결된 앱 워크플로우 #### 내장 워크플로우 아래의 다이어그램은 EAS(외부 권한 부여 서버), 외부 응용 프로그램(웹 서버 및 웹 페이지), Tableau 연결 앱 간의 인증이 작동하는 방식을 보여 줍니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_how_EAS.png) 1. **사용자가 웹 페이지를 방문:** 사용자가 웹 페이지의 내장된 콘텐츠를 방문하면 웹 페이지가 외부 응용 프로그램으로 GET 요청을 보냅니다. 2. **외부 응용 프로그램이 요청을 EAS로 리디렉션:** 외부 응용 프로그램은 EAS(외부 권한 부여 서버)로 리디렉션되는 웹 페이지로 응답합니다. 3. **EAS로 사용자 인증:** EAS를 통해 사용자를 인증하고 권한을 부여합니다. 4. **EAS는 인증 코드로 웹 페이지에 응답:** EAS는 인증 코드로 페이지에 응답하고 웹 페이지로 다시 리디렉션합니다. 5. **EAS가 인증 코드를 JWT로 변환:** 웹 페이지가 EAS를 호출하여 인증 코드를 JWT로 변환하고, 웹 페이지는 이를 내장된 콘텐츠의 URL에 삽입합니다. 6. **웹 페이지가 Tableau의 콘텐츠를 요청:** 웹 페이지가 iFrame을 로드하고 Tableau에 GET 요청을 보냅니다. 7. **Tableau가 토큰 검증:** Tableau는 서명이 있는 URL의 JWT 유효성을 검사하고 콘텐츠로 응답하며 JWT에 정의된 내장 범위를 준수합니다. ## 연결된 앱 만들기 ### 1단계: 시작하기 전에 EAS를 Tableau Server 에 등록하려면 EAS가 이미 구성되어 있어야 합니다. 또한 EAS에서 아래 표에 나열된 등록된 클레임 및 헤더가 포함된 유효한 JWT(JSON Web Token)를 전송해야 합니다.
클레임이름설명 또는 필요한 값
"kid"Key ID필수입니다(헤더에 필요). ID 공급자의 고유 키 식별자입니다.
"iss"Issuer필수입니다(헤더 또는 클레임에 필요). 신뢰할 수 있는 연결된 앱 및 서명 키를 식별하는 고유한 발급자 URI입니다.
"alg"Algorithm필수입니다(헤더에 필요). JWT 서명 알고리즘입니다. 지원되는 알고리즘 이름은 javadoc.io 설명서의 JWSAlgorithm 클래스(영문) 페이지에 나열되어 있습니다. 서명 알고리즘은 vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms 명령을 사용하여 구성할 수 있습니다.
"sub"Subject인증된 Tableau Server 사용자의 사용자 이름입니다.
"aud"Audience

값은 "tableau"여야 합니다.

"exp"Expiration Time유효한 JWT는 만료되지 않아야 합니다. JWT의 만료 시간(UTC 기준)은 구성된 최대 유효 기간 안에 있어야 합니다. 최대 유효 기간은 vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes 명령을 사용하여 구성할 수 있습니다.
"jti"JWT IDJWT ID 클레임은 JWT의 고유 식별자를 제공하며 대/소문자를 구분합니다.
"scp"Scope

내장 워크플로우의 경우 지원되는 값은 다음과 같습니다.

"tableau:views:embed"
"tableau:views:embed_authoring"(Tableau Server 2022.3에 추가됨)
"tableau:metrics:embed"(Tableau Server 2023.3에서 사용 중지됨)
'tableau:ask_data:embed'(Tableau Server 2023.1에 추가됨 Tableau Server 2024.2에서 사용 중지됨)

참고:

  • 값을 목록 유형으로 전달해야 합니다.
  • tableau:views:embed의 경우 범위는 Tableau Server에서 이미 구성된 사용자의 사용 권한을 따르며 원본 뷰에서 사용할 수 있는 경우 내장된 뷰에서 도구와 상호 작용할 수 있습니다.
  • 내장 코드에는 툴바 매개 변수를 제외하는 것이 좋습니다. 자세한 내용은 아래에서 알려진 문제(내장 워크플로우만 해당)를 참조하십시오.

REST API 권한 부여 워크플로우의 경우 JWT 권한 부여를 지원하는 REST API 메서드를 참조하십시오.

인증을 위해 REST API를 사용하는 메타데이터 API 워크플로우의 경우 유일하게 지원되는 범위는 tableau:content:read입니다.

인증을 위해 REST API를 사용하는 VizQL 데이터 서비스 워크플로우의 경우 유일하게 지원되는 범위는 tableau:viz_data_service:read입니다.

https://tableau.com/groups동적 그룹 멤버십내장 워크플로우만 해당합니다.

값은 Tableau Server에 있는 하나 이상의 그룹 이름과 일치해야 합니다. 자세한 내용은 어설션을 사용한 동적 그룹 멤버십를 참조하십시오.

(사용자 특성)(사용자 특성 값)

내장 워크플로우만 해당합니다.

Tableau Server 2025.1부터 사용자 특성을 JWT에 포함할 수 있습니다. 내장된 콘텐츠에서 사용자 특성 함수가 사용되는 경우 Tableau는 인증된 사용자의 컨텍스트를 확인하고 런타임 시 표시할 수 있는 데이터를 결정합니다.

참고:

**참고:** 위의 JWT 클레임은 IETF(Internet Engineering Task Force) 조직에서 배포한 설명서의 [등록된 클레임 이름(영문)](https://datatracker.ietf.org/doc/html/rfc7519#section-4.1) 섹션에 문서화되어 있습니다. ### 2단계: Tableau Server에 EAS 등록 Tableau Server에 EAS를 등록하면 EAS와 Tableau Server 간의 신뢰 관계가 설정됩니다. 즉, 사용자가 외부 응용 프로그램에 내장된 Tableau 콘텐츠에 액세스하면 IdP를 통한 인증을 위해 리디렉션됩니다. EAS에서 인증 토큰이 생성되고 확인을 위해 Tableau Server로 전달됩니다. 신뢰 관계가 확인되면 내장된 콘텐츠에 대한 액세스 권한이 사용자에게 부여됩니다. **참고:** 일부 EAS는 Tableau 콘텐츠에 대한 응용 프로그램 액세스에 대해 사용자의 승인을 구하는 동의 대화 상자를 표시하는 옵션을 지원합니다. 최상의 사용자 경험을 보장하려면 외부 응용 프로그램의 요청에 사용자 대신 자동으로 동의하도록 EAS를 구성하는 것이 좋습니다. #### 사이트 수준 EAS 정보 Tableau Server 2024.2부터 사이트 수준 EAS를 구성할 수 있습니다. 사이트 수준에서 EAS를 등록하려면 TSM(Tableau Server Manager)에서 연결된 앱을 사용하도록 설정해야 합니다. 서버 전체 EAS를 등록하는 방법에는 TSM 웹 UI를 사용하거나 TSM CLI를 사용하는 두 가지 방법이 있습니다. EAS를 등록한 후 설정된 신뢰 관계는 Tableau Server의 모든 사이트에 적용됩니다. ### 옵션 1: TSM 웹 UI 사용 1. Tableau Server 관리자로 TSM(Tableau 서비스 관리자) 웹 UI에 로그인합니다. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm#sign-in-to-the-tsm-web-ui)을 참조하십시오. 2. 다음 작업 중 _하나_를 수행합니다. - Tableau Server 2024.2 이상에서는 사용자 ID 및 액세스 페이지 > 연결된 앱 탭으로 이동합니다. - Tableau Server 2023.3 이하에서는 사용자 ID 및 액세스 페이지 > 권한 부여 서버 탭으로 이동합니다. 3. 다음 작업 중 _하나_를 수행합니다. - Tableau Server 2024.2 이상: 1. 연결된 앱 사용 확인란을 선택합니다. 2. 두 번째 라디오 버튼인 연결된 앱 허용(사이트 수준에서 구성) 및 서버 전체 OAuth 2.0 신뢰(그 아래 구성)를 선택합니다. 3. 발급자 URL 텍스트 상자에 EAS의 발급자 URL을 붙여 넣습니다. 4. 보류 중인 변경 내용 저장 단추를 클릭합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_eas_register_new.png) - Tableau Server 2023.3 이하: 1. 내장된 콘텐츠에 OAuth 액세스 사용 확인란을 선택합니다. 2. 발급자 URL 텍스트 상자에 EAS의 발급자 URL을 붙여 넣습니다. 3. 보류 중인 변경 내용 저장 단추를 클릭합니다. ![외부 권한 부여 서버 등록 양식입니다.](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_eas_register.png) 4. 작업을 마치면 다음을 수행합니다. 1. 페이지의 오른쪽 위에서 보류 중인 변경 내용 단추를 클릭합니다. 2. 페이지의 오른쪽 아래에서 변경 내용 적용 후 다시 시작 단추를 클릭하여 Tableau Server를 중지했다가 다시 시작합니다. ![권한 부여가 보류 중인 외부 구성 변경 내용 목록이며, 변경 내용을 적용하거나 취소할 수 있는 옵션이 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_eas_save.png) ### 옵션 2: TSM CLI 사용 1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다. 2. 다음 명령을 실행합니다. tsm configuration set -k vizportal.oauth.external\_authorization.enabled -v true tsm configuration set -k vizportal.oauth.external\_authorization\_server.issuer -v "" tsm restart Tableau Server 2024.2부터 사이트에 하나 이상의 EAS를 등록할 수 있습니다. 사이트 수준에서 EAS를 등록하면 설정된 신뢰 관계가 해당 사이트에만 적용됩니다. **참고:** 사이트 수준 EAS를 구성하려면 먼저 TSM에서 연결된 앱을 사용하도록 설정해야 합니다. ### 1단계: 연결된 앱 사용 1. Tableau Server 관리자로 TSM(Tableau 서비스 관리자) 웹 UI에 로그인합니다. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm#sign-in-to-the-tsm-web-ui)을 참조하십시오. 2. 사용자 ID 및 액세스 페이지 > 연결된 앱 탭으로 이동합니다. 3. 연결된 앱 사용 확인란을 선택합니다. 4. 다음 작업 중 _하나_를 수행합니다. - 첫 번째 라디오 버튼 연결된 앱 허용(사이트 수준에서 구성)을 선택하고 사이트 수준에서만 EAS 등록을 사용하도록 설정합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_eas_register_radio.png) - (기본값) 두 번째 라디오 버튼인 연결된 앱 허용(사이트 수준에서 구성) 및 서버 전체 OAuth 2.0 신뢰(그 아래 구성)를 선택하여 사이트 수준과 서버 전체에서 EAS 등록을 사용하도록 설정합니다. 이 옵션을 선택하는 경우 사이트 수준에서 지정된 발급자 URL이 서버 전체 발급자 URL과 달라야 합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_eas_register_radio_default.png) 5. 보류 중인 변경 내용 저장 단추를 클릭합니다. 6. 작업을 마치면 다음을 수행합니다. 1. 페이지의 오른쪽 위에서 보류 중인 변경 내용 단추를 클릭합니다. 2. 페이지의 오른쪽 아래에서 변경 내용 적용 후 다시 시작 단추를 클릭하여 Tableau Server를 중지했다가 다시 시작합니다. ### 2단계: EAS 등록 1. Tableau Server 관리자로 Tableau Server에 로그인합니다. 2. 왼쪽 패널에서 설정 > 연결된 앱을 선택합니다. 3. 새 연결된 앱 단추 드롭다운 화살표를 클릭하고 OAuth 2.0 신뢰를 선택합니다. 4. 연결된 앱 만들기 대화 상자에서 다음을 수행합니다. 1. 이름 텍스트 상자에 연결된 앱의 이름을 입력합니다. 2. 발급자 URL 텍스트 상자에 EAS의 발급자 URL을 붙여 넣습니다. 3. 연결된 앱 사용을 선택합니다. 연결된 앱은 보안을 위해 앱을 만들 때 기본적으로 사용되지 않도록 설정됩니다. 4. 작업을 마치면 만들기 단추를 클릭합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_create_eas.png) 5. 연결된 앱이 만들어지면 연결된 앱의 사이트 ID를 복사합니다. 사이트 ID는 위의 1단계에서 설명한 JWT의 “aud”(Audience) 클레임에 사용됩니다. ![사이트 ID를 복사하는 단추가 있는 외부 권한 부여 서버의 세부 정보입니다.](/tableau/current/ko-kr/server/ko-kr/Img/connectedapp_eas_button_luid.png) ### 3단계: 다음 단계 #### 내장 워크플로우의 경우 EAS를 사용하도록 Tableau Server 를 구성한 후에는 내장 코드를 외부 응용 프로그램에 추가해야 합니다. 위의 1단계에 설명된 대로 EAS를 통해 생성된 유효한 JWT를 외부 응용 프로그램에서 호출하는 웹 구성 요소에 포함해야 합니다. Tableau 콘텐츠 내장에 대한 자세한 내용은 다음을 참조하십시오. - [Tableau Embedding API v3](https://help.tableau.com/current/api/embedding_api/en-us/index.html)를 사용하여 Tableau 콘텐츠를 내장합니다. - ABAC(특성 기반 액세스 제어), 주문형 액세스 및 동적 그룹 멤버십에 대한 사용자 특성은 Tableau Embedding API v3에서 [데이터 액세스 사용자 지정 및 제어](https://help.tableau.com/current/api/embedding_api/ko-kr/docs/embedding_api_user_attributes.html)를 참조하십시오. - 메트릭을 포함하려면 Tableau 도움말에서 [웹 페이지에 메트릭 내장](https://help.tableau.com/current/pro/desktop/ko-kr/embed_metrics.htm) 항목을 참조하십시오. (Tableau Server 2023.3에서 메트릭 내장 기능이 사용 중지되었습니다.) **참고:** 사용자가 내장된 콘텐츠에 액세스할 때 성공적으로 인증하려면, 타사 쿠키를 허용하도록 브라우저를 구성해야 합니다. ##### 도메인 허용 목록을 사용하여 콘텐츠를 내장할 수 있는 위치 제어 Tableau Server 2023.3부터 귀하와 귀하의 사용자는 Tableau REST API에서 사이트의 내장 설정 업데이트 메서드를 사용하여 Tableau 콘텐츠를 제한 없이 내장할지, 아니면 특정 도메인으로 제한할지를 제어할 수 있습니다. 기본적으로 내장에 대한 `unrestrictedEmbedding` 사이트 설정이 `true`로 설정되면 무제한 내장이 허용됩니다. 또는 `false`로 설정하고 `allowList` 매개 변수를 사용하여 외부 응용 프로그램의 Tableau 콘텐츠를 내장할 수 있는 도메인을 지정할 수 있습니다. 자세한 내용은 다음 중 하나 또는 둘 모두를 참조하십시오. - [사이트의 내장 설정 업데이트(영문)](https://help.tableau.com/current/api/rest_api/ko-kr/REST/rest_api_ref_site.htm#update_embedding_settings_for_site) - Tableau REST API 도움말 - [내장 관련 Tableau 사이트 설정(영문)](https://help.tableau.com/current/api/embedding_api/ko-kr/docs/embedding_api_site.html#about-tableau-site-settings-for-embedding) - Tableau Embedding API v3 도움말 #### REST API 권한 부여 워크플로우의 경우 JWT를 구성한 후에는 유효한 JWT를 REST API 로그인 요청에 추가해야 액세스 권한이 부여됩니다. 자세한 내용은 [연결된 앱의 액세스 범위](https://help.tableau.com/current/server/ko-kr/connected_apps_scopes.htm)를 참조하십시오. #### 메타데이터 API 워크플로우의 경우 JWT를 구성한 후에는 유효한 JWT를 REST API 로그인 요청에 추가해야 합니다. 자세한 내용은 [연결된 앱의 액세스 범위](https://help.tableau.com/current/server/ko-kr/connected_apps_scopes.htm)를 참조하십시오. #### SCIM 워크플로우용 외부 토큰의 경우 JWT를 구성한 후에는 SCIM 기능을 사용하도록 설정해야 합니다. 자세한 내용은 [OAuth 2.0 신뢰를 사용하여 연결된 앱 구성](#scim)을 참조하십시오. ### 알려진 문제(내장 워크플로우만 해당) 연결된 앱을 사용하는 경우 몇 가지 알려진 문제가 있으며, 이는 향후 릴리스에서 해결될 예정입니다. - **툴바 기능:** 내장된 콘텐츠에 툴바 매개 변수가 정의되어 있으면 일부 툴바 기능이 작동하지 않습니다. 이 문제를 해결하려면 아래 예와 같이 툴바 매개 변수를 숨기는 것이 좋습니다. - **게시된 데이터 원본:** 데이터베이스 자격 증명이 사용자에게 확인으로 설정된 경우 게시된 데이터 원본이 표시되지 않습니다. 이 문제를 해결하려면 가능한 경우 데이터 원본 소유자가 대신 데이터베이스 자격 증명을 내장하는 것이 좋습니다. - **여러 사이트에 내장된 뷰:** Tableau Server 2023.1 이하 버전에서 동일한 브라우저에서 다른 사이트의 뷰 간에 전환하면 1008: 연결된 앱의 암호를 가져올 수 없습니다 오류가 발생합니다. 이 문제를 해결하려면 Tableau Server 2023.3 이상으로 업그레이드하십시오. ### 문제 해결 내장된 콘텐츠가 외부 응용 프로그램에 표시되지 않거나 Tableau REST API 권한 부여가 실패하면 브라우저의 개발자 도구를 사용하여 Tableau Server 에서 사용되는 EAS 기능과 관련되었을 수 있는 오류 코드를 검사하고 식별할 수 있습니다. 아래의 표를 참조하여 오류 코드 설명 및 가능한 해결 방법을 검토하십시오.
오류 코드요약설명잠재적 해결 방법 또는 설명
5SYSTEM_USER_NOT_FOUNDTableau 사용자를 찾을 수 없음
이 문제를 해결하려면 JWT의 'sub'(Subject) 클레임 값이 인증된 Tableau Server의 "username"인지 확인합니다. 이 값은 대/소문자를 구분합니다.
16LOGIN_FAILED로그인 실패이 오류는 일반적으로 JWT의 다음 클레임 문제 중 하나로 인해 발생합니다.
  • 'exp'(Expiration Time)가 기본 최대 유효 기간을 초과합니다. 이 문제를 해결하려면 유효한 JWT에 필요한 등록 클레임을 검토하고 올바른 값이 사용되는지 확인하십시오. 최대 유효 기간을 변경하려면 vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes 명령을 사용하면 됩니다.
  • 'sub'(Subject)가 알 수 없는 사용자를 호출하고 있습니다. 이 문제를 해결하려면 'sub' 클레임이 "username"인지 확인하십시오. 이 값은 대/소문자를 구분합니다.
67FEATURE_NOT_ENABLED주문형 액세스가 지원되지 않음주문형 액세스는 라이선스가 부여된 Tableau Cloud 사이트를 통해서만 사용할 수 있습니다.
10081COULD_NOT_RETRIEVE_IDP_METADATAEAS 메타데이터 끝점이 없음이 문제를 해결하려면 EAS가 올바르게 구성되어 있고 올바른 발급자가 호출되는지 확인하십시오.
10082AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED발급자가 없음이 문제를 해결하려면 올바른 발급자가 호출되는지 확인하십시오. 발급자 URL을 변경하려면 vizportal.oauth.external_authorization_server.issuer 명령을 사용하면 됩니다.
10083BAD_JWTJWT 헤더에 문제가 있음JWT 헤더에서 'kid'(Secret ID) 또는 'clientId'(Issuer) 클레임이 누락되었습니다. 이 문제를 해결하려면 해당 정보가 포함되어 있는지 확인하십시오.
10084JWT_PARSE_ERRORJWT에 문제가 있음이 문제를 해결하려면 다음을 확인합니다.
  • JWT에서 참조하는 'aud'(Audience) 값이 "tableau" 값을 사용합니다. 이 값은 대/소문자를 구분합니다.
  • 'aud'(Audience) 및 'sub'(Subject)가 JWT에 포함되어 있습니다.
10085COULD_NOT_FETCH_JWT_KEYSJWT에서 키를 찾을 수 없음암호를 찾을 수 없습니다.

이 문제를 해결하려면 올바른 발급자가 호출되는지 확인하십시오. 발급자 URL을 변경하려면 vizportal.oauth.external_authorization_server.issuer 명령을 사용하면 됩니다.

10087BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGNJWT 서명 알고리즘에 문제가 있음이 문제를 해결하려면 서명 알고리즘을 제거하면 됩니다. 자세한 내용은 vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms을 참조하십시오.
10088RSA_KEY_SIZE_INVALIDJWT 서명 요구 사항에 문제가 있음이 문제를 해결하려면 EAS 또는 IdP에서 JWT가 2048의 RSA 키 크기로 서명되고 있는지 확인합니다.
10091JTI_ALREADY_USED고유한 JWT가 필요함JWT가 이미 인증 프로세스에서 사용되었습니다. 이 문제를 해결하려면 EAS 또는 IdP에서 새 JWT를 생성해야 합니다.
10092NOT_IN_DOMAIN_ALLOW_LIST내장된 콘텐츠의 도메인이 지정되지 않음이 문제를 해결하려면 unrestrictedEmbedding 설정이 true로 설정되거나, 사이트의 내장 설정 업데이트(영문) 방법을 사용하여 Tableau REST API에서 Tableau 콘텐츠를 내장할 도메인을 domainAllowlist 매개 변수에 포함해야 합니다.
10094MISSING_REQUIRED_JTIJWT ID 누락이 문제를 해결하려면 'jti'(JWT ID)가 JWT에 포함되어 있는지 확인합니다.
10096JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD 'exp'(Expiration Time)가 기본 최대 유효 기간을 초과합니다. 이 문제를 해결하려면 유효한 JWT에 필요한 등록 클레임을 검토하고 올바른 값이 사용되는지 확인하십시오. 최대 유효 기간을 변경하려면 vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes 명령을 사용하면 됩니다.
10097SCOPES_MALFORMEDScope 클레임 관련 문제이 오류는 'scp'(Scope) 클레임이 JWT에서 누락되었거나 목록 유형으로 전달되지 않은 경우 발생할 수 있습니다. 이 문제를 해결하려면 'scp'가 JWT에 포함되었고 목록 유형으로 전달되었는지 확인하십시오. JWT 관련 문제 해결 도움말은 auth0 사이트에서 디버거(영문)를 참조하십시오.
10098JWT_UNSIGNED_OR_ENCRYPTEDJWT가 서명되지 않았거나 암호화되어 있음Tableau는 서명되지 않았거나 암호화된 JWT를 지원하지 않습니다.
10099SCOPES_MISSING_IN_JWTScope 클레임 누락JWT에서 필수 'scp'(Scope) 클레임이 누락되었습니다. 이 문제를 해결하려면 'scp'가 JWT에 포함되어 있는지 확인합니다. JWT 관련 문제 해결 도움말은 auth0 사이트에서 디버거(영문)를 참조하십시오.
10100JTI_PERSISTENCE_FAILED예기치 않은 JWT ID 오류'jti'(JWT ID)에 예기치 않은 오류가 있습니다. 이 문제를 해결하려면 새 'jti'를 사용하여 새 JWT를 생성해야 합니다.
10103JWT_MAX_SIZE_EXCEEDEDJWT가 최대 크기를 초과함이 오류는 JWT 크기가 8000바이트를 초과하는 경우에 발생할 수 있습니다. 이 문제를 해결하려면 필요한 클레임만 Tableau Server에 전달되는지 확인하십시오.
[주요 콘텐츠로 건너뛰기](#main-content) # OAuth 및 최신 인증에 대해 Azure AD 구성 Azure Synapse, Azure SQL Database, Azure Databricks, Azure Data Lake Gen2, OneDrive 및 SharePoint Online, SharePoint 목록(JDBC) 커넥터는 Tableau Server용 OAuth 클라이언트를 구성하여 Azure AD를 통한 인증을 지원합니다. **참고**: 현재 Tableau에 대한 Azure/Entra ID OAuth 연결에는 일회용 새로 고침 토큰(경우에 따라, 순환식 새로 고침 토큰 또는 새로 고침 토큰 순환이라고도 함)이 지원되지 않습니다. 이러한 토큰에 대한 지원은 향후 릴리스에서 제공될 예정입니다. **참고**: Azure AD에 대한 OAuth 지원은 [Microsoft SQLServer 드라이버 17.3](https://docs.microsoft.com/ko-kr/sql/connect/odbc/using-azure-active-directory?view=sql-server-ver15) 이상을 통해서만 지원됩니다. ## 1단계: Azure용 OAuth 클라이언트 등록 특정 Azure 테넌트에서 Azure용 OAuth 응용 프로그램을 등록하고 구성하려면 아래 단계를 따르십시오. 1. [Azure Portal](https://portal.azure.com/)에 로그인합니다. 2. 여러 테넌트에 액세스할 수 있는 경우 응용 프로그램을 등록하려는 테넌트를 선택합니다. 3. **Azure Active Directory**를 검색하여 선택합니다. 4. **Manage(관리)** 아래에서 **App registrations(앱 등록)**을 선택한 다음 **New registration(새 등록)**을 선택합니다. 5. **Name(이름)**에 "Tableau Server OAuth" 또는 유사한 값을 입력합니다. 6. 앱 등록 페이지의 **Supported account types(지원되는 계정 유형)** 필드에서 이 응용 프로그램을 사용할 수 있는 사용자를 선택합니다. **참고**: 다른 테넌트의 계정에 대해 응용 프로그램의 클라이언트 ID 및 클라이언트 암호 값을 사용하려면 두 번째 옵션(다중 테넌트)을 선택하십시오. 8. **URI 리디렉션**(선택사항) 필드 아래에서 **웹**을 선택한 다음 `/auth/add_oauth_token` 문자열이 추가된 서버의 인터넷 주소를 입력합니다. 예를 들면 다음과 같습니다. `https://your_server_url.com/auth/add_oauth_token` 10. **Register(등록)**를 선택합니다. 등록이 완료되면 Azure Portal에 앱 등록의 개요 패널이 표시되고 여기에 응용 프로그램(클라이언트) ID가 포함됩니다. _클라이언트 ID_라고도 하는 이 값은 Microsoft ID 플랫폼에서 응용 프로그램을 고유하게 식별합니다. 11. ID를 복사합니다. 이는 다음 단계에서 `[your_client_id]` 필드로 사용됩니다. 12. 왼쪽 표시줄에서 **Certificates & secrets(인증서 및 암호)**를 선택한 다음 **New client secret(새 클라이언트 암호)**을 선택합니다. 13. 암호의 설명을 추가합니다. 14. **Client secret lifetime(클라이언트 암호 수명)**을 선택합니다. 15. **Add(추가)**를 선택한 다음 암호 값을 복사합니다. 암호 값은 다음 단계에서 `[your_client_secret_value]`로 사용됩니다. 16. 왼쪽 표시줄에서 **API permissions(API 사용 권한)**을 선택합니다. 17. **Add permissions(사용 권한 추가)**를 선택합니다. 18. Microsoft Graph(Microsoft 그래프)를 선택합니다. 19. Delegated permissions(위임된 사용 권한)를 선택합니다. 20. Select permissions(사용 권한 선택) 아래에서 모든 OpenId 사용 권한(email, offline\_access, openid 및 profile)을 선택합니다. 21. Add permissions(사용 권한 추가)를 선택합니다. 22. 통합 문서 사용 권한을 추가합니다. 사용하도록 설정하려는 커넥터에 대해 아래 단계를 따르십시오. - Azure SQL Database 1. Add a permission(사용 권한 추가)을 클릭합니다. 2. My APIs(내 API)를 선택합니다. 3. Azure SQL Database(Azure SQL 데이터베이스)를 클릭한 다음 Delegated permissions(위임된 사용 권한)를 선택합니다. 4. user\_impersonation을 선택한 다음 Add a permission(사용 권한 추가)을 클릭합니다. - OneDrive 및 SharePoint Online 1. Add a permission(사용 권한 추가)을 클릭합니다. 2. Microsoft Graph(Microsoft 그래프)를 선택합니다. 3. Delegated permissions(위임된 사용 권한)를 클릭합니다. 4. Select permissions(사용 권한 선택) 아래의 필터 검색 상자에 다음 사용 권한을 입력하여 추가합니다. - Files.Read.All - Sites.Read.All - User.Read - SharePoint 목록(JDBC) 1. Add a permission(사용 권한 추가)을 클릭합니다. 2. Microsoft Graph(Microsoft 그래프)를 선택합니다. 3. Delegated permissions(위임된 사용 권한)를 클릭합니다. 4. Select permissions(사용 권한 선택) 아래의 필터 검색 상자에 User.Read 사용 권한을 입력하여 추가합니다. 5. Add a permission(사용 권한 추가)을 다시 클릭합니다. 6. SharePoint를 선택합니다. 7. Delegated permissions(위임된 사용 권한)를 클릭합니다. 8. AllSites 섹션을 확장한 후 AllSites.Manage 사용 권한을 선택하여 추가합니다. ## 2단계: Azure에 대해 Tableau Server 구성 Tableau Server를 구성하려면 TSM(Tableau Server Manager) 명령을 실행해야 합니다. Azure Data Lake Storage Gen2에는 Azure Synapse, Azure SQL Database 또는 Databricks에 대해 실행되는 일반적인 명령과 다른 명령 집합이 필요합니다. ### Azure Data Lake Storage Gen2에 대해 기본 OAuth 클라이언트 구성 Data Lake Storage Gen2에 대해 Tableau Server를 구성하려면 다음 구성 매개 변수가 있어야 합니다. - **Azure OAuth 클라이언트 ID:** 클라이언트 ID는 1단계의 절차에서 생성됩니다. 첫 번째 tsm 명령에서 `[your_client_id]`에 이 값을 복사합니다. - **Azure OAuth 클라이언트 암호 값:** 클라이언트 암호 값은 1단계의 절차에서 생성됩니다. 두 번째 tsm 명령에서 `[your_client_secret_value]`에 이 값을 복사합니다. - **Tableau Server URL**: Tableau Server URL(예: `https://myco.com`)을 입력합니다. 세 번째 tsm 명령에서 `[your_server_url]`에 이 값을 복사합니다. 다음 tsm 명령을 실행하여 Azure Data Lake Storage Gen2에 대해 Tableau Server OAuth를 구성합니다. - `tsm configuration set -k oauth.azuredatalake_storage_gen2.client_id -v [your_client_id] --force-keys` - `tsm configuration set -k oauth.azuredatalake_storage_gen2.client_secret -v [your_client_secret_value] --force-keys` - `tsm configuration set -k oauth.azuredatalake_storage_gen2.redirect_uri -v [your_server_url]/auth/add_oauth_token --force-keys` - `tsm pending-changes apply` ### Azure Synapse, Azure SQL Database 또는 Databricks에 대해 기본 클라이언트 구성 Tableau Server를 구성하려면 다음 구성 매개 변수가 있어야 합니다. - **Azure OAuth 클라이언트 ID:** 1단계의 절차에서 생성됩니다. tsm 명령에서 `[your_client_id]`에 이 값을 복사합니다. - **Azure OAuth 클라이언트 암호 값:** 1단계의 절차에서 생성됩니다. 두 번째 tsm 명령에서 `[your_client_secret_value]`에 이 값을 복사합니다. - **Tableau Server URL:** Tableau Server URL(예: `https://myco.com`)입니다. - **구성 ID:** 다음 tsm 명령에서 `oauth.config.id` 매개 변수에 대한 값입니다. 유효한 값은 다음과 같습니다. - Azure Synapse: `azure_sql_dw` - Azure SQL Database: `azure_sqldb` - Databricks: `databricks` 다음 tsm 명령을 실행하여 Azure Synapse, Azure SQL Database 또는 Databricks에 대해 Azure AD를 구성합니다. 예를 들어 Azure Synapse를 설치하려면: `tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys` `tsm pending-changes apply` ### OneDrive 및 SharePoint Online에 대한 기본 OAuth 클라이언트 구성 OneDrive 및 SharePoint Online에 대해 Tableau Server를 구성하려면 다음 구성 매개 변수가 있어야 합니다. - **Azure OAuth 클라이언트 ID:** 클라이언트 ID는 1단계의 절차에서 생성됩니다. 첫 번째 tsm 명령에서 \[your\_client\_id\]에 이 값을 복사합니다. - **Azure OAuth 클라이언트 암호 값:** 클라이언트 암호 값은 1단계의 절차에서 생성됩니다. 두 번째 tsm 명령에서 \[your\_client\_secret\_value\]에 이 값을 복사합니다. - **Tableau Server URL:** Tableau Server URL(예: `https://myco.com`)입니다. 세 번째 tsm 명령에서 \[your\_client\_url\]에 이 값을 복사합니다. 다음 tsm 명령을 실행하여 OneDrive 및 SharePoint Online에 대해 Tableau Server OAuth를 구성합니다. - `tsm configuration set -k oauth.onedrive_and_sharepoint_online.client_id -v [your_client_id] --force-keys` - `tsm configuration set -k oauth.onedrive_and_sharepoint_online.client_secret -v [your_client_secret_value] --force-keys` - `tsm configuration set -k oauth.onedrive_and_sharepoint_online.redirect_uri -v [your_server_url]/auth/add_oauth_token --force-keys` - `tsm pending-changes apply` ### SharePoint 목록(JDBC)에 대한 기본 OAuth 클라이언트 구성 SharePoint 목록(JDBC)에 대해 Tableau Server를 구성하려면 다음 구성 매개 변수가 있어야 합니다. - **Azure OAuth 클라이언트 ID:** 클라이언트 ID는 1단계의 절차에서 생성됩니다. 첫 번째 tsm 명령에서 \[your\_client\_id\]에 이 값을 복사합니다. - **Azure OAuth 클라이언트 암호 값:** 클라이언트 암호 값은 1단계의 절차에서 생성됩니다. 첫 번째 tsm 명령에서 \[your\_client\_secret\_value\]에 이 값을 복사합니다. - **Tableau Server URL:** Tableau Server URL(예: `https://myco.com`)입니다. 첫 번째 tsm 명령에서 \[your\_server\_url\]에 이 값을 복사합니다. 다음 tsm 명령을 실행하여 Tableau Server OAuth SharePoint 목록(JDBC)을 구성합니다. - `tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"cdata_sharepoint\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys` - `tsm pending-changes apply` ### OneDrive에 대한 기본 OAuth 클라이언트 구성(사용 중단됨) OneDrive대해 Tableau Server를 구성하려면(사용 중단됨) 다음 구성 매개 변수가 있어야 합니다. - **Azure OAuth 클라이언트 ID:** 클라이언트 ID는 1단계의 절차에서 생성됩니다. 첫 번째 tsm 명령에서 \[your\_client\_id\]에 이 값을 복사합니다. - **Azure OAuth 클라이언트 암호 값:** 클라이언트 암호 값은 1단계의 절차에서 생성됩니다. 두 번째 tsm 명령에서 \[your\_client\_secret\_value\]에 이 값을 복사합니다. - **Tableau Server URL:** Tableau Server URL(예: `https://myco.com`)입니다. 세 번째 tsm 명령에서 \[your\_client\_url\]에 이 값을 복사합니다. 다음 tsm 명령을 실행하여 OneDrive에 대해 Tableau Server OAuth를 구성합니다(사용 중단됨). - `tsm configuration set -k oauth.onedrive.client_id -v [your_client_id] --force-keys` - `tsm configuration set -k oauth.onedrive.client_secret -v [your_client_secret_value] --force-keys` - `tsm configuration set -k oauth.onedrive.redirect_uri -v [your_server_url]/auth/add_oauth_token --force-keys` - `tsm pending-changes apply` ### 서버 다시 시작 시나리오 기본 OAuth 클라이언트를 구성한 후 다음 시나리오가 발생할 수 있습니다. - 보류 중인 변경 내용을 적용하기 위해 서버를 다시 시작해야 하는 경우 다시 시작 메시지가 표시됩니다. - `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작이 중지되지는 않습니다. - 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ### 여러 커넥터 설정 여러 커넥터를 설정해야 하는 경우 단일 명령에 모든 커넥터를 포함해야 합니다. 예를 들면 다음과 같습니다. `tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"databricks\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret_value]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys` `tsm pending-changes apply` ## 사이트에 대해 사용자 지정 OAuth 구성 사이트에 대해 사용자 지정 Azure Data Lake Storage Gen2, Azure Synapse, Azure SQL Database, Databricks OAuth, OneDrive 및 SharePoint Online, SharePoint 목록(JDBC) 클라이언트를 구성할 수 있습니다. 1) 서버에 구성된 OAuth 클라이언트를 재정의하거나 2) 고유한 OAuth 클라이언트가 필요한 데이터에 대한 안전한 연결을 지원하려면 사용자 지정 OAuth 클라이언트를 구성하는 것이 좋습니다. 사용자 지정 OAuth 클라이언트를 구성하면 사이트 수준 구성이 서버 측 구성보다 우선하며 생성된 모든 새로운 OAuth 자격 증명에 사이트 수준 OAuth 클라이언트가 기본적으로 사용됩니다. Tableau Server를 다시 시작하지 않아도 구성이 적용됩니다. **중요:** 사용자 지정 기존 OAuth 클라이언트를 구성하기 전에 설정된 OAuth 자격 증명은 임시로 사용 가능하지만 중단 없는 데이터 액세스를 보장하려면 서버 관리자와 사용자 모두가 저장된 자격 증명을 업데이트해야 합니다. ### 1: OAuth 클라이언트 ID value, 클라이언트 암호 값 및 리디렉션 URL 준비 사용자 지정 OAuth 클라이언트를 구성하려면 아래에 나열된 정보가 필요합니다. 이 정보를 준비한 후 사이트에 대한 사용자 지정 OAuth 클라이언트를 등록할 수 있습니다. - **OAuth 클라이언트 ID 및 클라이언트 암호 값:** 먼저 OAuth 클라이언트를 데이터 공급자(커넥터)에 등록하여 Tableau Server용으로 생성된 클라이언트 ID와 암호 값을 검색합니다. - **리디렉션 URL:** 올바른 리디렉션 URL을 기록합니다. 아래 **2단계**의 등록 프로세스 중에 필요합니다. https://.com/auth/add\_oauth\_token 예: https://example.com/auth/add\_oauth\_token ### 2: OAuth 클라이언트 ID 및 클라이언트 암호 등록 아래에 설명된 절차에 따라 사용자 지정 OAuth 클라이언트를 사이트에 등록합니다. 1. 관리자 자격 증명을 사용하여 Tableau Server 사이트에 로그인하고 설정 페이지로 이동합니다. 2. OAuth 클라이언트 레지스트리에서 OAuth 클라이언트 추가 단추를 클릭합니다. 3. 위의 **1단계**의 정보를 포함하여 필요한 정보를 입력합니다. 1. 연결 유형의 경우 사용자 지정 OAuth 클라이언트를 구성하려는 커넥터를 선택합니다. 2. OAuth 인스턴스 URL은 여러 OAuth 클라이언트가 등록되는 경우에 필요합니다. 그 외에는 선택 사항입니다. 3. 클라이언트 ID, 클라이언트 암호 및 리디렉션 URL의 경우 위의 **1단계**에서 준비한 정보를 입력합니다. 4. OAuth 클라이언트 추가 단추를 클릭하여 등록 프로세스를 완료합니다. ![OAuth 클라이언트를 생성하기 위한 양식이며, 연결 유형, OAuth 인스턴스 URL, 클라이언트 ID, 클라이언트 암호, 리디렉션 URL에 대한 필드가 포함되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/oauth_custom.png) 4. (선택 사항) 지원되는 모든 커넥터에 대해 3단계를 반복합니다. 5. 설정 페이지의 맨 아래 또는 맨 위에 있는 저장 단추를 클릭하여 변경 내용을 저장합니다. ### 3: 저장된 자격 증명의 유효성 검사 및 업데이트 중단 없는 데이터 액세스를 보장하려면 관리자(및 사이트 사용자)가 이전에 저장된 자격 증명을 삭제하고 다시 추가하여 사이트에 사용자 지정 OAuth 클라이언트를 사용해야 합니다. 1. 내 계정 설정 페이지로 이동합니다. 2. 데이터 원본의 저장된 자격 증명에서 다음을 수행합니다. 1. 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 기존의 저장된 자격 증명 옆에서 삭제를 클릭합니다. 2. 커넥터 이름 옆에서 추가를 클릭하고 표시되는 메시지에 따라 1) 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트에 연결하고 2) 최신 자격 증명을 저장합니다. ### 4: 사용자에게 저장된 자격 증명을 업데이트하도록 알림 위의 **2단계**에서 구성한 사용자 지정 OAuth 클라이언트의 커넥터에 대한 저장된 자격 증명을 업데이트하도록 사이트 사용자에게 알립니다. 사이트 사용자는 [저장된 자격 증명 업데이트](https://help.tableau.com/current/server/ko-kr/manage_stored_credentials.htm#oauth_update_credentials)에 설명된 절차를 사용하여 저장된 자격 증명을 업데이트할 수 있습니다. ## OAuth 인증에 대한 정방향 프록시 Tableau Server의 OAuth 인증으로 정방향 프록시를 설정하는 방법(Windows만 해당)에 대한 자세한 내용은 Tableau 도움말에서 [OAuth 인증에 대한 정방향 프록시 구성](https://help.tableau.com/current/pro/desktop/ko-kr/config_proxy_oauth.htm#server)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # OAuth 연결 Tableau Server는 다양한 커넥터에 대해 OAuth를 지원합니다. 대부분의 경우 OAuth 기능을 사용할 때 Tableau Server에서 추가 구성이 필요하지 않습니다. Tableau에서 OAuth를 사용하는 커넥터로 데이터에 로그인하면 인증 공급자의 로그인 페이지로 리디렉션됩니다. 자격 증명을 입력하고 Tableau의 데이터 액세스를 인증하면 인증 공급자가 Tableau 및 사용자를 고유하게 식별하는 **액세스 토큰**을 Tableau에 전송합니다. 이 액세스 토큰은 사용자 대신 데이터에 액세스하는 데 사용됩니다. 자세한 내용은 아래에서 [OAuth 프로세스 개요](#Overview)를 참조하십시오. OAuth 기반 연결을 사용하면 다음과 같은 이점이 있습니다. - **보안:** 데이터베이스 자격 증명이 Tableau Server에서 알려지거나 저장되지 않으며 사용자를 대신하여 Tableau만 액세스 토큰을 사용할 수 있습니다. - **편리성:** 데이터 원본 ID와 암호를 여러 곳에 내장할 필요 없이 특정 데이터 공급자에 대해 제공된 토큰을 해당 데이터 공급자에 접근하는 게시된 모든 통합 문서와 데이터 원본에 사용할 수 있습니다. **참고:** Google BigQuery 데이터에 대한 라이프 연결의 경우 통합 문서 Viewer(뷰어)마다 단일 사용자 이름과 비밀번호 자격 증명을 공유하는 대신 사용자를 식별하는 고유한 액세스 토큰을 가질 수 있습니다. ## OAuth 프로세스 개요 다음 단계에서는 OAuth 프로세스를 호출하는 Tableau 환경의 작업 흐름을 설명합니다. 1. 사용자가 클라우드 기반 데이터 원본에 액세스해야 하는 작업을 수행합니다. 예를 들어 Tableau Server에 게시된 통합 문서를 엽니다. 2. Tableau는 사용자를 클라우드 데이터 공급자의 로그인 페이지로 연결합니다. 데이터 공급자로 전송되는 정보는 Tableau를 요청 사이트로 식별합니다. 3. 사용자가 데이터에 로그인하면 데이터 액세스를 위한 Tableau Server 인증을 확인하라는 메시지가 나타납니다. 4. 사용자가 확인되면 데이터 공급자가 액세스 토큰을 다시 Tableau Server로 전송합니다. 5. Tableau Server 통합 문서와 데이터가 사용자에게 표시됩니다. ![사용 중인 노트북, Tableau Server, 데이터베이스 간의 데이터 흐름을 나타낸 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/protected_auth_server.png) **참고**: OAuth 연결을 위한 일회용 새로 고침 토큰(일회성 새로 고침 토큰, 순환식 새로 고침 토큰 또는 새로 고침 토큰 순환이라고도 함) 지원 기능은 Tableau Cloud 2025.2(2025년 여름) 릴리스에서 추가되었으며, Tableau Server 2025.3 릴리스에서도 추가되었습니다(데이터 원본 공급자의 IDP가 토큰을 지원하는 경우). 이러한 기능은 Tableau Cloud에 대한 Tableau Bridge 연결에서는 아직 지원되지 않습니다. 연결에 외부 OAuth 구성을 사용하는 경우 자세한 내용은 GitHub에서 [OAuth 구성 및 사용 설명서(영문)](https://tableau.github.io/connector-plugin-sdk/docs/oauth "OAuth 구성 문서")를 참조하십시오. 다음과 같은 사용자 작업 흐름에서 OAuth 프로세스를 사용할 수 있습니다. - Tableau Desktop 또는 Tableau Server에서 통합 문서 만들기 및 데이터 원본에 연결 - Tableau Desktop에서 데이터 원본 게시 - Tableau Mobile 또는 Tableau Desktop 같은 승인된 _클라이언트_에서 Tableau Server에 로그인 ## 기본 저장된 자격 증명 커넥터 _저장된 자격 증명_은 Tableau Server가 OAuth 연결의 사용자 토큰을 저장하는 기능을 나타냅니다. 이를 통해 사용자는 자신의 OAuth 자격 증명을 Tableau Server의 사용자 프로필에 저장할 수 있습니다. 자격 증명을 저장하면 커넥터에 액세스한 후 게시, 편집 또는 새로 고침을 수행할 때 메시지가 나타나지 않습니다. **참고**: 웹에서 Tableau Prep 흐름을 편집하는 경우에는 재인증 메시지가 계속 표시될 수 있습니다. 다음 커넥터는 기본적으로 저장된 자격 증명을 사용하며 Tableau Server에서 추가 구성이 필요하지 않습니다. - Anaplan - Box - Dropbox - Esri ArcGIS Server - Google Ads - LinkedIn Sales Navigator - Marketo - OneDrive 및 SharePoint Online(2022.3부터 추가 구성 필요) - Oracle Eloqua - ServiceNow ITSM - Snowflake - "전용 링크"를 사용하려면 추가 구성이 필요합니다. 자세한 내용은 Snowflake 웹 사이트에서 [파트너 응용 프로그램을 위한 Snowflake OAuth 구성(영문)](https://docs.snowflake.net/manuals/user-guide/oauth-partner.html#configure-snowflake-oauth-for-partner-applications) 및 [Tableau Server에서 Snowflake 연결을 위한 OAuth 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_snowflake.htm)을 참조하십시오. 서버 관리자가 추가 구성을 수행하면 다음 커넥터에서 저장된 자격 증명을 사용할 수 있습니다. - Amazon Athena 자세한 내용은 Tableau Desktop 도움말의 [Amazon Athena에서 사용자 고유의 ID 공급자 사용](https://help.tableau.com/current/pro/desktop/ko-kr/amazon_athena_idp.htm)을 참조하십시오. - Azure Data Lake Storage Gen2, Azure Synapse, Azure SQL Database, Databricks, OneDrive 및 SharePoint Online, SharePoint 목록(JDBC) 자세한 내용은 [OAuth 및 최신 인증에 대해 Azure AD 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_azure_ad.htm)을 참조하십시오. - Dremio 자세한 내용은 [Dremio에 대한 OAuth 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_dremio.htm)을 참조하십시오. - Google Analytics, Google BigQuery, Google BigQuery(JDBC), Google 드라이브 자세한 내용은 [Google에 대한 OAuth 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_google.htm)을 참조하십시오. **참고:** Tableau Server가 Google 관리 콘솔의 Accessed Apps(액세스된 앱) 목록에 없는 경우 클라이언트 ID를 사용하여 목록에 새 앱을 수동으로 추가할 수 있습니다. 클라이언트 ID를 만들려면 [Google OAuth를 저장된 자격 증명으로 변경](https://help.tableau.com/current/server/ko-kr/config_oauth_google.htm)을 참조하십시오. - Intuit QuickBooks Online 자세한 내용은 [Intuit QuickBooks Online에 대한 OAuth 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_qbo.htm)을 참조하십시오. OneDrive 및 SharePoint Online(2022.3부터) 자세한 내용은 [사이트에 대해 사용자 지정 OAuth 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_azure_ad.htm#custom)을 참조하십시오. - Salesforce 자세한 내용은 [Salesforce.com OAuth를 저장된 자격 증명으로 변경](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm)을 참조하십시오. - Salesforce CDP 자세한 내용은 [Tableau Server를 Salesforce Data Cloud에 연결](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc_cdp.htm)을 참조하십시오. - Snowflake 버전 2024.2부터 가능합니다. 자세한 내용은 [Snowflake OAuth를 저장된 자격 증명으로 변경](https://help.tableau.com/current/server/ko-kr/config_oauth_snowflake.htm)을 참조하십시오. 지원되는 모든 커넥터는 Tableau Server에서 사용자의 내 계정 설정 페이지에 있는 데이터 원본의 저장된 자격 증명 아래에 나열됩니다. 사용자는 각 커넥터에 대한 자신의 저장된 자격 증명을 관리합니다. ![모든 저장된 자격 증명 지우기 옵션이 있는 데이터 원본에 대한 저장된 자격 증명 목록입니다.](/tableau/current/ko-kr/server/ko-kr/Img/oauth-savedcreds.png) ### 데이터 연결을 위한 액세스 토큰 초기 인증 프로세스 후 데이터에 직접 액세스할 수 있도록 데이터 연결과 함께 액세스 토큰에 기반한 자격 증명을 내장할 수 있습니다. 액세스 토큰은 Tableau Server 사용자가 삭제하거나 데이터 공급자가 철회하지 않는 한 유효합니다. 데이터 원본 공급자가 허용하는 액세스 토큰 수를 초과할 수 있습니다. 그럴 경우 사용자가 토큰을 만들면 데이터 공급자는 마지막 액세스 이후의 시간을 사용하여 새 토큰용 여유 공간을 만들기 위해 무효화할 토큰을 결정합니다. ### 승인된 클라이언트의 인증을 위한 액세스 토큰 기본적으로 Tableau Server 사이트에서는 사용자가 처음 로그인할 때 자격 증명을 제공한 후 승인된 Tableau 클라이언트에서 직접 사이트에 액세스할 수 있도록 허용합니다. 이 유형의 인증에서도 OAuth 액세스 토큰을 사용하여 사용자의 자격 증명을 안전하게 저장합니다. 자세한 내용은 [자동 클라이언트 인증 사용 안 함](https://help.tableau.com/current/server/ko-kr/devices_connected_credentials.htm)을 참조하십시오. ## 기본 관리되는 키 체인 커넥터 _관리되는 키 체인_은 공급자가 Tableau Server용으로 OAuth 토근을 생성하고 동일한 사이트의 모든 사용자가 해당 토큰을 공유하는 기능을 나타냅니다. 사용자가 처음 데이터 원본을 게시할 경우 데이터 원본 자격 증명을 묻는 메시지가 나타납니다. Tableau Server가 데이터 원본 공급자에게 자격 증명을 제출하고, 데이터 원본 공급자는 Tableau Server가 사용자를 대신하여 사용할 OAuth 토큰을 반환합니다. 후속 게시 작업 시 Tableau Server가 동일한 클래스에 대해 저장한 OAuth 토큰과 사용자 이름이 사용되므로 OAuth 자격 증명을 묻는 메시지가 표시되지 않습니다. 데이터 원본 비밀번호를 변경해야 하는 경우 이전 프로세스를 반복하여 Tableau Server에서 이전 토큰을 새 토큰으로 바꿉니다. 기본 관리되는 키 체인 커넥터의 경우 Tableau Server에서 추가적인 OAuth 구성이 필요하지 않습니다. - Google 애널리틱스, Google BigQuery 및 Google 스프레드시트(Tableau 버전 2022.1부터 사용 중단됨) - Salesforce ### 토큰 제한 및 저장소 Google에는 클라이언트 응용 프로그램별로 각 사용자에 대해 50개 토큰 제한이 있습니다(이 시나리오에서 Tableau Server는 클라이언트 응용 프로그램임). OAuth 토큰은 Tableau Server에 저장되고 사용자에 의해 재사용되므로 사용자가 토큰 제한을 초과하는 일은 거의 없습니다. 모든 사용자 토큰은 Tableau Server에 저장될 때 암호화되어 저장됩니다. 자세한 내용은 [서버 암호 관리](https://help.tableau.com/current/server/ko-kr/security_secret_storage.htm)를 참조하십시오. ### 사용되지 않은 키 체인 레코드 제거 관리되는 키 체인 레코드에는 dbClass, 사용자 이름 및 OAuth 암호 특성과 같은 연결 특성이 포함됩니다. 지정된 사이트에 대한 모든 관리되는 키 체인 레코드가 병합되고 암호화되어 PostgreSQL에 저장됩니다. 제거된 통합 문서 및 데이터 원본에 대한 레코드도 유지됩니다. 시간이 지나면 이러한 레코드의 크기가 커져 문제가 발생할 수 있습니다. 정기적인 유지 관리 작업으로 사용되지 않은 키 체인 레코드를 주기적으로 정리하는 것이 좋습니다. 각 사이트에 저장된 레코드 수와 사용되지 않은 레코드 수를 볼 수 있습니다. 사용되지 않은 레코드를 삭제할 수도 있습니다. ![저장된 자격 증명 키 체인을 관리하기 위한 대화 상자입니다. 대화 상자에는 사용되지 않은 키 체인의 수를 표시하는 옵션과 키 체인을 삭제하는 단추가 포함되어 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/oauth-purge-managed-keys.png) 관리되는 키 체인 정리에 액세스하려면 Tableau Server 관리 페이지에 로그인하고 사용되지 않은 레코드를 삭제하려는 사이트로 이동한 다음 설정을 클릭합니다. ### 관리되는 키 체인의 시나리오 제한 사항 Tableau Server에서 관리되는 키 체인 OAuth를 사용할 경우 다음 세 가지 시나리오가 지원되지 않습니다. - 라이브 연결에서 OAuth 자격 증명에 대한 프롬프트. 사용자는 관리되는 키 체인 OAuth를 사용하는 라이브 연결에서 자격 증명을 내장해야 합니다. - Tableau Server에서 OAuth 데이터 원본 연결 편집 - 웹 작성 ### 관리되는 키 체인을 저장된 자격 증명으로 변환 Tableau Server에서 각 커넥터에 대해 OAuth 클라이언트 ID와 암호를 구성하여 관리되는 키 체인을 사용하는 커넥터를 저장된 자격 증명을 사용하도록 변환할 수 있습니다. 이러한 커넥터를 저장된 자격 증명으로 변환하면 사용자가 Tableau Server의 내 계정 설정 페이지에서 각 커넥터 유형에 대한 자신의 자격 증명을 관리할 수 있습니다. 또한 라이브 연결 프롬프트, 연결 편집 및 웹 작성도 지원됩니다. ## 사이트에 대해 사용자 지정 OAuth 구성 커넥터 하위 집합의 경우 사용자 지정 OAuth 클라이언트를 구성하여 사이트 수준 OAuth를 구성할 수 있습니다. 자세한 내용은 다음 항목 중 하나를 참조하십시오. - Azure Data Lake Storage Gen2, Azure SQL Database, Azure Synapse, Databricks, OneDrive 및 SharePoint Online, SharePoint 목록(JDBC)의 경우 [사이트에 대해 사용자 지정 OAuth 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_azure_ad.htm#custom)을 참조하십시오. - Dremio의 경우 [Dremio에 대한 OAuth 설정](https://help.tableau.com/current/server/ko-kr/config_oauth_dremio.htm)을 참조하십시오. - Google 애널리틱스, Google BigQuery, Google 스프레드시트(Tableau 버전 2022.1부터 사용 중단됨)의 경우 [사이트에 대해 사용자 지정 OAuth 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_google.htm#custom)을 참조하십시오. - Salesforce의 경우 [사이트에 대해 사용자 지정 OAuth 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc.htm#custom)을 참조하십시오. - Salesforce CDP에 대한 자세한 내용은 [Tableau Server를 Salesforce Data Cloud에 연결](https://help.tableau.com/current/server/ko-kr/config_oauth_sfdc_cdp.htm#custom)을 참조하십시오. - Snowflake의 경우 [옵션 2: 사이트별 Snowflake 연결을 위한 OAuth 구성](https://help.tableau.com/current/server/ko-kr/config_oauth_snowflake.htm#custom)을 참조하십시오. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # OAuth 연결 문제 해결 이 항목에서는 OAuth 데이터 연결을 구성할 때 발생할 수 있는 문제의 해결 방법에 대한 정보를 제공합니다. ## 충돌 오류 일부 경우 OAuth를 사용하여 연결할 때 오류가 발생할 수 있습니다. 오류 메시지의 첫 번째 문장은 다음과 같습니다. 서버에 내부 오류가 발생했거나 설정이 잘못되어 있어 요청을 완료할 수 없습니다. 이 오류는 Tableau Server의 FQDN(정규화된 도메인 이름)을 Tableau Server의 리디렉션 키 허용 목록에 추가해야 한다는 의미입니다. 사용자가 로컬 호스트 이름(https://tableau)으로 Tableau Server에 액세스하고 OAuth 데이터 공급자는 공개 DNS 이름(https://data.example.com)으로 응답하는 경우 Tableau Server가 외부 FQDN을 로컬 서버 이름과 연결해야 합니다. 로컬 호스트 이름은 사용자가 내부 네트워크에서 Tableau Server에 액세스할 때 입력하는 URL에서 서버 이름입니다. 이 오류를 해결하려면 [tsm configuration set](https://help.tableau.com/current/server/ko-kr/cli_configuration_tsm.htm#TSMSet) 명령을 `oauth.whitelisted.redirect_to_origin_host` 키 옵션을 사용하여 실행합니다. 이 키에는 값 쌍 `"internal_host,FQDN1,FQDN2"`를 사용합니다. 예를 들어 다음 명령은 로컬 호스트 이름을 _tableau_로 설정하고, FQDN을 _tableau.example.com_으로 설정합니다. `tsm configuration set -k oauth.whitelisted.redirect_to_origin_host -v "tableau,tableau.example.com"` `tsm pending-changes apply` 내부 Tableau Server에 액세스하기 위해 여러 공개 URL을 사용하는 경우 다른 FQDN을 쉼표로 구분하여 명령에 추가합니다. 다음 예를 참조하십시오. `tsm configuration set -k oauth.whitelisted.redirect_to_origin_host -v "tableau,tableau.example.com,tableau2.example.com"` 기존 리디렉션 허용 목록 구성을 편집해야 하는 경우 전체 매핑 집합을 입력해야 합니다. 기존 구성 키를 잘라내거나 추가할 수 없습니다. [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect SSO(Single Sign-on)에 대해 OIDC(OpenID Connect)를 지원하도록 Tableau Server을 구성할 수 있습니다. OIDC는 Google, Salesforce 등의 IdP(ID 공급자)에 로그인할 수 있도록 지원하는 표준 인증 프로토콜입니다. IdP에 로그인하고 나면 자동으로 Tableau Server에 로그인됩니다. OIDC 구성에는 여러 단계가 필요합니다. 이 섹션의 항목에서는 Tableau Server 및 OIDC 사용에 대한 일반 정보와 IdP 및 Tableau Server 구성 절차를 설명합니다. **참고:** 달리 명시되지 않은 한 OIDC 인증에 대한 정보는 Tableau Server 설치 중에 TSM에서 구성된 OIDC 또는 [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)을 통해 구성된 OIDC에 모두 적용됩니다. ## 인증 개요 이 섹션에서는 Tableau Server의 OIDC(OpenID Connect) 인증 프로세스에 대해 설명합니다. ![Tableau Server, 클라이언트 및 OpenID Connect 간의 상호 작용을 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/openid_auth_overview.png) 1\. 사용자가 클라이언트 컴퓨터에서 Tableau Server에 로그인하려고 합니다. 2\. Tableau Server가 인증 요청을 IdP 게이트웨이로 리디렉션합니다. 3\. 사용자가 자격 증명을 입력하고 IdP에 성공적으로 인증됩니다. IdP는 리디렉션 URL로 Tableau Server에 다시 응답합니다. 리디렉션 URL에는 사용자에 대한 인증 코드가 포함되어 있습니다. 4\. 클라이언트가 Tableau Server으로 리디렉션되고 인증 코드가 표시됩니다. 5\. Tableau Server이 고유한 클라이언트 자격 증명과 함께 IdP에 클라이언트의 인증 코드를 제공합니다. Tableau Server은 IdP의 클라이언트이기도 합니다. 이 단계는 스푸핑 또는 메시지 가로채기(man-in-the-middle) 공격을 방지하기 위한 것입니다. 6\. IdP가 액세스 토큰 및 ID 토큰을 Tableau Server에 반환합니다. - JWT(JSON Web Token) 유효성 검사: 기본적으로 Tableau는 IdP JWT에 대한 유효성 검사를 수행합니다. 검색 중에 Tableau는 IdP 구성 검색 문서에서 `jwks_uri`로 지정된 공개 키를 검색합니다. Tableau는 ID 토큰의 만료에 대한 유효성을 검사하고 JWS(JSON 웹 서명), 발급자(IdP) 및 클라이언트 ID를 확인합니다. JWT 프로세스에 대한 자세한 내용은 OpenID 설명서에서 [10\. Signatures and Encryption(서명 및 암호화)](http://openid.net/specs/openid-connect-core-1_0.html#SigEnc)와 IETF 제안 표준 [JSON Web Token](https://tools.ietf.org/html/rfc7519)에서 확인할 수 있습니다. IdP에서 지원하지 않는 경우가 아니라면 JWT 유효성 검사를 사용 설정된 상태로 두는 것이 좋습니다. - ID 토큰은 사용자의 특성 키 쌍 집합입니다. 이러한 키 쌍을 _클레임_이라고 합니다. 다음은 사용자의 IdP 클레임에 대한 예입니다. "sub" : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5" "email" : "alice@example.com", "email\_verified" : true, "name" : "Alice Adams", "given\_name" : "Alice", "family\_name" : "Adams", "phone\_number" : "+359 (99) 100200305", "profile" : "https://tableau.com/users/alice" 7\. Tableau Server이 IdP 클레임에서 사용자를 식별하고 1단계의 인증 요청을 완료합니다. Tableau Server는 'sub'(주체 식별자)를 일치시켜 리포지토리에 저장된 사용자의 계정 레코드를 검색하여 올바른 사용자 계정을 식별합니다. sub 클레임 값으로 저장된 사용자 계정이 없는 경우 Tableau Server는 리포지토리에서 IdP의 'email' 클레임과 일치하는 사용자 이름을 검색합니다. 사용자 이름 일치가 성공하면 Tableau Server가 해당하는 sub 클레임을 리포지토리의 사용자 레코드에 저장합니다.이 프로세스에 다른 클레임을 사용하도록 Tableau Server를 구성할 수 있습니다. 자세한 내용은 [OpenID Connect 사용 시 요구 사항](https://help.tableau.com/current/server/ko-kr/openid_auth_requirements.htm)을 참조하십시오. 8\. Tableau Server은 사용자에게 권한을 부여합니다. ## Tableau와 OpenID Connect의 작동 원리 OIDC(OpenID Connect)는 서비스 제공업체(여기서 Tableau Server)와 IdP 사이에 교환하는 정보를 위한 다수의 옵션을 지원하는 유연한 프로토콜입니다. 다음 목록에 OIDC의 Tableau Server 구현에 대한 세부 정보가 나와 있습니다. 이러한 세부 정보는 Tableau Server에서 전송하고 필요로 하는 정보의 유형과 IdP를 구성하는 방법을 이해하는 데 도움이 될 수 있습니다. - Tableau Server 에서는 OpenID Connect 설명서의 [OpenID Connect 최종 사양](http://openid.net/specs/openid-connect-core-1_0.html)에 설명된 대로 OpenID Authorization Code Flow만 지원합니다. - Tableau Server 에서는 검색 또는 공급자 URL을 사용하여 OpenID 공급자 메타데이터를 검색합니다.또는 Tableau Server에서 정적 검색 문서를 호스팅할 수 있습니다. 자세한 내용은 [OpenID Connect에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_server_config.htm)을 참조하십시오. - Tableau Server 에서는 `client_secret_basic` 및 `client_secret_post` 클라이언트 인증이 지원됩니다. - Tableau Server는 `id_token` 특성의 JOSE 머리글에 있는 `kid` 값을 예상합니다. 이 값은 JWK Set 문서의 키 중 하나와 일치됩니다. 이 문서의 URI는 OpenID 검색 문서에서 `jwks_uri` 값으로 지정됩니다. JWK Set 문서에 키가 하나뿐인 경우에도 `kid` 값이 있어야 합니다. - Tableau Server에는 JWK `x5c` 매개 변수 또는 X.509 인증서 사용에 대한 OpenID 지원이 포함됩니다. - 기본적으로 Tableau Server는 프록시 설정을 무시하고 모든 OpenID 요청을 IdP로 직접 전송합니다. Tableau Server가 정방향 프록시를 사용하여 인터넷에 연결하도록 구성된 경우 [OpenID Connect에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_server_config.htm)에 설명된 대로 추가 변경을 수행해야 합니다. ## OIDC 클레임의 사용자 특성 Tableau Sever 2026.2부터 해당 기능 설정을 구성하고 사용하도록 설정한 경우, 로그인 시 IdP(ID 공급자)가 Tableau Cloud로 전송하는 JWT(JSON 웹 토큰)에 사용자 특성 클레임을 전달할 수 있습니다. 이러한 사용자 특성은 Tableau의 사용자 특성 함수`(USERATTRIBUTE()`, `USERATTRIBUTEINCLUDES()`)와 함께 사용하여 콘텐츠를 동적으로 제어하고 사용자 지정할 수 있습니다. Tableau는 클레임의 유효성을 검사한 다음 콘텐츠에 대한 액세스를 허용할 수 있습니다. 자세한 내용은 [사용자 특성을 사용하여 데이터 액세스 사용자 지정 및 제어](https://help.tableau.com/current/server/ko-kr/openid_auth_server_config.htm#user_attributes)을 참조하십시오. **JWT 예** "sub" : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5" "email" : "alice@example.com", "email\_verified" : true, "name" : "Alice Adams", "given\_name" : "Alice", "family\_name" : "Adams", "phone\_number" : "+359 (99) 100200305", "profile" : "https://tableau.com/users/alice", "region" : \["South", "South West"\] ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect 문제 해결 Tableau Server의 OIDC(OpenID Connect) 문제를 해결하려면 다음 항목을 사용하십시오. OIDC 프로토콜은 많은 ID 공급자가 지원합니다. OIDC 프로토콜은 개방적이고 유연한 표준이기 때문에 표준의 모든 구현이 동일하지 않습니다. 관리자가 Tableau Server에서 OIDC를 구성할 때 발생하는 대부분의 문제는 서로 다른 ID 공급자가 OIDC를 구성하는 방법에 따른 결과입니다. Tableau Server에서 OIDC를 설정할 때 오류가 발생한다면 IdP와 함께 문제를 해결하는 것이 좋습니다. ## 향상된 OpenID 로깅 사용 Tableau Server에서 OpenID Connect 문제를 효율적으로 해결하려면 다음 TSM 명령을 사용하여 `vizportal.openid.full_server_request_logging_enabled` 구성 키를 `true`로 설정합니다. 이는 로깅 수준을 debug로 설정하고 OpenID에 대한 전체 로깅을 설정하여 향상된 로깅을 사용하도록 설정합니다. `tsm configuration set -k vizportal.log.level -v debug` `tsm configuration set -k vizportal.openid.full_server_request_logging_enabled -v true` `tsm pending-changes apply` 문제 해결을 완료한 후에는 로그에 수집되는 정보를 제한하고 로그 파일 크기를 줄이기 위해 두 구성 키의 값을 기본값으로 다시 설정하는 것이 좋습니다. 구성 키를 기본값으로 재설정하는 방법에 대한 자세한 내용은 [구성 키를 기본값으로 재설정](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm#Reset2Default)을 참조하십시오. **참고:** [ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)에 대한 향상된 로깅은 지원되지 않습니다. 그러나 `vizportal.log.level debug` 로깅은 지원됩니다. ## 명령줄에서 로그인 Tableau Server가 OIDC를 사용하도록 구성되어 있어도 [tabcmd](https://help.tableau.com/current/server/ko-kr/tabcmd.htm), [Tableau REST API](https://help.tableau.com/current/api/rest_api/ko-kr/help.htm) 또는 [Tableau Data Extract 명령줄 유틸리티](https://help.tableau.com/current/pro/online/ko-kr/help.htm)(Tableau Desktop과 함께 제공됨)를 사용하여 Tableau Server에 로그인하면 OIDC가 사용되지 않습니다. ## 로그인 실패 로그인이 실패하고 다음과 같은 메시지가 나타날 수 있습니다. `Login failure: Identity Provider authentication unsuccessful for user . Failed to find the user in Tableau Cloud.` 이 오류는 대개 Tableau Server에 저장되어 있는 사용자 이름과 IdP에서 제공되는 사용자 이름이 일치하지 않는다는 의미입니다. 이 오류를 해결하려면 두 사용자 이름이 일치해야 합니다. 예를 들어 강현수의 사용자 이름이 IdP에 `kanghs`으로 저장되면 Tableau Server에도 `kanghs`으로 저장되어야 합니다. ## 오류 69: "로그인할 수 없음" 웹 브라우저에서 Tableau Server에 로그인하려고 하면 오류 69가 반환될 수 있으며 "로그인할 수 없습니다. 로그인하지 못했습니다. Tableau Server 관리자에게 문의하십시오." 오류가 나타납니다. 이 메시지를 반환하는 URL은 `https://example.com/#/error/signin/69?redirectPath=%2`입니다. 이 오류가 발생하는 경우 IDP 공급자에게 문의하여 IdP에 Tableau 기본값인 `client_secret_basic` 대신`client_secret_post`가 필요한지 확인하십시오. IdP에 `client_secret_post`가 필요한 경우 `vizportal.openid.client_authentication` 매개 변수를 `client_secret_post`로 설정해야 합니다. 예를 들어 이 오류가 발생하고 Salesforce IdP의 OIDC를 구성한 경우 `vizportal.openid.client_authentication` 매개 변수를 설정해야 합니다. 자세한 내용은 [tsm configuration set 옵션](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm)을 참조하십시오. ## OpenID 오류 로그 OpenID 인증은 Tableau Server 외부에서 수행됩니다. 따라서 인증 관련 문제 해결이 어려울 수 있습니다. 하지만 로그인 시도가 Tableau Server에 기록됩니다. 로그 파일의 스냅샷을 만들고 이 스냅샷을 사용하여 문제를 해결할 수 있습니다. 자세한 내용은 [Tableau Server 로그 및 로그 파일 위치](https://help.tableau.com/current/server/ko-kr/logs_loc.htm)를 참조하십시오. **참고**: OpenID 관련 이벤트를 기록하려면 `vizportal.log.level`을 `debug`로 설정하고 [tsm configuration set 옵션](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm)을 사용해야 합니다. 압축을 푼 로그 파일 스냅샷의 다음 파일에서 OpenID 오류를 확인할 수 있습니다. `\vizportal\vizportal-.log` ## 사용자를 찾을 수 없음 사용자가 처음 로그인한 후 'sub' 클레임이 변경된 경우 '사용자를 찾을 수 없음' 오류가 반환될 수 있습니다. 이 문제를 확인하려면 vizportal 로그에 다음이 표시되는지 봅니다. `Possible conflicting or stale account: A different user already owns this account`. 이 문제가 계속 발생하면 해당 사용자 또는 Tableau Server의 모든 사용자에 대한 'sub' 클레임을 재설정하십시오. 자세한 내용은 [사용자 식별자 재설정](https://help.tableau.com/current/server/ko-kr/openid_auth_changing_idp.htm#reset_sub)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect 사용 시 요구 사항 이 항목에서는 Tableau Server에서 OpenID Connect를 사용하는 데 필요한 요구 사항에 대해 설명합니다. **참고:** TSM 인증 구성 명령은 Tableau Server 설치 중에 TSM에서 구성된 OIDC 인증에만 적용됩니다. ID 풀의 OIDC 인증 구성을 변경하려면 Tableau REST OpenAPI를 통해 [인증 구성 업데이트](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#operation/AuthnService_UpdateAuthConfiguration) 끝점을 사용하면 됩니다. **요구 사항 요약** - IdP 계정 - 로컬 ID 저장소 - IdP 클레임- 사용자 매핑 - 인증 컨텍스트 ## IdP 계정 OpenID Connect(OIDC) 프로토콜을 지원하는 IdP(ID 공급자)에 액세스할 수 있어야 합니다. IdP의 계정도 있어야 합니다. OpenID Connect는 많은 ID 공급자가 지원합니다. OIDC 프로토콜은 개방적이고 유연한 표준이기 때문에 표준의 모든 구현이 동일하지 않습니다. Tableau Server에서 OIDC를 구성할 때 IdP와 함께 작업하십시오. Google IdP 구현은 Tableau Server에서 광범위하게 테스트되었으며 이러한 항목에 문서화된 구성의 대표 IdP입니다. ## 로컬 ID 저장소 Tableau Server에서 OpenID Connect를 사용하려면 다음 중 하나가 참이어야 합니다. - **Tableau Server 설치 중에 TSM에서 OIDC를 구성**하는 경우 Tableau Server가 로컬 ID 저장소를 사용하도록 구성되어 있어야 합니다. Active Directory와 같은 외부 디렉터리에서 사용자를 가져오는 대신 Tableau Server에서 명시적으로 사용자를 만들도록 서버를 구성해야 합니다. OpenID에서는 외부 ID 저장소로 사용자를 관리할 수 없습니다. - **[ID 풀](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)을 사용하여 OIDC를 구성**하는 경우 1) 로컬 ID 저장소로 OIDC를 구성하거나 2) Tableau Server 설치 중에 TSM에서 AD 또는 LDAP가 구성되어 있어야 합니다. ## IdP 클레임- 사용자 매핑 Tableau Server에 성공적으로 로그인하려면 지정된 사용자를 OpenID에서 프로비저닝한 다음 Tableau Server의 사용자 계정에 매핑해야 합니다. OpenID는 _클레임_을 사용하여 사용자 계정 특성을 다른 응용 프로그램과 공유하는 방법을 사용합니다. 클레임에는 이메일, 전화 번호, 이름 등과 같은 사용자 계정 특성이 포함됩니다. Tableau Server에서 IdP 클레임을 사용자 계정에 매핑하는 방법을 확인하려면 [OpenID Connect](https://help.tableau.com/current/server/ko-kr/openid_auth.htm#Authenti)를 참조하십시오. Tableau Server는 IdP 클레임을 사용하여 IdP의 사용자 계정을 Tableau Server에서 호스팅되는 사용자 계정에 매핑합니다. 기본적으로 Tableau Server는 IdP가 email 클레임을 전달할 것으로 예상합니다. 사용하는 IdP에 따라 다른 IdP 클레임을 사용하도록 Tableau Server를 구성해야 할 수 있습니다. Google을 IdP로 사용하는 경우 기본값인 `email` 클레임을 사용하여 IdP ID를 Tableau Server 사용자 계정에 매핑합니다. Google을 IdP로 사용하지 않는 경우 해당 IdP에 문의하여 Tableau Server를 구성할 때 사용할 클레임을 확인하십시오. ### 기본값: 이메일 클레임을 사용하여 사용자 매핑 기본적으로 사용자의 Tableau Server 사용자 이름이 IdP ID 토큰의 `email` 클레임과 일치해야 합니다. 그러므로 기본 구성에서는 이메일 주소(UPN이라고도 함)를 Tableau Server 사용자 이름으로 사용해야 합니다. Google을 IdP로 사용하는 경우 Tableau Server의 사용자 이름은 사용자의 Gmail 주소여야 합니다(`alice@gmail.com`). 두 사용자가 동일한 이메일을 사용하지만 이메일 호스트가 다른 경우라도 전체 이메일 주소를 이 방식으로 사용하면 Tableau Server에서 사용자 이름의 고유성이 보장됩니다. **참고:** Tableau Server에서 사용자 ID를 만들 때 사용자 이름, 비밀번호 그리고 경우에 따라 이메일 주소를 지정합니다. OpenID Connect를 기본 구성으로 사용하는 경우 사용자 이름(이메일 주소로 표시됨)은 IdP의 사용자 이름과 일치하는 값이어야 합니다. Tableau Server 사용자 ID에 선택적으로 지정한 이메일 주소는 OpenID 인증에 사용되지 않습니다. #### 도메인 이름 무시 IdP `email` 클레임을 Tableau Server의 사용자 이름과 일치시킬 때 이메일 주소의 도메인 부분을 무시하도록 Tableau를 구성할 수 있습니다. 이 시나리오에서 IdP의 `email` 클레임이 `alice@example.com`인 경우 Tableau Server에서 `alice`라는 사용자 이름만 일치시킵니다. 도메인 이름을 무시하는 옵션은 `email` 클레임의 사용자 이름 부분은 일치하지만 도메인 부분은 일치하지 않는 사용자가 Tableau Server에 이미 정의되어 있는 경우 유용할 수 있습니다. **중요:** 예방 조치를 취하지 않고 사용자 도메인 이름을 무시하는 것은 권장하지 않습니다. 즉, IdP에서 만든 구성된 도메인 전체에서 사용자 이름이 고유한지 확인해야 합니다. 사용자 도메인 이름을 무시하도록 Tableau Server를 설정하면 의도치 않은 사용자가 로그온하게 될 수도 있습니다. IdP에 다중 도메인(`example.com` 및 `tableau.com`)이 구성되어 있다고 가정합니다. 조직에 이름이 같지만 사용자 계정이 다른 두 사용자(`alice@tableau.com` 및 `alice@example.com`)가 있는 경우 OpenID 프로비저닝 시퀀스를 먼저 완료하는 사용자가 IdP에서 `sub` 매핑을 요청하게 됩니다. 잘못된 사용자가 매핑되면 연결된 `sub` 값을 재설정할 때까지 다른 사용자가 로그온할 수 없게 됩니다. IdP의 사용자 이름에서 도메인 이름을 무시하도록 Tableau Server를 구성하려면 `tsm authentication openid configure --ignore-domain`을 `true`로 설정합니다. 자세한 내용은 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)를 참조하십시오. 사용자 이름의 도메인을 무시하도록 tsm authentication openid configure `--ignore-domain` 옵션을 변경하려면 Tableau Server의 모든 사용자 이름에 도메인 이름이 있어야 합니다. ### 사용자 지정 클레임을 사용하여 사용자 매핑 [OpenID Connect](https://help.tableau.com/current/server/ko-kr/openid_auth.htm#Authenti)에 설명된 것과 같이 `sub` 클레임이 IdP 클레임에 포함되는 경우가 종종 있습니다. 일반적으로 `sub` 클레임은 지정된 사용자 계정을 식별하는 고유한 문자열입니다. `sub` 클레임을 사용할 때의 장점은 계정에 연결된 다른 사용자의 특성 또는 IdP 클레임(이메일, 전화 번호 등)이 업데이트되더라도 클레임이 변경되지 않는다는 것입니다. 기본적으로 Tableau Server는 IdP ID 토큰의 `sub` 클레임에 따라 OpenID 사용자를 식별하고 확인합니다. OpenID `sub` 클레임 값은 Tableau Server의 해당하는 사용자에게 매핑되어야 합니다. `sub` 클레임은 임의 문자열이므로 첫 로그인 세션 중에 계정을 연결할 때 다른 클레임이 사용됩니다. 사용자가 처음으로 OpenID를 통해 Tableau Server에 로그인하면 Tableau가 OpenID 사용자 계정과 일치하는 Tableau Server 사용자 계정을 찾습니다. 기본적으로 Tableau는 `email` IdP 클레임을 사용하여 Tableau 사용자를 식별합니다. 그런 다음 OpenID의 `sub` 클레임으로 사용자 레코드를 업데이트합니다. ID 토큰에는 항상 `sub` 클레임과 함께 다른 클레임이 포함되므로 후속 세션에서는 `sub` 클레임을 통해서만 사용자가 식별됩니다. 일부 조직에서는 안정성 또는 IdP 지원 문제로 사용자 이름을 이메일 주소에 매핑하지 못할 수 있습니다. Tableau Server 10.2부터는 모든 임의 IdP 클레임의 사용자 계정을 Tableau Server 사용자 이름에 매핑할 수 있습니다. 사용하는 IdP 클레임은 해당하는 Tableau Server 사용자 이름에 정확히 매핑되어야 합니다. 아래의 예에서 사용자 이름은 `kwilliams`입니다. ![Tableau Server에 새로운 사용자를 추가하는 양식입니다.](/tableau/current/ko-kr/server/ko-kr/Img/users_add_srvruser.png) Tableau Server의 ID를 매핑할 때 사용되는 IdP 클레임을 변경하려면 `tsm authentication openid map-claims --user-name` 명령을 사용합니다. 자세한 내용은 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)를 참조하십시오. ### `sub` 클레임 변경 위에 설명된 것과 같이 `sub` 클레임은 초기 매핑 세션 후 Tableau Server가 사용자를 식별할 때 사용하는 식별자입니다. `sub` 클레임은 Tableau Server의 해당하는 사용자 계정에 기록됩니다. 사용하는 IdP에서 `sub` 클레임을 제공하지 않는 경우에는 대신 사용할 임의 클레임을 지정할 수 있습니다. `sub` 클레임과 마찬가지로 지정하는 클레임 값은 고유해야 하며 다른 사용자 클레임이 업데이트될 때 변경되지 않습니다. 기본 sub 클레임으로 다른 IdP 클레임을 지정하려면 `tsm authentication openid map-claims --id` 명령을 사용합니다. 자세한 내용은 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)를 참조하십시오. 여기서 `arbitraryClaim`은 `sub` 클레임을 대체하여 사용할 IdP 클레임의 이름입니다. ## 인증 컨텍스트 OpenID Connect IdP에 특정 인증 컨텍스트가 필요한 경우 `vizportal.openid.essential_acr_values` 및 `vizportal.openid.voluntary_acr_values` 구성 키를 사용하여 필수 및 자발적 ACR 값 목록을 지정할 수 있습니다. 자세한 내용은 [tsm configuration set 옵션](https://help.tableau.com/current/server/ko-kr/cli_configuration-set_tsm.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect 인증 요청 매개 변수 Tableau Server에서 전송된 OpenID 인증 요청은 이 항목에 나열된 것과 같은 제한된 매개 변수 집합을 사용합니다. OpenID IdP에 다음 목록에 나와 있지 않은 매개 변수가 필요한 경우 Tableau Server 제품과 함께 사용할 때 호환되지 않습니다. - `scope`. 이 값은 반환할 사용자 정보를 IdP에 알려주는 프로필을 지정합니다. 이 값은 Tableau Server 관리자가 구성할 수 있습니다. 기본값은 "openid email profile"입니다. 자세한 내용은 이 문서의 뒷부분에 있는 [scope 값 구성](#configure-scope-value)을 참조하십시오. - `response_type`. OpenID Connect는 다중 흐름을 지원합니다. 이 값은 Tableau Server가 예상하는 흐름을 IdP에 알려줍니다. Tableau는 인증 코드 흐름만 지원하면 값은 항상 "code"로 설정됩니다. - `client_id`. 이 값은 서버의 ID(Tableau Server 구성 대화 상자에서 공급자 클라이언트 ID)를 지정합니다. 이 ID는 IdP가 요청이 시작된 위치를 확인하는 데 사용됩니다. 서비스를 등록하면 IdP가 이 ID를 제공합니다. 이 값은 Tableau Server 관리자가 구성할 수 있습니다. - `redirect_uri`. 이 값은 OpenID Connect를 사용하여 사용자를 인증한 후 IdP가 리디렉션되는 URL을 지정합니다. URL에는 호스트 및 프로토콜(예: `http://example.tableau.com`)이 포함되어야 하지만 URL 끝점은 Tableau에서 제공합니다. - `nonce`. Tableau Server는 nonce 값을 생성하여 리디렉션된 클라이언트가 IdP에서 돌아오는 엔터티와 일치하는지 확인합니다. ## scope 값 구성 `scope` 값은 Tableau Server가 사용자에 대해 요청하는 정보를 IdP에 보여 줍니다. 기본적으로 Tableau Server는 값 "openid profile email"을 전송합니다. 이는 Tableau가 OpenID를 사용하여 인증(이 부분의 `scope` 특성 값이 항상 포함되어야 함)하고 Tableau Server가 사용자 인증 코드를 교환할 때 사용자 프로필 및 이메일 정보를 요청한다는 것을 나타냅니다. 이 기본 scope가 시나리오에 해당하지 않는 경우 Tableau Server에서 사용자에 대한 사용자 지정 정보를 요청하도록 할 수 있습니다. 그러려면 사용자 지정 프로필을 사용하여 IdP를 구성합니다(예: "tableau-scope"). 그런 다음 Tableau Server에서 사용자 지정 프로필의 이름을 사용하여 범위 요청을 전송하도록 할 수 있습니다. Tableau Server에서 요청하는 범위 값을 변경하려면 다음 TSM CLI 명령을 사용합니다. `tsm authentication openid configure --custom-scope-name custom-scope-name` **참고:** - Tableau Server에는 항상 "openid"가 scope 값의 일부로 포함되며 `custom_scope` 설정에서 포함하지 않은 경우에도 마찬가지입니다. - TSM 인증 구성 명령은 Tableau Server 설치 중에 TSM에서 구성된 OIDC 인증에만 적용됩니다. ID 풀의 OIDC 인증 구성을 변경하려면 Tableau REST OpenAPI를 통해 [인증 구성 업데이트](https://help.tableau.com/current/api/rest_api/ko-kr/REST/TAG/index.html#operation/AuthnService_UpdateAuthConfiguration) 끝점을 사용하면 됩니다. [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect를 사용하여 Tableau Server 로그인 이 항목에서는 OpenID Connect를 사용하여 Tableau Server에 로그인하는 방법에 대한 자세한 정보를 제공합니다. 다음 항목에서는 Tableau Server에서 OpenID Connect를 구성하고 사용하는 방법에 대한 자세한 정보를 제공합니다. - [OpenID Connect](https://help.tableau.com/current/server/ko-kr/openid_auth.htm) - [OpenID Connect용 IdP(ID 공급자) 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_idp_config.htm) - [OpenID Connect에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_server_config.htm) - OpenID Connect를 사용하여 Tableau Server 로그인(현재 위치) ## OpenID Connect를 사용하여 로그인 OpenID Connect를 사용하도록 Tableau Server를 구성한 후 서버 액세스 권한이 있는 사용자 중 아직 로그인하지 않은 사용자는 IdP 사이트로 리디렉션되고 여기에 로그인하라는 메시지가 표시됩니다. 사용자는 IdP에서 사용하는 자격 증명을 입력하면 됩니다. 대부분의 경우 다음 예와 같이 Tableau Server와 정보를 공유하도록 IdP에 권한을 부여할지를 묻는 메시지도 표시됩니다. ![액세스를 허용하거나 거부하는 Google 양식입니다.](/tableau/current/ko-kr/server/ko-kr/Img/Google-grant-access-db.png) 사용자가 OpenID Connect를 사용하여 로그인하는 경우 IdP는 Tableau Server로 리디렉션하는 정보와 함께 고유 사용자 ID(OpenID의 sub 값)을 전송합니다. 이 sub 값은 사용자의 Tableau 사용자 ID와 연결됩니다. ## 명령줄 도구의 로그인을 서버 관리자로 제한 Tableau Server(`tabcmd`, TSM 및 `tableau.com`)와 함께 작동하는 명령줄 도구는 OpenID Connect를 사용한 로그인을 지원하지 않습니다. 서버에 대해 OpenID Connect를 사용하도록 설정한 경우라도 명령줄 도구를 사용하려면 Tableau Server 사용자 이름과 암호를 사용하여 로그인해야 합니다. 사용자가 일반적으로 OpenID Connect를 사용하여 인증하는 경우에도 각 사용자에게 Tableau Server 사용자 이름과 암호가 있습니다. 즉, 해당 사용자는 `tabcmd` 같은 명령줄 도구를 사용할 수 있습니다. 보안 수단으로, _서버 관리자만_ 명령줄 도구를 사용할 수 있도록 제한할 수 있습니다. 이렇게 하려면 `tsm configuration set`을 사용하여 `wgserver.authentication.restricted`를 `true`로 설정합니다. 이 설정이 `true`이면 서버 관리자만 사용자 이름과 암호를 사용하여 Tableau Server에 로그인할 수 있습니다. 다른 모든 사용자는 OpenID Connect 같은 SSO(Single Sign-On) 옵션을 사용하여 서버에 _로그인해야 합니다_. 결과적으로, 관리자가 아닌 사용자는 명령줄 도구를 사용할 수 없게 됩니다. 이렇게 변경하려면 다음과 같은 순서로 TSM 명령을 실행합니다. tsm configuration set -k wgserver.authentication.restricted -v true tsm pending-changes apply [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect에 대해 Tableau Server 구성 이 항목에서는 SSO(Single Sign-On)에 대해 OIDC(OpenID Connect)를 사용하도록 Tableau Server을 구성하는 방법에 대해 설명합니다. 이 단계는 여러 단계로 구성된 프로세스 중 하나입니다. 다음 항목에서는 Tableau Server에서 OIDC를 구성하고 사용하는 방법에 대한 자세한 정보를 제공합니다. 1. [OpenID Connect](https://help.tableau.com/current/server/ko-kr/openid_auth.htm) 개요 2. [OpenID Connect용 IdP(ID 공급자) 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_idp_config.htm) 3. OpenID Connect에 대해 Tableau Server 구성(현재 위치) 4. [OpenID Connect를 사용하여 Tableau Server 로그인](https://help.tableau.com/current/server/ko-kr/openid_auth_signing_in.htm) **참고:** - 여기에 설명되어 있는 단계를 수행하기 전에 [OpenID Connect용 IdP(ID 공급자) 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_idp_config.htm)에 설명된 대로 OpenID IdP(ID 공급자)를 구성해야 합니다. - 이 항목에 설명된 절차는 ID 풀을 통해 구성된 OIDC 인증에 적용될 수 있습니다. 그러나 먼저 [ID 풀을 사용하여 사용자 프로비저닝 및 인증](https://help.tableau.com/current/server/ko-kr/identity_pools.htm)의 지침을 따르고 필요한 경우 이 항목으로 되돌아와 참조하십시오. - Tableau REST API 및 tabcmd는 OIDC SSO(Single-Sign On)를 지원하지 않습니다. [tabcmd](https://help.tableau.com/current/server/ko-kr/tabcmd.htm) 또는 [REST API](https://help.tableau.com/current/api/rest_api/ko-kr/help.htm "REST API 도움말이 새 탭에서 열립니다.")를 사용하려면 사용자가 TableauID 계정을 사용하여 Tableau Server에 로그인해야 합니다. 1. 브라우저에서 TSM을 엽니다. https://:8850. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm)을 참조하십시오. 2. 구성 탭에서 사용자 ID 및 액세스 > 인증 방법을 선택합니다. 3. 인증 방법의 드롭다운 메뉴에서 OpenID Connect를 선택합니다. 4. OpenID Connect 아래에서 서버에 OpenID 인증 사용을 선택합니다. 5. 조직의 OpenID 구성 정보를 입력합니다. ![TSM의 OpenID Connect 구성 이미지](/tableau/current/ko-kr/server/ko-kr/Img/tsm_ui_oidc.png) **참고:** - **3단계**의 경우: 공급자가 공용 URL이 아닌 로컬 컴퓨터에서 호스팅되는 구성 파일을 사용하는 경우 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)를 사용하여 파일을 지정할 수 있습니다. `--metadata-file ` 옵션을 사용하여 로컬 IdP 구성 파일을 지정합니다. - **4단계**의 경우: Tableau Server 2025.3부터 SLO(싱글 로그아웃)을 사용하도록 설정하고, 로그아웃한 후 사용자를 리디렉션할 URL을 지정할 수 있습니다. - 5단계: Tableau Server 2026.2부터 OIDC 인증 워크플로우의 일부로 사용자 특성 및 해당 함수를 사용하도록 설정할 수 있습니다. 자세한 내용은 [OIDC 클레임의 사용자 특성](https://help.tableau.com/current/server/ko-kr/openid_auth.htm#user_attributes)을 참조하십시오. 6. 구성 정보를 입력한 후 보류 중인 변경 내용 저장을 클릭합니다. 7. 페이지 맨 위에서 보류 중인 변경 내용을 클릭합니다. ![보류 중인 변경 내용이 있음을 나타내는 Tableau Server Manager 툴바입니다.](/tableau/current/ko-kr/server/ko-kr/Img/tsm-ui-pending-changes-btn.png) 8. 변경 내용 적용 후 다시 시작을 클릭합니다. 이 섹션의 절차에서는 TSM 명령줄 인터페이스를 사용하여 OpenID Connect를 구성하는 방법에 대해 설명합니다. 또한, OpenID Connect 초기 구성에 구성 파일을 사용할 수 있습니다. 자세한 내용은 [openIDSettings 엔터티](https://help.tableau.com/current/server/ko-kr/entity_openid.htm)를 참조하십시오. 1. [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)의 `configure` 명령을 사용하여 다음과 같은 필수 옵션을 설정합니다. - `--client-id `: IdP가 응용 프로그램에 할당한 공급자 클라이언트 ID를 지정합니다. 예를 들어 `“xxxkjwdlnaoiloadjkwha"`입니다. - `--client-secret `: 공급자 클라이언트 암호를 지정합니다. 이는 Tableau에서 IdP의 응답 신뢰성을 확인하는 데 사용하는 토큰입니다. 이 값은 암호이므로 안전하게 보관해야 합니다. 예를 들어 `“xxxhfkjaw72123="`입니다. - `--config-url ` 또는 `--metadata-file `: 공급자 구성 json 파일의 위치를 지정합니다. 공급자가 공개 JSON 검색 파일을 호스팅하는 경우 `--config-url`을 사용합니다. 그렇지 않은 경우, `--metadata-file`에 대한 로컬 컴퓨터의 경로와 파일 이름을 대신 지정합니다. - `--return-url `: 서버의 URL입니다. 이는 일반적으로 `"http://example.tableau.com"`과 같이 서버의 공개 이름입니다. 예를 들어 다음 명령을 실행합니다. `tsm authentication openid configure --client-id “xxxkjwdlnaoiloadjkwha" --client-secret “xxxhfkjaw72123=" --config-url "https://example.com/openid-configuration" --return-url "http://tableau.example.com"` **참고:**  - [openIDSettings 엔터티](https://help.tableau.com/current/server/ko-kr/entity_openid.htm)를 사용하여 Open ID Connect에 대해 설정할 수 있는 선택적인 추가 구성이 있습니다. 또는 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)를 사용할 수 있습니다. 또한 IdP 클레임 매핑을 구성해야 한다면 [openid map-claims에 대한 옵션](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#Options2)을 참조하십시오. - Tableau Server 2025.3부터 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC)를 사용하여 선택적으로 SLO(싱글 로그아웃)를 사용하도록 설정할 수 있습니다. 2. 다음 명령을 입력하여 Open ID Connect를 사용하도록 설정합니다. `tsm authentication openid enable` 3. `tsm pending-changes apply`를 실행하여 변경 내용을 적용합니다. 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 정방향 프록시를 사용하도록 OpenID 구성 기본적으로 Tableau Server는 프록시 설정을 무시하고 모든 OpenID 요청을 IdP로 직접 전송합니다. Tableau Server 2021.2.2 이상부터 Tableau가 정방향 프록시를 사용하여 인터넷에 연결하도록 구성된 경우 프록시 호스트 및 포트 설정을 사용하여OpenID IdP에 접속하도록 Tableau Server를 구성할 수 있습니다. Tableau Server를 구성하는 방법은 조직에서 정방향 프록시를 구현한 방법에 따라 다릅니다. - 정방향 프록시는 Tableau Server를 실행 중인 Windows 컴퓨터에 구성됩니다. - Tableau Server는 모든 아웃바운드 트래픽을 조직에서 실행되는 정방향 프록시 서버로 직접 전송합니다. ### Windows 시스템 프록시 구성 조직에서 각 Windows 컴퓨터에 정방향 프록시를 구성한 경우 이 방법을 사용하여 Tableau Server의 OpenID에 대한 시스템 프록시 구성을 사용합니다. 다음 명령을 실행합니다. tsm configuration set -k tomcat.useSystemProxies -v true tsm pending-changes apply ### 전방향 프록시 서버 [tsm configuration set](https://help.tableau.com/current/server/ko-kr/cli_configuration_tsm.htm#TSMSet) 명령을 사용하여 변경을 수행합니다. - HTTPS 프록시 호스트의 경우 다음 키-값 쌍을 사용합니다. `-k tomcat.https.proxyHost -v host.domain` `-k tomcat.https.proxyPort -v port_number` 예를 들어 프록시 서버가 `https://proxy.example.lan:8443`에 있는 경우 다음 명령을 실행합니다. tsm configuration set -k tomcat.https.proxyHost -v proxy.example.lan tsm configuration set -k tomcat.https.proxyPort -v 8443 tsm pending-changes apply - HTTP 프록시 호스트의 경우 다음 키-값 쌍을 사용합니다. `-k tomcat.http.proxyHost -v host.domain` `-k tomcat.http.proxyPort -v port_number` 이러한 키를 설정한 후 `tsm pending-changes apply`를 실행합니다. ## 사용자 특성을 사용하여 데이터 액세스 사용자 지정 및 제어 사용자 특성은 조직에서 정의한 사용자 메타데이터입니다. 사용자 특성은 일반적인 ABAC(특성 기반 액세스 제어) 권한 부여 모델에서 액세스 권한을 결정하는 데 사용할 수 있습니다. 사용자 특성은 직무, 부서 소속, 관리 수준 등 사용자 프로필의 모든 측면을 포함할 수 있습니다. 또한 사용자가 로그인한 위치 또는 언어 기본 설정과 같은 런타임 사용자 컨텍스트와 연관될 수 있습니다. 워크플로우에 사용자 특성을 포함하면 데이터 액세스 및 개인화를 통해 사용자 환경을 제어하고 사용자 지정할 수 있습니다. - **데이터 액세스**: 사용자 특성을 사용하여 데이터 보안 정책을 적용할 수 있습니다. 이를 통해 사용자는 자신이 볼 권한을 부여받은 정보만 볼 수 있습니다. - **개인 설정**: 위치 및 역할과 같은 사용자 특성을 전달하면 액세스하는 사용자와 관련된 정보만 표시하도록 콘텐츠를 사용자 지정할 수 있으므로 필요한 정보를 더 쉽게 찾을 수 있습니다. **사용자 특성을 전달하는 단계 요약** 워크플로우에서 사용자 특성을 사용하도록 설정하는 프로세스는 다음 단계로 요약됩니다. 1. 사용자 특성 설정 사용 2. 어설션에 사용자 특성 포함 3. 콘텐츠 작성자가 사용자 특성 함수와 관련 필터를 포함하는지 확인 4. 콘텐츠 검토 ### 1단계: 사용자 특성 설정 사용 보안상의 이유로 서버 관리자가 사용자 특성 설정을 사용하도록 설정한 경우에만 인증 워크플로우에서 사용자 특성의 유효성이 검사됩니다. 1. 브라우저에서 TSM을 엽니다. https://:8850. 자세한 내용은 [Tableau 서비스 관리자 웹 UI에 로그인](https://help.tableau.com/current/server/ko-kr/sign_in_tsm.htm)을 참조하십시오. 2. 구성 탭에서 사용자 ID 및 액세스 > 인증 방법을 선택합니다. 3. 인증 방법의 드롭다운 메뉴에서 SAML을 선택합니다. 4. **8단계**의 SAML 인증에서 사용자 특성 캡처 사용 확인란을 선택합니다. 5. 작업을 완료하면 다음을 수행합니다. 1. 보류 중인 변경 내용 저장을 클릭합니다. 2. 페이지 맨 위에서 보류 중인 변경 내용 단추를 클릭합니다. 3. 변경 내용 적용 후 다시 시작을 클릭합니다. ### 2단계: 어설션에 사용자 특성 포함 어설션에 사용자 특성이 포함되어 있는지 확인합니다. **참고:** `scp` 또는 `scope` 특성을 제외하고 SAML 응답의 특성에는 4096자 제한이 적용됩니다. 사용자 특성을 포함하여 응답의 특성이 이 제한을 초과하는 경우 Tableau는 해당 특성을 제거하고 대신 `ExtraAttributesRemoved` 특성을 전달합니다. 그런 다음 콘텐츠 작성자는 특성이 감지되었을 때 사용자에게 콘텐츠를 표시하는 방법을 결정하기 위해 `ExtraAttributesRemoved` 특성이 포함된 계산을 만들 수 있습니다. **예** South 지역에 위치한 관리자인 Fred Suzuki라는 직원이 있다고 가정하겠습니다. Fred가 보고서를 검토할 때 South 지역의 데이터만 볼 수 있도록 해야 합니다. 이와 같은 시나리오에서는 아래 예와 같이 SAML 응답에 Region 사용자 특성을 포함할 수 있습니다. https://myidp.okta.com/saml South ### 3단계: 콘텐츠 작성자가 특성 함수를 포함하는지 확인 콘텐츠 작성자가 사용자 특성 함수와 관련 필터를 포함하여 콘텐츠에 표시할 수 있는 데이터를 제어해야 합니다. 사용자 특성 어설션이 Tableau로 전달되도록 하려면 콘텐츠에 다음 사용자 특성 함수 중 하나가 포함되어야 합니다. - `USERATTRIBUTE('attribute_name')` - `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')` 콘텐츠 작성자가 사용하는 함수는 사용자 특성이 단일 값을 반환하는지 아니면 여러 값을 반환하는지에 따라 달라집니다. 이러한 함수에 대한 자세한 내용과 각 함수의 예는 Tableau 도움말의 [사용자 함수](https://help.tableau.com/current/pro/desktop/ko-kr/functions_functions_user.htm#user_attributes)를 참조하십시오. **참고:** - Tableau Desktop 또는 Tableau Cloud에서 작성하는 경우 이러한 함수를 사용하는 콘텐츠의 미리 보기를 사용할 수 없습니다. 함수는 NULL 또는 FALSE 값을 반환합니다. 사용자 함수가 예상대로 작동하는지 확인하려면 작성자가 콘텐츠를 사용할 수 있도록 설정한 후 함수를 검토하는 것이 좋습니다. - 콘텐츠가 예상대로 렌더링될 수 있도록 콘텐츠 작성자는 `ExtraAttributesRemoved` 특성을 사용하는 계산을 포함하려 할 수 있습니다. 이 계산은 1) 해당 특성의 존재 여부를 확인하고 2) 특성이 존재할 경우 콘텐츠에 대해 수행할 작업을 결정합니다(예: 메시지 표시). SAML XML의 특성이 4096자를 초과하는 경우 Tableau는 `ExtraAttributesRemoved` 특성만 추가하고 `scp` 또는 `scope`를 제외한 다른 모든 특성을 제거합니다. 이는 최적의 성능을 보장하고 저장소 제한을 준수하기 위한 것입니다. **예** 위의 [2단계: 어설션에 사용자 특성 포함](#step_pass_user_attribute)에서 설명한 예를 계속 진행하겠습니다. 'Region' 사용자 특성 어설션을 통합 문서에 전달하기 위해 작성자는 `USERATTRIBUTEINCLUDES`를 포함할 수 있습니다. 예를 들어 `USERATTRIBUTEINCLUDES('Region', [Region])`와 같습니다. 여기서, 'Region'은 사용자 특성이고 \[Region\]은 데이터의 열입니다. 작성자는 새 계산을 사용하여 Manager 및 Sales 데이터가 있는 테이블을 만들 수 있습니다. 계산이 추가되면 통합 문서는 예상대로 'False' 값을 반환합니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/uaf_calc_view.png) 내장된 통합 문서에서 South 지역과 연관된 데이터만 표시하려는 경우 작성자는 필터를 만들고 South 지역이 'True'일 때 값을 표시하도록 필터를 사용자 지정할 수 있습니다. 필터를 적용하면 함수가 'False' 값을 반환하고 필터는 'True' 값만 표시하도록 사용자 지정되기 때문에 통합 문서가 예상대로 비어 있게 됩니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/uaf_filter_view.png) ### 4단계: 콘텐츠 검토 콘텐츠를 검토하고 유효성을 검사합니다. **예** 위의 [3단계: 콘텐츠 작성자가 특성 함수를 포함하는지 확인](#step_include_uaf)의 예로 마무리하겠습니다. Fred Suzuki의 사용자 컨텍스트가 South 지역이기 때문에 뷰의 Sales 데이터가 Fred Suzuki로 사용자 지정된 것을 확인할 수 있습니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/uaf_embedded_view_south.png) 통합 문서에 표시된 지역의 Manager는 자신의 지역과 연결된 값을 볼 수 있습니다. 예를 들어 West 지역의 Sawdie Pawthorne은 자신이 속한 지역과 관련된 데이터를 볼 수 있습니다. ![](/tableau/current/ko-kr/server/ko-kr/Img/uaf_embedded_view_west.png) 통합 문서에서 해당 지역을 대표하지 않는 Manager에게는 빈 통합 문서가 표시됩니다. ### 알려진 문제와 제한 사항 사용자 특성 함수로 작업할 때 고려해야 할 몇 가지 알려진 문제 및 제한 사항이 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # OpenID Connect용 IdP(ID 공급자) 구성 이 항목에서는 Tableau Server에서 OIDC(OpenID Connect)를 사용하도록 IdP(ID 공급자)를 구성하는 방법에 대한 자세한 정보를 제공합니다. 이 단계는 여러 단계로 구성된 프로세스 중 하나입니다. 다음 항목에서는 Tableau에서 OIDC를 구성하고 사용하는 방법에 대한 자세한 정보를 제공합니다. 1. [OpenID Connect](https://help.tableau.com/current/server/ko-kr/openid_auth.htm) 개요 2. OpenID Connect용 IdP(ID 공급자) 구성(현재 위치) 3. [OpenID Connect에 대해 Tableau Server 구성](https://help.tableau.com/current/server/ko-kr/openid_auth_server_config.htm) 4. [OpenID Connect를 사용하여 Tableau Server 로그인](https://help.tableau.com/current/server/ko-kr/openid_auth_signing_in.htm) OpenID Connect를 Tableau Server에 사용할 수 있으려면 먼저 IdP(ID 공급자)의 계정이 있어야 하며 해당 IdP의 프로젝트 또는 응용 프로그램이 있어야 합니다. Tableau Server을 구성할 때 다음 정보를 제공할 수 있어야 합니다. - **클라이언트 ID:** 이는 IdP가 사용자의 응용 프로그램에 할당한 식별자입니다. - **클라이언트 암호:** 이는 Tableau에서 IdP의 응답 신뢰성을 확인하는 데 사용하는 토큰입니다. 이 값은 암호이므로 안전하게 보관해야 합니다. - **구성 URL:** 이 URL은 OpenID 공급자 메타데이터가 포함된 공급자 구성 검색 문서의 URL입니다. #### 리디렉션 URL 일부 IdP에는 Tableau Server에 대한 리디렉션 URL이 필요합니다. 다음 구문을 사용하여 IdP에 대한 URL을 수동으로 구성할 수 있습니다. `:///vizportal/api/web/v1/auth/openIdLogin` 예를 들어 `https://tableau.example.com/vizportal/api/web/v1/auth/openIdLogin`입니다. #### 서명 알고리즘 Tableau Cloud는 RS256(SHA-256을 사용하는 RSA)을 지원합니다. #### IdP 프로세스 예 다음 절차는 공급자 사이트에서 따라야 할 개괄적인 단계입니다. 절차는 일례로 Google을 공급자로 사용하여 설명되어 있습니다. 단, 각 공급자마다 절차가 다소 상이하므로 구체적인 단계 및 순서는 공급자마다 다를 수 있습니다. 1. 공급자의 개발자 사이트에 등록하고 로그인합니다. 예를 들어 Google의 경우 URL [https://console.developers.google.com](https://console.developers.google.com)의 개발자 콘솔로 이동합니다. 2. 새 프로젝트, 응용 프로그램 또는 신뢰 당사자 계정을 만듭니다. 3. 개발자 대시보드에서 OAuth 2.0 클라이언트 ID 및 클라이언트 암호를 얻는 단계를 따릅니다. 나중을 위해 해당 값을 기록합니다. **참고:** 클라이언트 암호를 안전한 곳에 보관하십시오. 4. 개발자 사이트에서 IdP가 OpenID Connect 검색에 사용하는 끝점의 URL을 찾습니다. 예를 들어 Google은 URL [https://accounts.google.com/.well-known/openid-configuration](https://accounts.google.com/.well-known/openid-configuration)을 사용합니다. 나중을 위해 해당 URL을 기록합니다. 또는 IdP로부터 정적 검색 문서를 제공받은 경우 나중을 위해 해당 파일을 Tableau Server의 로컬 디렉터리에 복사합니다. [주요 콘텐츠로 건너뛰기](#main-content) # openIDSettings 엔터티 OpenID 인증을 구성하기 전에 [OpenID Connect 사용 시 요구 사항](https://help.tableau.com/current/server/ko-kr/openid_auth_requirements.htm)을 검토하십시오. 아래의 구성 파일 템플릿을 사용하여 json 파일을 만듭니다. 옵션을 적절한 값으로 채운 후 다음 명령으로 json 파일을 전달하고 설정을 적용합니다. `tsm settings import -f path-to-file.json` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 구성 템플릿 이 템플릿을 사용하여 OpenID 설정을 구성합니다. **중요:** 모든 엔터티 옵션은 대/소문자를 구분합니다. 구성 파일, 엔터티 및 키에 대한 자세한 설명은 [구성 파일 예제](https://help.tableau.com/current/server/ko-kr/config_file_example.htm)를 참조하십시오. OIDC의 초기 구성을 마친 후 [tsm authentication openid ](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMOIDC) 하위 범주를 사용하여 추가 값을 설정합니다. { "configEntities": { "openIDSettings": { "\_type": "openIDSettingsType", "enabled": true, "clientId": "required", "clientSecret": "required", "configURL": "required if staticFile value is not set", "staticFile": "required if configURL value is not set", "externalURL": "required" } } } ## 구성 파일 참조 다음 목록에는 `"openIDSettings"` 엔터티 집합과 함께 포함할 수 있는 모든 옵션이 나열되어 있습니다. \_type 필수 항목입니다. 변경하지 마십시오. enabled 필수 항목입니다. `true`로 설정합니다. clientId 필수 항목입니다. IdP가 응용 프로그램에 할당한 공급자 클라이언트 ID를 지정합니다. 예를 들어 `“laakjwdlnaoiloadjkwha"`입니다. clientSecret 필수 항목입니다. 공급자 클라이언트 암호를 지정합니다. 이는 Tableau에서 IdP의 응답 신뢰성을 확인하는 데 사용하는 토큰입니다. 이 값은 암호이므로 안전하게 보관해야 합니다. 예를 들어 `“fwahfkjaw72123="`입니다. configURL 필수 항목입니다. 공급자 구성 URL을 지정합니다. 구성 URL을 지정하지 않은 경우 이 옵션을 삭제하고 `staticFile`의 경로 및 파일 이름을 지정하십시오. staticFile 필수 항목입니다. 정적 OIDC 검색 JSON 문서에 대한 로컬 경로를 지정합니다. 정적 파일을 지정하지 않은 경우 이 옵션을 삭제하고 `configURL`의 URL을 지정하십시오. externalURL 필수 항목입니다. 서버의 URL입니다. 이는 일반적으로 `http://example.tableau.com`과 같이 서버의 공개 이름입니다. connectionTimeout 선택 사항입니다. 연결 시간 초과 기간(초)을 지정합니다. 기본값은 `10`입니다. readTimeout 선택 사항입니다. 읽기 시간 초과 기간(초)을 지정합니다. 기본값은 `30`입니다. ignoreDomain 다음에 해당하는 경우 `true`로 설정합니다. - Tableau Server의 사용자 이름으로 이메일 주소를 사용합니다. - 여러 도메인 이름을 사용하여 IdP 사용자를 프로비저닝했습니다. - IdP의 `email` 클레임에서 도메인 이름 부분을 무시하고 싶습니다. 계속하기 전에 이 옵션을 `true`로 설정함에 따라 사용하게 될 사용자 이름을 검토하십시오. 사용자 이름이 충돌할 수 있습니다. 사용자 이름이 충돌하는 경우 정보 유출의 위험이 높아집니다. [OpenID Connect 사용 시 요구 사항](https://help.tableau.com/current/server/ko-kr/openid_auth_requirements.htm)을 참조하십시오. ignoreJWK IdP가 JWK 유효성 검사를 지원하지 않는 경우 `true`로 설정합니다. 이 경우 상호 TLS 또는 다른 네트워크 계층 보안 프로토콜을 사용하여 IdP와의 통신을 인증하는 것이 좋습니다. 기본값은 `false`입니다. customScope IdP를 쿼리하는 데 사용할 수 있는 사용자 지정 범위의 사용자 관련 값을 지정합니다. [OpenID Connect 사용 시 요구 사항](https://help.tableau.com/current/server/ko-kr/openid_auth_requirements.htm)을 참조하십시오. idClaim IdP가 ID 토큰의 사용자를 고유하게 식별할 때 `sub` 클레임을 사용하지 않는 경우 이 값을 변경합니다. 지정하는 IdP 클레임에는 단일의 고유한 문자열이 포함되어야 합니다. usernameClaim 이 값을 조직에서 Tableau Server에 저장된 사용자 이름과 일치시킬 때 사용할 IdP 클레임으로 변경합니다. clientAuthentication OpenID Connect에 대한 사용자 지정 클라이언트 인증 방법을 지정합니다. Salesforce IdP를 사용하도록 Tableau Server를 구성하려면 이 값을 `client_secret_post`로 설정합니다. iFramedIDPEnabled iFrame에 표시되는 IdP를 허용하려면 `true`로 설정합니다. iFrame에 표시할 수 있으려면 IdP가 클릭재킹 방지를 사용하지 않도록 설정해야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # PostgreSQL 데이터베이스를 독립 실행형 설치로 만들기 버전 2021.2부터는 Tableau Server 리포지토리를 독립 실행형 설치로 별도 호스팅할 수 있습니다. 이는 AWS RDS 또는 Azure 데이터베이스와 같은 관리형 클라우드 서비스를 사용하는 것과 다릅니다. 이 구성은 온프레미스, AWS EC2 또는 Azure VM에서 수행할 수 있습니다. 이러한 Tableau Server 리포지토리 설치를 독립 실행형 외부 리포지토리라고 합니다. 외부 리포지토리에 사용할 수 있는 전체 호스트 목록을 보려면 [Tableau Server 외부 리포지토리](https://help.tableau.com/current/server/ko-kr/server_external_repo.htm)를 참조하십시오. 이 항목에서는 Tableau Server가 PostgreSQL 설치에 연결하여 Tableau Server 외부 리포지토리로 사용하는 데 필요한 요구 사항 및 구성에 대한 지침을 제공합니다. 이 항목에서는 PostgreSQL 설치 방법에 대한 자세한 지침을 제공하지 않습니다. 이 정보를 보려면 [PostgreSQL 사이트의 설명서](https://www.postgresql.org/docs/)를 따르는 것이 좋습니다. ## 요구 사항 및 권장 사항 - **하드웨어 권장 사항:** CPU와 저장소는 요구 사항에 따라 다릅니다. 소규모 설치의 경우 50GB 이상의 디스크 저장소와 32GB의 RAM이 장착된 쿼드 프로세서(또는 4개의 가상 코어) 시스템이 있어야 합니다. 백업 및 복원을 위한 디스크 공간 요구 사항을 계산하려면 [이 항목](https://help.tableau.com/current/server/ko-kr/requ_diskspace.htm#backup-and-restore-processes)의 지침을 검토하십시오. 일반적인 권장 사항은 더 많은 하드웨어 리소스로 시작하고 모니터링 후 축소하는 것입니다. - **네트워킹:** Tableau Server 클러스터의 모든 노드가 PostgreSQL 데이터베이스 인스턴스에 연결할 수 있어야 합니다. 이렇게 하는 방법 중 하나는 PostgreSQL 데이터베이스 인스턴스를 Tableau Server 클러스터의 모든 노드가 액세스할 수 있는 사용 권한을 가진 보안 그룹의 멤버로 만드는 것입니다. - **버전 호환성:** PostgreSQL의 버전은 로컬로 설치할 때 Tableau Server 리포지토리에서 사용하는 버전과 일치해야 합니다. 호환성에 대한 자세한 내용은 [제품 호환성](https://help.tableau.com/current/server/ko-kr/server_external_repo_upgrade_postgres.htm#postgres-ts-compat)을 참조하십시오. - **보안:** Tableau Server와 외부 리포지토리 간의 SSL을 사용한 보안 연결은 필수는 **아니지만** 권장됩니다. Tableau Server와 외부 리포지토리 간에 보안 연결을 설정하지 않으려는 경우 암호화되지 않은 연결을 허용하도록 독립 실행형 PostgreSQL 데이터베이스를 구성해야 합니다. ## 독립 실행형 PostgreSQL 데이터베이스 인스턴스 만들기 ### 1단계: PostgreSQL 설치 및 초기화 1. [PostgreSQL 설명서](https://www.postgresql.org/docs/)를 사용하여 Tableau Server의 외부 리포지토리 역할을 할 PostgreSQL 데이터베이스 인스턴스를 설치합니다. 고가용성 요구 사항을 충족하도록 PostgreSQL 데이터베이스 클러스터를 설정할 수 있습니다. 2. uuid-ossp 확장 프로그램이 포함된 contrib 패키지를 설치합니다. 이 모듈은 Tableau Server가 데이터베이스의 키에 사용하는 UUID를 생성하는 데 사용됩니다. 3. PostgreSQL 인스턴스를 초기화합니다. ### 2단계: PostgreSQL 인스턴스 구성 PostgreSQL 인스턴스를 구성하기 위해 두 개의 구성 파일을 사용합니다. - `pg_hba`: 호스트 기반 인증을 위한 구성 파일입니다. - `postgresql.conf`: 일반 서버 구성 파일입니다. 기본적으로 이러한 파일의 위치는 다음과 같습니다. C:\\Program Files\\PostgreSQL\\\\Data #### 슈퍼 사용자 설정 요구 사항을 충족하는 사용자 이름을 선택합니다. Admin user name(관리자 사용자 이름)으로 **postgres**를 사용하는 것이 좋습니다. 다른 사용자 이름을 사용하도록 선택하는 경우 사용자 이름이 **pg**로 시작하지 않는지 확인하십시오. 또한 사용자 이름으로 **rails**, **tblwgadmin**, **tableau**, **readonly** 또는 **tbladminviews**를 사용할 수 없습니다. > [!IMPORTANT] > > **Tableau Server에서 외부 리포지토리가 올바르게 작동하려면 이 요구 사항이 충족되어야 합니다.** #### 네트워크 및 보안 모든 Tableau Server 노드에서 데이터베이스 인스턴스에 연결할 수 있는지 확인하십시오. 대부분 모든 노드에서 액세스할 수 있도록 허용하는 보안 그룹을 만들어 처리합니다. #### 데이터베이스 옵션 포트는 아무 값이나 사용할 수 있지만 기본값인 `5432`로 유지하는 것이 좋습니다. #### 업데이트 매개 변수 Tableau Server 수준에서 인스턴스에 대한 대부분의 매개 변수 값을 기본값으로 설정할 수 있습니다. 특정 성능 또는 로깅 요구 사항이 있는 경우 매개 변수 값을 수정할 수 있지만 다음 매개 변수를 기본값으로 설정하고 변경하지 않는 것이 좋습니다. - `standard_conforming_strings` - `escape_string_warning` 또한 성능 문제를 방지하기 위해 `work_mem` 값을 `16384` 이상으로 설정하는 것이 좋습니다. #### 원격 연결 구성 다음 단계에 따라 구성 파일을 업데이트합니다. 1. 기본적으로 `postgresql.conf` 의 구성은 로컬 연결만 수신하도록 구성됩니다. `postgresql.conf` 파일의 연결 및 인증 섹션에서 다음과 같이 변경하여 원격 연결을 사용하도록 설정합니다. 원격 연결을 허용하려면 다음 줄을 추가합니다. `listen_addresses = '*'` 2. PostgreSQL 인스턴스를 다시 시작합니다. ### SSL 구성 Tableau Server와 외부 리포지토리 간의 보안 연결은 필수는 **아니지만** 권장됩니다. Tableau Server와 외부 리포지토리 간에 암호화된 연결을 구성하려면 아래에 설명된 지침 및 자세한 단계를 따릅니다. 독립 실행형 PostgreSQL 데이터베이스 인스턴스를 사용하도록 Tableau Server를 구성할 때 서버 연결을 확인하는 데 사용되는 신뢰할 수 있는 루트 CA(인증 기관)를 제공해야 합니다. 이상적으로, 독립 실행형 PostgreSQL 인스턴스의 서버 인증서는 확인 가능한 호스트 이름을 지정해야 Tableau Server가 sslmode, **verify-full**을 사용할 수 있습니다. 이 모드는 PostgreSQL 서버의 인증서가 신뢰할 수 있는 CA에 의해 서명되었으며 PostgresSQL Server 인증서의 호스트 이름이 PostgreSQL 인스턴스에 연결하는 데 사용된 호스트 이름과 일치하는지 확인합니다. 그러나 sslmode, **verify-ca**를 사용할 수 없는 경우 Postgres 서버의 인증서가 신뢰할 수 있는 CA에 의해 서명되었는지 확인하기만 하면 됩니다. 다음 절차에서는 PostgreSQL 서버에 루트 CA 인증서를 생성하는 일반적인 단계를 설명합니다. 자세한 내용은 PostgreSQL 웹 사이트의 [SSL 설명서](https://www.postgresql.org/docs/12/ssl-tcp.html)를 참조하십시오(링크는 버전 12를 가리킴). 1. 서명 루트 CA(인증 기관) 키를 생성합니다. 2. 루트 CA 인증서를 만듭니다. 3. PostgreSQL 서버에 대한 인증서와 관련 키(예: `server.csr` 및 `server.key`)를 생성합니다. 인증서의 주체 이름은 PostgreSQL 서버의 DNS 이름과 일치해야 합니다. 주체 이름은 ‘`/CN=`’ 형식의 -subj 옵션으로 설정됩니다. 4. 2단계에서 만든 CA 인증서를 사용하여 새 인증서에 서명합니다. 5. crt 및 키 파일을 데이터 디렉터리(`/pgsql//data`)에 복사합니다. 6. `pg_hba.conf` 파일은 데이터베이스에 대한 연결을 제어합니다. 원격 연결을 허용하려면 다음 줄을 추가합니다. 예를 들면 다음과 같습니다. `host all all 10.0.0.0/8 md5` 7. SSL을 사용하도록 설정하려면 다음을 사용하여 `postgresql.conf` 파일을 추가하거나 업데이트합니다. `ssl = on` SSL로만 연결을 제한하려면 _host_ 대신 _hostssl_을 사용합니다. ## 고가용성 및 재해 복구 Tableau Server는 외부 리포지토리에 대한 고가용성을 관리하거나 설정하지 않습니다. PostgreSQL 데이터베이스는 복제 및 로그 전달을 비롯한 이러한 목적을 위한 여러 솔루션을 지원합니다. 자세한 내용은 PostgreSQL 웹 사이트에서 [고가용성 설명서(영문)](https://www.postgresql.org/docs/current/high-availability.html)를 참조하십시오. 재해가 발생할 경우 새 PostgreSQL 인스턴스를 설정해야 하면 다음 단계에 따라 새 인스턴스를 사용하도록 Tableau Server를 구성해야 합니다. 1. 새 RDS 인스턴스에 대한 연결 정보를 포함하는 **새 JSON 설정 파일을 만듭니다**. JSON 설정 파일 만들기에 대한 자세한 내용은 [외부 PostgreSQL 리포지토리와 함께 Tableau Server 설치](https://help.tableau.com/current/server/ko-kr/server_external_repo_new_install.htm)의 **1단계**를 참조하십시오. 2. `tsm topology external-services repository replace-host` **명령**을 **사용**하여 Tableau Server를 새 PostgreSQL 인스턴스를 가리키도록 설정합니다. `tsm topology external-services repository replace-host` 명령에 대한 자세한 내용은 [tsm topology](https://help.tableau.com/current/server/ko-kr/cli_topology_tsm.htm)를 참조하십시오. ## 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자만 Tableau Server를 외부 리포지토리를 사용하도록 구성할 수 있습니다. AWS EC2 또는 Azure VM을 사용하여 독립 실행형 외부 리포지토리를 설정하는 경우 이러한 플랫폼에 액세스하려면 계정이 있어야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # PostgreSQL의 새로운 주 버전을 위해 외부 리포지토리로 Tableau Server 업그레이드 Tableau Server에 대한 PostgreSQL 주 버전 요구 사항이 변경된 경우 Tableau Server 업그레이드가 성공하도록 보장하기 위해 따라야 하는 몇 가지 구체적인 지침이 있습니다. 예를 들어 Tableau Server 2020.4에서는 리포지토리가 PostgreSQL 버전 12를 사용해야 합니다. 이것은 2020.4 이전의 Tableau Server 버전에서 사용된 PostgreSQL 버전 9.x의 주 버전 변경 사항입니다. 따라서 이전 버전의 Tableau Server에서 2020.4 이상 버전으로 업그레이드하는 경우 다음 섹션에 설명된 단계를 수행하여 업그레이드를 완료해야 합니다. 이 항목에는 PostgreSQL과 Tableau Server 간의 제품 호환성도 포함됩니다. ## 업그레이드 전 Amazon RDS 또는 PostgreSQL DB용 Azure 데이터베이스의 기존 PostgreSQL DB 인스턴스에서 PostgreSQL 버전을 업데이트하기 위해 현재 위치 업그레이드를 수행할 수 없습니다. 대신 새 인스턴스를 만들고 업그레이드 중에 Tableau Server가 새 인스턴스를 가리키도록 지정해야 합니다. 다음 정보를 사용하여 새 인스턴스를 만들고 업그레이드를 준비합니다. 1. PostgreSQL 데이터베이스 인스턴스의 새 인스턴스 만들기: 1. [AWS RDS(Relational Database Service)에서 PostgreSQL DB 인스턴스 만들기](https://help.tableau.com/current/server/ko-kr/server_external_repo_configure_RDS.htm) 2. [Azure에서 Azure 데이터베이스 PostgreSQL 인스턴스 만들기](https://help.tableau.com/current/server/ko-kr/server_external_repo_configure_Azure.htm) 3. [Google Cloud에서 PostgreSQL 인스턴스 만들기](https://help.tableau.com/current/server/ko-kr/server_external_repo_configure_gcp.htm) 4. [PostgreSQL 데이터베이스를 독립 실행형 설치로 만들기](https://help.tableau.com/current/server/ko-kr/server_external_repo_configure_standalone.htm) 2. SSL 연결은 필수는 **아니지만** 권장됩니다. Tableau Server와 외부 리포지토리 간의 통신에 대한 SSL 연결을 설정하려면 다음을 수행합니다. - **Amazon RDS:** [SSL을 사용하여 DB 인스턴스에 대한 연결 암호화](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL)를 참조하십시오. - **Azure 데이터베이스:** [PostgreSQL용 Azure 데이터베이스에 대한 TLS 연결 구성(영문)](https://docs.microsoft.com/ko-kr/azure/postgresql/concepts-ssl-connection-security)을 참조하십시오. - **Google Cloud 인스턴스:** [SSL/TLS 인증서 구성](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/configure-ssl-instance&sa=D&source=docs&ust=1635271250769000&usg=AOvVaw3YRZJ0JQdXSkhNjdOxhuww)을 참조하십시오. - **독립 실행형 PostgreSQL 인스턴스:** [SSL 구성](https://help.tableau.com/current/server/ko-kr/server_external_repo_configure_standalone.htm#configure-ssl)을 참조하십시오. 3. 1단계에서 만든 새 인스턴스에 대한 구성 파일을 만듭니다. 다음 구성 설정을 사용하여 json 파일을 만듭니다. { "flavor":"", "masterUsername":"", "masterPassword":"", "host":"", "port":5432 } - **flavor:** Tableau Server 리포지토리로 사용할 외부 서비스의 유형입니다. - Amazon RDS: "rds" 사용 - Azure 데이터베이스: "azure" 사용 - Google Cloud 데이터베이스: "gcp" 사용 - 독립 실행형 PostgreSQL 데이터베이스: "generic" 사용 - **masterUsername:** - **Amazon RDS:** 사용자 이름으로 "rails"를 사용합니다. 이 사용자는 RDS 인스턴스를 만들 때 지정한 사용자입니다. > [!IMPORTANT] > > masterUsername으로 "rails"를 사용해야 합니다. 외부 리포지토리가 Tableau Server에서 올바르게 작동하려면 이 설정이 필요합니다. - **Azure 데이터베이스, Google Cloud 인스턴스 또는 독립 PostgreSQL 인스턴스:** 요구 사항을 충족하는 사용자 이름을 선택합니다. Admin user name(관리자 사용자 이름)으로 **postgres**를 사용하는 것이 좋습니다. 다른 사용자 이름을 사용하도록 선택하는 경우 사용자 이름이 **pg** 또는 **azure**로 시작하지 않는지 확인하십시오. 또한 사용자 이름으로 **rails**, **tblwgadmin**, **tableau**, **readonly** 또는 **tbladminviews**를 사용할 수 없습니다. - **masterPassword:** PostgreSQL 데이터베이스 인스턴스를 만들 때 지정한 것과 동일한 비밀번호입니다. - **host:** PostgreSQL 데이터베이스 인스턴스의 끝점입니다. - **port:** PostgreSQL DB 인스턴스를 만들 때 지정한 데이터베이스 포트입니다. PostgreSQL의 기본 포트는 5432입니다. ## Tableau Server 업그레이드 **참고:** Tableau Server 외부 리포지토리를 사용하는 경우 명령줄 옵션을 사용하여 Tableau Server를 업그레이드해야 합니다. 다음은 업그레이드 스크립트를 실행할 때 외부 리포지토리 매개 변수를 지정하는 방법에 대한 개략적인 단계입니다. Tableau Server 업그레이드 프로세스에 대한 완전한 단계별 안내는 [이전 버전에서 업그레이드](https://help.tableau.com/current/server/ko-kr/sug_plan.htm)를 참조하십시오. 1. Tableau Server에서 관리자로 명령 프롬프트를 엽니다. **참고:** 설치 프로그램이 새 설치를 위해 경로를 업데이트하므로 새 명령 창을 열어야 합니다. 2. 새 설치의 스크립트 폴더로 이동합니다. 기본적으로 다음과 같습니다. `C:\Program Files\Tableau\Tableau Server\packages\scripts.\` 3. 업그레이드 스크립트를 실행하고 구성 파일 및 SSL 인증서를 지정합니다. `upgrade-tsm.cmd --external-repository-config-file= --external-repository-cert-file=` ## 제품 호환성 아래 표에 Tableau Server에서 지원되는 PostgreSQL 버전이 나와 있습니다. 이 표를 사용하여 외부 리포지토리용으로 설치할 PostgreSQL 버전을 확인하십시오. **Amazon RDS 지원:** Tableau Server 버전 2019.3 이상에서는 Amazon RDS를 사용하는 외부 리포지토리가 지원됩니다. **Azure 데이터베이스 지원:** Tableau Server 버전 2020.4 이상에서는 Azure 데이터베이스 인스턴스를 사용하는 외부 리포지토리가 지원됩니다. **Google Cloud 지원:** Tableau Server 버전 2021.4 이상에서는 Google Cloud SQL 인스턴스를 사용하는 외부 리포지토리가 지원됩니다. **독립형 PostgreSQL 인스턴스 지원:** Tableau Server 버전 2021.2 이상에서는 PostgreSQL 데이터베이스의 독립 실행형 설치를 사용하는 외부 리포지토리가 지원됩니다. Google Cloud Platform 지원: Google Cloud Platform의 PostgreSQL 인스턴스를 사용하는 외부 리포지토리는 Tableau Server 버전 2021.4 이상에서 지원됩니다.
Tableau Server 버전PostgreSQL 최소 호환 버전

2022.3.0 ~ 2022.3.7

2023.1.0 ~ 2023.1.4

13.7
2022.1.17 ~ 2022.1.19

2022.3.8 ~ 2022.3.19

2023.1.5 ~ 2023.1.15

2023.3.0 ~ 2023.3.8

13.11
2022.3.20 ~ 2022.3.x

2023.1.16 ~ 2023.1.x

2023.3.9 ~ 2023.3.x

13.14
2024.0 ~ 2024.2.815.6
2024.2.9 ~ 2024.2.13

2025.1.0 ~ 2025.1.6

15.10
2024.2.14 ~ 2024.2.16

2025.1.7 ~ 2025.1.9

15.13

2024.2.17

2025.1.10

2025.3 ~ 2025.3.5

15.14
2025.3.615.16

2026.2.x

17.7
레거시 호환성 아래 표에는 두 개의 열이 있습니다. 1. Tableau Server와 함께 제공되는 PostgreSQL 버전은 로컬 리포지토리용으로 Tableau Server와 함께 설치되는 버전입니다. 2. 외부 리포지토리에 대해 모든 PostgreSQL 버전이 지원됩니다. **참고:** \- 버전 10 이전의 PostgreSQL 버전에서 처음 두 자리는 주 버전을 나타내고 부 버전은 마지막 자리로 나타납니다. 예를 들어 버전 9.4.1에서 9.4는 주 버전을 나타내고 .1은 부 버전을 나타냅니다. \- PostgreSQL 버전 10 이상에서 첫 번째 자리는 주 버전을 나타내고 부 버전은 마지막 자리로 나타납니다. 예를 들어 버전 11.1에서 11은 주 버전이고 .1은 부 버전입니다. \- Tableau Server와 함께 제공되는 Postgres 버전과 주 버전이 같고 부 버전이 더 큰 PostgreSQL 버전은 명시적으로 허용되는 이전 버전과 함께 외부 리포지토리로 사용하는 것이 항상 허용됩니다.
Tableau Server 버전PostgreSQL 버전(Tableau Server와 함께 제공됨)외부 리포지토리에 지원되는 대체 PostgreSQL 버전
2019.3 ~ 2019.3.39.6.11

9.6.x(x는 11보다 큼)

2019.3.4 ~ 2019.3.109.6.159.6.x(x는 15보다 큼)
2019.3.11 ~ 2019.3.149.6.179.6.15 또는 9.6.x(x는 17보다 큼)
2019.4 ~ 2019.4.19.6.149.6.x(x는 14보다 큼)
2019.4.2 ~ 2019.4.69.6.159.6.x(x는 15보다 큼)
2019.4.7 ~ 2019.4.139.6.179.6.15 또는 9.6.x(x는 17보다 큼)
2020.1 ~ 2020.1.69.6.159.6.x(x는 15보다 큼)
2020.1.7 ~ 2020.3.29.6.179.6.15 또는 9.6.x(x는 17보다 큼)
2020.4 ~ 2021.412.8

12.8 또는 12.x(x는 8보다 큼)

2022.1 이상13.313.3 또는 13.x(x는 3보다 큼)
## 이 작업을 수행할 수 있는 사용자 Tableau Server 관리자는 Tableau Server를 업그레이드하고 구성할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Intuit QuickBooks Online에 대한 OAuth 설정 이 항목에서는 Intuit QuickBooks Online 데이터 원본을 OAuth 인증에 맞게 설정하는 방법을 설명합니다. Tableau Server 인스턴스마다 이 단계를 완료합니다. QuickBooks Online에 대한 OAuth 설정은 다음 작업으로 구성됩니다. 1. Intuit 개발자 플랫폼에서 연결된 앱을 만듭니다. 2. 연결된 앱을 만드는 과정에서 얻은 정보를 사용하여 서버를 구성합니다. 3. (선택 사항) 사이트별 OAuth를 구성합니다. ## 1단계: Intuit 앱 만들기 1. Intuit 개발자 계정에 로그인하고 My Apps(내 앱)를 클릭합니다. 2. Just start coding(코드 작성 시작) 섹션에서 Select APIs(API 선택)를 클릭합니다. 3. **Accounting**(계정)을 선택하고 Create App(앱 만들기)을 클릭합니다. 4. Get your app ready for submission(앱 제출 준비) 섹션에서 제품 키를 얻는 링크를 클릭합니다. **중요:** 개발 키가 아닌 제품 키를 사용해야 합니다. 5. 앱 토큰, OAuth 소비자 키 및 OAuth 소비자 암호를 복사합니다. ## 2단계: Intuit QuickBooks Online에 사용하도록 Tableau Server 구성 - Tableau Server 컴퓨터에서 bash 셸을 열고 다음 명령을 실행합니다. `tsm configuration set -k oauth.quickbooks.oauth_callback_uri -v http://YOUR-SERVER/auth/add_oauth_token` `tsm configuration set -k oauth.quickbooks.consumer_key -v ` `tsm configuration set -k oauth.quickbooks.consumer_secret -v ` `tsm pending-changes apply` 보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/current/server/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오. ## 액세스 토큰 관리 QuickBooks Online 데이터 원본에 대해 추출 새로 고침 작업을 실행하는 경우 Tableau Server에서 자동으로 액세스 토큰을 갱신합니다. 액세스 토큰이 만료되는 것을 방지하려면 한 달에 한 번 이상 추출 새로 고침 작업을 실행하십시오. 그렇지 않으면 QuickBooks Online의 액세스 토큰이 만료되고 추출 새로 고침 작업이 실패합니다. 액세스 토큰이 만료된 경우 설정 페이지에서 저장된 자격 증명을 편집할 수 있습니다. 저장된 자격 증명은 중앙 집중식으로 관리하거나 사용자가 관리할 수 있습니다. 자세한 내용은 [저장된 액세스 토큰 허용](https://help.tableau.com/current/server/ko-kr/allow_saved_tokens.htm)을 참조하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # RDS 인스턴스 업그레이드 Tableau 리포지토리를 호스팅하기 위해 사용하는 현재 RDS 인스턴스가 성능 병목 지점이 된 경우 RDS 인스턴스를 더 큰 크기로 업그레이드할 수 있습니다. 이 항목에서는 RDS 인스턴스를 업그레이드하는 데 사용할 수 있는 단계에 대해 설명합니다. 1. [Tableau Server 데이터 백업](https://help.tableau.com/current/server/ko-kr/db_backup.htm). 2. Tableau Server를 중지합니다. `tsm stop` 3. 서버가 종료되었는지 확인한 후 AWS 관리 콘솔에 로그인하고 Amazon RDS 콘솔(위치: https://console.aws.amazon.com/rds/)을 엽니다. 4. 탐색 패널에서 **Databases(데이터베이스)**를 선택한 다음 수정하려는 DB 인스턴스를 선택합니다. 5. **Modify(수정)**를 선택합니다. Modify DB Instance(DB 인스턴스 수정) 페이지가 나타납니다. 6. DB 인스턴스 클래스를 원하는 클래스로 설정하여 RDS 인스턴스를 수정합니다. 7. **Apply immediately(즉시 적용)**를 선택하여 변경 사항이 즉시 적용되게 합니다. 자세한 내용은 AWS 설명서 사이트에서 [PostgreSQL 데이터베이스 엔진을 실행 중인 DB 인스턴스 수정](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ModifyPostgreSQLInstance.html)을 참조하십시오. 8. AWS 콘솔에서 RDS 인스턴스의 상태를 모니터링합니다. 시간이 걸릴 수 있으며 상태가 Available(사용 가능)로 표시되면 Tableau Server를 시작하고 정상 작업을 재개할 수 있습니다. `tsm start` ## 이 작업을 수행할 수 있는 사용자 Amazon RDS 계정에 액세스할 수 있는 Tableau Server 관리자는 Amazon RDS 인스턴스를 업그레이드하는 데 필요한 모든 단계를 수행할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Resource Monitoring Tool 설치 Tableau Resource Monitoring Tool에는 RMT 서버와 에이전트라는 두 가지 구성 요소가 있습니다. Resource Monitoring Tool 필수 요건 및 RMT 서버는 필요한 리소스를 갖도록 보장하기 위해 전용 하드웨어에 설치되어야 하며 다른 프로그램 또는 소프트웨어와 컴퓨터 리소스를 경합하지 않아야 합니다. 즉, 프로덕션 환경이 아닌 환경에서 제한적인 데모 용도로 사용되는 경우와 같이 예외적인 사례를 제외하고 Tableau Server 컴퓨터에 설치해서는 안 됩니다. 에이전트는 모니터링하려는 Tableau Server의 모든 노드에 설치됩니다. Resource Monitoring Tool 설치를 위한 설치 프로그램은 [Advanced Management 다운로드](https://www.tableau.com/ko-kr/support/releases/server-management) 사이트에서 찾을 수 있습니다. **Tabrmt**로 시작하는 모든 파일을 다운로드하십시오. 회사 가치인 평등에 맞추려는 노력의 일환으로 가능한 경우 비포용적인 용어를 변경했습니다. 특정 위치에서 용어를 변경하면 해당 변경이 너무 큰 영향을 미칠 수 있으므로 기존 용어를 유지합니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 [Tableau 도움말 정보](https://help.tableau.com/current/tableau/ko-kr/about-tableau-help.htm)를 참조하십시오. ## 설치 버전 기록 이 섹션에서는 설치 프로세스의 중요 변경 사항을 설명합니다. 이 섹션에서 현재 버전 및 업그레이드 대상 버전에 따라 변경된 내용을 이해할 수 있습니다. - 버전 **2025.3.4**부터 Windows 설치 프로그램에 대한 업데이트로 인해 워크플로우가 다소 변경되었습니다. 표시되는 대화 상자의 메시지는 이전 버전과 약간 다를 수 있으며 기본 위치가 아닌 설치 위치는 환영 대화 상자에서 Options을 클릭하여 구성할 수 있습니다. - 버전 **2022.3** 부터는 클라우드 플랫폼에서 Resource Monitoring Tool가 사용하는 RabbitMQ 메시징 서비스 및 PostgreSQL 데이터베이스를 구성할 수 있는 옵션이 있습니다. 현재, RabbitMQ용 AWS AMQ 및 PostgreSQL 데이터베이스용 Amazon RDS가 지원됩니다. 게다가 RMT 서버와 함께 리포지토리 및 메시지 큐 서비스를 동일한 컴퓨터에 설치하거나 AWS 플랫폼에 별도로 설치할지 선택할 수 있습니다. - 버전 **2020.4**부터 Resource Monitoring Tool를 Linux 컴퓨터에 설치할 수 있습니다. 이전 Resource Monitoring Tool 설치는 Windows 컴퓨터에서만 지원되었습니다. ## Resource Monitoring Tool 설치 전 - 다음 요구 사항과 지침을 검토하십시오. - [Tableau Resource Monitoring Tool의 최소 하드웨어 요구 사항 및 권장 사항](https://help.tableau.com/current/server/ko-kr/rmt-min-hardware-req.htm) - [설치 전 검사 목록 - Tableau Resource Monitoring Tool](https://help.tableau.com/current/server/ko-kr/rmt-install-checklist.htm) - 다음 OS가 지원됩니다. - Windows Server 2022(버전 2023.3.1부터) - Windows Server 2016 - Windows Server 2019 - 모니터링하려는 Tableau Server 설치에 Advanced Management 라이선스가 부여되었는지 확인합니다. Resource Monitoring Tool를 사용하려면 유효한 Advanced Management 라이선스가 있어야 합니다. - Tableau Server 로그의 크기를 검토합니다. 에이전트가 설치되고 구성된 후 Resource Monitoring Tool는 데이터를 표시하기 전에 Tableau Server 로그에서 관련 기록 데이터를 처리합니다. 많은 양의 기록 로그 데이터가 있는 경우 정보를 처리하는 데 시간이 걸릴 수 있으며, 그로 인해 Server의 최신 이벤트를 처리하는 데 지연이 발생할 수 있습니다. 지연이 문제가 되고 기록 정보가 없는 것은 중요하지 않은 경우 다음을 수행하여 기존 파일을 정리할 수 있습니다. - [불필요한 파일 제거](https://help.tableau.com/current/server/ko-kr/maintenance_cleanup.htm)를 수행하고 로그 파일을 제거하기 전에 [로그 파일 스냅샷(로그 아카이브)](https://help.tableau.com/current/server/ko-kr/logs_archive.htm)을 수행하는 것이 좋습니다. **참고:** CPU 사용량 및 메모리 사용량과 같은 성능 데이터는 기록 로그 데이터를 사용하여 수집되지 않으며 에이전트가 설치 및 구성된 후에 수집되므로 기록 데이터를 정리하더라도 성능 데이터는 영향을 받지 않습니다. - Tableau Server 리포지토리에 대해 읽기 전용 기본 사용자를 사용하도록 설정합니다. 이 사용자는 Resource Monitoring Tool 에이전트 설치 시에 사용됩니다. **이 작업은 버전 2022.3부터 필요합니다.** 자세한 내용은 [Tableau Server 리포지토리를 사용한 데이터 수집](https://help.tableau.com/current/server/ko-kr/perf_collect_server_repo.htm#enable-access-to-the-tableau-server-repository)을 참조하십시오. - 리포지토리 및 메시지 큐 서비스를 Resource Monitoring Tool 외부에 구성할지 여부를 결정합니다. ### 설치 아키텍처 Resource Monitoring Tool 설치의 개략적인 모양입니다. 이 다이어그램은 RMT 서버에서 모니터링하는 두 개의 Tableau Server 클러스터를 보여 줍니다. ![프로덕션과 개발/테스트 둘 다를 위한 마스터 서버와 Tableau 서버 클러스터 간의 관계를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/rmt-setup-architecture.png) RMT 서버와 에이전트에 설치된 Resource Monitoring Tool 구성 요소의 세부적인 모양입니다. ![Tableau Resource Monitoring Tool의 프로그램과 종속성을 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/rmt-setup-architecture-details.png) ## 설치 개요 RMT 서버는 두 운영 체제 중 하나에 설치할 수 있으며 에이전트가 설치된 운영 체제에 종속되지 않습니다. 즉, RMT 서버와 에이전트를 서로 다른 운영 체제에 설치할 수 있습니다. 그러나 에이전트는 Tableau Server 클러스터 노드에 설치되므로 에이전트에 대한 운영 체제 선택은 Tableau Server 설치에 따라 달라집니다. 동일한 Resource Monitoring Tool 를 사용하여 여러 Tableau Server 클러스터를 모니터링할 수 있습니다. 각 Tableau 클러스터는 별도의 환경으로 설정해야 합니다. ### 외부 구성 리포지토리와 메시지 큐 서비스는 모두 AWS 플랫폼의 RMT 서버 외부에서 호스팅될 수 있습니다. 리포지토리를 호스팅하는 데는 AWS RDS 인스턴스를 사용하고 메시지 큐에는 AWS AMQ를 사용합니다. 구성, 단계별 지침 및 기타 자세한 내용은 다음을 참조하십시오. - [Tableau Resource Monitoring Tool용 외부 리포지토리](https://help.tableau.com/current/server/ko-kr/rmt-external-repo.htm) - [Tableau Resource Monitoring Tool용 외부 메시지 큐 서비스(RabbitMQ)](https://help.tableau.com/current/server/ko-kr/rmt-external-messagequeue.htm) ### Windows 기반 설치 웹 인터페이스 또는 명령줄을 사용하여 RMT 서버와 에이전트를 설치할 수 있습니다. 다음은 Resource Monitoring Tool를 설치하는 단계입니다. 1. [웹 인터페이스를 사용](https://help.tableau.com/current/server/ko-kr/rmt-admin-master-install.htm)하거나 [명령줄을 사용](https://help.tableau.com/current/server/ko-kr/rmt-admin-master-install-cli.htm)하여 RMT 서버를 설치합니다. Resource Monitoring Tool 설치 프로그램을 시작하면 설치 프로그램이 먼저 Resource Monitoring Tool를 실행하는 데 필요한 특정 프로그램을 설치합니다. 설치되는 프로그램은 RabbitMQ, Erlang 및 전용 PostgreSQL 데이터베이스입니다. 그런 다음 계속해서 RMT 서버를 설치합니다. 2. [웹 인터페이스를 사용](https://help.tableau.com/current/server/ko-kr/rmt-admin-agent-install.htm)하거나 [명령줄을 사용](https://help.tableau.com/current/server/ko-kr/rmt-admin-agent-install-cli.htm)하여 에이전트를 설치합니다. Tableau Server 노드마다 에이전트를 설치합니다. 에이전트는 보고를 위해 Tableau Server 사용량 및 성능에 대한 정보를 RMT 서버로 보냅니다. ### 바이러스 백신 바이러스 백신 검사에서 [Tableau Resource Monitoring Tool 로그 파일](https://help.tableau.com/current/server/ko-kr/rmt-admin-logs.htm)을 제외하는 것이 좋습니다. 이렇게 하면 Resource Monitoring Tool이 로그 파일을 쓸 때 경합이 방지되어 성능이 향상됩니다. ### HTTPS HTTPS를 사용하여 민감한 정보와 사용자 자격 증명을 보호하는 것이 최상의 방법입니다. 서버 구성의 **Require HTTPS(HTTPS 필요)** 설정은 사용자와 RMT 서버 간의 통신에 사용됩니다. 또한 에이전트를 등록할 때에도 사용됩니다. 데이터를 수집하기 위한 에이전트와 RMT 서버 간의 정기적인 에이전트 통신은 Rabbit MQ를 통해 수행됩니다. 기본적으로, RMT 서버는 자체 서명 인증서를 사용하여 설치되고 에이전트 등록 과정의 통신을 비롯한 HTTPS 통신에 해당 인증서를 사용합니다. 고유한 인증서를 사용하여 자체 서명 인증서를 대체할 수 있습니다. 이 작업은 RMT 서버 설치 중에 서버 구성 페이지에서 수행하거나 설치가 완료된 후 수행할 수 있습니다. 다음 섹션에서는 요구 사항에 대해 설명합니다. #### SSL 인증서 모드 및 요구 사항 Resource Monitoring Tool 는 SSL 인증서를 사용하는 다음 모드를 지원합니다. - **기본:** 이 모드에서는 설치 프로그램에서 제공하는 기본 자체 서명 인증서를 사용합니다. - **저장소:** 이 모드를 사용하면 Windows 인증서 저장소에 인증서 지문을 입력할 수 있습니다. - **로컬**: 이 모드를 사용하면 `\config` 폴더에 파일 기반 인증서를 지정할 수 있습니다. 기본 위치는 `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config`입니다. 고유한 인증서를 사용하는 경우 **로컬** 또는 **저장소**를 선택할 수 있습니다. - **로컬**을 선택하는 경우 그룹화된 파일 또는 단일 파일에서 사용할 수 있는 인증서, 인증 기관 및 개인 키가 있어야 합니다. - **저장소** 옵션을 선택하는 경우 인증서와 지문을 미리 저장하고 설치 중에 참조할 수 있습니다. 인증서 및 개인 키는 함께 패키지화되어야 하며 단일 지문에서 참조할 수 있어야 합니다. 패키지된 인증서는 .NET 요구 사항에 의해 정의된 특정 위치에 저장되어야 하며 이러한 위치는 [여기](https://docs.microsoft.com/ko-kr/dotnet/api/system.security.cryptography.x509certificates.storename?view=netcore-3.1)에 있는 Microsoft 웹 사이트에 문서화되어 있습니다. 컴퓨터로 인증서를 가져온 후 해당 인증서를 사용하여 HTTPS를 구성할 수 있습니다. 인증서에 대한 다음 지침 및 요구 사항을 따르십시오. - 적절한 도메인에 대한 HTTPS 인증서(예: X.509)가 있어야 합니다. 이는 로컬 보안 정책 및 인증서 요구 사항에 따라 다릅니다. 예를 들어 Resource Monitoring Tool에서 CName 또는 SSL 통과 프록시를 사용하는 경우 SAN 인증서를 사용해야 할 수 있습니다. 하위 도메인이 여러 개인 경우 와일드카드 인증서가 지원됩니다. - Resource Monitoring Tool는 PKCS #12 및 PEM 형식만 지원합니다. - Resource Monitoring Tool 웹 서버에는 인증서와 개인 키가 필요하며, 선택적으로 신뢰 체인을 필요로 합니다. 개인 키는 RSA 또는 DSA가 될 수 있습니다. 이러한 파일은 단일 파일 또는 그룹화된 파일로 제공될 수 있습니다. - 단일 파일 예: - PKCS #12: 파일 확장명이 .pfx 또는 .p12인 단일 파일입니다. - PEM: PEM 인코딩 인증서 + 개인 키(그리고 선택적으로 루트 CA에 연결된 중간 CA), .pem 확장명의 단일 파일입니다. 파일의 항목은 특정 순서로 되어 있지 않아도 됩니다. - 그룹화된 파일 예: - .crt 또는 .cer 파일의 PEM 인코딩 인증서 그리고 - .key 파일의 PEM 인코딩 개인 키(선택 사항) 그리고 - 하나 이상의 .ca 파일에 있는 PEM 인코딩 인증 기관 ### 기본 파일 및 디렉터리 위치: #### RMT 서버: - 설치 디렉터리: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master` - 구성 파일: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json` - 로그 디렉터리: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs` #### 에이전트: - 설치 디렉터리: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent` - 로그 디렉터리: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\logs` ## 이 작업을 수행할 수 있는 사용자 Resource Monitoring Tool를 설치하려면 다음이 모두 필요합니다. - Resource Monitoring Tool를 설치하는 컴퓨터에 대한 관리자 사용 권한 - Tableau Server 관리자 사이트 역할 - Resource Monitoring Tool 관리자 계정 ## 다음 단계 RMT 서버 설치: - [웹 인터페이스 사용](https://help.tableau.com/current/server/ko-kr/rmt-admin-master-install.htm) - [명령줄 사용](https://help.tableau.com/current/server/ko-kr/rmt-admin-master-install-cli.htm) ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Resource Monitoring Tool 시작하기 이 문서는 Tableau Resource Monitoring Tool를 시작하는 데 유용한 정보를 제공합니다. 또한 Resource Monitoring Tool 설치 전에 준비해야 하는 정보와 관련된 다른 문서에 대한 링크와 업그레이드 및 기타 유용한 리소스에 대한 링크가 포함되어 있습니다. 회사 가치인 평등에 맞추려는 노력의 일환으로 가능한 경우 비포용적인 용어를 변경했습니다. 특정 위치에서 용어를 변경하면 해당 변경이 너무 큰 영향을 미칠 수 있으므로 기존 용어를 유지합니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 [Tableau 도움말 정보](https://help.tableau.com/current/tableau/ko-kr/about-tableau-help.htm)를 참조하십시오. ## 설치 전 ### Tableau Server와의 제품 호환성 지원되는 Tableau Server 버전을 모니터링하기 위해 Resource Monitoring Tool를 설치할 수 있습니다. 아래 표에는 Resource Monitoring Tool(RMT)와 Tableau Server 간의 버전 호환성이 나와 있습니다.
RMT 버전OS 지원Tableau Server 버전
2026.2.xWindows, Linux2024.2.x, 2024.3.x, 2025.1.x, 2025.2.x, 2025.3.x, 2026.1.x, 2026.2.x
2026.1.xWindows, Linux2024.1.x, 2024.2.x, 2024.3.x, 2025.1.x, 2025.2.x, 2025.3.x, 2026.1.x
2025.3.xWindows, Linux

2022.3.x, 2023.1.x, 2023.3.x, 2024.2.x, 2025.1.x, 2025.3.x

2025.1.x, 2025.2.xWindows, Linux

2022.3.x, 2023.1.x, 2023.3.x, 2024.2.x, 2025.1.x

2024.2.xWindows, Linux

2022.3.x, 2023.1.x, 2023.3.x, 2024.2.x

2023.3.xWindows, Linux

2022.3.x, 2023.1.x, 2023.3.x

2023.1.xWindows, Linux

2022.3.x, 2023.1.x

2022.3.xWindows, Linux

2022.3.x

### Resource Monitoring Tool 서버(RMT 서버) 및 에이전트 호환성 일반적으로 호환되는 RMT 서버 및 에이전트를 설치하려면 동일한 버전의 RMT 서버와 에이전트를 설치하는 것이 좋습니다. RMT 서버 버전과 호환되지 않는 버전을 사용하는 에이전트가 있는 경우 중요 인시던트가 기록됩니다. 자세한 내용은 [에이전트 인시던트](https://help.tableau.com/current/server/ko-kr/rmt-incidents-agents-unlicensed.htm)를 참조하십시오. ### 개념 및 용어 Resource Monitoring Tool 항목에 사용되는 개념 및 용어에 익숙해지도록 하십시오. 자세한 내용은 [개념](https://help.tableau.com/current/server/ko-kr/rmt-concepts.htm)을 참조하십시오. ### 설치 아키텍처 Resource Monitoring Tool에는 Resource Monitoring Tool 서버(RMT 서버)와 에이전트라는 두 가지 주요 구성 요소가 있습니다. RMT 서버는 자체 컴퓨터에 설치되어야 하고 에이전트는 Tableau Server 클러스터의 각 노드에 설치됩니다. 설치 아키텍처에 대한 자세한 내용은 [Tableau Resource Monitoring Tool 설치](https://help.tableau.com/current/server/ko-kr/rmt-admin-installation.htm)를 참조하십시오. Resource Monitoring Tool 설치의 개략적인 모양입니다. 이 다이어그램에서는 3개 노드 Tableau Server 클러스터를 보여 줍니다. ![프로덕션과 개발/테스트 둘 다를 위한 마스터 서버와 Tableau 서버 클러스터 간의 관계를 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/rmt-setup-architecture.png) ### Resource Monitoring Tool의 최소 하드웨어 요구 사항 및 권장 사항 Resource Monitoring Tool는 Tableau Server 설치에서 수집된 모니터링 데이터에 대한 처리, 집계, 저장 및 웹 인터페이스를 모두 처리합니다. 프로덕션 환경에서 사용하는 경우 Resource Monitoring Tool를 설치하는 컴퓨터는 최소 하드웨어 권장 사항을 충족하거나 초과해야 합니다. 자세한 내용은 [Tableau Resource Monitoring Tool의 최소 하드웨어 요구 사항 및 권장 사항](https://help.tableau.com/current/server/ko-kr/rmt-min-hardware-req.htm)을 참조하십시오. ### Resource Monitoring Tool의 설치 전 검사 목록 Resource Monitoring Tool를 설치하기 전에 이러한 작업 항목을 검토하고 필요한 모든 단계를 완료하십시오. [설치 전 검사 목록 - Tableau Resource Monitoring Tool](https://help.tableau.com/current/server/ko-kr/rmt-install-checklist.htm) ## Resource Monitoring Tool 업그레이드 Resource Monitoring Tool 업그레이드 방법에 대한 지침은 [Resource Monitoring Tool 업그레이드](https://help.tableau.com/current/server/ko-kr/rmt-admin-upgrade.htm)를 참조하십시오. ## 문제 해결 지원 팀에 문의하기 전에 [Tableau Resource Monitoring Tool 문제 해결](https://help.tableau.com/current/server/ko-kr/rmt-faq.htm)에서 일반 질문에 대한 답변을 확인하시기 바랍니다. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Resource Monitoring Tool 업그레이드 다음 지침은 기존 Tableau Resource Monitoring Tool 설치의 업그레이드에 대한 것입니다. 회사 가치인 평등에 맞추려는 노력의 일환으로 가능한 경우 비포용적인 용어를 변경했습니다. 특정 위치에서 용어를 변경하면 해당 변경이 너무 큰 영향을 미칠 수 있으므로 기존 용어를 유지합니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 [Tableau 도움말 정보](https://help.tableau.com/current/tableau/ko-kr/about-tableau-help.htm)를 참조하십시오. **참고:** Resource Monitoring Tool은 현재 설치를 최신 버전으로 업그레이드하는 현재 위치 업그레이드를 수행합니다. 업그레이드하기 **전에** 기존 설치를 제거하지 마십시오. ## 업그레이드 참고 사항 **업그레이드를 시작하기 전에 다음 사항을 고려하십시오.** 1. 2025.3.6 릴리스부터 Tableau RMT(Resource Monitoring Tool) 설치 프로그램에 업그레이드 전후에 환경의 유효성을 자동으로 검사하는 상태 확인 스크립트가 포함되어 있습니다. 이러한 스크립트를 자동으로 실행하기 위한 추가 설정이나 권한이 필요하지 않습니다. 수동으로 실행하도록 선택할 수도 있습니다. 자세한 내용은 [RMT 업그레이드 상태 확인 스크립트](https://help.tableau.com/current/server/ko-kr/rmt-admin-upgrade-health-scripts.htm)를 참조하십시오. 2. 외부 리포지토리(PostgreSQL) 또는 외부 메시지 큐 서비스(RabbitMQ)를 이동하여 사용하려면 다음 항목의 업그레이드 모범 사례 섹션을 검토하십시오. - [업그레이드 모범 사례](https://help.tableau.com/current/server/ko-kr/rmt-external-repo.htm#upgrade-external-repo) - 외부 메시지 큐에 대한 [업그레이드 모범 사례](https://help.tableau.com/current/server/ko-kr/rmt-external-messagequeue.htm#upgrade-messagequeue) 3. 버전 2022.3부터 Tableau Resource Monitoring Tool에는 RMT 서버와 에이전트 간에 암호화된 통신이 내장되어 있습니다. 그러나 TLS를 사용하도록 설정하려면 모든 에이전트에서 `rmtadmin rotate-mq-certificates`를 실행해야 합니다. 이는 RMT 서버와 동일한 컴퓨터에 로컬로 구성된 RabbitMQ에 적용됩니다. 자세한 방법은 아래의 **RabbitMQ에서 TLS를 사용할 때의 업그레이드 단계**를 참조하십시오. 4. 업그레이드 중에 컴퓨터를 다시 부팅해야 할 수 있습니다. 이는 일반적으로 파일이 잠겨 있어 설치 프로그램에서 업데이트할 수 없는 경우에 발생합니다. 필요한 경우 설치 프로그램의 메시지가 표시됩니다. 따라서 업무 시간이 아닐 때 업그레이드를 수행하는 것이 좋을 수 있습니다. 5. Resource Monitoring Tool(서버 및 에이전트)을 업그레이드할 때 원래 설치를 실행한 사용자와 다른 Windows 사용자로 설치 프로그램을 실행하는 경우 원래 사용한 사용자 지정 설치 디렉터리 중 일부가 업그레이드에서 감지되지 않을 수 있으며, 이로 인해 업그레이드가 다른 디렉터리에 설치될 수 있습니다. 6. 경우에 따라 Resource Monitoring Tool가 데이터베이스를 수정하며, 그와 같은 경우 업그레이드 프로세스에 데이터베이스 마이그레이션이 포함됩니다. 데이터베이스 마이그레이션의 경우 RMT 서버 웹 페이지 상단에 프로세스 완료 예상 시간과 함께 메시지 배너가 표시됩니다. 아래에 예제 스크린샷이 표시되어 있습니다. ![마이그레이션이 42% 완료되었음을 보여주는 Tableau Resource Monitoring Tool 데이터베이스입니다.](/tableau/current/ko-kr/server/ko-kr/Img/rmt-upgrade-db-migration-collapsed.png) 배너를 확장하면 업그레이드 영향의 세부 정보를 검토할 수 있습니다. 변경 사항은 릴리스별로 고유하며 표시되는 세부 정보는 릴리스와 관련됩니다. ![세부 정보가 확장되어 마이그레이션이 42% 완료되었음을 보여주는 Tableau Resource Monitoring Tool 데이터베이스입니다.](/tableau/current/ko-kr/server/ko-kr/Img/rmt-upgrade-db-migration-details.png) 7. Resource Monitoring Tool은 Tableau Server 버전의 하위 버전과는 호환되지만 상위 버전과는 호환되지 않습니다. 즉, Resource Monitoring Tool 버전은 모니터링하려는 Tableau Server 버전과 같거나 보다 커야 합니다. 호환성 이유로 Resource Monitoring Tool을 먼저 업그레이드한 다음 Tableau Server 업그레이드를 수행하는 것이 좋습니다. 자세한 내용은 [Tableau Server와의 제품 호환성](https://help.tableau.com/current/server/ko-kr/rmt-getting-started.htm#compat_table)을 참조하십시오. ## Resource Monitoring Tool 업그레이드 방법 Resource Monitoring Tool의 현재 위치 업그레이드를 수행하는 것이 좋습니다. Resource Monitoring Tool를 제거하고 데이터베이스의 새 버전을 설치하면 데이터가 손상될 수 있으며 이전 버전을 다시 설치하고 업그레이드 프로세스를 다시 수행하라는 메시지가 표시됩니다. 1. 업그레이드를 시작하기 전에 브라우저에서 Resource Monitoring Tool에 로그인하고 작동 중인지 확인합니다. 2. RMT 서버 컴퓨터에 RMT 서버 설치 프로그램의 새 버전을 복사합니다. 3. RMT 에이전트 설치 프로그램의 새 버전을 RMT 에이전트가 설치된 컴퓨터에 복사합니다. RMT 에이전트는 모니터링하는 Tableau Server 노드에 설치됩니다. 4. RMT 에이전트 서비스를 실행하는 각 Tableau Server 노드에서 다음 명령을 사용하여 각 RMT 에이전트를 중지합니다. `rmtadmin stop` 5. RMT 서버 서비스를 실행하는 컴퓨터에서 다음 명령을 사용하여 RMT 서버를 중지합니다. `rmtadmin stop` 6. RMT 서버 및 에이전트 컴퓨터의 작업 관리자에서 이름에 Resource Monitoring Tool, tabrmt-master 또는 tabrmt-agent가 포함된 프로세스가 실행되지 않을 때까지 기다린 후 다음 단계로 계속합니다. 7. RMT 서버가 설치된 컴퓨터에서 RMT 서버 설치 프로그램을 실행합니다. 그러면 모든 필요한 필수 요건이 설치되거나 업그레이드된 후 RMT 서버가 업그레이드됩니다. Resource Monitoring Tool이 기본 위치에 이미 설치된 경우 업그레이드 중에 사용자 지정 디렉터리로 설치 위치를 변경할 수 없습니다. 8. RMT 에이전트가 설치된 모든 컴퓨터에서 RMT 에이전트 설치 프로그램을 실행합니다. **중요:** 2021.4부터 RMT 에이전트에 대한 ‘서비스 계정 사용자’ 계정을 지정해야 합니다. 이 계정은 Tableau Server에 액세스하여 모니터링 정보를 수집하는 데 사용됩니다. ‘서비스 계정 사용자’ 계정에 Tableau Server ‘서비스 계정 사용자’ 계정에 현재 사용하는 것과 동일한 계정을 지정합니다. 이 계정이 이전에 사용자 지정 사용자 계정으로 설정되었고 기본 계정(NT AUTHORITY/네트워크 서비스)이 아닌 경우 업그레이드 프로세스 중에 기본 계정을 사용하도록 되돌려집니다. 설치 후에 [rmtadmin service-setup](https://help.tableau.com/current/server/ko-kr/rmt-admin-cmdline.htm#rmtadmin%20service-setup) 명령을 사용하여 원래 사용자 지정 사용자 계정으로 변경할 수 있습니다. 9. RMT 서버 및 에이전트가 실행되고 있는지 확인합니다. 업그레이드가 완료된 후 자동으로 다시 시작되지 않는 경우 RMT 서버 및 에이전트를 시작합니다. 10. 브라우저에서 Resource Monitoring Tool에 로그인하고 작동 중인지 확인합니다. 설치가 작동하지 않으면 업그레이드를 실행하는 데 사용된 사용자 계정과 관련된 문제일 수 있습니다. 이 항목의 시작 부분에 있는 [업그레이드 참고 사항 섹션](#Upgrade)에서 업그레이드에 사용하는 사용자 계정에 대해 참조하십시오. RMT 에이전트가 업그레이드되었는지 확인하려면 **Admin** 메뉴로 이동하고 **Environments**를 선택한 다음 **Edit Environment** 아이콘을 클릭하여 환경 세부 정보를 표시합니다. **서버** 탭에서 RMT 에이전트 버전을 볼 수 있습니다. 이 기능은 다중 노드 Tableau Server 클러스터를 사용하는 경우 어떤 RMT 에이전트가 업그레이드되었는지 확인할 때 유용합니다. ### RabbitMQ에서 TLS를 사용할 때의 업그레이드 단계 2022.3 이전 버전의 에이전트는 암호화되지 않은 연결을 사용하여 RabbitMQ 메시지 큐 서비스와 통신하기 때문에 버전 2022.3 이상으로 업그레이드할 때 새로운 보안 연결 세부 정보를 사용하도록 이러한 에이전트를 업데이트해야 합니다. 이 작업을 수행하기 위한 단계는 다음과 같습니다. 1. 위의 섹션에 설명된 업그레이드 단계를 완료한 후 다음 명령을 실행하여 모든 에이전트를 중지합니다. `rmtadmin stop --agent` 2. 다음 명령을 실행하여 환경의 부트스트랩 파일을 다운로드합니다. `rmtadmin bootstrap-file --env --filename ` 3. 에이전트가 설치된 각 컴퓨터에서 다음 명령을 실행합니다. `rmtadmin rotate-mq-certificate --username= --password-file=` 4. `rmtadmin rotate-mq-certificate` 명령을 실행한 후 각 에이전트 컴퓨터를 다시 시작합니다. ### 이 작업을 수행할 수 있는 사용자 Resource Monitoring Tool를 업그레이드하려면 다음과 같은 사용 권한이 있어야 합니다. - Resource Monitoring Tool를 설치하는 컴퓨터의 관리자 - Tableau Server 관리자 - Resource Monitoring Tool 관리자 ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Resource Monitoring Tool 업그레이드 FAQ 업그레이드하는 동안 자주 묻는 질문에 대한 답변을 확인해보십시오. ## 루트/관리자 권한 없이 스크립트를 실행할 수 있습니까? 스크립트가 설치 프로그램을 통해 자동으로 실행되는 경우 설치 프로그램에 필요한 권한이 있습니다. 스크립트가 서비스 상태와 파일 사용 권한을 확인하고 RMT 서비스 계정으로 명령을 실행하므로, 수동으로 실행하려면 루트(Linux) 또는 관리자(Windows) 권한이 필요합니다. ## 데이터베이스 비밀번호를 모르는 경우 어떻게 해야 합니까? PostgreSQL에 종속되는 모든 검사는 **WARN**으로 건너뜁니다. 스크립트는 여전히 다른 모든 검사를 실행합니다. 비밀번호에 대해서는 Tableau 지원 팀에 문의하십시오. ## tabrmtdb 데이터베이스 사용자의 비밀번호를 검색하는 방법은 무엇입니까? RMT 서버 디렉터리로 이동하고 운영 체제에 적합한 명령을 실행하여 자격 증명을 검색할 수 있습니다. **Windows의 경우**: `.\rmtadmin get db:username db:password` **Linux의 경우:** `rmtadmin get db:username db:password` ## RMT를 사용하는 동안 업그레이드 전 검사를 실행할 수 있습니까? 예. 스크립트는 읽기 전용이며 프로덕션 시스템에서 언제든지 안전하게 실행할 수 있습니다. ## 업그레이드 후 검사에서 오류가 발견되면 어떻게 됩니까? 업그레이드 후 검사는 설치 프로그램을 절대 차단하지 않습니다. 오류는 보고서에 표시됩니다. '브로커에 연결할 수 없음' 등 일부 오류는 일시적이며 자체적으로 해결됩니다. ## 스크립트가 외부 PostgreSQL/RabbitMQ와 호환됩니까? 예. 업그레이드 후 스크립트는 외부 구성을 자동으로 감지하고 로컬 검사를 적절하게 건너뜁니다. 업그레이드 전 스크립트의 DB 검사는 내부 RMT 데이터베이스에 연결되므로, 어떤 경우든 `--db-password`가 필요합니다. ## RMT 서버와 Agent 컴퓨터 모두에서 스크립트를 실행할 수 있습니까? 예. RMT 서버에서 `--component master`를 사용하고 에이전트에서 `--component agent`를 사용합니다. 지정되지 않은 경우 스크립트가 자동으로 감지합니다. ## 보고서에서 InstallerContext는 무엇을 의미합니까? Windows MSI 업그레이드 중에 업그레이드 전 검사가 자동으로 실행되면 `-InstallerContext` 옵션이 설정됩니다. 그러면 설치 프로그램이 이미 서비스를 중단했기 때문에 '중지됨/사용 안 함'을 보고할 수 있는 서비스 및 포트 검사가 **WARN**으로 완화되고, 고립된 프로세스 게이트(#38a)를 건너뛰어 설치 프로그램이 프로세스 수명 주기를 직접 관리할 수 있습니다. 스크립트를 수동으로 실행하는 경우 이러한 검사는 일반적인 심각도 수준을 적용합니다. [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Resource Monitoring Tool 정보 이 문서에서는 Tableau Resource Monitoring Tool에 대한 개요를 제공합니다. ## Resource Monitoring Tool란? Resource Monitoring Tool는 Tableau Server의 상태와 성능을 모니터링하는 데 사용할 수 있는 도구입니다. 이 도구는 Tableau Server에서 데이터를 수집하여 Tableau Server의 상태를 종합적으로 보여 줍니다. 이 도구를 사용하면 느린 로드 시간, 추출 실패 및 기타 중요 문제의 원인을 파악할 수 있습니다. Resource Monitoring Tool를 사용하려면 서버에서 Advanced Management을 사용하도록 설정해야 합니다. Advanced Management에 대한 자세한 내용은 [Tableau Server의 Tableau Advanced Management 정보](https://help.tableau.com/current/server/ko-kr/itm_intro.htm)를 참조하십시오. Resource Monitoring Tool에는 Resource Monitoring Tool 서버(RMT 서버)와 에이전트라는 두 가지 주요 구성 요소가 있습니다. - RMT 서버는 웹 인터페이스를 통해 Tableau Server의 데이터가 수집되고 제공되는 위치입니다. Tableau Server의 상태 및 성능을 구성하고 모니터링하고 분석할 수 있는 위치이기도 합니다. - 에이전트는 Tableau 클러스터의 각 노드에서 실행되어 해당 노드의 성능 및 작업을 모니터링합니다. 다음 다이어그램에서는 Tableau Server 노드와 RMT 서버 간의 상호 작용을 설명합니다. ![마스터 서버에서 노드로의 데이터 흐름을 보여주는 다이어그램입니다.](/tableau/current/ko-kr/server/ko-kr/Img/rmt-data-flow.png) ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # Resource Monitoring Tool 제거 Resource Monitoring Tool 설치 프로그램에는 설치 제거 프로그램이 있습니다. Windows에서 실행하는 경우 **프로그램 추가/제거**에서 설치 제거 프로그램을 실행할 수 있습니다. **참고:** Resource Monitoring Tool를 제거하는 동안 문제가 발생한 경우 [RMT 제거 오류 문제 해결](https://help.tableau.com/current/server/ko-kr/rmt-troubleshoot-uninstall.htm)을 참조하십시오. 다음 단계에 따라 Resource Monitoring Tool를 제거합니다. 1. 완전히 제거하려면 다음 프로그램을 모두 제거하십시오. RMT 서버에 설치된 프로그램: - Tableau Resource Monitoring Tool - Tableau Resource Monitoring Tool Erlang Configuration - Tableau Resource Monitoring Tool PostgreSQL Configuration - Tableau Resource Monitoring Tool Prerequisites - Tableau Resource Monitoring Tool Prerequisites Setup - Tableau Resource Monitoring Tool RabbitMQ Configuration 에이전트 컴퓨터에서 Tableau Resource Monitoring Tool 에이전트를 제거합니다. 2. 위에 나열된 모든 프로그램을 제거한 후 RMT 서버 및 에이전트 컴퓨터에서 Tableau Resource Monitoring Tool 디렉터리를 삭제합니다. 데이터 디렉터리의 기본 위치는 `C:\Program Files\Tableau\Tableau Resource Monitoring Tool`입니다. **참고:** Tableau Resource Monitoring Tool 디렉터리를 삭제하지 않으면 이후에 Resource Monitoring Tool를 다시 설치하는 경우 사용자 이름 및 비밀번호, 구성 설정 등과 같은 특정 정보가 유지되고 다시 사용됩니다. ## 이 작업을 수행할 수 있는 사용자 Resource Monitoring Tool를 제거하려면 다음이 모두 필요합니다. - Resource Monitoring Tool를 설치하는 컴퓨터에 대한 관리자 사용 권한 - Tableau Server 관리자 사이트 역할 - Resource Monitoring Tool 관리자 계정 [주요 콘텐츠로 건너뛰기](#main-content) # 기본 설치 사용 권한 - Tableau Resource Monitoring Tool 다음 항목에서는 설치 중에 다양한 시스템 계정이나 그룹에 설정된 기본 사용 권한을 설명합니다. 사용자의 환경이나 조직에서 기본이 아닌 계정을 사용해야 하는 경우 이는 RMT(Resource Monitoring Tool)가 제대로 작동하는 데 필요한 사용 권한을 확인하는 데 도움이 됩니다. **참고:** RMT(Resource Monitoring Tool) 서버 및 에이전트는 FIPS(Federal Information Process Standard) 140-2를 준수하지 않으며 FIPS 모드가 사용되는 운영 체제에서는 제대로 작동하지 않습니다. ## Windows 설치 기본적으로 Tableau Resource Monitoring Tool은 설치 시 다음 계정을 생성합니다. - NT SERVICE\\TableauResourceMonitoringTool - NT SERVICE\\TableauResourceMonitoringToolPostgreSQL - NT SERVICE\\TableauResourceMonitoringToolRabbitMQ 기본 계정 대신 다른 계정을 사용해야 하는 경우 설치 후 `rmt-admin` 명령줄 유틸리티를 사용하여 해당 계정을 지정할 수 있습니다. 자세한 내용은 [rmtadmin service-setup](https://help.tableau.com/current/server/ko-kr/rmt-admin-cmdline.htm#rmtadmin-service-setup)을 참조하십시오. 이러한 기본 서비스 계정에서 사용하는 사용 권한은 아래와 같으며, 필요한 최소 사용 권한도 나와 있습니다. 서비스 계정은 최소 사용 권한 또는 기본 사용 권한과 일치해야 합니다.
서비스 계정리소스기본 사용 권한필요한 최소 사용 권한
Tableau Resource Monitoring Tool Master   
 응용 프로그램 파일

Tableau Resource Monitoring Tool\master

모든 권한: 읽기, 쓰기, 실행, 수정

모든 권한
 로그 디렉터리 및 파일

Tableau Resource Monitoring Tool\master\logs

모든 권한: 읽기, 쓰기, 실행, 수정

읽기, 쓰기
 구성 디렉터리

Tableau Resource Monitoring Tool\master\config

모든 권한: 읽기, 쓰기, 실행, 수정

모든 권한
    
Tableau Resource Monitoring Tool PostgreSQL   
 응용 프로그램 디렉터리

Tableau Resource Monitoring Tool\prerequisites\postgresql<nn>

모든 권한: 읽기, 쓰기, 실행, 수정모든 권한
 

데이터 디렉터리

Tableau Resource Monitoring Tool\data\postgresql<nn>

모든 권한: 읽기, 쓰기, 실행, 수정모든 권한
 로그 디렉터리

Tableau\Tableau Resource Monitoring Tool\master\logs\pgsql

모든 권한: 읽기, 쓰기, 실행, 수정읽기, 쓰기
    
Tableau Resource Monitoring Tool RabbitMQ   
 

데이터 디렉터리

Tableau Resource Monitoring Tool\data\rabbitmq

모든 권한: 읽기, 쓰기, 실행, 수정모든 권한
 

응용 프로그램 파일

Tableau Resource Monitoring Tool\prerequisites\rabbitmq

Tableau Resource Monitoring Tool\prerequisites\erlang

모든 권한: 읽기, 쓰기, 실행, 수정모든 권한
 

로그 파일

Tableau Resource Monitoring Tool\master\logs\rabbitmq

모든 권한: 읽기, 쓰기, 실행, 수정읽기, 쓰기
    
Tableau Resource Monitoring Tool Agent   
 

응용 프로그램 파일

Tableau Resource Monitoring Tool\agent

모든 권한: 읽기, 쓰기, 실행, 수정모든 권한
 

로그 디렉터리 및 파일

Tableau Resource Monitoring Tool\agent\logs

모든 권한: 읽기, 쓰기, 실행, 수정읽기
 

구성 디렉터리

Tableau Resource Monitoring Tool\agent\config

모든 권한: 읽기, 쓰기, 실행, 수정모든 권한
## Linux 설치 기본적으로 Tableau Resource Monitoring Tool은 설치 시 특정 계정을 생성합니다. 기본값 대신 그룹 및 사용자를 사용해야 하거나 사용하려는 경우, 설치 후 `rmt-admin` 명령줄 유틸리티를 사용하여 해당 그룹 및 사용자를 지정할 수 있습니다. 자세한 내용은 [rmtadmin service-setup](https://help.tableau.com/current/server/ko-kr/rmt-admin-cmdline.htm#rmtadmin-service-setup)을 참조하십시오. 이러한 서비스 계정에서 사용하는 기본 사용 권한은 아래와 같습니다. 사용자의 사용 권한은 다음 사용 권한과 일치해야 합니다.
서비스 계정리소스permissions
Tableau Resource Monitoring Tool Master  
 응용 프로그램 파일

/var/opt/tableau/tabrmt/master

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기, 실행

기타 - 읽기, 실행

 로그 디렉터리 및 파일

/var/opt/tableau/tabrmt/master/logs

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기, 실행

기타 - 읽기, 실행

 구성 디렉터리

/var/opt/tableau/tabrmt/master/config

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기, 실행

기타 - 읽기, 실행

   
Tableau Resource Monitoring Tool PostgreSQL  
 응용 프로그램 디렉터리

/opt/tableau/tabrmt/prerequisites/postgresql13

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 실행

기타 - 읽기, 실행

 

서비스 디렉터리

/var/opt/tableau/tabrmt/data/postgresql13/pg_*

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 없음

기타 - 없음

 

데이터 디렉터리

/var/opt/tableau/tabrmt/data/postgresql13/

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기, 실행

기타 - 읽기, 실행

 

로그 디렉터리

/var/opt/tableau/tabrmt/master/logs/pgsql

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기, 실행

기타 - 실행

 위에 언급되지 않은 PostgreSQL 디렉터리 아래의 다른 디렉터리

/var/opt/tableau/tabrmt/data/postgresql13/<not mentioned above>

소유자 - 읽기, 쓰기

그룹 - 없음

기타 - 없음

 /var/opt/tableau/tabrmt/data/postgresql13/base

/var/opt/tableau/tabrmt/data/postgresql13/global

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 없음

기타 - 없음

 /var/opt/tableau/tabrmt/data/postgresql13/certificates소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 모든 권한(읽기, 쓰기, 실행)

기타 - 실행

   
Tableau Resource Monitoring Tool RabbitMQ  
 

데이터 디렉터리

/var/opt/tableau/tabrmt/data/rabbitmq

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기 및 실행

기타 - 읽기, 실행

 

응용 프로그램 파일

/var/opt/tableau/tabrmt/rabbitmq/prerequisites/rabbitmq

/var/opt/tableau/tabrmt/rabbitmq/prerequisites/erlang

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 실행

기타 - 읽기, 실행

 

로그 파일

/var/opt/tableau/tabrmt/master/logs/rabbitmq

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기 및 실행

기타 - 실행

 

다른 디렉터리(/rabbitmq의 하위 디렉터리)

/var/opt/tableau/tabrmt/data/rabbitmq/certificates

/var/opt/tableau/tabrmt/data/rabbitmq/mnesia

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기 및 실행

기타 - 실행

 /var/opt/tableau/tabrmt/data/rabbitmq/<other than mentioned>소유자 - 읽기, 실행

그룹 - 읽기, 실행

기타 - 없음

   
Tableau Resource Monitoring Tool Agent  
 

응용 프로그램 파일

/var/opt/tableau/tabrmt/agent

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기 및 실행

기타 - 읽기, 실행

 

로그 디렉터리 및 파일

/var/opt/tableau/tabrmt/agent/logs

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기 및 실행

기타 - 읽기, 실행

 

구성 디렉터리

/var/opt/tableau/tabrmt/agent/config

소유자 - 모든 권한(읽기, 쓰기, 실행)

그룹 - 읽기, 쓰기 및 실행

기타 - 읽기, 실행

### 이 작업을 수행할 수 있는 사용자 위에 설명된 모든 단계를 수행하려면 Resource Monitoring Tool를 설치하는 컴퓨터의 관리자이고 Tableau Server 관리자여야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # RMT 서버 서비스 중단 문제 해결 RMT 서버의 주기적인 중지로 인한 서비스 중단을 경험할 수 있습니다. 이 문제의 원인은 대부분의 경우 Resource Monitoring Tool이 내부 IT 정책을 따르지 않는 서비스 계정으로 구성되었기 때문일 수 있습니다. 많은 IT 부서가 표준을 위반한 것으로 간주되는 계정의 권한을 취소하는 자동화 도구를 사용하는데, 이것이 서비스 중단의 원인입니다. **임시 해결책:** `rmtadmin start -master`를 실행하여 RMT 서버를 다시 시작합니다. **장기적 해결책:** 내부 거버넌스 정책을 준수하는 계정으로 실행되도록 Resource Monitoring Tool을 구성하거나(권장) IT 부서와 협력하여 정책에서 예외를 받으십시오. ## 이 작업을 수행할 수 있는 사용자 구성 및 데이터베이스를 변경할 수 있으려면 컴퓨터의 관리자이자 Resource Monitoring Tool 관리자여야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # RMT 서버 초기화 스크립트 옵션 RMT 서버를 설치한 후 서버를 초기화해야 합니다. 기본적으로 초기화 스크립트를 실행할 때 포함해야 하는 유일한 필수 플래그는 `--accepteula`입니다. 다른 옵션은 환경과 기업의 보안 요구 사항에 따라 설치를 사용자 지정하는 데 유연성을 제공하기 위한 것입니다. \--accepteula 필수 항목입니다. EULA(최종 사용자 사용권 계약)의 조건을 읽고 이에 동의했는지 나타냅니다. \-a 선택 사항입니다. 제공된 사용자 이름을 초기화 스크립트를 실행하는 사용자 대신 해당하는 그룹에 추가합니다. 그러면 그룹이 소유한 리소스에 대한 액세스 권한이 사용자에게 부여됩니다. 이것은 '서비스 계정' 사용자 계정과 다릅니다. 기본값: 초기화 스크립트를 실행하는 사용자 \-f 선택 사항입니다. 경고 메시지 또는 배포 버전 확인을 우회합니다. \-h | -? 선택 사항입니다. 스크립트의 도움말 텍스트를 표시합니다. \-q 선택 사항입니다. 오류 및 경고를 제외한 출력을 표시하지 않고 억제합니다. \--debug 선택 사항입니다. 디버깅 목적으로 실행되는 각 명령을 인쇄합니다. 생성되는 출력이 방대합니다. \--default-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. Tableau RMT 에이전트에 대한 액세스 권한을 부여할 수 있는 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. \---disable-account-creation **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. 존재하지 않는 계정/그룹을 만들지 않습니다. 지정하는 경우 `--unprivileged-user` 매개 변수와 `--default-group` 및/또는 다른 `--rmt-<...>-group` 매개 변수의 조합도 지정해야 합니다. 이러한 매개 변수가 참조하는 사용자 ID 및 그룹이 이미 있어야 합니다. \--enable-fips **버전:** 버전 2025.3.0에 추가되었습니다. RHEL 8 Linux만 해당합니다. 자세한 내용은 [Tableau Resource Monitoring Tool의 FIPS 규정 준수](https://help.tableau.com/current/server/ko-kr/rmt-fips-compliance.htm)를 참조하십시오. 선택 사항입니다. RHEL 8 컴퓨터에 설치할 때 RMT에서 FIPS 모드를 사용하도록 설정합니다. \--rmt-authorized-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. 설치 기반 설치 디렉터리 및 `install_dir/prerequisites` 폴더를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtmasterapp`" 또는 `--default-group` 값 \--rmt-config-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/master/config` 디렉터리를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtmasterconfig`" 또는 `--default-group` 값 \--rmt-logs-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/master/logs` 디렉터리를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtmasterlogs`" 또는 `--default-group` 값 \--rmt-openssl-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/prerequisites/openssl` 디렉터리를 소유한 그룹의 이름입니다. 기본값: "`rmtopenssl`" 또는 `--default-group` 값 \--rmt-postgres-app-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/prerequisites/postgresql13` 디렉터리를 소유한 그룹의 이름입니다. 기본값: "`rmtpostgresapp`" 또는 `--default-group` 값 \--rmt-postgres-data-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. install\_dir/master/logs 디렉터리를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtmasterlogs`" 또는 `--default-group` 값 \--rmt-rabbitmq-app-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/prerequisites/rabbitmq` 디렉터리를 소유한 그룹의 이름입니다. 기본값: "`rmtrabbitmqapp`" 또는 `--default-group` 값 \--rmt-rabbitmq-data-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/data/rabbitmq` 디렉터리를 소유한 그룹의 이름입니다. 기본값: "`rmtrabbitmqdata`" 또는 `--default-group` 값 \--unprivileged-user= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. Tableau RMT 마스터를 실행할 권한이 없는 사용자 계정의 이름입니다. RMT를 초기화한 후에는 계정을 변경할 수 없습니다. 기본값: "`tabrmt-master`" [주요 콘텐츠로 건너뛰기](#main-content) # RMT 서버의 하드웨어 변경 - PostgreSQL 데이터베이스 조정 RMT 서버가 설치된 컴퓨터의 하드웨어를 업그레이드하거나 변경해야 하는 경우가 있습니다. 메모리와 CPU 같은 하드웨어를 변경한 경우에는 항상 RMT 서버에 설치되어 있는 기초 PostgreSQL 데이터베이스를 튜닝하는 것이 좋습니다. RMT 서버를 설치할 때 설치 프로그램은 컴퓨터에서 사용 가능한 하드웨어의 사용을 최적화할 수 있도록 PostgreSQL 데이터베이스를 구성합니다. 최적화의 예에는 버퍼 및 캐시 크기 관리가 포함됩니다. 컴퓨터의 하드웨어를 변경할 경우 성능이 영향을 받을 수 있습니다. 다음 단계에 따라 하드웨어 변경 내용을 반영하도록 구성이 업데이트되었는지 확인하십시오. 1. PowerShell 명령 프롬프트를 엽니다. 관리자로 실행합니다. 2. Tableau Resource Monitoring Tool 의 필수 요건 디렉터리로 이동합니다. 기본적으로 이 디렉터리는 _C:\\Program Files\\Tableau Resource Monitoring Tool\\prerequisites_입니다. `cd C:\Program Files\Tableau Resource Monitoring Tool\master\` 3. 다음 명령을 실행합니다. `.\tunePostgres.psl` 구성 파일이 업데이트되었음을 알리는 메시지가 나타나야 합니다. 변경 내용을 적용하려면 PostgreSQL 서비스를 다시 시작해야 한다는 메시지도 나타납니다. 구성 파일이 업데이트된 경우 서버를 중단할 필요가 없습니다. 4. PostgreSQL 데이터베이스를 다시 시작합니다. 업무 외 시간 중에 Resource Monitoring Tool가 사용되지 않을 때 이 작업을 수행할 수 있습니다. [주요 콘텐츠로 건너뛰기](#main-content) # RMT 업그레이드 상태 검사 스크립트 2025.3.6 릴리스부터 RMT 설치 프로그램에 업그레이드 전후 Tableau RMT(Resource Monitoring Tool) 환경의 유효성을 검사하는 업그레이드 전 및 업그레이드 후 상태 검사 스크립트가 포함됩니다. 이러한 스크립트는 구성 오류, 사용 권한 변경, 디스크 공간 부족, 만료된 인증서, 서비스 장애 등 업그레이드 실패를 유발할 수 있는 기존 환경 내의 문제를 식별합니다. 업그레이드 전 및 업그레이드 후 상태 검사 스크립트는 다음과 같은 문제를 식별할 수 있습니다. - **데이터베이스 및 디스크 준비 상태**: 대규모 데이터베이스 또는 과도한 WAL 파일로 인해 마이그레이션이 중단되거나 디스크 공간이 소진되는지 감지합니다. - **사용 권한 및 보안 무결성**: 서비스 재시작이나 에이전트 재연결을 차단할 수 있는 파일 소유권 변경 사항이나 만료된 SSL 인증서를 식별합니다. - **종속성 유효성 검사**: PostgreSQL 15를 설치하기 전에 Visual C++ 2022 재배포 가능 패키지 및 OpenSSL 3.x와 같은 필수 Windows 구성 요소가 있는지 확인합니다. - **버전 논리 안전성**: 버전 메타데이터의 회귀 현상으로 인해 발생하는 '잘못된 다운그레이드' 오류를 방지합니다. ## 업그레이드 전 스크립트 업그레이드 전 스크립트는 업그레이드를 시작할 때 자동으로 실행됩니다. 기존 설치가 아직 존재하는 동안 RMT 서버 또는 Agent 호스트를 검사하고 PASS/FAIL/WARN 보고서를 생성합니다. **Linux**의 경우 업그레이드 전 검사가 다음의 일부로 자동 실행됩니다. sudo bash upgrade-rmt-master ... sudo bash upgrade-rmt-agent ... 자동 검사를 건너뛰려면(권장하지 않음): sudo bash upgrade-rmt-master --skip-pre-upgrade-check ... **Windows**의 경우 설치 프로그램이 업그레이드 전 검사를 자동으로 실행합니다. 설치 중에 업그레이드를 건너뛸 수 있는 옵션이 표시됩니다. 그러나 이는 권장되지 않습니다. ### 수동 업그레이드 전 검사 스크립트를 수동으로 실행하여 잠재적인 문제를 미리 볼 수 있습니다. 수동으로 실행하려면 운영 체제에 따라 다음 단계를 사용하십시오. **Linux의 경우:** 루트 사용자로 명령을 실행합니다. 데이터베이스 검사를 포함하려면 export 명령을 사용하여 비밀번호를 안전하게 전달합니다. sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh PostgreSQL 검사를 사용하도록 설정한 상태로 실행하려면 다음 명령을 사용합니다. export RMT\_DB\_PASSWORD="" sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh 특정 구성 요소 및 출력 경로를 사용하여 실행하려면 다음 명령을 사용합니다. sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt **Windows의 경우:** RMT 서버의 업그레이드 전 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1` Agent의 업그레이드 전 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1` 스크립트를 수동으로 실행하려면 관리자 권한으로 PowerShell을 시작하고 다음을 실행합니다. `cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"` .`\rmt-pre-upgrade-check.ps1` PostgreSQL 검사를 사용하도록 설정한 상태로 실행하려면 다음 명령을 사용합니다. $env:RMT\_DB\_PASSWORD = "" .\\rmt-pre-upgrade-check.ps1 특정 구성 요소 및 출력 경로를 사용하여 실행하려면 다음 명령을 사용합니다. .\\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\\temp\\rmt-report.txt ### 추가 옵션 다음 옵션을 사용하여 업그레이드 전 검사를 사용자 지정합니다. `-Component` RMT 서버 또는 Agent를 지정합니다. 생략할 경우 스크립트가 이를 자동으로 감지합니다. `--db-password / -DbPassword` 내부 RMT 데이터베이스 관리자 비밀번호입니다. PostgreSQL 검사에 필요합니다. `--output / -OutputPath` 보고서를 저장할 위치를 지정합니다. 기본적으로 저장되는 위치: `/tmp/ (Linux) or C:\temp\ (Windows).` `--target-version / -TargetVersion` 설치하려는 RMT 버전이며, 버전별 검사를 사용하도록 설정합니다. `--quiet / -Quiet` 출력을 필터링하여 FAIL 및 WARN 결과만 표시합니다. `--verbose / -Verbose` 출력에는 수행된 모든 검사에 대한 자세한 기술 데이터가 표시됩니다. ### 스크립트 결과 및 필요한 동작 다음 표에는 스크립트 결과와 필요한 동작이 설명되어 있습니다.
결과상태동작
PASSEXIT CODE 0문제가 발견되지 않았습니다. 업그레이드가 계속 진행됩니다.
WARNEXIT CODE 1업그레이드가 계속 진행되지만 보고서를 검토하여 심각하지 않은 위험이 무엇인지 확인해야 합니다.
FAILEXIT CODE 2업그레이드가 중단되었습니다. 업그레이드를 다시 실행하기 전에 이러한 문제를 해결해야 합니다.
## 업그레이드 후 스크립트 업그레이드 후 상태 검사 스크립트는 모든 RMT 설치 및 업그레이드가 끝날 때 자동으로 실행됩니다. 모든 서비스가 올바르게 시작되었는지, 인프라가 정상 상태인지, 구성이 손상되지 않았는지를 검사합니다. 업그레이드 후 검사는 설치 프로그램을 차단하지 않습니다. 식별된 모든 오류는 최종 보고서에 기록됩니다. ### 수동 업그레이드 후 검사 수동으로 실행하려면 운영 체제에 따라 다음 단계를 사용하십시오. **Linux의 경우:** 루트 사용자 또는 `sudo` 권한이 있는 사용자로 다음 명령을 실행합니다. - RMT 서버의 경우: sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade - Agent의 경우: sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade **Windows의 경우:** RMT 서버의 업그레이드 후 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1` Agent의 업그레이드 후 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1` 스크립트를 수동으로 실행하려면 관리자 자격으로 PowerShell을 열고 RMT 설치 디렉터리로 이동한 후 명령을 실행해야 합니다. - RMT 서버의 경우: .\\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade - Agent의 경우: .\\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade ### 추가 옵션 다음 옵션을 사용하여 스크립트를 사용자 지정할 수 있습니다. `--component / -Component` RMT 서버 또는 Agent를 지정합니다. 생략된 경우 자동 감지가 시도됩니다. `--db-password / -DbPassword` 내부 RMT 데이터베이스 관리자의 비밀번호입니다. 이는 PostgreSQL 검사를 사용하도록 설정하는 데 필요합니다. `--output / -OutputPath` 보고서 파일이 저장될 경로입니다. 기본값은 `/tmp/ (Linux)` 또는 `C:\temp\ (Windows)`입니다. `--target-version / -TargetVersion` 업그레이드하려는 특정 RMT 버전이며, 버전별 검사에 사용됩니다. `--quiet / -Quiet` 출력을 축소하여 **FAIL** 및 **WARN** 결과만 표시합니다. `--verbose / -VerboseOutput` 수행된 모든 검사에 대한 자세한 기술 출력을 제공합니다. 참고: 명령줄 인수는 프로세스 목록에 표시되므로 RMT\_DB\_PASSWORD를 명령줄에서 직접 전달하기보다는 환경 변수로 설정하는 것이 좋습니다. ### 스크립트 결과 및 필요한 동작 다음 표에는 스크립트 결과와 필요한 동작이 설명되어 있습니다.
결과상태동작
PASSEXIT CODE 0시스템이 정상 상태입니다. 필요한 동작이 없습니다.
WARNEXIT CODE 1경고를 검토하십시오. 대부분은 자체적으로 해결됩니다(예: 일시적인 RabbitMQ 시작 지연).
FAILEXIT CODE 2하나 이상의 중요 검사에 실패했습니다. 조사하여 해결하십시오.
## 보고서 업그레이드 전 보고서는 다음 위치에서 찾을 수 있습니다. - Linux: `/tmp/rmt-precheck-.txt` - Windows(수동): `C:\temp\rmt-precheck--.txt` 업그레이드 후 보고서는 다음 위치에서 찾을 수 있습니다. - Linux: `/rmt-postcheck-report.txt` - Windows(수동): `C:\temp\rmt-postcheck--.txt` - Windows(설치 프로그램 사용): 설치 프로그램이 검사를 실행할 때 고정된 파일 이름이 사용됩니다. - `C:\temp\rmt-postcheck-master-report.txt` - `C:\temp\rmt-postcheck-agent-report.txt` 보고서의 업그레이드 전 및 업그레이드 후 검사에 대한 자세한 내용은 [업그레이드 참조서](https://help.tableau.com/current/server/ko-kr/rmt-admin-upgrade-reference.htm) 섹션을 참조하십시오. ### 샘플 보고서 다음은 업그레이드 전 상태 검사 보고서 샘플입니다. \================================================================== RMT Pre-Upgrade Health Check Report Script Version : 1.0.0 Generated : 2026-04-08 14:30:00 Component : master Hostname : rmt-master-01.example.com RMT Version : 2025.1.9 \================================================================== OVERALL STATUS : UPGRADE WITH CAUTION (2 warning(s) -- review before proceeding) PASS: 44 FAIL: 0 WARN: 2 INFO: 10 SKIP: 3 \================================================================== WARNINGS -- Review Before Upgrading \================================================================== \[WARN\] #21d Hangfire schema is 1.2 GB Check 21g for delete\_hash() volatility bug \[WARN\] #24 1 queue(s) with >10000 messages (max: 15234) Resolve backlogs before upgrading [주요 콘텐츠로 건너뛰기](#main-content) # RMT 업그레이드: 기술 참조 이 섹션은 업그레이드 프로세스 중에 검사되는 작동 임계값, 시스템 경로 및 네트워크 포트에 대한 기술 참조 가이드입니다. 다음 테이블을 사용하여 유효성 검사 오류를 신속하게 진단하고 환경을 필요한 RMT 기준선에 맞게 조정할 수 있습니다. **참고**: '평등'이라는 회사 가치에 부합하기 위해 RMT 마스터라는 명칭을 RMT 서버로 업데이트했습니다. 일부 경우 RMT 서버 설치 경로 및 명령에서 '서버' 대신 '마스터'라는 용어를 사용할 수 있습니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 [Tableau 도움말 정보](https://help.tableau.com/current/tableau/ko-kr/about-tableau-help.htm)를 참조하십시오. ## 업그레이드 전 상태 검사 업그레이드 전 상태 검사는 기존 설치가 아직 존재하는 동안 RMT 서버 또는 Agent 호스트를 검사하여 서비스가 실행 중인지, 데이터베이스에 액세스할 수 있는지 등을 확인하고 자세한 PASS/FAIL/WARN 보고서를 생성합니다. 시스템 리소스, 계정, 파일 사용 권한, PostgreSQL, RabbitMQ, 네트워킹, 구성 파일 및 RMT 서비스 전반에 걸쳐 80개 이상의 개별 검사를 실행합니다. 다음 표에는 업그레이드 전에 수행되는 검사가 나와 있습니다. **FAIL** 상태(Exit Code 2)를 반환하는 항목이 있으면 업그레이드가 취소됩니다. ### 시스템 및 하드웨어
검사 ID이름 플랫폼실패(FAIL)/경고(WARN) 조건
#1운영 체제Linux, WindowsWARN OS 버전이 사전 검사 허용 목록에 없습니다. 지원되는 목록은 RHEL 8.x/9.x, Ubuntu 20.04/22.04/24.04, CentOS Stream 8/9, Oracle Linux 8.x/9.x, AlmaLinux 8.x/9.x, Rocky Linux 8.x/9.x, Amazon Linux 2023, Windows Server 2019/2022입니다.
#2디스크 공간Linux, WindowsFAIL 여유 공간이 RMT 서버에서 20GB 미만이거나 Agent에서 5GB 미만인 경우 실패. WARN 여유 공간이 RMT 서버에서 50GB 미만이거나 Agent에서 10GB 미만인 경우 경고
#2a디스크 유형Linux, WindowsINFO 드라이브가 SSD인지 HDD인지를 보고함
#3

RAM

Linux, WindowsWARN RMT 서버가 8GB(최소) 미만인 경우 또는 Agent가 4GB(최소) 미만인 경우 경고
#4CPU 코어Linux, WindowsWARN RMT 서버가 8GB(최소) 미만인 경우 또는 Agent가 4GB(최소) 미만인 경우 경고
#4aCPU 명령어Linux, WindowsFAIL(Linux): sse4_2 또는 popcnt가 없는 경우 실패. WARN(Windows): 오래된 CPU가 감지된 경우 경고.
#4bVC++ RedistWindowsFAIL Visual Studio 2022 C++ Redistributable 가능 패키지가 없는 경우 실패.
#4cOpenSSL DLLsWindowsINFO libcrypto-3-x64.dll 및 libssl-3-x64.dll을 확인함
#5시스템 가동 시간Linux, WindowsINFO: 10분 미만인 경우(최근 재부팅) 또는 90일 초과인 경우(패치 대기 중) 알림
#6Systemd 실행 중LinuxFAIL systemd가 실행되고 있지 않은 경우 실패, PASS: 실행 중이거나 성능이 저하된 경우 통과
#7FIPS 모드Linux, WindowsFAIL(Windows): 레지스트리에서 사용하는 경우 실패, PASS FIPS를 사용 안 하는 경우 통과. WARN(Linux) config.json과 일치하지 않는 경우 경고. PASS OS 및 구성이 일치하는 경우 통과
#7aPowerShell 버전WindowsINFO PowerShell 버전
#7b시스템 로캘WindowsINFO 시스템 로캘 정보
#7cWMI 상태WindowsWARN WMI 리포지토리가 일관되지 않는 경우 경고
### 계정 및 사용 권한
검사 ID이름플랫폼실패(FAIL)/경고(WARN) 조건
#8서비스 계정Linux, WindowsFAIL RMT 서비스 계정 또는 Windows 서비스를 찾을 수 없는 경우 실패
#9그룹 멤버십LinuxFAIL 필수 서비스 그룹(예: rmtmasterapp, rmtmasterconfig 등)이 없는 경우 실패
#10사용자 SystemdLinuxFAIL 사용자 systemd daemon/링거가 활성 상태가 아닌 경우 실패
#44pamtester 설치됨LinuxWARN 설치되지 않은 경우 경고. 이 문제를 해결하려면 yum install pamtester 또는 apt install libpam-runtime을 설치해야 함
#### Linux에 대한 디렉터리 소유권 및 사용 권한
검사 ID디렉터리Expected Owner:Group예상 모드
#11구성 디렉터리tabrmt-master:rmtmasterconfig2775
#12로그 디렉터리tabrmt-master:rmtmasterlogs2775
#13데이터 디렉터리(+ PG/RMQ 하위 디렉터리)구성 요소별로 다름2775
#14필수 요건 디렉터리root 또는 구성 요소 사용자755
#14arabbitmq-defaults 파일그룹 쓰기 가능 권한 필요g+w
#15SSL 인증서 디렉터리tabrmt-master:rmtopenssl2775
#15a홈 디렉터리구성 요소 사용자770
#15b/etc/profile.d/tabrmt-*.shroot기본값
#15c구성 디렉터리 setgid 비트--2xxx 필수
#16environment.bash구성 요소 사용자group-writable
심각도: 데이터 디렉터리 집합(#13 및 #15)에 대한 소유권에만 **FAIL**이 발생합니다. 다른 모든 Linux 디렉터리 검사(#11, #12, #14, #14a, #15a–c, #16)는 설치 프로그램의 사후 설치 단계에서 업그레이드 중에 소유권을 다시 적용하기 때문에 소유권/모드 불일치 시 **WARN**이 발생합니다. 사용 권한 모드가 잘못되었지만 소유권이 올바른 경우 **WARN**이 발생합니다. #### Windows에 대한 디렉터리 소유권 및 사용 권한
검사이름심각도
#11구성 디렉터리 ACLFAIL 서비스 사용자에게 FullControl이 없는 경우 실패
#12로그 디렉터리 ACLFAIL 서비스 사용자에게 수정 권한이 없는 경우 실패
#13데이터 디렉터리 ACL(RMT 서버)FAIL 서비스 사용자에게 PG/RMQ 데이터 디렉터리에 대한 FullControl이 없는 경우 실패
#14필수 요건 디렉터리 ACL(RMT 서버)WARN ReadAndExecute가 없는 경우 경고(권고 - 모든 업그레이드는 필수 요건 MSI를 다시 설치하고 설치 후 동작은 ACL을 다시 적용함)
#15SSL 인증서 디렉터리 ACL(RMT Server)FAIL 서비스 사용자에게 FullControl이 없는 경우 실패
#16a서비스 사용자 IDPASS(정보 제공용 -- 서비스를 실행하는 사용자를 표시)
#16bSeServiceLogonRight 권한있는 경우 INFO를 제공하고, 없거나 secedit가 실패하는 경우 WARN 경고가 발생
#16cRMT 디렉터리의 서비스 사용자 ACLFAIL 서비스 사용자에게 필요한 권한이 없는 경우 실패
### 데이터베이스(PostgreSQL) 모든 PostgreSQL 검사는 RMT 서버에서만 실행됩니다.
검사 ID이름--db-password 옵션 필요실패(FAIL)/경고(WARN) 조건
#17PG 서비스아니요FAIL 로컬 서비스가 중지되어 사용 안 함으로 설정된 경우 실패
#18포트 5555 수신 대기아니요WARN(보안 그룹 / VPC / RDS 힌트) 수신 대기 안 하는 경우 경고
#19DB Connection예WARN 내부 DB에 연결할 수 없는 경우 경고(SSL, 비밀번호 또는 네트워크 문제)
### 메시징(RabbitMQ) 메시징(RabbitMQ) 검사는 RMT 서버에서만 실행됩니다.
검사 ID이름실패(FAIL)/경고(WARN) 조건
#22RMQ 서비스FAIL 로컬 서비스가 중지되어 사용 안 함으로 설정된 경우 실패
#24큐 백로그WARN 메시지가 10,000개를 초과하는 큐가 있는 경우 경고
#25RabbitMQ 사용자WARN 기본 guest 사용자가 여전히 존재하는 경우 경고
#26활성 연결INFO만 해당. 활성 연결 수를 보고함
#27Erlang 쿠키 액세스 가능WARN 쿠키 파일이 없는 경우, 사용 권한이 잘못된 경우 경고(모드 400 또는 600이어야 함)
#27aERLANG_HOME 집합WARN(Windows만 해당) `ERLANG_HOME`가 설정되지 않았거나 경로가 없는 경우 경고.
#27bSSL 유효성FAIL 인증서가 만료된 경우 실패
#27c디스크 경보FAIL RMQ 파티션에 여유 공간이 10GB 미만인 경우 실패(업그레이드 중단됨)
#45인증서 디렉터리가 채워짐WARN 인증서 디렉터리가 있지만 비어 있는 경우 또는 필요한 인증서 파일(서버 인증서, 키, CA 인증서)이 없는 경우 경고
### 네트워크 및 구성
검사 ID이름실패(FAIL)/경고(WARN) 조건
#28a/bAgent-마스터 통신WARN Agent가 5671, 5672, 80 또는 443에서 마스터에 연결할 수 없는 경우 경고
#33-35JSON/Bash ConfigFAIL config.json, setup.json 또는 environment.bash가 없거나 잘못된 경우 실패
#36a알려진 결함이 있는 버전FAIL 현재 버전은 2025.3.0임(회귀 문제로 인한 업그레이드 차단)
### 서비스 및 백업
검사 ID이름실패(FAIL)/경고(WARN) 조건
#38모든 RMT 서비스가 실행 중임WARN 중지된 각 서비스에 대해 경고
#38a중단된 프로세스FAIL 서비스가 중지된 후에도 남아 있는 tabrmt-* 프로세스가 있는 경우 실패
#39백그라운드 프로세서 실행 중WARN 호스트 프로세스가 실행되고 있지 않는 경우 경고
#40업그레이드 전 백업 미리 알림WARN 업그레이드 전에 구성을 백업하도록 미리 알림으로 경고
#41토폴로지INFO만 해당. 마스터/Agent 노드 유형 및 활성 에이전트 수(DB 포함)를 보고함
#42구성 요소 버전 인벤토리INFO만 해당. RMT, PostgreSQL, RabbitMQ, OpenSSL 버전을 보고함
#43컴퓨터 사양 요약INFO만 해당. OS, CPU 코어, RAM, 디스크 여유 공간을 보고함
## 업그레이드 후 상태 검사 이러한 검사는 업그레이드 후에 실행됩니다. 이는 차단되지 않으며 실패가 발생해도 업그레이드가 중지되지는 않지만 설치 후 문제가 발생함을 나타냅니다.
검사 ID이름구성 요소실패(FAIL)/경고(WARN) 조건
#1a-d서비스 및 프로세스RMT Server, AgentFAIL 주, PG 또는 RMQ 서비스가 실행되고 있지 않는 경우 실패
#2호스트 프로세스 감독자RMT Server, AgentWARN 호스트 감독자 프로세스가 없는 경우 경고(자동 복구 없음)
#3a-b구성 파일 무결성RMT Server, AgentFAIL JSON이 없거나 잘못된 경우 실패
#4a-b파일 사용 권한RMT Server, AgentFAIL 서비스 계정으로 구성/로그 디렉터리를 읽거나 쓸 수 없는 경우 실패
#5a-d포트 수신 대기RMT ServerFAIL Web(443), AMQP(5672) 또는 DB(5555)가 수신 대기 중에 있지 않는 경우 실패
#6PostgreSQL 연결RMT ServerFAIL PostgreSQL이 연결을 허용하지 않는 경우 실패
#7RabbitMQ 상태RMT 서버SKIP 외부인 경우 건너뜁니다. FAIL 모든 재시도가 소진된 후 실패합니다.
#8a큐 소비자RMT ServerWARN 백로그가 있지만 활성 소비자가 없는 경우 경고(마스터 작업자 연결 끊김)
#9RMQ 경보RMT ServerFAIL 활성 메모리 또는 디스크 리소스 경보가 감지되는 경우 실패
#10RabbitMQ SSL 인증서RMT 서버FAIL 인증서가 만료된 경우 실패. WARN 인증서가 30일 이내에 만료되는 경우 경고
#11FIPS 일치RMT Server, AgentFAIL OS FIPS 상태가 isFIPSEnabled 구성과 불일치하는 경우 실패
#12웹 서버 HTTP 응답RMT 서버HTTP GET을 `https://localhost:<port>/authentication/login`으로 설정합니다. PASS 200 또는 302인 경우 통과. FAIL 연결 거부/시간 초과인 경우 실패. WARN 그 외 다른 오류인 경우 경고.
#13HTTPS 인증서 유효성RMT ServerFAIL 웹 서버 TLS 인증서가 만료된 경우 실패
#14a-d디스크 공간RMT Server, AgentFAIL 여유 공간이 1GB 미만인 경우 실패. WARN: 여유 공간이 5GB 미만인 경우 경고
#15최근 로그 오류RMT Server, AgentFAIL 로그에 FATAL 오류가 있는 경우 실패. WARN: CRITICAL 오류가 있는 경우 경고
#16RMT 상태RMT Server, AgentFAIL rmtadmin 상태가 오류 패턴을 반환하면 실패
#17Agent 로그 기록AgentAgent 데이터 디렉터리에서 로그 추적 파일(.history, .json)을 검사합니다. WARN 파일을 읽을 수 없거나 손상된 경우 경고
#18a-f인벤토리 버전RMT Server, AgentINFO RMT 버전, PostgreSQL 버전, RabbitMQ 버전, Erlang/OTP 버전, .NET Runtime(Windows) / OS(Linux), OS 버전(Windows) / 커널(Linux)에 대한 정보 제공
## 상태 검사 종료 코드 다음 종료 코드를 사용하여 업그레이드 전 및 업그레이드 후 상태 검사 스크립트의 결과를 해석할 수 있습니다. ### 업그레이드 전 스크립트
종료 코드상태업그레이드 동작
0READY TO UPGRADE업그레이드 진행
1UPGRADE WITH CAUTION업그레이드가 진행되지만 경고를 검토해야 함
2Do not upgrade업그레이드가 취소됨
3Script Error실행 환경 검사
### 업그레이드 후 스크립트
종료 코드상태
0ALL PASSED
1WARNINGS PRESENT
2CRITICAL FAILURES
## InstallerContext 심각도 변경 자동 Windows MSI 업그레이드 중에 `-InstallerContext`를 사용하여 실행하는 경우 다음 검사는 수동 기본값과 다르게 동작합니다. 기본(InstallerContext가 아닌) 동작은 'stopped but not Disabled' / 'port not listening' 상태에 대해 \*이미\* WARN으로 설정되어 있으며, FAIL은 \`Stopped+Disabled\` 상태에 한해 사용됩니다. \`-`InstallerContext`\`에서는 'Disabled' 분기조차도 WARN으로 보고되므로, 설치 프로그램이 곧 수정할 일시적인 상태 때문에 진행 중인 설치 프로그램 기반 업그레이드가 차단되는 일은 절대 없습니다.
검사이름기본값InstallerContext
#17PG 서비스WARN 중지된 경우 경고, FAIL 중지 및 비활성화된 경우 실패, INFO 모두 중지된 경우 정보 제공WARN
#18PG 포트WARN 수신 대기 중이 아닌 경우 경고, INFO 모든 서비스가 중지된 경우 정보 제공WARN
#22RabbitMQ 서비스WARN 중지된 경우 경고, FAIL 중지+비활성화된 경우 실패, INFO 모두 중지된 경우 정보 제공WARN
#23Port 5672 (AMQP)WARN 수신 대기 중이 아닌 경우 경고, INFO 모든 서비스가 중지된 경우 정보 제공WARN
#38a중단된 RMT 프로세스(검사 설명 참조)SKIP(설치 프로그램이 프로세스 수명 주기를 관리함)
### 업그레이드 전 임계값
임계값RMT ServerAgent단위
디스크 공간 FAIL205GB 여유 공간
디스크 공간 WARN5010GB 여유 공간
임시 디렉터리 FAIL55GB 여유 공간
임시 디렉터리 WARN1010GB 여유 공간
RAM FAIL84GB
RAM WARN168GB
CPU FAIL42코어
CPU WARN84코어
데이터베이스 크기 FAIL500-GB
데이터베이스 크기 WARN200-GB
Hangfire 스키마 FAIL10-GB
Hangfire 스키마 WARN1-GB
WAL 디렉터리 FAIL(Windows)10-GB
WAL 디렉터리 FAIL(Windows)2-GB
WAL 디렉터리 FAIL(Linux)10-GB
Mnesia 디렉터리 WARN5-GB
RabbitMQ 디스크 경보 FAIL10-GB 여유 공간
큐 백로그 WARN10,000-메시지
인증서 만료 WARN3030일
정리 보존 WARN180-일
데드 튜플 비율 WARN20-퍼센트
Agent 하트비트 시간 경과15-분
네트워크 드라이버 사용 기간 WARN3-년
로그 디렉터리 크기 WARN55GB
로그 디렉터리 크기 WARN(심각)2020GB
### 업그레이드 후 임계값
임계값값단위
디스크 공간 FAIL1GB 여유 공간
디스크 공간 WARN5GB 여유 공간
인증서 만료 WARN30일
큐 백로그 WARN10,000메시지
로그 검사 기간60분
RabbitMQ 시작 재시도6회 시도 x 5초총 30초
## 지원되는 최소 구성 요소 버전
구성 요소최소 버전
RabbitMQ3.10.10 이상
Agent 버전2023.1.0 이상
### 자동화 및 CI/CD 통합 **Linux의 경우:** \`\`\`base \# Linux sudo bash rmt-pre-upgrade-check.sh --component master --db-password "$DB\_PASSWORD" EXIT\_CODE=$? if \[ $EXIT\_CODE -eq 2 \]; then echo "BLOCKED: Fix critical issues before upgrading" exit 1 fi \`\`\` **Windows의 경우:** \`\`\`powershell \# Windows .\\rmt-pre-upgrade-check.ps1 -Component master if ($LASTEXITCODE -eq 2) { Write-Error "BLOCKED: Fix critical issues before upgrading" exit 1 } \`\`\` ## 설치 디렉터리 참조서 기초 진단 유틸리티를 수동으로 호출하거나 설치 구조를 확인하려면 플랫폼별 디렉터리 경로를 참조하십시오. ### Linux 디렉터리 구조 \`\`\` `/opt/tableau/tabrmt/ # Install root` +`-- master/ # Master application binaries` `+-- agent/ # Agent application binaries` `+-- prerequisites/ # Bundled dependencies` `/var/opt/tableau/tabrmt/ # Data root` `+-- master/config/ # config.json, setup.json` `+-- master/logs/ # Application logs` `+-- data/postgresql15/ # PostgreSQL data files` `+-- data/rabbitmq313/ # RabbitMQ data/mnesia` `+-- data/ssl/ # TLS certificates` `/etc/opt/tableau/tabrmt/` `+-- master/environment.bash # Master environment variables` `+-- agent/environment.bash # Agent environment variables` \`\`\` ### Windows 디렉터리 구조 \`\`\` `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\ # Install root` `C:\ProgramData\Tableau\Tableau Resource Monitoring Tool\ # Data root` \`\`\` ### 필수 네트워크 포트
포트서비스방향
80RMT 웹 UI(HTTP)인바운드
443RMT 웹 UI(HTTPS)인바운드
5672RabbitMQ AMQPRMT 서버에서 인바운드
5671TLS를 통한 RabbitMQ AMQPRMT 서버에서 인바운드
15672RabbitMQ 관리 UI로컬
25672RabbitMQ 상호 노드로컬
5555내부 PostgreSQL로컬
[주요 콘텐츠로 건너뛰기](#main-content) # RMT 에이전트 초기화 스크립트 옵션 RMT 에이전트를 설치한 후 에이전트를 초기화해야 합니다. 기본적으로 초기화 스크립트를 실행할 때 포함해야 하는 유일한 필수 플래그는 `--accepteula`입니다. 다른 옵션은 환경과 기업의 보안 요구 사항에 따라 설치를 사용자 지정하는 데 유연성을 제공하기 위한 것입니다. ## RMT 에이전트 초기화 옵션 \--accepteula 필수 항목입니다. EULA(최종 사용자 사용권 계약)의 조건을 읽고 이에 동의했는지 나타냅니다. \-a 선택 사항입니다. 제공된 사용자 이름을 초기화 스크립트를 실행하는 사용자 대신 해당하는 그룹에 추가합니다. 그러면 그룹이 소유한 리소스에 대한 액세스 권한이 사용자에게 부여됩니다. 이것은 '서비스 계정' 사용자 계정과 다릅니다. 기본값: 초기화 스크립트를 실행하는 사용자 \-f 선택 사항입니다. 경고 메시지 또는 배포 버전 확인을 우회합니다. \-h | -? 선택 사항입니다. 스크립트의 도움말 텍스트를 표시합니다. \-q 선택 사항입니다. 오류 및 경고를 제외한 출력을 표시하지 않고 억제합니다. \--debug 선택 사항입니다. 디버깅 목적으로 실행되는 각 명령을 인쇄합니다. 생성되는 출력이 방대합니다. \--default-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. Tableau RMT 에이전트에 대한 액세스 권한을 부여할 수 있는 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. \---disable-account-creation **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. 존재하지 않는 계정/그룹을 만들지 않습니다. 지정하는 경우 `--unprivileged-user` 매개 변수와 `--default-group` 및/또는 다른 `--rmt-<...>-group` 매개 변수의 조합도 지정해야 합니다. 이러한 매개 변수가 참조하는 사용자 ID 및 그룹이 이미 있어야 합니다. \--rmt-authorized-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. 설치 기반 설치 디렉터리 및 `install_dir/prerequisites` 폴더를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtagentapp`" 또는 `--default-group` 값 \--rmt-config-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/agent/config` 디렉터리를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtagentconfig`" 또는 `--default-group` 값 \--rmt-logs-group= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. `install_dir/agent/logs` 디렉터리를 소유한 그룹의 이름입니다. 지정하는 경우 `--unprivileged-user`도 지정해야 합니다. 기본값: "`rmtagentlogs`" 또는 `--default-group` 값 \--unprivileged-user= **버전:** 버전 2023.1.0에 추가되었습니다. 선택 사항입니다. Tableau RMT 에이전트를 실행하는 데 사용되는 권한이 없는 사용자 계정의 이름입니다. RMT를 초기화한 후에는 계정을 변경할 수 없습니다. 기본값: "`tabrmt-agent`" [주요 콘텐츠로 건너뛰기](#main-content) # RMT 제거 오류 문제 해결 RMT를 제거하려고 시도할 때 다음 오류가 발생할 수 있습니다. _하나 이상의 문제로 인해 설치하지 못했습니다. 문제를 해결한 다음 설치를 다시 시도하십시오._ 제거를 다시 시도하기 전에 문제를 진단하고 해결해야 합니다. 이를 수행하는 방법에 대한 자세한 내용은 다음 Tableau 기술 자료 문서 [RMT 제거 오류(영문)](https://kb.tableau.com/articles/Issue/error-one-or-more-issues-caused-the-setup-to-fail-please-fix-the-issues-and-then-retry-setup-with-rmt-uninstall?lang=ko-kr)를 참조하십시오. ## 이 작업을 수행할 수 있는 사용자 제거 문제를 해결하려면 컴퓨터의 관리자이자 Resource Monitoring Tool 관리자여야 합니다. [주요 콘텐츠로 건너뛰기](#main-content) # RMT(Resource Monitoring Tool) 서비스 Resource Monitoring Tool에는 Resource Monitoring Tool 마스터(RMT 서버) 및 RMT 에이전트라는 두 가지 기본 구성 요소가 있습니다. - RMT 마스터는 웹 인터페이스를 통해 Tableau Server의 데이터가 수집되고 제공되는 위치입니다. RMT를 구성하고 Tableau Server의 상태 및 성능을 모니터링 및 분석할 수 있는 위치이기도 합니다. - 에이전트는 Tableau Server 클러스터의 각 노드에서 실행되어 해당 노드의 성능 및 작업을 모니터링합니다. 이 항목에서는 RMT로 설치되는 서비스에 대해 설명합니다. 아래 표에는 RMT 서버 컴퓨터에 설치된 서비스와 RMT 에이전트 컴퓨터에 설치된 서비스가 나열되어 있습니다.
RMT 서버 서비스
이름목적로그 파일 위치

Windows: C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\

Linux: /var/opt/tableau/tabrmt/master/logs

참고: 로그 파일에 대한 자세한 내용은 Tableau Resource Monitoring Tool 로그 파일을 참조하십시오.

참고
호스트설치 중에 사용되며 다른 프로세스가 실행 중인지 확인하는 데에도 사용됩니다.Windows: host\YYYYMMDD.log

Linux: host/YYYMMDD.log

담당 작업:

  • 프로세스 감시자: 다른 프로세스가 실행 중인지 확인합니다.

  • 구성 파일 감시자: 구성 파일의 변경 사항을 감지하고 대응합니다.

백그라운더에이전트에서 보낸 정보를 처리하고 RMT가 수집한 postgres 데이터를 유지 관리합니다. 또한 관리자 명령줄 유틸리티도 제공합니다. 처리된 정보를 기반으로 인시던트와 알림을 생성합니다.Windows: background\YYYYMMDD-pts.log

Linux: background/YYYYMMDD-pts.log

담당 작업:

  • rmtadmin: 관리자를 위한 명령줄 기능을 제공하는 명령줄 유틸리티입니다.

  • 에이전트 데이터 처리: 다양한 에이전트의 데이터 수집 및 처리를 담당합니다.

  • TS 상태 폴링: 주기적으로 TS(Tableau Server) 상태를 폴링하여 시스템이 활성 상태이고 정상인지 확인합니다.

  • 인시던트 분석: 오류, 실패, 다양한 측정값의 임계값 도달 등 인시던트를 분석합니다.

  • 데이터 정리: 오래된 데이터를 정리하는 업무를 담당합니다.

  • 애드혹 그래프 정보 수집: 모니터링을 위해 필요한 데이터를 수집합니다.

  • 알림: 알림 및 인시던트에 대한 알림 보내기를 관리합니다.

  • 데이터 보관(사용 안 함): 리소스 확보나 규정 준수를 위해 오래된 데이터를 보관하는 것이 포함됩니다. 현재 사용하지 않도록 설정되어 있습니다.

디렉터일종의 조정 프로세스이며, 주요 담당 작업 중 하나는 Tableau Server에 라이선스 상태를 쿼리하고 시스템 전체 상태를 설정하는 것입니다.Windows: director\YYYYMMDD-pts.log

Linux: director/YYYYMMDD-pts.log

담당 작업:

  • 클러스터 상태: 서버 클러스터의 상태를 모니터링하고 시스템 전체 상태를 설정합니다.

  • 라이선스: Tableau Server에서 라이선스 상태를 쿼리합니다.

  • 그래프 스크래핑: 모니터링 및 보고를 위해 데이터를 추출합니다. 서버 데이터베이스에 액세스할 가능성이 높습니다.

  • 데이터베이스 업그레이드: 데이터베이스 스키마 또는 버전에 대한 업데이트를 처리합니다.

  • 일일 집계 처리: 보고서나 분석을 위해 데이터를 집계하는 등 일일 처리 작업을 실행합니다.

웹웹 서버를 실행합니다. 사용자 인터페이스를 제공합니다. 정보 수집을 위한 에이전트를 등록합니다.Windows: web\YYYYMMDD-pts.log

Linux: web/YYYYMMDD-pts.log

담당 작업:

  • 에이전트 등록: Tableau Server에서 데이터를 모니터링하거나 수집하는 에이전트의 등록을 관리합니다.

  • 구성 UI: 다양한 시스템 설정과 매개 변수를 구성하기 위한 사용자 인터페이스를 제공합니다.

  • 성과/작업/콘텐츠 UI: 사용자가 시스템에서 성과 메트릭, 작업 로그, 콘텐츠 관련 데이터를 볼 수 있는 UI를 제공합니다.

PostgreSQL로컬 데이터 리포지토리Windows: pgsql\*.log and *.csv

Linux: pgsql/*.log and *.csv

 
RabbitMQ메시지 브로커Windows: \master\logs\rabbitmq\*.log

Linux: master/logs/*.log

 
RMT 에이전트 서비스
이름목적로그 파일 위치

Windows: C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\

Linux: /var/opt/tableau/tabrmt/master/logs

참고: 로그 파일에 대한 자세한 내용은 Tableau Resource Monitoring Tool 로그 파일을 참조하십시오.

참고
호스트설치 중에 사용되며 다른 프로세스가 실행 중인지 확인하는 데에도 사용됩니다.Windows: host\YYYYMMDD.log

Linux: host/YYYYMMDD.log

담당 작업:

  • 프로세스 감시자: 다른 프로세스가 실행 중인지 확인합니다.

  • 구성 파일 감시자: 구성 파일의 변경 사항을 감지하고 대응합니다.

백그라운더에이전트에서 보낸 정보를 처리하고 RMT가 수집한 postgres 데이터를 유지 관리합니다. 관리자 명령줄 유틸리티도 제공합니다. 처리된 정보를 기반으로 인시던트와 알림을 생성합니다.Windows: background\YYYYMMDD-pts.log

Linux: background/YYYMMDD-pts.log

담당 작업:

  • rmtadmin: 관리자를 위한 명령줄 기능을 제공하는 명령줄 유틸리티입니다.

  • 로그 감시자: Tableau Server에서 로그로 보낸 정보를 처리합니다.

웹웹 서버를 실행합니다.

데이터 게시를 위해 마스터에 에이전트 등록을 수행합니다.

Windows: web\YYYYMMDD-pts.log

Linux: web/YYYMMDD-pts.log

 

[주요 콘텐츠로 건너뛰기](#main-content) # RMT(Tableau Resource Monitoring Tool) 응답 헤더 이 문서에서는 Tableau Resource Monitoring Tool에서 사용자 지정 응답 헤더를 설정하는 방법을 설명합니다. 이 기능은 2024년 8월 RMT 유지 관리 버전에서 추가되었습니다. 응답 헤더를 변경하려면 RMT를 다시 시작해야 합니다. **중요:** 응답 헤더를 변경하면 RMT가 중단될 수 있습니다. 헤더를 업데이트한 경우 변경 후 RMT가 제대로 작동하는지 확인하기 위해 테스트를 실시해야 합니다. ## 사용자 지정 응답 헤더 보기 및 업데이트 `rmtadmin get` 및 `rmtadmin set` 명령을 사용하여 사용자 지정 응답 헤더를 보고 변경할 수 있습니다. ### 모든 사용자 지정 응답 헤더 목록 가져오기 현재 설정된 사용자 지정 응답 헤더 목록을 보려면 다음 명령을 실행하십시오. rmtadmin get server:web:responseheaders 예를 들면 다음과 같습니다. \> rmtadmin get server:web:responseheaders server:web:responseHeaders:Access-Control-Allow-Origin = \* server:web:responseHeaders:Connection = Keep-Alive server:web:responseHeaders:X-Frame-Options = DENY server:web:responseHeaders:X-Cache-Info = not cacheable; meta data too large ### 특정 사용자 지정 응답 헤더의 값 가져오기 특정 사용자 지정 응답 헤더를 가져오려면 다음 명령을 실행하십시오. rmtadmin get server:web:responseheader: 예를 들면 다음과 같습니다. \> rmtadmin get server:web:responseheader:X-Frame-Options server:web:responseHeaders:X-Frame-Options = DENY 존재하지 않는 사용자 지정 응답 헤더를 가져오거나 설정하려고 하면 다음 오류가 표시됩니다. \> rmtadmin get server:web:responseheaders: \[ERR\] Config key not found. Key: server:web:responseHeaders: 여러 키를 가져올 수 있습니다. 모든 중복 항목은 삭제됩니다. 유효하지 않은 키는 끝에 나열됩니다. \> rmtadmin get server:web:responseheaders server:web:responseheaders:SomethingNew server:web:responseHeaders:Connection server:web:responseHeaders:Access-Control-Allow-Origin = \* server:web:responseHeaders:Connection = Keep-Alive server:web:responseHeaders:X-Frame-Options = DENY server:web:responseHeaders:X-Cache-Info = not cacheable; meta data too large \[ERR\] Config key not found. Key: server:web:responseheaders:SomethingNew ### 특정 사용자 지정 응답 헤더 설정 또는 업데이트 특정 사용자 지정 응답 헤더를 설정하거나 변경하려면 다음 명령을 실행하십시오. rmtadmin set server:web:responseheader: 예를 들면 다음과 같습니다. \> rmtadmin set server:web:responseheaders:X-Frame-Options = Allow Config value set successfully. Key: server:web:responseHeaders:X-Frame-Options server:web:responseHeaders:X-Frame-Options = Allow 헤더는 전체 헤더와 키-값 쌍(해당하는 경우)으로 구성된 문자열입니다. 예를 들어, 다음은 유지 제한 시간과 최대값을 설정합니다. rmtadmin set server:web:responseheader:connection "Keep-Alive: timeout=5, max=997" Config value set successfully. Key: server:web:responseHeaders:Connection server:web:responseHeaders:Connection = "Keep-Alive: timeout=5, max=997" ### 사용자 지정 응답 헤더 제거 \> rmtadmin set server:web:responseheaders:X-Frame-Options --remove Config value successfully removed. Key: server:web:responseHeaders:X-Frame-Options #### 일반 구성 값 제거 일반 구성 값은 제거할 수 없으며 제거하려고 하면 오류가 발생합니다. \> rmtadmin set db:username --remove \[ERR\] The --remove argument is not valid for this key. Key: db:username #### 사용자 지정 응답 헤더 값을 빈 값으로 설정 사용자 지정 응답 헤더를 제외한 모든 `rmtadmin set` 키에는 값을 포함해야 합니다. 사용자 지정 응답 헤더를 사용하면 키 값을 없음으로 설정할 수 있습니다. 다음 예에서는 X-Frame-Options 키를 빈 값으로 설정합니다. \> rmtadmin set server:web:responseheaders:X-Frame-Options Config value set successfully. Key: server:web:responseheaders:X-Frame-Options server:web:responseheaders:X-Frame-Options = 이는 X-Frame-Options 헤더를 제거하는 것과 다릅니다. 이를 수행하는 이유는 무엇입니까? RMT는 기본적으로 몇 가지 사용자 지정 응답 헤더를 생성하며, RMT가 헤더를 포함하지 못하게 하려면 키를 빈 값으로 설정하면 됩니다. 예를 들어 기본적으로 RMT는 `X-Frame-Options = Deny`를 사용하여 응답 헤더를 생성합니다. 이 경우 다음과 같이 X-Frame-Options에 사용자 지정 응답 헤더를 만들 수 있습니다. \> rmtadmin set server:web:responseheaders:X-Frame-Options ALLOW 기본값으로 돌아가려면 완전히 제거하거나 DENY로 설정하면 됩니다. \> rmtadmin set server:web:responseheaders:X-Frame-Options --remove 그러나 RMT가 아무것도 전송하지 않게 하려면 빈 값으로 설정하면 됩니다. \> rmtadmin set server:web:responseheaders:X-Frame-Options ## 잘못된 헤더 RMT에서는 잘못된 응답 헤더 설정이 허용됩니다. 지정한 응답 헤더가 유효하지 않은 경우 RMT는 경고를 표시하지만 값을 설정할 수 있도록 허용합니다. 응답 헤더를 업데이트한 후 RMT가 제대로 작동하는지 확인하는 것은 사용자의 책임입니다. 'responseheaders'를 설정할 수 없습니다. 응답 헤더 내에서는 개별 하위 키만 설정할 수 있습니다. rmtadmin set server:web:responseheaders \[ERR\] Key cannot be set: server:web:responseHeaders > [!IMPORTANT] > > **중요:** 응답 헤더를 _변경_한 후 RMT를 테스트하십시오. [주요 콘텐츠로 건너뛰기](#main-content) # RMT(Tableau Resource Monitoring Tool)에서 사용자 및 인증 관리 RMT를 설치할 때 구성 중에 관리자 사용자를 만들 수 있습니다. 이 사용자에게는 RMT 서버에서 모든 작업을 수행할 수 있는 사용 권한이 부여됩니다. 나중에 다른 사용자를 추가하고 RMT와 관련하여 수행할 수 있는 작업을 지정할 수 있습니다. ## 로컬 사용자 추가 RMT에 사용자를 추가하려면 Admin(관리) 메뉴를 클릭하고 Users(사용자)(환경을 구성하지 않은 경우 이 옵션을 사용하지 못할 수 있음)를 선택합니다. Resource Monitoring Tool에서 새 사용자를 추가하려면: 1. **Admin** 메뉴에서 Users을 선택합니다. 2. New User를 클릭합니다. 3. 사용자 이름, 비밀번호를 제공하고 서버 역할을 적용합니다. 4. Save를 클릭합니다. ## 위임된 사용자 추가 버전 2023.1부터 RMT에 로컬로 저장된 개별 비밀번호를 사용하는 대신 도메인 계정 자격 증명을 사용하여 사용자를 인증할 수 있습니다. 위임된 인증이 구성된 사용자가 RMT에 로그인하면 RMT가 사용자와 사용자가 입력한 비밀번호를 컴퓨터 OS(운영 체제)로 전달하여 확인합니다. **참고:** 버전 2025.2부터 위임된 인증에 PAM 인증을 사용할 수 있습니다. 자세한 내용은 [RMT(Tableau Resource Monitoring Tool)의 PAM 기반 인증](https://help.tableau.com/current/server/ko-kr/rmt-admin-authentication-PAM.htm)을 참조하십시오. Resource Monitoring Tool에서 위임된 새 사용자를 추가하려면: 1. **Admin** 메뉴에서 Users을 선택합니다. 2. New User를 클릭합니다. 기본값은 로컬 사용자입니다. 3. Operating System (Delegated)(운영 체제(위임됨))을 선택합니다. 4. Username(사용자 이름)을 제공합니다. 사용자 이름_만_ 입력해야 합니다. 도메인을 포함하지 마십시오. RMT에 로그인할 때 사용자는 표준 네트워크 비밀번호를 입력하게 됩니다. 그러면 OS가 이를 확인합니다. 5. 사용자에게 지정할 서버 역할을 선택합니다. 서버 역할에 대한 자세한 내용은 아래를 참조하십시오. 6. Save를 클릭합니다. ## 사용자 인증 변경 버전 2023.1.0 이상에서는 기존 사용자의 인증 유형을 변경할 수 있습니다. 기존 사용자의 인증을 변경하려면: 1. Edit(편집) 아이콘을 클릭합니다. 2. 원하는 Authentication Mode(인증 모드)를 선택합니다. - Operating System (Delegated)(운영 체제(위임됨)) 모드로 변경하는 경우 도메인 없이 사용자 이름만 입력하면 됩니다. 사용자는 로그인 시 자신의 비밀번호를 제공하게 됩니다. RMT에 저장된 기존 비밀번호는 삭제되어 복원할 수 없습니다. - RMT (Local)(RMT(로컬)) 모드로 변경하는 경우 사용자 이름과 비밀번호를 입력해야 합니다. 이는 RMT에 로컬로 저장됩니다. 3. 사용자에 대해 선택된 Server Roles(서버 역할)를 확인합니다. 4. **Save(저장)**를 클릭하여 변경 내용을 저장합니다. ## Tableau Resource Monitoring Tool의 서버 역할 Tableau Resource Monitoring Tool에는 사용자에게 할당하여 특정 작업을 수행하는 사용 권한을 부여할 수 있는 다양한 서버 역할이 있습니다. 다음 표에는 사용 가능한 역할과 각 역할이 사용자에게 허용하는 작업이 나와 있습니다. | 서버 역할 | 역할 설명 | | --- | --- | | 로그 번들 다운로드 | 로그 파일을 다운로드합니다. | | TDS 파일 다운로드 | **.tds** 파일을 다운로드합니다. | | 차지백 보고서 생성 | 차지백 보고서를 만듭니다. | | 서버/환경 관리 | 모든 구성을 업데이트하는 사용 권한이 있습니다. | | 사용자 관리 | 사용자를 만들고 편집합니다. | | 웹후크 관리 | Slack 알림 설정을 관리합니다. | ### 인증 문제 해결 사용자 로그인 및 인증 문제를 해결하는 방법에 대한 자세한 내용은 [사용자 인증 문제 해결](https://help.tableau.com/current/server/ko-kr/rmt-troubleshoot-user-signin.htm)을 참조하십시오. ## 이 섹션의 다른 문서 [주요 콘텐츠로 건너뛰기](#main-content) # rmtadmin 명령줄 유틸리티 Resource Monitoring Tool의 설치 폴더에는 명령줄 인터페이스인 `rmtadmin.cmd`가 있습니다. 기본 설치 폴더는 다음과 같습니다. - RMT 서버 `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\Master` - 에이전트: `%PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\agent` **참고:** 이러한 명령을 성공적으로 실행하려면 관리자로 명령 프롬프트를 실행해야 합니다. > `rmtadmin`은 **RMT 서버** 및 **에이전트** 설치에 모두 포함됩니다. 일부 명령은 RMT 서버 또는 에이전트 `rmtadmin` 명령줄 유틸리티의 사용 여부에 따라 달라질 수 있습니다. 예를 들어 `users` 명령은 _RMT 서버_에서만 작동합니다. `ziplogs` 명령은 어디서나 사용할 수 있지만 명령이 실행된 응용 프로그램의 로그 파일만 포함됩니다. 다음은 `rmtadmin` 명령줄에서 사용할 수 있는 명령입니다. **참고:** `rmtadmin` 명령은 위치 매개 변수와 옵션을 모두 사용합니다. 위치 매개 변수는 값만 사용하여 지정해야 합니다. 실제 키워드를 지정할 필요가 없습니다. option 키워드 및 값은 등호를 사용하여 지정해야 합니다. 예: `rmtadmin --