---
schema_version: "1"
id: 05a50d6c284fa018d0d976f544351d1f93e5825a208ef72ec4086463d75d3c38
title: web-data-connector-settings 엔터티
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server/entity_wdc.md
canonical_url: https://help.tableau.com/current/server/ko-kr/entity_wdc.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 789d5057df0fad56b691ff3a4d653cb87707e4034e5e7937e97c09ae03697244
description: Reference for the web-data-connector-settings entity to manage WDC settings via JSON.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# web-data-connector-settings 엔터티

이 엔터티는 WDC(웹 데이터 커넥터) 설정을 관리하는 데 사용됩니다. Tableau Server에서 WDC를 사용하는 것에 대해 자세히 알아보려면 [Tableau Server의 웹 데이터 커넥터](https://help.tableau.com/current/server/ko-kr/datasource_wdc.htm) 및 [tsm data-access](https://help.tableau.com/current/server/ko-kr/cli_data-access.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)를 참조하십시오.

### 웹 데이터 커넥터 설정

아래 템플릿의 WDC(웹 데이터 커넥터) 설정은 WDC 사용 여부, WDC 새로 고침 사용 여부 및 주/보조 허용 목록을 지정합니다. 허용 목록은 Tableau Server 설치에서 사용하도록 승인된 WDC URL과 커넥터에서 요청을 보내고 받을 수 있는 도메인 또는 URL을 지정합니다.

### 구성 템플릿

이 템플릿을 사용하여 WDC 설정을 구성합니다.

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

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

{
  "configEntities": {
    "web-data-connector-settings": {
      "\_type": "webDataConnectorSettingsType",
      "refreshEnabled": true,
      "whitelist": {
        "https://www.example.com:443/wdc/": {
          "secondaryWhitelist": \[
          "https://www.example.com/.\*",
          "https://www.coolapi.com/.\*"
          \]
        }
      },
      "enabled": true
    }
  }
}

{
  "configEntities": {
    "web-data-connector-settings": {
      "\_type": "webDataConnectorSettingsType",
      "refreshEnabled": true,
      "whitelist": {
        "https://www.example.com:443/wdc/": {
          "secondaryWhitelist": \[
          "https://www.example.com/.\*"
          \]
        },
        "https://www.mysite.com:443/coolwdc/": {
          "secondaryWhitelist": \[
          "https://www.mysite.com/.\*",
          "https://www.coolapi.com/.\*"
          \]
        }
      },
      "enabled": true
    }
  }
}

### 구성 파일 참조

다음 표에는 `web-data-connector-settings` 엔터티 집합과 함께 포함할 수 있는 모든 옵션이 나열되어 있습니다.

\_type

필수 항목입니다.

값: `webDataConnectorSettingsType`

변경하지 마십시오.

refreshEnabled

WDC 새로 고침을 사용하지 않도록 설정하려면 `false`로 설정합니다. 기본값은 `true`입니다.

whitelist

필수 항목입니다.

허용 목록 및 보조 허용 목록의 일치하는 집합을 하나 이상 포함할 수 있습니다(WDC당 집합 하나). 제공된 첫 번째 URL이 허용 목록이며, 다음과 같은 형식으로 WDC URL 및 포트를 지정합니다.

`<scheme>://<host>:<port>/<path>`

많은 WDC에서 `<port>` 값은 HTTPS의 기본 포트인 443이지만 Tableau Server 또는 Tableau Cloud에서 데이터 원본 세부 정보를 조사하여 커넥터의 값을 확인할 수 있습니다.

secondaryWhitelist

필수 항목입니다.

커넥터가 요청을 보내고 받을 수 있는 도메인 또는 URL(예: 외부 JavaScript 라이브러리, REST API 또는 로컬 파일)을 지정합니다. 이 보조 허용 목록에 전체 도메인을 추가하려면 URL 끝에 와일드카드 식 `.*`을 사용할 수 있습니다. 다음 예를 참조하십시오.

`https://www.example.com/.*`  

enabled

WDC를 사용하지 않도록 설정하려면 `false`로 설정합니다. 기본값은 `true`입니다.