---
schema_version: "1"
id: ea80b99d515b1783deabd41a8e78d92e0e9a319bd9ad4dd901ed31201a4773bf
title: openIDSettings 엔터티
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server/entity_openid.md
canonical_url: https://help.tableau.com/current/server/ko-kr/entity_openid.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 8e99e5cdc1dc92ef5310d4dcb4543d40476020c58e3c2bcb979e7d0bc6c9e3f5
description: Reference for the openIDSettings entity to configure OpenID Connect authentication via JSON.
---
[주요 콘텐츠로 건너뛰기](#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 <commands>](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가 클릭재킹 방지를 사용하지 않도록 설정해야 합니다.