Linux 기반 Tableau Server 도움말

초기 노드(TSM이 설치된 노드) 또는 클러스터의 모든 추가 노드에서 tsm 명령을 실행할 수 있습니다.

tsm 명령을 실행하려면 명령 프롬프트를 열어야 합니다.

1. 클러스터의 노드에서 tsmadmin 그룹의 멤버인 계정을 사용하여 명령 프롬프트를 엽니다.

2. 원하는 명령을 실행합니다. 초기 노드가 아닌 다른 노드에서 명령을 실행하는 경우 -s 옵션을 포함하여 이름(IP 주소 아님)으로 초기 노드의 URL을 지정하고 TSM 포트 8850을 포함하십시오.

   초기 노드에서 TSM 및 Tableau Server의 버전을 확인하려면

   tsm version

   추가 노드에서 TSM 및 Tableau Server의 버전을 확인하려면

   tsm version -s https://<inital_node_name>:8850

   예를 들면 다음과 같습니다.

   tsm version -s https://myTableauHost:8850

backgrounder.failure_threshold_for_run_prevention

기본값: 5

구독, 추출 또는 흐름 실행 작업을 일시 중단하기 전에 작업이 연속적으로 실패한 횟수입니다. 연속적으로 실패한 작업을 일시 중단하면 백그라운더 리소스를 다른 작업에 사용할 수 있습니다. 실패한 백그라운드 작업이 보류되지 않도록 하려면 이 값을 -1로 설정합니다.

backgrounder.log.level

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

기본값: info

백그라운더 프로세스의 로그 수준입니다. 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

backgrounder.restrict_serial_collections_to_site_level

기본값: false

Tableau Server에서 추출 새로 고침, 구독 또는 흐름을 주기적으로 실행하도록 예약할 수 있습니다. 이러한 예약된 항목을 태스크라고 합니다. 백그라운더 프로세스는 이러한 작업의 고유한 인스턴스를 초기화하고 예약된 시간에 실행합니다. 결과로 초기화되는 고유한 태스크 인스턴스를 작업이라고 합니다.

이 설정은 연속으로 실행되도록 구성된 일정에 영향을 줍니다. 기본적으로 일정을 순차적으로 실행하도록 구성하면 해당 일정을 사용하는 모든 작업이 순차적으로 실행됩니다. 이 설정을 true로 설정하면 다른 사이트에서 실행되는 작업을 동시에 실행할 수 있습니다. 같은 사이트에서 예약된 태스크에 대한 작업은 계속해서 순차적으로 실행됩니다.

아래 예는 이 시나리오를 보여줍니다.

Tableau Server에는 매일 오전 7시에 작업을 실행할 수 있는 "Daily"라는 일정이 포함되어 있습니다. "Daily" 일정은 순차적으로 실행되도록 구성됩니다. "HR" 사이트 및 "Payroll" 사이트에는 각각 "Daily" 일정을 사용하는 여러 개의 예약된 태스크가 있습니다. 이 설정을 true로 설정하면 "HR" 사이트의 이러한 예약된 태스크에 대한 작업이 "Payroll" 사이트의 작업과 동시에 실행될 수 있지만 동일한 사이트의 작업은 계속 순차적으로만 실행됩니다.

backgrounder.timeout.single_subscription_notify

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

기본값: 1800초(30분)

단일 구독 작업을 완료하는 데 허용되는 최대 시간(초)입니다.

backgrounder.timeout.sync_ad_group

버전: 버전 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1에 추가되었습니다.

기본값: 14400초(4시간)

Active Directory 그룹 동기화를 완료하는 데 허용되는 최대 시간(초)입니다. 백그라운더 서비스를 통해 수행되는 예약 그룹 동기화에 적용되며 오래 실행되는 동기화의 무기한 실행을 방지합니다. Tableau Server UI 또는 REST API를 사용하여 수행되는 그룹 동기화는 영향을 받지 않습니다.

backgrounder.vInstances_max_overflow_queue_size

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

기본값: 1000

보조 큐에 포함할 수 있는 작업의 최대 수입니다. 보조 큐는 실행 중인 작업 수가 설정된 동시 제한에 도달할 때 만들어집니다. 기본 최대값은 1,000개 작업으로 설정됩니다. 즉, 동시 제한에 도달할 때 1,000개가 넘는 작업이 있으면 1,000를 초과하는 모든 작업은 큐에 대기되지 않습니다. backgrounder.vInstance_max_overflow_queue_size tsm 명령을 사용하면 오버플로 최대 큐 크기를 변경할 수 있습니다.

값은 정수로 지정해야 합니다.

backup.zstd.thread_count

버전: 버전 2021.1.0에 추가되었습니다. 이 키는 동적으로 구성 가능합니다. 자세한 내용은 Tableau Server 동적 토폴로지 변경을 참조하십시오.

기본값: 2

백업을 만들 때 사용해야 하는 스레드 수입니다.

이 수를 늘리면 백업 성능을 개선할 수 있지만 스레드 수는 Tableau Server 컴퓨터의 논리적 프로세서 수(최대 4개)를 초과하지 않는 것이 좋습니다.

basefilepath.backuprestore

기본값: /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

이 위치에 tsm maintenance backup 명령이 백업을 만듭니다. tsm maintenance restore 명령이나 tsm maintenance send-logs 명령을 사용하여 복원할 때에도 이 위치에 백업 파일이 있어야 합니다. 설정한 후 tsm maintenance validate-backup-basefilepath 명령(버전 2022.1 이상에서 사용 가능)을 실행하여 해당 위치에 대한 사용 권한이 올바르게 설정되었는지 확인해야 합니다. 자세한 내용은 tsm 파일 경로를 참조하십시오.

basefilepath.log_archive

기본값: /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

이 위치에 tsm maintenance ziplogs 명령이 압축된 아카이브를 만듭니다. 자세한 내용은 tsm 파일 경로를 참조하십시오.

basefilepath.site_export.exports

기본값: /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports/

이 위치에 tsm sites export 명령이 내보내기 파일을 만듭니다. 자세한 내용은 tsm 파일 경로를 참조하십시오.

basefilepath.site_import.exports

기본값: /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/

이 위치에서 tsm sites import 명령이 가져오기 파일을 찾습니다. 자세한 내용은 tsm 파일 경로를 참조하십시오.

clustercontroller.log.level

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

기본값: info

클러스터 컨트롤러에 대한 로그 수준입니다. 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

databaseservice.max_database_deletes_per_run

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

기본값: null

이 옵션을 사용하면 features.DeleteOrphanedEmbeddedDatabaseAsset에서 제어하는 백그라운더 프로세스가 실행될 때마다 삭제할 수 있는 내장된 외부 자산(데이터베이스 및 테이블)의 최대 수를 조정할 수 있습니다. 이 옵션을 비워 두면 삭제할 수 있는 내장된 외부 자산의 기본 최대 개수는 100개입니다.

자세한 내용은 features.DeleteOrphanedEmbeddedDatabaseAsset를 참조하십시오.

dataserver.log.level

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

기본값: info

데이터 서버에 대한 로그 수준입니다. 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

excel.shadow_copy_all_remote.enabled

버전: 버전 2019.1.5, 2019.2.1에 추가되었습니다.

기본값: false

Tableau Server가 라이브 데이터 원본으로 사용되고 있는 공유 Excel 스프레드시트(.xlxs 또는 .xlxm)의 "섀도 복사본"을 만들지 여부를 제어합니다. 이 옵션을 사용하도록 설정하면 Excel 사용자에게 "공유 위반 오류"와 파일이 "현재 사용 중"이라는 메시지가 나타나지 않습니다. 이 옵션은 대규모 Excel 파일의 성능에 영향을 미칠 수 있습니다. Excel 사용자가 공유 파일을 편집할 필요가 없다면 이 옵션을 사용할 필요가 없습니다.

참고: Tableau Server는 항상 .xls 파일의 섀도 복사본을 만들려고 합니다. 이 옵션은 이 동작을 변경하지 않습니다.

extractservice.command.execution.timeout

버전: 버전 2021.4에 추가됨

기본값: 7200초

VConn 추출 새로 고침 실행 시간에 대한 시간 초과 값을 설정합니다.

예: tsm configuration set -k extractservice.command.execution.timeout -v <timeout_in_seconds> --force-keys

참고: 이 값을 변경하려면 --force-keys 옵션을 사용해야 합니다.

features.ActiveMQ

버전: 버전 2021.4에 추가됨

기본값: true

Tableau Server가 내부 메시징 메커니즘에 Apache ActiveMQ 서비스(Tableau Server 메시징 서비스)를 사용할지 여부를 제어합니다.

features.DeleteOrphanedEmbeddedDatabaseAsset

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

기본값: true

다운스트림 Tableau 콘텐츠와 더 이상 연관되지 않은 내장된 외부 자산(데이터베이스 및 테이블)을 삭제하는 Tableau Catalog(또는 Tableau Metadata API)의 백그라운더 프로세스를 제어합니다. 이 프로세스는 매일 22:00:00 UTC(협정 세계시)에 실행되며 다운스트림 Tableau 콘텐츠를 연결하지 않고도 남아 있는 외부 자산이 없을 때까지 매일 최대 100개의 외부 자산을 삭제할 수 있습니다. 이 옵션을 false로 설정하여 이 프로세스의 실행을 중지할 수 있습니다. 또는 databaseservice.max_database_deletes_per_run을 사용하여 삭제할 수 있는 최대 외부 내장 자산 수를 조정할 수도 있습니다.

