버전: 버전 2026.3.0에 추가되었습니다.

Tableau Server 버전 2026.3.0부터 서버 관리자는 Tableau Server에서 사용하는 자체 서명 인증서를 사용자 지정 인증서로 교체할 수 있습니다.Tableau Server에서 사용자 지정 인증서를 사용하도록 구성한 후 조정 서비스에 문제가 있는 경우(예: 만료된 인증서, 키 불일치 또는 더 이상 유효하지 않은 사용자 제공 체인 등) Tableau Server를 새로 설치하거나 기존 백업을 복원할 필요 없이 문제를 해결하려면 특별한 조치를 취해야 합니다.내부 서비스 통신에 사용자 지정 인증서를 사용하는 방법에 대한 자세한 내용은 Tableau Server에 내부 사용자 지정 인증서 구성을 참조하십시오.

노드별 recover-coordination-service-cert 도구를 사용하여 조정 서비스(ZooKeeper) mTLS 인증서 및 키 자료를 디스크에서 직접 교체합니다.모든 노드에 동일한 서버 및 클라이언트 인증서/키 쌍을 적용해야 합니다.

필수 요건

• 기존 Tableau Server 노드에서 root 사용자 또는 권한이 없는 Tableau 서비스 계정 사용자로 도구를 실행해야 합니다.

• 서버 인증서/키 쌍 하나와 클라이언트 인증서/키 쌍 하나를 준비합니다.선택적으로 체인 파일과 암호화된 키를 위한 암호를 사용할 수 있습니다.

사용자 지정 인증서 복구

1. 아직 인증서가 없는 경우 단일 노드에서 새로운 자체 서명 쌍을 생성한 후, 동일한 파일을 모든 노드에 복사하십시오.해당 쌍은 TSM이 내부적으로 생성하는 것과 동일한 형식(EC P-256, 자체 서명, CN=*)이어야 합니다.

   openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -days 1825 -nodes -subj "/CN=*" -keyout server.key -out server.crt

   openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -days 1825 -nodes -subj "/CN=*" -keyout client.key -out client.crt

   암호로 암호화된 키를 생성하려면 -nodes를 생략합니다.OpenSSL에서 암호 입력을 요청하면 해당 암호를 일치하는 --server-passphrase 또는 --client-passphrase 옵션과 함께 전달합니다.

2. 첫 번째 노드에서 복구 도구를 실행합니다.쿼럼이 다시 형성될 수 있도록 조정 서비스를 호스팅하는 노드부터 시작합니다.

   recover-coordination-service-cert --server-cert server.crt --server-key server.key --client-cert client.crt --client-key client.key [--server-chain <file.crt>] [--client-chain <file.crt>] [--server-passphrase <passphrase>] [--client-passphrase <passphrase>]

   이 도구는 작업을 중단하기 전에 입력값을 사전 검증합니다. 즉, 인증서가 X.509 형식인지, 제공된 암호로 키를 해독할 수 있는지, 그리고 제공된 체인의 첫 번째 인증서가 리프 인증서의 발급자인지 확인합니다.그런 다음 로컬 서비스를 중지하고 모든 서비스의 구성 및 키 저장소를 패치한 후 제어부 서비스를 다시 시작합니다(먼저 ZooKeeper부터 시작해 관리 에이전트, 나머지 서비스 순).

3. 동일한 인증서 및 키 파일을 사용하여 나머지 모든 노드에서 정확히 같은 명령을 실행하십시오.조정 서비스를 호스팅하는 노드를 먼저 복구한 다음 나머지 노드를 복구합니다.도구가 모든 노드에서 실행되기 전까지 클러스터 복구는 완료되지 않으며, 여전히 이전 키 저장소를 보유하고 있는 노드는 다시 조인되지 않습니다.

   참고: 이 단계에서는 tsm status에 비즈니스 서비스가 오류 상태로 표시됩니다.이는 예상된 동작입니다.이 도구는 서비스에 패치를 적용하지만 서비스를 시작하지는 않습니다.다음 단계의 set 명령으로 서비스를 시작합니다.

4. 모든 노드가 완료된 후 컨트롤러 또는 초기 노드에서 다음 set 명령을 한 번 실행하여 조정 서비스의 영구 구성을 현재 디스크의 구성과 동기화합니다.

   tsm security coordination-service-internal-cert set --server-cert server.crt --server-key server.key --client-cert client.crt --client-key client.key [--server-chain <file.crt>] [--client-chain <file.crt>] [--server-passphrase <passphrase>] [--client-passphrase <passphrase>]

   복구 도구는 사용자가 전달한 경로가 미리 입력된 이 명령을 출력합니다.암호 옵션을 다시 추가하라는 알림은 표시하지만 암호 값 자체는 출력하지 않습니다.이 명령의 동일 인증서 단축 경로는 구성을 동기화하고 중지된 비즈니스 서비스를 포함한 전체 클러스터를 다시 시작하여 오류 상태를 해소합니다.

문제 해결: 실행할 때마다 구조화된 로그가 ${TABLEAU_SERVER_DATA_DIR}/logs/app-recover-coordination-service-cert.log에 기록됩니다.

참고: Windows에서는 동일한 옵션을 사용하고 동일하게 동작하는 recover-coordination-service-cert.cmd 래퍼를 사용할 수 있습니다.