---
schema_version: "1"
id: 902aee467281d7d7e32c518fecdaddc818a6e65c07d25230f5a7e23fce7f3b43
title: trustedAuthenticationSettings 엔터티
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server/entity_trusted_auth.md
canonical_url: https://help.tableau.com/current/server/ko-kr/entity_trusted_auth.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 81b568874a51b727a83de4c79cfd7b1693fa597a6c52c53b031a81f57a7ea804
description: Reference for the trustedAuthenticationSettings entity to configure trusted authentication.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# trustedAuthenticationSettings 엔터티

신뢰할 수 있는 인증을 구성하기 전에 [신뢰할 수 있는 인증](https://help.tableau.com/current/server/ko-kr/trusted_auth.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)를 참조하십시오.

## 구성 템플릿

이 템플릿을 사용하여 신뢰할 수 있는 인증 설정을 구성합니다.

**중요:** 모든 엔터티 옵션은 대/소문자를 구분합니다.

구성 파일, 엔터티 및 키에 대한 자세한 설명은 [구성 파일 예제](https://help.tableau.com/current/server/ko-kr/config_file_example.htm)를 참조하십시오.

신뢰할 수 있는 인증의 초기 구성을 완료한 후 [tsm authentication trusted <commands>](https://help.tableau.com/current/server/ko-kr/cli_authentication_tsm.htm#TSMTrusted) 하위 범주를 사용하여 추가 값을 설정합니다.

{
"configEntities": {
	"trustedAuthenticationSettings": {
		"\_type": "trustedAuthenticationSettingsType",
		"trustedHosts": \["webserv1","webserv2","webserv3"\]
		}
	}
}

## 구성 파일 참조

다음 목록에는 `"trustedAuthenticationSettings"` 엔터티 집합과 함께 포함할 수 있는 모든 옵션이 나열되어 있습니다.

trustedHosts

필수 항목입니다.

Tableau Server의 신뢰할 수 있는 티켓을 요청하는 웹 서버의 IP 주소 또는 호스트 이름입니다.

이 옵션에는 문자열 목록을 사용하며, 각 IP 또는 호스트를 따옴표로 묶고 쉼표로 구분(공백 없이)한 후 대괄호로 묶어 전달해야 합니다. 예를 들어 `["192.168.1.101","192.168.1.102","192.168.1.103"]` 또는 `["webserv1","webserv2","webserv3"]`을 사용할 수 있습니다.

지정한 값이 이전 설정을 재정의합니다. 따라서 이 값을 구성할 때는 호스트의 전체 목록을 포함해야 합니다.

tokenLength

선택 사항입니다.

값은 9와 255(포함) 사이의 정수로 설정할 수 있습니다.

신뢰할 수 있는 각 티켓의 문자 수를 결정합니다. 기본 설정인 `24`자는 무작위 144비트를 제공합니다. 이 옵션은 `useV2Tickets`를 `true`로 설정(권장되지 않음)하지 않는 한 무시됩니다.

logLevel

선택 사항입니다.

`all` | `debug` | `info` | `warn` | `error` | `fatal` | `off`

기본값: `info`

신뢰할 수 있는 티켓을 만들고 교환하는 작업과 관련된 프로세스의 로그 수준을 지정합니다. [로그 수준 변경](https://help.tableau.com/current/server/ko-kr/logs_debug_level.htm)을 참조하십시오.

timeoutInSeconds

선택 사항입니다.

기본값: `180`

신뢰할 수 있는 티켓을 만든 후 해당 티켓을 무효화할 때까지의 기간(초)을 지정합니다.

tryCount

선택 사항입니다.

정수입니다.

기본값: `10`

신뢰할 수 있는 티켓 항목 만들기를 시도하는 횟수를 지정합니다.

use9DigitToken

선택 사항입니다.

`true` | `false`

기본값: `false`

`true`로 설정되면 티켓의 길이가 9자리(버전 8.0 이하)이며, `tokenLength` 옵션이 무시됩니다. 이 옵션은 레거시 코드를 일시적으로 지원하기 위한 것입니다.

**경고**: 이 옵션을 `true`로 설정하면 신뢰할 수 있는 티켓 인증의 보안 강도에 심각하고 부정적인 영향이 발생합니다.

useV2Tickets

선택 사항입니다.

`true` | `false`

기본값: `false`

신뢰할 수 있는 티켓 요청에 대해 기존 URL 형식을 반환할지 여부를 Tableau Server에 지정합니다. 기존 URL 형식에는 24자의 Base64로 인코딩된 문자열이 포함됩니다. Tableau Server 10.3부터 반환되는 URL이 업데이트되었으며 Base64로 인코딩된 UUID 및 24자 보안 임의 문자열이 포함됩니다. 이 옵션은 기존 URL 형식이 필요한 사용자 지정 코드로 신뢰할 수 있는 티켓을 배포한 경우에만 `true`로 설정합니다. 새 URL 형식을 허용하도록 사용자 지정 코드를 업데이트하는 것이 더 좋습니다.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 30%;"><col style="width: 70%;"></colgroup><tbody><tr></tr></tbody></table>