자세한 내용은 누락된 콘텐츠 문제 해결을 참조하십시오.

features.IdentityMigrationBackgroundJob

버전: 버전 2022.1에 추가되었습니다. 기본값이 버전 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 및 2023.3에서 false로 변경되었습니다.

기본값: false

ID 마이그레이션을 수행하는 프로세스를 제어합니다. true로 설정하면 Tableau Server를 버전 2022.1 이상으로 업그레이드하고 Tableau Server 버전 2021.4 이하의 백업을 복원한 직후 기존 배포에서 ID 마이그레이션이 실행됩니다. 마이그레이션을 사용하지 않으려면 false(기본값)로 설정하십시오.

예를 들어 ID 마이그레이션을 시작하려면 다음을 실행합니다.

tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

자세한 내용은 ID 마이그레이션 정보를 참조하십시오.

참고: ID 마이그레이션을 사용하지 않도록 설정하면 Tableau Server는 ID 서비스를 사용하여 사용자 ID 정보를 저장하고 관리할 수 없습니다. ID 풀과 같은 특정 기능을 사용하려면 ID 서비스 사용이 전제되어야 합니다.

features.IdentityPools

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

기본값: false

새 Tableau Server를 설치하는 경우 사용하도록 설정해야 하는 ID 풀 기능의 구성 요소입니다. feature.NewIdentityMode 및 wgserver.authentication.legacy_identity_mode.enabled가 필요합니다. ID 풀을 사용하도록 설정하려면 true로 설정하십시오. ID 풀을 사용하지 않으려면 false(기본값)로 설정하십시오.

예를 들어 ID 풀을 사용하도록 설정하려면 다음을 실행합니다.

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

자세한 내용은 ID 풀 문제 해결를 참조하십시오.

features.MessageBusEnabled

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

기본값: true

Tableau Server가 새 내부 메시징 메커니즘을 사용할지 여부를 제어합니다.

features.NewIdentityMode

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

기본값은 false입니다. 2023.1.6에서 기본값이 true에서 false로 변경되었습니다.

ID 풀 기능의 필수 조건입니다. ID 풀을 사용하지 않으려면 wgserver.authentication.legacy_identity_mode.enabled가 false로 설정되어 있어야 합니다. ID 풀을 사용하지 않도록 설정하려면 true로 설정하십시오.

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

자세한 내용은 ID 풀 문제 해결를 참조하십시오.

features.PasswordlessBootstrapInit

기본값: true

Tableau Server에서 부트스트랩 파일의 내장된 자격 증명을 허용할지 여부를 제어합니다. 사용(기본값)하는 경우 포함하지 않도록 지정하지 않는 한 내장된 자격 증명이 부트스트랩 파일에 포함됩니다. 생성된 부트스트랩 파일에 자격 증명을 포함하지 않으려면 false로 설정합니다. 부트스트랩 파일에 대한 자세한 내용은 tsm topology nodes get-bootstrap-file을 참조하십시오.

이 옵션은 Tableau Server 버전 2019.3에서 추가되었습니다.

features.PasswordReset

버전: 버전 2024.2에서 사용 중지되었습니다. 버전 2024.2 이상에서는 vizportal.password_reset을 사용하십시오.

기본값: false

로컬 인증을 사용하는 서버에만 적용됩니다. true로 설정하면 사용자가 로그인 페이지에서 "비밀번호 잊음" 옵션을 사용하여 비밀번호를 재설정할 수 있게 됩니다.

filestore.empty_folders_reaper.enabled

버전: 2020.x(2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2) 및 2021.1.x에 추가되었습니다. 2021.2에서 기본값이 true로 변경되었습니다.

기본값: true

비어 있는 Filestore 폴더를 "재확보"(제거)하는 작업을 사용하도록 설정합니다.

filestore_empty_folders_reap.frequency_s

버전: 2020.x(2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2)에 추가되었습니다.

기본값: 86400(24시간)

빈 파일 저장소 폴더를 제거하는 작업을 실행하는 빈도를 분 단위로 지정합니다.

features.Hyper_DisallowTDEPublishing

버전: 버전 2023.1.0부터 기본적으로 true 값으로 설정됩니다. Tableau Server 2024.2에서 사용 중단되었습니다.

기본값: true

사용자가 .tde 형식 파일을 업로드할 수 있는지 여부를 지정합니다. 이 형식은 Tableau Server 버전 10.5부터 .hyper 형식으로 대체되었지만 업로드가 차단되지는 않았습니다. 버전 2024.3부터 .tde 형식 파일을 더 이상 사용할 수 없습니다. 여러 동작 중 하나를 수행하는 경우 이 파일은 .hyper 형식으로 자동 변환되었습니다. 자세한 내용은 .hyper 형식으로 추출 업그레이드를 참조하십시오.

filestore.log.level

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

기본값: info

파일 저장소에 대한 로그 수준입니다. 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

filestore.reapemptyfoldersholdoffms

버전: 2020.x(2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2)에 추가되었습니다. 이는 아직 2021.1에서 사용할 수 없습니다.

기본값: 300000(5분)

빈 파일 저장소 폴더를 제거하기 전까지 대기할 시간(밀리초)을 지정합니다.

floweditor.max_datafile_upload_size_in_kb

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

기본값: 1048576

Tableau Prep 흐름 웹 작성에서 Tableau Server에 업로드할 수 있는 구분 기호로 분리된 텍스트 파일(예: CSV 또는 TXT)의 최대 크기입니다.

gateway.external_url

버전: 버전 2023.1에 추가됨

기본값: Null

Tableau Server 설치 중에 TSM에서 OIDC(OpenID Connect) 인증을 구성하거나 ID 풀을 사용하는 경우 필요합니다. IdP(ID 공급자)에서 Tableau 인증 사용자를 리디렉션할 때 사용할 Tableau Server URL을 지정합니다. 게이트웨이 외부 URL은 IdP 리디렉션 URL로 지정한 것과 동일한 URL이며 일치하는지 확인할 목적으로 사용됩니다.

예를 들어 OIDC 인증 구성에 연결된 IdP를 Tableau Server(http://myco)로 리디렉션하려면 다음 명령을 실행합니다.

tsm configuration set -k gateway.external_url -v http://myco

gateway.http.hsts

기본값: false

HSTS(HTTP Strict Transport Security) 헤더가 있으면 HTTPS를 사용하도록 설정된 도메인에서 브라우저가 HTTPS를 사용합니다.

gateway.httpd.loglevel

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

기본값: notice

게이트웨이(Apache HTTPD 서버)의 로그 수준을 지정합니다. 기본적으로 notice로 설정됩니다. 다른 옵션으로는 debug, info, warning, error가 있습니다. 로그 수준을 변경하는 경우 디스크 공간 사용량 및 성능에 대한 잠재적 영향을 숙지하십시오. 모범 사례는 필요한 정보를 수집한 후 로그 수준을 기본값으로 되돌리는 것입니다. Apache 로깅에 대한 자세한 내용은 Apache HTTP 설명서(링크가 새 창에서 열림)를 참조하십시오.

gateway.httpd.shmcb.size

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

기본값: 2048000

shmcb 저장소 유형을 사용할 때 순환 버퍼의 메모리 양을 바이트로 지정합니다. 이 구성 키는 dbm저장소 유형을 사용하는 경우 적용되지 않습니다.

gateway.httpd.socache

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

기본값: shmcb

global/inter-process SSL 세션 캐시의 저장소 유형을 지정합니다. 기본적으로 shmcb로 설정되며 다른 구성 옵션 dbm을 사용할 수 있습니다. shmcb 및 dbm 저장소 유형에 대한 자세한 내용은 Apache 웹 사이트에서 SSLSessionCache 지시문(영문)(링크가 새 창에서 열림)을 참조하십시오.

gateway.log.level

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

기본값: info

게이트웨이에 대한 로그 수준입니다. 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

hyper.log_queries

기본값: true

true로 설정하면 쿼리 정보가 로깅됩니다.

기본적으로 쿼리 정보는 로깅됩니다. 하지만 로그 파일이 사용 가능한 디스크 공간의 양에 비해 너무 큰 경우 이 옵션을 false로 설정하여 쿼리 정보 로깅을 사용하지 않도록 설정할 수 있습니다. 이 구성은 true로 설정된 상태로 두는 것이 좋습니다.

hyper.session_memory_limit

기본값: 0(제한 없음을 의미함)

개별 쿼리가 사용할 수 있는 최대 메모리 사용량을 제어합니다. 바이트 단위로 지정합니다. 킬로바이트를 나타내려면 값에 'k' 문자를, 메가바이트를 나타내려면 'm' 문자를, 기가바이트를 나타내려면 'g' 문자를, 테라바이트를 나타내려면 't' 문자를 추가합니다.

예를 들어 메모리 제한을 900메가바이트로 설정하려면 다음 명령을 실행합니다.

tsm configuration set -k hyper.session_memory_limit -v 900m.

또는 세션 메모리 제한을 사용 가능한 총 시스템 메모리의 백분율로 지정하려면 다음 명령을 실행합니다.

tsm configuration set -k hyper.session_memory_limit -v 90%.

한 쿼리가 과도한 양의 메모리를 사용하여 다른 쿼리들이 긴 시간 동안 장애 조치되는 경우 이 값을 낮추면 도움이 될 수 있습니다. 이 제한을 낮추면 대규모 단일 쿼리는 실패(또는 스풀링을 해제하지 않은 경우 스풀링)하고 다른 쿼리에 부정적인 영향을 주지 않습니다.

hyper.srm_cpu_limit_percentage

기본값은 75(퍼센트)입니다.

Hyper에서 허용하는 시간당 최대 평균 CPU 사용량을 지정합니다. 초과할 경우 컴퓨터의 다른 프로세스에 대한 영향을 최소화하기 위해 데이터 엔진이 자동으로 다시 시작됩니다.

기본적으로 데이터 엔진은 한 시간 동안 평균 CPU 사용량이 75% 이상인 경우 자동으로 다시 시작됩니다. 이 값은 Tableau 지원 팀과 작업할 때 또는 전용 서버 노드에서 데이터 엔진을 실행할 때를 제외하고는 변경하면 안 됩니다. 데이터 엔진이 전용 노드에서 실행 중인 경우 사용 가능한 컴퓨터 하드웨어를 최대한 활용할 수 있도록 이 값을 95%로 늘려도 안전합니다. 전용 노드에서 데이터 엔진을 실행하는 방법에 대한 자세한 내용은 추출 쿼리가 많은 환경 최적화를 참조하십시오.

이를 95%로 늘리려면:

tsm configuration set -k hyper.srm_cpu_limit_percentage -v 95 --force-keys

tsm pending-changes apply

이를 기본값인 75%로 재설정하려면:

tsm configuration set -k hyper.srm_cpu_limit_percentage -v 75 --force-keys

tsm pending-changes apply

hyper_standalone.consistent_hashing.enabled

기본값: true

쿼리의 추출이 이미 캐시되어 있을 확률을 높입니다. 추출이 캐시되어 있는 노드가 추가적인 로드를 지원할 수 없는 경우 새 노드로 라우팅되고 새 노드의 캐시에 추출이 로드됩니다. 이렇게 하면 로드에 따라 필요한 경우에만 추출이 메모리에 로드되기 때문에 시스템 사용률을 개선할 수 있습니다.

indexandsearchserver.vmopts

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

기본값: "-Xmx<default_value> -Xms<default_value>"

기본값은 시스템 메모리 양을 기준으로 하며 전체 시스템 RAM의 3.125%입니다.

인덱스 및 검색 서버 힙 크기를 제어합니다. 기본값은 크기가 자동으로 조정되므로 반드시 필요한 경우에만 이 옵션을 사용하여 기본값을 재정의하십시오. 값에 'k' 문자를 추가하여 킬로바이트를 나타내거나, 'm'을 추가하여 메가바이트를 나타내거나, 'g'를 추가하여 기가바이트를 나타냅니다. 일반적인 원칙으로, 초기 힙 크기(-Xms)를 최대 힙 크기(-Xmx)와 같게 설정하여 가비지 수집을 최소화합니다.

jmx.security.enabled

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

기본값: false

JMX는 기본적으로 사용되지 않도록 설정되므로 보안 secure JMX도 사용되지 않습니다. JMX를 사용하는 경우 보안 JMX를 사용하도록 설정하는 것이 좋습니다.

tsm maintenance jmx enable 명령을 실행한 후 JMX의 보안 기능을 사용하겠냐는 질문에 y로 답하면 true로 설정되고 읽기 전용 액세스에 SSL 및 기본 사용자 이름/비밀번호 인증과 함께 보안 JMX가 사용됩니다.

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.ssl.enabled

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

기본값: true

JMX에 대해 SSL을 적용합니다. 이 옵션은 기본적으로 true로 설정되지만 jmx.security.enabled를 true로 설정하지 않으면 효과가 없습니다. JMX 보안을 사용하도록 설정하려면 tsm maintenance jmx enable 명령을 실행합니다. 메시지가 표시되면 y를 입력하여 SSL을 사용하는 상태로 유지하거나 n을 입력하여 SSL을 사용하지 않도록 설정합니다.

tsm maintenance jmx enable
...
Would you like to enable SSL?
(y/n): n

jmx.ssl.require_client_auth

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

기본값: false

tsm maintenance jmx enable 명령을 실행한 후 클라이언트 인증(mTLS)을 요구하겠냐는 질문에 y로 답하면 true로 설정됩니다.

tsm maintenance jmx enable
...
Would you like to require client authentication (mTLS)?
(y/n): y

구성을 완료하려면 클라이언트 인증서가 있어야 하고 이 인증서를 클라이언트 컴퓨터의 올바른 위치에 배치해야 합니다.

jmx.ssl.user.name

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

기본값: tsmjmxuser

Tableau Server를 설치하거나 업그레이드할 때 설정됩니다.

jmx.ssl.user.password

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

기본값: <generated>

Tableau Server를 설치하거나 업그레이드할 때 설정됩니다.

jmx.user.access

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

기본값: readonly

tsm maintenance jmx enable 명령을 실행한 후 readwrite 액세스를 추가하겠냐는 질문에 y로 답하면 이 값을 readwrite로 변경할 수 있습니다.

tsm maintenance jmx enable
...
JMX access is readonly by default. Would you like to add readwrite access?
(y/n): y

licensing.login_based_license_management.default_requested_duration_seconds

기본값: 0

다시 활성화하라는 메시지를 표시하기 전에 Tableau Server에 대한 연결 없이 사용자의 로그인 기반 라이선스가 오프라인일 수 있는 기간(초)을 설정합니다. 이 기간은 Tableau Desktop이 사용 중이며 Tableau Server에 연결할 수 있을 때 항상 새로 고쳐집니다.

licensing.login_based_license_management.enabled

기본값: true

로그인 기반 라이선스 관리를 사용하려면 true로 설정합니다. 로그인 기반 라이선스 관리를 사용하지 않으려면 false로 설정합니다.

참고: 로그인 기반 라이선스 관리를 사용하려면 로그인 기반 라이선스 관리를 사용하도록 설정된 제품 키를 활성화합니다. tsm licenses list를 사용하여 로그인 기반 라이선스 관리를 사용하도록 설정된 제품 키를 확인할 수 있습니다.

licensing.login_based_license_management.max_requested_duration_seconds

기본값: 7776000

Tableau를 다시 활성화하라는 메시지를 표시하기 전에 Tableau Server에 대한 연결 없이 사용자의 로그인 기반 라이선스가 오프라인일 수 있는 최대 기간(초)을 설정합니다. 최대값은 7776000초(90일)입니다. 이 기간은 Tableau Desktop이 사용 중이며 Tableau Server에 연결할 수 있을 때 항상 새로 고쳐집니다.

metadata.ingestor.blocklist

기본값: null

구성된 경우 Tableau Catalog는 지정된 콘텐츠가 수집되지 않도록 차단합니다. 차단할 콘텐츠를 지정하려면 서버 "비대화형" 로그 파일에서 차단할 콘텐츠의 사이트 ID, 콘텐츠 유형 및 콘텐츠 ID의 조합인 차단 목록 값을 식별해야 합니다. 차단 목록 값은 쉼표로 구분해야 합니다.

중요: Tableau 지원 부서에서 요청하는 경우에만 이 옵션을 사용해야 합니다.

예를 들어 다음 명령과 같이 tsm configuration set --force-keys -k metadata.ingestor.blocklist를 사용하여 데이터 원본, 통합 문서 및 흐름 조합의 수집을 차단할 수 있습니다.

tsm configuration set --force-keys -k metadata.ingestor.blocklist -v "sites/1/datasources/289, sites/2/datasources/111, sites/1/workbooks/32, sites/3/workbooks/15, sites/1/flows/13, sites/1/flows/18”

차단된 콘텐츠의 유효성을 검사하려면 서버 "비대화형" 로그 파일에서 다음 이벤트를 검토합니다.

• Skipping ingestion for
• Successfully updated blocklist to

예를 들면 다음과 같습니다.

Skipping ingestion for contentType [Workbook], contentId [sites/1/datasources/289], siteDisabled [false], swallowEvent [false], contentBlocked [true]

Skipping ingestion for contentType [Workbook], contentId [sites/3/workbooks/15], siteDisabled [false], swallowEvent [false], contentBlocked [true]

및

Successfully updated blocklist to: [sites/1/datasources/289, sites/1/workbooks/32, sites/2/datasources/111]

metadata.ingestor.pipeline.throttleEventsEnable

기본값: false

Eventing이라고도 하는 새 콘텐츠 및 업데이트된 콘텐츠의 인덱싱이 서버의 모든 사이트에 대해 조절되는지 여부를 제어합니다. 기본적으로 이벤트 조절은 해제됩니다. 이벤트 조절을 설정하려면 다음 명령을 사용하여 이 설정을 true로 변경합니다. 

tsm configuration set -k metadata.ingestor.pipeline.throttleEventsEnable -v true --force-keys

이벤트 조절에 대한 자세한 내용은 Tableau Catalog 사용을 참조하십시오.

metadata.ingestor.pipeline.throttleLimit

기본값: 20

이벤트 조절이 사용되는 경우 이 값은 지정된 기간 동안 인덱싱할 수 있는 새 콘텐츠 항목 및 업데이트된 콘텐츠 항목의 최대 수입니다. 특정 항목에 대한 지정된 제한에 도달하면 인덱싱이 연기됩니다.

기본적으로 이 제한은 20로 설정되며 2 미만으로 설정할 수 없습니다. 다음 명령을 사용하여 이 제한을 변경할 수 있습니다. 

tsm configuration set -k metadata.ingestor.pipeline.throttleLimit -v 25 --force-keys

정체된 이벤트는 서버의 "비대화형" 로그 파일에서 ingestor event flagged for removal by throttle filter로 식별할 수 있습니다.

metadata.ingestor.pipeline.throttlePeriodLength

기본값: 20

이벤트 조절이 사용되는 경우 이 값은 지정된 최대 수의 새 콘텐츠 항목과 업데이트된 콘텐츠 항목을 인덱싱할 수 있는 기간(분)입니다. 지정된 시간에 도달하면 추가적인 모든 새 콘텐츠 및 업데이트된 콘텐츠의 인덱싱이 연기됩니다.

기본적으로 이 시간은 30분으로 설정되어 있습니다. 다음 명령을 사용하여 이 시간을 변경할 수 있습니다.

tsm configuration set -k metadata.ingestor.pipeline.throttlePeriodLength -v PT45M --force-keys

metadata.query.limits.time

기본값: 20

Catalog 또는 Metadata API 쿼리가 실행될 수 있는 최대 허용 시간(초)입니다. 이 시간이 지나면 시간 초과가 발생하고 쿼리가 취소됩니다. 다음 명령을 사용하여 시간 초과 제한을 점진적으로 늘리되 60초를 넘지 않도록 하는 것이 좋습니다.

tsm configuration set -k metadata.query.limits.time –v PT30S --force-keys

중요: 이 옵션은 시간 초과 제한 및 노드 제한 초과됨 메시지에서 설명하는 오류가 나타나는 경우에만 변경해야 합니다. 시간 초과 제한을 늘리면 더 긴 시간 동안 더 많은 CPU를 사용할 수 있기 때문에 Tableau Server 전체에서 작업 성능이 영향을 받을 수 있습니다. 또한 시간 초과 제한을 늘리면 메모리 사용량이 더 높아져 쿼리가 병렬로 실행될 때 대화형 마이크로서비스 컨테이너 관련 문제가 발생할 수 있습니다.

metadata.query.limits.count

기본값: 20000

Catalog가 반환할 수 있는 최대 개체 수(쿼리 결과 수에 느슨하게 매핑될 수 있음)이며, 이 수를 초과하면 노드 제한이 초과되고 쿼리가 취소됩니다. 다음 명령을 사용하여 개수 제한을 점진적으로 늘리되 100,000개를 넘지 않도록 하는 것이 좋습니다.

tsm configuration set -k metadata.query.limits.count –v 3000 --force-keys

중요: 이 옵션은 시간 초과 제한 및 노드 제한 초과됨 메시지에서 설명하는 오류가 나타나는 경우에만 변경해야 합니다. 노드 제한을 늘리면 메모리 사용량이 더 높아져 쿼리가 병렬로 실행될 때 대화형 마이크로서비스 컨테이너 관련 문제가 발생할 수 있습니다.

metadata.query.throttling.enabled

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

기본값: true

메타데이터 API(링크가 새 창에서 열림) 쿼리 제한을 사용할지 여부를 제어합니다. 메타데이터 API 쿼리 제한은 서버의 API 응답이 전체 성능에 부정적인 영향을 미치는 것을 방지하기 위해 설계된 기능입니다. true(기본값)로 설정하면 메타데이터 API에 대한 요청이 정의된 임계값을 초과하는 경우 RATE_EXCEEDED 오류가 반환됩니다.

메타데이터 API 사용자에게 RATE_EXCEEDED 오류가 자주 표시되는 경우 관리자는 metadata.query.throttling.tokenRefilledPerSecond 및 metadata.query.throttling.queryCostCapacity 설정을 사용하여 제한을 조정할 수 있습니다. 또는 관리자는 metadata.query.throttling.enabled 값을 false로 설정하여 제한을 완전히 사용하지 않도록 설정할 수 있습니다. 그러나 그렇게 설정하는 경우 해당 기능의 성능 보호 이점을 누릴 수 없게 됩니다.

metadata.query.throttling.queryCostCapacity

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

기본값: 20000000

메타데이터 API(링크가 새 창에서 열림)가 쿼리에 응답할 수 있는 용량을 나타내는 숫자입니다. 메타데이터 API에 대한 각 요청에는 실행 시 이 숫자에서 차감되는 계산된 비용이 있습니다. (토큰 버킷 모델을 사용하는 경우 버킷에 담을 수 있는 최대 토큰 양입니다.)

메타데이터 API 사용자에게 자주 표시되는 경우 RATE_EXCEEDED 오류가 발생하면 관리자는 제한 설정을 조정할 수 있습니다. metadata.query.throttling.queryCostCapacity를 조정하기 전에 metadata.query.throttling.tokenRefilledPerSecond를 조정하고 결과를 테스트합니다. 또는 관리자는 metadata.query.throttling.enabled를 false로 설정하여 제한을 완전히 사용하지 않도록 설정할 수 있습니다. 그러나 그렇게 설정하는 경우 해당 기능의 성능 보호 이점을 누릴 수 없게 됩니다.

metadata.query.throttling.tokenRefilledPerSecond

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

기본값: 5555

매초마다 재생성되는 메타데이터 API(링크가 새 창에서 열림) 쿼리 용량을 나타내는 숫자입니다. (토큰 버킷 모델을 사용하는 경우 매초마다 버킷에 들어가는 토큰 수입니다.)

메타데이터 API 사용자에게 자주 표시되는 경우 RATE_EXCEEDED 오류가 발생하면 관리자는 제한 설정을 조정할 수 있습니다. metadata.query.throttling.queryCostCapacity를 조정하기 전에 metadata.query.throttling.tokenRefilledPerSecond를 조정하고 결과를 테스트합니다. 또는 관리자는 metadata.query.throttling.enabled를 false로 설정하여 제한을 완전히 사용하지 않도록 설정할 수 있습니다. 그러나 그렇게 설정하는 경우 해당 기능의 성능 보호 이점을 누릴 수 없게 됩니다.

native_api.allowed_paths

기본값: ""

참고: 2023년 10월 이전의 Tableau Server 릴리스(유지 관리 릴리스 포함)에서는 이 설정이 기본적으로 모든 경로에 대한 액세스를 허용하도록 구성되었습니다.

Tableau 또는 원격 공유 위치에 저장된 파일의 액세스에 대한 허용 목록을 지정하려면 이 설정을 사용합니다. 이 시나리오에서는 권한 있는 Tableau Server 사용자가 서버의 파일을 파일 기반 데이터 원본(예: 스프레드시트)으로 사용하여 통합 문서를 작성하는 것이 허용됩니다.

이 설정을 사용하면 지정한 디렉터리로만 액세스를 제한할 수 있습니다. 따라서 tableau 시스템 계정 액세스는 데이터 파일을 호스팅하는 디렉터리 경로로 제한됩니다.

중요: 이 설정에서 지정하는 파일 경로가 존재하고 시스템 계정으로 액세스할 수 있는지 확인하십시오.

native_api.ExplainDataEnabled

기본값: true

이 옵션은 서버에 대해 데이터 설명을 사용할지 여부를 제어합니다. 데이터 설명에 대한 자세한 내용은 Tableau 도움말의 데이터 설명 시작(링크가 새 창에서 열림)을 참조하십시오.

이 옵션은 Tableau Server 버전 2019.3부터 추가되었습니다.

native_api.unc_mountpoints

기본값: none

Linux 기반 Tableau Server에서 액세스하는 공유 Windows 디렉터리에 대한 UNC 및 FQDN 경로를 지정합니다. 각 경로는 해당하는 auto.cifs 파일에서 참조되어야 합니다. 다음과 같이 각 경로를 세미콜론으로 구분합니다.

'//filesrv01/development;/mnt/filesrv01/development;//filesrv01.example.lan/development;/mnt/filesrv01/development'

이후에 native_api.unc_mountpoints 값을 업데이트하면 기존 값을 덮어씁니다. 따라서 Windows 공유를 추가할 때마다 업데이트된 값에 모든 공유를 포함시켜야 합니다.

자세한 내용은 Community Wiki 항목인 Windows 공유 디렉터리에 연결(영문)(링크가 새 창에서 열림)을 참조하십시오.

nlp.concepts_shards_count

기본값: 1

참고: 기본 샤드 카운트 값이 대부분의 Tableau Server 설치에 적합합니다.

데이터에 질문의 개념 인덱스에 대한 데이터 샤드 수, 필드명, 필드 동의어 및 샤드에 저장된 분석 용어를 제어합니다.

• 2022.1 이상 버전의 인덱스 및 검색 서버
• 2019.1 ~ 2021의 탄력적 서버 4

샤드 카운트는 검색 인덱스를 분할하여 총 인덱스 크기를 줄이므로 데이터에 질문의 의미 체계 구문 분석기의 성능이 향상될 수 있습니다. 샤드 카운트를 조정하는 것은 실행 중인 Tableau Server의 버전에 따라 elasticserver.vmopts 또는 indexandsearchserver.vmopts를 통해 힙 크기를 증가시키는 것과 함께 수행할 수 있는 또 다른 성능 향상 수단입니다.

Tableau에서는 50GB마다 1씩 샤드 카운트를 늘리도록 권장합니다. 샤드 카운트를 조정해야 하는 횟수를 줄이려면 현재 인덱스 크기에 50%를 추가하여 총 인덱스 크기를 계산하십시오. 예를 들어 총 인덱스 크기가 50GB보다 작으면 샤드 카운트 1로 충분합니다. 실제 성능은 서버, 인덱스 크기 증가 속도 및 기타 요인에 따라 달라집니다.

• 0 ~ 50GB: 1
• 50GB ~ 100GB: 2
• 100GB ~ 150GB: 3

다음 명령을 사용하여 개념 인덱스 샤드 카운트를 기본값에서 2로 증가시킬 수 있습니다.

tsm configuration set -k nlp.concepts_shards_count -v 2

nlp.values_shards_count

기본값: 1

데이터에 질문의 개념 인덱스에 대한 데이터 샤드 수, 필드명, 필드 동의어 및 샤드에 저장된 분석 용어를 제어합니다.

• 2022.1 이상 버전의 인덱스 및 검색 서버
• 2019.1 ~ 2021의 탄력적 서버 4

샤드 카운트는 검색 인덱스를 분할하여 총 인덱스 크기를 줄이므로 데이터에 질문의 의미 체계 구문 분석기의 성능이 향상될 수 있습니다. 샤드 카운트를 조정하는 것은 실행 중인 Tableau Server의 버전에 따라 elasticserver.vmopts 또는 indexandsearchserver.vmopts를 통해 힙 크기를 증가시키는 것과 함께 수행할 수 있는 또 다른 성능 향상 수단입니다.

Tableau에서는 50GB마다 1씩 샤드 카운트를 늘리도록 권장합니다. 샤드 카운트를 조정해야 하는 횟수를 줄이려면 현재 인덱스 크기에 50%를 추가하여 총 인덱스 크기를 계산하십시오. 예를 들어 총 인덱스 크기가 50GB보다 작으면 샤드 카운트 1로 충분합니다. 실제 성능은 서버, 인덱스 크기 증가 속도 및 기타 요인에 따라 달라집니다.

• 0 ~ 50GB: 1
• 50GB ~ 100GB: 2
• 100GB ~ 150GB: 3

다음 명령을 사용하여 값 인덱스 샤드 카운트를 기본값에서 2로 증가시킬 수 있습니다.

tsm configuration set -k nlp.values_shards_count -v 2

nlp.defaultNewSiteAskDataMode

기본값: disabled_by_default

이 옵션을 사용하여 사이트를 만들 때 데이터에 질문 모드의 초기 값을 설정합니다. 자세한 내용은 사이트에 대한 데이터에 질문(Ask Data) 사용 또는 사용 안 함을 참조하십시오.

유효한 옵션은 disabled_by_default 및 disabled_always입니다.

이 옵션은 Tableau Server 버전 2019.4.5, 2020.1.3에서 추가되었습니다.

noninteractive.vmopts

pgsql.port

기본값: 8060

PostgreSQL이 수신 대기하는 포트입니다.

pgsql.preferred_host

기본 설정 리포지토리가 설치되어 있는 노드의 컴퓨터 이름을 지정합니다. 이 값은 tsm topology failover-repository 명령에 --preferred 또는 -r 옵션이 지정된 경우 사용됩니다.

예:

pgsql.ssl.ciphersuite

기본값: HIGH:MEDIUM:!aNULL:!MD5:!RC4

리포지토리에 대한 SSL에 허용되는 암호화 알고리즘을 지정합니다.

허용되는 값 및 서식 지정 요구 사항에 대해서는 Postgres 웹 사이트에서 ssl_ciphers(영문)(링크가 새 창에서 열림)를 참조하십시오.

pgsql.ssl.max_protocol_version

기본값: TLSv1.3

SSL을 통해 리포지토리에 연결할 때 사용할 최대 SSL/TLS 프로토콜 버전을 설정합니다.

유효한 값: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3

pgsql.ssl.min_protocol_version

기본값: TLSv1.2

SSL을 통해 리포지토리에 연결할 때 사용할 최소 SSL/TLS 프로토콜 버전을 설정합니다.

유효한 값: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3

pgsql.verify_restore.port

기본값: 8061

PostgreSQL 데이터베이스의 무결성을 확인하는 데 사용되는 포트입니다. 자세한 내용은 tsm maintenance backup을 참조하십시오.

ports.blocklist

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

기본값: 자동 포트 할당에 사용되는 범위에는 차단된 포트가 없습니다.

포트를 동적으로 할당할 때 Tableau에서 사용하지 않아야 하는 포트 할당 범위 내에서 포트를 지정하는 데 사용됩니다. 이 옵션은 다른 응용 프로그램이 범위 내의 포트를 사용하고 있음을 알고 있을 때 유용합니다. 포트가 여러 개이면 쉼표로 구분합니다. 다음 예를 참조하십시오.

tsm configuration set -k ports.blocklist -v 8000,8089, 8090

ports.blocklist 키 사용 방법에 대한 자세한 내용은 범위 내 특정 포트 차단을 참조하십시오.

recommendations.enabled

기본값: true

데이터 원본 및 테이블에 대한 추천 항목(Tableau Desktop의 경우)과 뷰에 대한 추천 항목(Tableau Server의 경우)을 구동하는 추천 항목 기능을 제어합니다. 추천 항목은 콘텐츠의 인기도와 현재 사용자와 유사하다고 확인된 다른 사용자가 사용하는 콘텐츠에 기반합니다.

searchserver.connection_timeout_milliseconds

버전: 버전 2019.1에 추가되었습니다. 버전 2022.3에서 사용 중단되었습니다. 버전 2023.3에서 사용 중지되었습니다.

기본값은 100000(밀리초)입니다.

검색 및 찾아보기 클라이언트가 검색 및 찾아보기 서버에 대한 연결이 설정될 때까지 대기하는 기간(밀리초)을 지정합니다.

특별히 사용량이 많은 Tableau Server 컴퓨터이거나 로그에 "Failed zookeeper health check. Refusing to start SOLR." 오류가 나타나는 경우 이 값을 늘리십시오.

자세한 내용은 클라이언트 세션 시간 초과를 참조하십시오.

searchserver.index.bulk_query_user_groups

버전: 버전 2022.3에서 사용 중지되었습니다.

기본값: true

CSV 파일을 사용하여 사용자를 가져오거나 삭제할 때 사이트 사용자 쿼리를 대량으로 수행할지 여부를 지정합니다. true(기본값)로 설정되어 있으면 인덱싱이 대량으로 수행됩니다.

searchserver.javamemopts

버전: 버전 2019.1에 추가되었습니다. 2023.3에서 사용 중지되었습니다.

기본값: -Xmx512m -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData

SOLR에 대한 JVM 옵션을 결정합니다.

모든 구성 가능한 옵션 중에서 -Xmx 매개 변수로 구성되는 최대 힙 메모리가 검색 서버를 튜닝할 때 가장 중요합니다. 대부분의 경우 Tableau Server 컴퓨터에서 사용 가능한 물리적 메모리를 기준으로 최대 24GB까지 가능한 높게 설정해야 합니다. 최대 힙 메모리만 변경하려면 전체 기본 문자열을 지정하고 -Xmx에 대한 값만 변경하십시오.

-Xmx의 유효한 값은 Tableau Server 컴퓨터에서 사용 가능한 메모리 크기에 따라 다르지만 24GB를 넘을 수 없습니다. 자세한 내용은 검색 및 찾아보기 최대 힙 메모리를 참조하십시오.

searchserver.startup.zookeeper_healthcheck_timeout_ms

버전: 버전 2020.1에 추가되었습니다. 버전 2023.3에서 사용 중지되었습니다.

기본값은 300000(밀리초)입니다.

Tableau Server가 Zookeeper 상태 확인이 성공할 때까지 대기하는 기간(밀리초)을 지정합니다.

특별히 사용량이 많은 Tableau Server 컴퓨터이거나 로그에 "Failed zookeeper health check. Refusing to start SOLR." 오류가 나타나는 경우 이 값을 늘리십시오.

자세한 내용은 시작 시 Zookeeper 연결 상태 확인 시간 초과를 참조하십시오.

searchserver.zookeeper_session_timeout_milliseconds

버전: 버전 2022.3에서 사용 중지되었습니다.

기본값은 100000(밀리초)입니다.

검색 및 찾아보기 클라이언트가 조정 서비스(Zookeeper)에 대한 연결이 설정될 때까지 대기하는 기간(밀리초)을 지정합니다.

자세한 내용은 클라이언트 세션 시간 초과를 참조하십시오.

ServerExportCSVMaxRowsByCols

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

기본값: 0(제한 없음)

데이터 보기에서 CSV 파일로 다운로드할 수 있는 데이터의 최대 셀 수를 지정합니다. 기본적으로 제한이 없습니다. 셀 수를 지정합니다. 예를 들어 제한을 3백만 개로 설정하려면 다음과 같이 합니다. 

tsm configuration set -k ServerExportCSVMaxRowsByCols -v 3000000 

tsm pending-changes apply

ssl.ciphersuite

기본값: HIGH:MEDIUM:!EXP:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED

게이트웨이에 대한 SSL에 허용되는 암호화 알고리즘을 지정합니다.

허용되는 값 및 서식 지정 요구 사항에 대해서는 Apache 웹 사이트에서 SSLCipherSuite(영문)(링크가 새 창에서 열림)를 참조하십시오.

ssl.client_certificate_login.blocklisted_signature_algorithms

기본값:

• 버전 2020.4.0: 

  sha1withrsaencryption,
sha1withrsa

• 버전 2020.4.1 이상:

  sha1withrsaencryption,
sha1withrsa,
sha1withrsaandmgf1,
sha1withdsa,
sha1withecdsa

기본값은 SHA-1 서명 알고리즘을 사용하는 인증서를 차단합니다. SSL에 대해 차단되는 클라이언트 서명 알고리즘을 지정합니다. 모든 서명 알고리즘의 차단을 사용하지 않으려면 빈 따옴표 쌍으로 이 키를 실행하십시오.

이 키에 대한 자세한 내용은 기술 자료 문서 인증서가 SHA-1로 서명된 경우 업그레이드 후 상호 SSL이 실패함(영문)(링크가 새 창에서 열림)을 참조하십시오.

ssl.client_certificate_login.min_allowed.elliptic_curve_size

기본값: 256

상호 SSL을 통해 Tableau Server에 인증하는 ECDSA 클라이언트 인증서에 필요한 최소 타원 곡선 크기를 지정합니다. 클라이언트에서 이 최소 곡선 크기를 충족하지 않는 ECDSA 클라이언트 인증서를 제시하면 인증 요청이 실패합니다.

이 옵션은 Tableau Server 버전 2021.1에서 도입되었습니다.

ssl.client_certificate_login.min_allowed.rsa_key_size

기본값: 2048

상호 SSL을 통해 Tableau Server에 인증하는 RSA 클라이언트 인증서에 필요한 최소 키 크기를 지정합니다. 클라이언트에서 이 최소 키 크기를 충족하지 않는 RSA 클라이언트 인증서를 제시하면 인증 요청이 실패합니다.

이 옵션은 Tableau Server 버전 2021.1에서 도입되었습니다.

ssl.protocols

기본값: all +TLSv1.2 -SSLv2 -SSLv3 -TLSv1.3

게이트웨이에 대한 TLS 연결에 대해 Tableau Server가 지원하는 SSL 프로토콜을 지정합니다. 허용되는 값은 Apache SSLPrtocol 지시문(영문)(링크가 새 창에서 열림)에 근거합니다. 보안 강화 검사 목록에 설명된 대로 다음 SSL 프로토콜 구성을 따르는 것이 좋습니다.

storage.monitoring.email_enabled

기본값: false

서버 디스크 공간 모니터링에 대해 이메일 알림을 사용할지 여부를 지정합니다. 기본적으로 이메일 알림은 사용됩니다. 디스크 공간 모니터링에 대해 알림을 사용하려면 true로 설정합니다.

알림이 전송되려면 SMTP를 구성해야 합니다. 자세한 내용은 SMTP 설정 구성을 참조하십시오.

storage.monitoring.warning_percent

기본값: 20

남은 디스크 공간의 경고 임계값이며 전체 디스크 공간의 백분율로 표시됩니다. 디스크 공간이 이 임계값 밑으로 떨어지면 경고 알림이 전송됩니다.

storage.monitoring.critical_percent

기본값: 10

남은 디스크 공간의 중요 임계값이며 전체 디스크 공간의 백분율로 표시됩니다. 디스크 공간이 이 임계값 밑으로 떨어지면 중요 알림이 전송됩니다.

storage.monitoring.email_interval_min

기본값: 60

디스크 공간 모니터링이 사용되고 임계값이 초과된 경우 이메일 알림을 보내는 빈도(분)입니다.

storage.monitoring.record_history_enabled

기본값: true

디스크 여유 공간 기록을 저장하고 관리 뷰에 표시할지 여부를 결정합니다. 모니터링에 대해 기록 저장을 사용하지 않으려면 storage.monitoring.record_history_enabled를 false로 설정합니다.

svcmonitor.notification.smtp.enabled

기본값: false

서버 처리 이벤트에 대해 이메일 알림을 사용할지 여부를 지정합니다. 기본적으로 알림은 프로세스가 중단되거나, 장애 조치되거나, 다시 시작될 때 전송됩니다. 서버 프로세스 알림을 사용하려면 true로 설정합니다.

알림이 전송되려면 SMTP를 구성해야 합니다. 자세한 내용은 SMTP 설정 구성을 참조하십시오.

svcmonitor.notification.smtp.mime_use_multipart_mixed

버전: 2020.1.8, 2020.2.5, 2020.3.1 버전에 추가되었습니다.

기본값: false

구독 HTML MIME 첨부 파일을 multipart/related(기본값) 형식으로 전송할지, 아니면 multipart/mixed 형식으로 전송할지를 제어합니다.

드물지만 이메일 클라이언트가 Tableau Server에서 보낸 이메일을 제대로 구문 분석하지 못할 수 있습니다. 대부분의 경우 이 속성을 true로 설정하여 해결할 수 있습니다. 알려진 클라이언트로는 iOS Mail 및 Microsoft Outlook(Exchange S/MIME 암호화와 페어링된 경우)이 포함됩니다.

tabadmincontroller.auth.expiration.minutes

기본값: 120

세션 쿠키의 유효 기간을 제어합니다. 기본적으로 120분으로 설정됩니다. 이 값은 노드 부트스트랩 파일의 내장된 자격 증명에 대한 유효 기간도 결정합니다. 자세한 내용은 tsm topology nodes get-bootstrap-file을 참조하십시오.

tdsservice.log.level

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

기본값: info

데이터 원본 속성 서비스의 로그 수준입니다. 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

tomcat.useSystemProxies

기본값: false

tomcat 구성 요소(OpenID)가 로컬 Windows 운영 체제에서 정방향 프록시 구성에 액세스해야 하는지 여부를 지정합니다. OpenID Connect에 대해 Tableau Server 구성을 참조하십시오.

tomcatcontainer.log.level

기본값: info

대화형 마이크로서비스 컨테이너 및 비대화형 마이크로서비스 컨테이너의 마이크로서비스에 대한 로그 수준입니다. 버전 2020.4부터 동적으로 구성할 수 있으므로 이 값만 변경한 경우 Tableau Server를 다시 시작할 필요가 없습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

tsm.log.level

기본값: info

TSM 서비스의 로그 수준. 이러한 로그에는 TSM 서비스(관리 에이전트, 관리 컨트롤러, 클라이언트 파일 서비스, 클러스터 컨트롤러, 서비스 관리자 및 라이선스 서비스)에 문제가 있는 경우 유용하게 사용할 수 있는 정보가 포함되어 있습니다. 이 구성 키는 조정 서비스 또는 유지 관리 프로세스의 로그 수준을 변경하지 않습니다. 자세한 내용은 로그 수준 변경 및 Tableau Server 프로세스를 참조하십시오.

tsm.controlapp.log.level

기본값: info

control_<app> 서비스의 로그 수준. 이러한 로그에는 TSM 또는 Tableau Server 프로세스를 시작하거나 다시 구성할 때 문제가 발생하는 경우 유용하게 사용할 수 있는 정보가 포함되어 있습니다. 자세한 내용은 로그 수준 변경을 참조하십시오.

usernotifications.reap_after_days

기본값: 30

사용자 알림이 서버에서 삭제되기 전까지의 기간(일)입니다.

vizportal.adsync.update_system_user

기본값: false

Active Directory 그룹이 Tableau Server에서 동기화될 때 Active Directory에서 변경된 경우라도 사용자의 이메일 주소 및 표시 이름을 변경할지 여부를 지정합니다. 동기화 도중 사용자의 이메일 주소 및 표시 이름을 업데이트하려면 vizportal.adsync.update_system_user를 true로 설정한 후 서버를 다시 시작합니다.

vizportal.alwaysUseEmbeddedShareLinks

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

기본값: false

링크 복사 옵션에 “embed=y” 매개 변수를 포함할지 여부를 지정합니다. 버전 2019.4부터는 기본적으로 이 매개 변수가 포함되지 않습니다. 이 구성 키를 true로 설정하면 “embed=y” 매개 변수가 포함되도록 동작이 변경됩니다. 링크 복사 옵션을 사용하여 웹 페이지 내장을 위한 링크를 공유하는 방법에 대한 자세한 내용은 Tableau Desktop 및 웹 작성 도움말에서 웹 페이지에 내장된 뷰(링크가 새 창에서 열림)를 참조하십시오.

vizportal.art_skip_list

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

기본값: null

이 구성 키를 사용하여 ART(활동 및 리소스 추적)를 사용하지 않고 ART를 사용하는 동안 대량의 불필요한 데이터를 생성하는 Tableau Server 기능의 측면을 지정할 수 있습니다.

이 키는 응용 프로그램 서버(VizPortal) 문제를 해결하기 위해 vizportal.log_art_java 및 vizportal.enable_art와 함께 사용됩니다. 설정 값에 관한 정보[need info here about what it gets set to.] 이 구성 설정을 사용하는 방법을 알아보려면 응용 프로그램 서버 문제 해결을 참조하십시오.

vizportal.csv_user_mgmt.index_site_users

버전: 버전 2022.3에서 사용 중단되었습니다. 버전 2023.3에서 사용 중지(완전히 제거)되었습니다.

기본값: true

CSV 파일을 사용하여 사용자를 가져오거나 삭제할 때 사용자별로 사이트 사용자 인덱싱을 수행할지 여부를 지정합니다. true(기본값)로 설정되어 있으면 각 사용자가 추가되거나 삭제될 때 인덱싱이 수행됩니다. 전체 CSV 파일의 처리가 완료될 때까지 사이트 사용자 인덱싱을 지연시키려면 false로 설정합니다.

vizportal.csv_user_mgmt.bulk_index_users

버전: 버전 2022.3에서 사용 중단되었습니다. 버전 2023.3에서 사용 중지(완전히 제거)되었습니다.

기본값: false

CSV 파일을 사용하여 사용자를 가져오거나 삭제할 때 사이트 사용자 인덱싱을 대량으로 수행할지 여부를 지정합니다. false(기본값)로 설정되어 있으면 인덱싱이 개별적으로 수행됩니다. CSV 파일이 처리된 후 인덱싱을 대량으로 수행하려면 true로 설정합니다.

vizportal.enable_art

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

기본값: false

이 구성 키는 응용 프로그램 서버(VizPortal) 문제를 해결하기 위해 vizportal.log_art_java 및 vizportal.art_skip_list와 함께 사용됩니다. true로 설정하면 응용 프로그램 서버에서 ART(활동 및 리소스 추적)이 활성화됩니다. 이 구성 설정을 사용하는 방법을 알아보려면 응용 프로그램 서버 문제 해결을 참조하십시오.

vizportal.log_art_java

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

기본값: false

이 구성 키는 응용 프로그램 서버(VizPortal) 문제를 해결하기 위해 vizportal.enable_art 및 vizportal.art_skip_list와 함께 사용됩니다. true로 설정하면 응용 프로그램 서버에서 ART(활동 및 리소스 추적)이 활성화됩니다. 이 구성 설정을 사용하는 방법을 알아보려면 응용 프로그램 서버 문제 해결을 참조하십시오.

vizportal.oauth.connected_apps.max_expiration_period_in_minutes

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

기본값: 10

JWT(JSON Web Token)가 유효한 최대 기간(분)입니다. JWT를 확인할 때 Tableau Server는 JWT에 지정된 기간이 이 기본값을 초과하지 않는지 확인합니다. 이 설정은 Tableau의 연결된 앱이 Tableau Server에서 Tableau REST API(링크가 새 창에서 열림)를 사용하여 구성된 경우 사용됩니다.

예를 들어 최대 기간을 5분으로 변경하려면 다음 명령을 실행합니다.

tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5

vizportal.oauth.external_authorization.enabled

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

기본값: false

Tableau Server 2024.2 이상에서는 Tableau Server에 대해 연결된 앱 사용 옵션이 활성화되어 있습니다. Tableau Server 2023.2 이하에서는 Tableau Server에 콘텐츠 내장에 OAuth 액세스 사용 옵션을 사용할지 여부를 지정합니다.

Tableau Server에 EAS(외부 권한 부여 서버)를 등록하여 응용 프로그램 통합을 사용하도록 설정하려면 이 옵션을 사용합니다. 자세한 내용은 OAuth 2.0 신뢰를 사용하여 연결된 앱 구성을 참조하십시오.

이 옵션을 사용하도록 설정하려면 다음 명령을 실행합니다.

tsm configuration set -k vizportal.oauth.external_authorization.enabled -v true

vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms

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

기본값: ES256K

EAS(외부 권한 부여 서버)가 등록되었거나 연결된 앱이 구성된 경우 이 명령을 사용하여 JWT(JSON Web Token) 헤더에 사용되는 서명 알고리즘을 지정할 수 있습니다. 자세한 내용은 OAuth 2.0 신뢰를 사용하여 연결된 앱 구성 또는 Tableau의 연결된 앱을 사용하여 응용 프로그램 통합을 참조하십시오.

예를 들어 필요한 경우 다음 명령을 실행하여 알고리즘을 제거할 수 있습니다.

tsm configuration set - k vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms -v

중요: 위의 예제 명령은 안전하지 않은 서명 알고리즘을 허용하므로 오류 해결에만 사용되어야 합니다.

vizportal.oauth.external_authorization_server.issuer

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

기본값: null

필수 항목입니다. 이 명령을 사용하여 발급자 URL을 지정합니다. 발급자 URL은 EAS(외부 권한 부여 서버)를 Tableau Server에 등록하는 데 필요합니다. 자세한 내용은 OAuth 2.0 신뢰를 사용하여 연결된 앱 구성을 참조하십시오.

예를 들어 EAS가 Okta인 경우 다음과 유사한 명령을 실행할 수 있습니다.

tsm configuration set -k vizportal.oauth.external_authorization_server.issuer -v "https://dev-12345678.okta.com/oauth2/abcdefg9abc8eFghi76j5"

vizportal.oauth.external_authorization_server.jwks

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

기본값: null

EAS(외부 권한 부여 서버)가 등록된 경우 이 명령을 사용하여 JWKS(JSON Web Key Set) URL을 지정할 수 있습니다. JWKS URL은 IdP(ID 공급자)가 외부 권한 부여 서버 메타데이터 끝점을 노출하지 않는 경우 필요합니다.

예를 들어 IdP 가 Amazon Cognito인 경우 다음과 유사한 명령을 실행할 수 있습니다.

tsm configuration set -k vizportal.oauth.external_authorization_server.jwks -v "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_Ab129faBb/.well-known/jwks.json"

vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes

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

기본값: 10

JWT(JSON Web Token)가 유효한 최대 기간(분)입니다. JWT를 확인할 때 Tableau Server는 JWT에 지정된 기간이 이 기본값을 초과하지 않는지 확인합니다. 이 설정은 EAS가 Tableau Server에 등록된 경우 사용됩니다. 자세한 내용은 OAuth 2.0 신뢰를 사용하여 연결된 앱 구성을 참조하십시오.

예를 들어 최대 기간을 5분으로 변경하려면 다음 명령을 실행합니다.

tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5

vizportal.openid.full_server_request_logging_enabled

기본값: false

OpenID 작업의 전체 로깅을 수집할지 여부를 지정합니다.

OpenID Connect 문제를 해결할 때 더 자세한 로그를 수집해 더 나은 문제 해결을 가능하게 하려면 이를 true 값으로 설정합니다.

모든 로깅 관련 구성과 마찬가지로 문제 해결 및 로그 수집을 마친 후 이 키를 기본값(false)으로 재설정하는 것이 좋습니다. 그래야 기록되는 정보의 양이 제한되고 로그 파일 크기가 최소로 유지됩니다.

vizportal.password_reset

버전: 버전 2024.2에서 features.PasswordReset을 대체합니다.

기본값: false

로컬 인증을 사용하는 서버에만 적용됩니다. true로 설정하면 사용자가 로그인 페이지에서 "비밀번호 잊음" 옵션을 사용하여 비밀번호를 재설정할 수 있게 됩니다.

vizportal.rest_api.cors.enabled

기본값: false

Tableau Server에서 CORS(Cross Origin Resource Sharing)를 허용할지 여부를 제어합니다. true로 설정하면 서버가 Tableau REST API 끝점에 대한 웹 브라우저 액세스를 허용합니다. 이 옵션과 REST API를 사용하여 사용자 지정 포털을 만들 수 있습니다. 기본적으로 이 기능은 사용되지 않습니다. 액세스할 수 있는 원본(사이트)을 지정하려면 vizportal.rest_api.cors.allow_origin 옵션을 사용합니다. 이 옵션으로 지정된 원본만 Tableau Server REST API에 요청을 전송할 수 있습니다. 자세한 내용은 Tableau Server에서 CORS 사용을 참조하십시오.

vizportal.site_user_group_count_enabled

버전: 버전 2022.3.5 이상, 2023.1.0 이상에 추가되었습니다.

기본값: false

사이트 사용자 페이지에 각 사용자의 그룹 수를 표시하는 열을 포함할지 여부를 제어합니다.

vizqlserver.force_maps_to_offline

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

기본값: false

Tableau Server가 맵에 대해 오프라인 모드로 실행되는지 여부를 결정합니다. 이 설정은 인터넷 및 맵 서버에 대한 액세스가 제한된 연결이 끊긴 환경에서 유용합니다. 맵에 대해 오프라인 모드를 사용하려면 이 값을 true로 설정합니다. 인터넷에 액세스할 수 없는 환경에서 Tableau Server를 설치 및 구성하는 것에 대한 자세한 내용은 연결되지 않은 환경(Air-Gapped 환경)에서 Tableau Server 설치를 참조하십시오.

wgserver.authentication.legacy_identity_mode.enabled

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

기본값: Tableau Server 2022.1 이상의 경우 false입니다. 2022.1 이상으로 업그레이드된 2022.1 이전 Tableau Server 배포의 경우 기본값은 true입니다.

ID 풀을 사용하려면 false로 설정하십시오.

자세한 내용은 ID 풀 문제 해결를 참조하십시오.

wgserver.authentication.identity_pools.default_pool_description

버전: 버전 2023.1에 추가됨

기본값: Null

필요한 경우 초기 풀(TSM 구성됨)의 대상을 Tableau Server 방문 페이지에 추가하고 모든 사용자에게 표시할 수 있습니다. ID 풀을 1개 이상 만드는 경우 기본 로그인 옵션 아래에 이 대상이 추가되며 초기 풀(TSM 구성됨)에 속하는 사용자를 올바른 로그인 옵션으로 안내하는 데 사용할 수 있습니다.

예를 들어 "Regular employees sign in here(여기서 정규 직원 로그인)" 설명을 추가하려면 다음 명령을 사용하면 됩니다.

tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v “Regular employees sign in here"

참고: 초기 풀(TSM 구성됨) 설명은 로그인 사용자 지정 노트와 다릅니다. 로그인 사용자 지정 노트는 Tableau Server 방문 페이지의 모든 로그인 옵션 아래와 초기 풀(TSM 구성됨) 사용자가 사용자 이름과 비밀번호를 입력하는 페이지에 표시됩니다.

wgserver.domain.accept_list

버전: 버전 2020.4.0에 추가되었으며 wgserver.domain.whitelist를 대체합니다.

기본값: null

Tableau Server에서 보조 Active Directory 도메인으로의 연결을 허용합니다. 보조 도메인은 Tableau Server가 사용자 동기화를 위해 연결하지만 Tableau Server가 설치되어 있지 않은 도메인입니다. Tableau Server는 사용자 및 그룹 동기화를 위해 보조 도메인에 연결하려고 시도합니다. Tableau Server가 보조 도메인에 연결할 수 없는 경우가 있으며, 이 경우 "Domain not in accept list (errorCode=101015)" 오류가 발생합니다.

보안 취약점에 대한 수정 [중요] ADV-2020-003: Tableau Server 강제 인증(영문)(링크가 새 창에서 열림)에 따라 wgserver.domain.accept_list 옵션 설정이 필수입니다. 2020년 2월 기준으로, 이 취약점에 대한 수정이 Tableau Server의 모든 최신 버전 및 유지 관리 릴리스에 포함됩니다.

이 옵션을 설정하려면 큰따옴표로 보조 도메인을 묶어 입력하십시오. 여러 도메인은 쉼표와 공백으로 구분해야 합니다. 예를 들어 tsm configuration set -k wgserver.domain.accept_list -v "example.org, domain.com"입니다.

와일드카드 기능은 지원되지 않습니다. 예를 들어, Tableau가 sub1.example.org 및 sub2.example.org에 연결하는 경우 두 도메인을 모두 추가해야 합니다.

wgserver.domain.accept_list 옵션을 업데이트하면 기존 값을 덮어씁니다. 따라서 값에 저장되어 있는 기존 도메인 집합에 새 도메인을 추가하려는 경우 옵션을 설정할 때 새 도메인과 함께 모든 기존 도메인을 포함하십시오. 기존 도메인의 전체 목록은 tsm configuration get –k wgserver.domain.accept_list를 실행하여 얻을 수 있습니다.

wgserver.domain.ldap.domain_custom_ports

기본값: null

하위 도메인과 해당 LDAP 포트를 매핑할 수 있습니다. 도메인과 포트는 콜론(:)으로 구분되며 각 도메인:포트 쌍은 FQDN1:port,FQDN2:port 형식을 사용하여 쉼표로 구분됩니다.

예: tsm configuration set -k wgserver.domain.ldap.domain_custom_ports -v childdomain1.lan:3269,childdomain2.lan:3269,childdomain3.lan:389

wgserver.domain.password

기본값: null

LDAP 연결에 사용되는 사용자 계정의 비밀번호를 지정합니다. 자세한 내용은 외부 ID 저장소 구성 참조를 참조하십시오.

wgserver.domain.username

기본값: null

LDAP 연결에 사용되는 사용자 계정의 이름을 지정합니다. 자세한 내용은 외부 ID 저장소 구성 참조를 참조하십시오.

wgserver.domain.whitelist

중요: 이 키는 버전 2020.4.0부터 사용 중단되었습니다. 대신 wgserver.domain.accept_list 를 사용하십시오.

기본값: null

Tableau Server에서 보조 Active Directory 도메인으로의 연결을 허용합니다. 보조 도메인은 Tableau Server가 사용자 동기화를 위해 연결하지만 Tableau Server가 설치되어 있지 않은 도메인입니다. Tableau Server는 사용자 및 그룹 동기화를 위해 보조 도메인에 연결하려고 시도합니다. Tableau Server가 보조 도메인에 연결할 수 없는 경우가 있으며, 이 경우 "Domain not in whitelist (errorCode=101015)" 오류가 발생합니다.

wgserver.ignore_domain_in_username_for_matching

버전: 버전 2021.4.21, 2022.1.17, 2022.3.9 및 2023.1.5에 추가됨

기본값: false

SAML을 사용하도록 설정하는 경우 IdP(ID 공급자) 사용자 이름을 Tableau Server의 사용자 계정과 일치시킬 때 SAML 사용자 이름 특성의 도메인 부분을 무시하도록 Tableau Server를 구성할 수 있습니다. 사용자 이름 특성의 접두사 부분과 일치하지만 사용자 이름 특성의 도메인 부분과 일치하지 않는 사용자가 Tableau Server에 이미 정의되어 있는 경우 사용자 이름 특성의 도메인 부분을 무시할 수 있습니다. 자세한 내용은 SAML 요구 사항 항목의 SAML 사용자 이름 특성과 일치할 때 도메인 무시 섹션을 참조하십시오.

예를 들어 SAML 사용자 이름 특성에서 도메인 이름을 무시하려면 다음 명령을 실행합니다.

tsm configuration set -k wgserver.ignore_domain_in_username_for_matching -v true

중요:

• 예방 조치를 취하지 않고 사용자 도메인 이름을 무시하는 것은 권장하지 않습니다. 즉, IdP에서 만든 구성된 도메인 전체에서 사용자 이름이 고유한지 확인해야 합니다.
• 이 명령은 오직 Tableau Server 배포가 legacy-identity-mode이거나 ID 서비스를 사용하기 위해 ID 마이그레이션(링크가 새 창에서 열림)을 통해 업데이트되지 않은 배포인 경우에만 작동합니다.

wgserver.saml.blocklisted_digest_algorithms

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

기본값: SHA1

모든 관련 SAML 인증서 서명 또는 SAML 어설션 다이제스트 방법 또는 서명 방법에 허용되지 않는 해싱 알고리즘을 지정합니다. 설정하면 차단 목록의 알고리즘으로 서명되거나 해시 처리된 인증서 또는 어설션이 실패합니다.

Tableau와 IdP 측에서 SHA-1은 여러 위치에서 사용될 수 있습니다. 예를 들면 다음과 같습니다.

• TSM을 통해 업로드된 인증서는 Tableau Server에서 IdP로 전송되는 요청에 서명하는 데 사용됩니다.
• IdP 메타데이터의 인증서는 인증서의 공개 키를 사용하여 IdP에서 받은 AuthnResponse(서명)를 확인하는 데 사용됩니다.
• SHA-1로 서명되고 해시 처리된 수신 어설션(DigestMethod는 SHA-1로 설정되고 SignatureMethod는 SHA-1로 설정됨).

Tableau Server 2021.2에서는 기본값이 SHA1로 변경되었습니다. 2021.2로 업그레이드하고 SAML을 구성하는 방법에 대한 자세한 내용은 기술 자료 문서 Tableau Server 2021.2로 업그레이드한 후 SAML 인증을 사용한 Tableau Server가 시작되지 않거나 로그인이 거부됨(영문)을 참조하십시오.

wgserver.saml.forceauthn

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

기본값: false

true로 설정한 경우 Tableau 사용자 세션이 만료되면 Tableau Server가 IdP로 사용자를 다시 인증합니다. 사용자에게 활성 IdP 세션이 있더라도 IdP의 사용자 재인증 메시지를 표시하려는 경우에도 이 옵션을 사용할 수 있습니다.

wgserver.saml.min_allowed.elliptic_curve_size

기본값: 256

버전: 버전 2021.1에 추가되었지만 기본값은 포함되지 않았습니다. 2021.2에서는 기본값이 256으로 설정되었습니다.

이 옵션은 SAML 인증에 사용되는 인증서에 허용되는 최소 ECDSA 곡선 크기를 지정합니다. ECDSA 곡선 크기가 256 미만인 인증서를 업로드하면 변경 내용을 적용할 때 TSM에서 오류를 기록합니다.

Tableau Server 2021.2 이상으로 업그레이드하고 SAML 인증서에 256 미만의 ECDSA 곡선 크기를 사용하면 업그레이드 후 Tableau Server가 시작되지 않습니다. 업그레이드 전에 ECDSA 곡선 크기가 256 이상인 새 인증서를 업로드하는 것이 좋습니다. 또는 업그레이드 전에 다음 명령을 실행하여 이전 버전(2021.1 이전)의 Tableau Server에서 낮은 ECDSA 곡선 크기를 설정할 수 있습니다. 2021.1 이전 버전에서 이 명령을 실행하는 경우 --force-keys 옵션을 명령에 포함해야 합니다. 2021.2로 업그레이드하고 SAML을 구성하는 방법에 대한 자세한 내용은 기술 자료 문서 Tableau Server 2021.2로 업그레이드한 후 SAML 인증을 사용한 Tableau Server가 시작되지 않거나 로그인이 거부됨(영문)을 참조하십시오.

wgserver.saml.min_allowed.rsa_key_size

기본값: 2048

버전: 버전 2021.1에 추가되었지만 기본값은 포함되지 않았습니다. 2021.2에서는 기본값이 2048으로 설정되었습니다.

이 옵션은 SAML 인증에 사용되는 인증서에 허용되는 최소 RSA 키 길이를 지정합니다. RSA 키 길이가 2048 미만인 인증서를 업로드하면 변경 내용을 적용할 때 TSM에서 오류를 기록합니다.

1024 RSA 키 길이로 SAML 인증을 실행하려면(권장하지 않음) 이 값을 1024로 설정합니다.

Tableau Server 2021.2 이상으로 업그레이드하고 SAML 인증서에 2048 미만의 키 길이를 사용하면 업그레이드 후 Tableau Server가 시작되지 않습니다. 업그레이드 전에 키 길이가 2048 이상인 새 인증서를 업로드하는 것이 좋습니다. 또는 업그레이드 전에 다음 명령을 실행하여 이전 버전(2021.1 이전)의 Tableau Server에서 낮은 키 강도를 설정할 수 있습니다. 2021.1 이전 버전에서 이 명령을 실행하는 경우 --force-keys 옵션을 명령에 포함해야 합니다. 2021.2로 업그레이드하고 SAML을 구성하는 방법에 대한 자세한 내용은 기술 자료 문서 Tableau Server 2021.2로 업그레이드한 후 SAML 인증을 사용한 Tableau Server가 시작되지 않거나 로그인이 거부됨(영문)을 참조하십시오.