OAuth 2.0 신뢰를 사용하여 연결된 앱 구성
Tableau Cloud 사이트 관리자는 하나 이상의 EAS(외부 권한 부여 서버)를 등록하고 OAuth 2.0 표준 프로토콜을 사용하여 Tableau Cloud 사이트와 EAS 간의 신뢰 관계를 설정할 수 있습니다.
중요:
- 이 항목의 일부 절차에는 타사 소프트웨어 및 서비스를 사용한 구성이 필요합니다. Tableau는 Tableau Cloud에서 EAS 기능을 사용하도록 설정하는 절차를 확인하기 위해 최선을 다했습니다. 그러나 타사 소프트웨어 및 서비스에서 변경되었거나 조직에 따라 다를 수 있습니다. 문제가 발생하는 경우 신뢰할 수 있는 구성 세부 정보 및 지원은 타사 설명서를 참조하십시오.
- 세션 토큰이 유효하려면 외부 응용 프로그램의 시계와 외부 응용 프로그램을 호스트하는 서버의 시계가 UTC(협정 세계시)로 설정되어야 합니다. 두 클록이 다른 표준 시간대를 사용하는 경우 연결된 앱을 신뢰할 수 없게 됩니다.
OAuth 2.0 신뢰와 Tableau 연결된 앱이 작동하는 방식
Tableau Cloud 사이트와 외부 응용 프로그램 간의 신뢰 관계는 JWT(JSON 웹 토큰) 표준의 인증 토큰을 통해 설정되고 검증됩니다.
내장된 Tableau 콘텐츠를 외부 응용 프로그램에 로드하면 인증 코드 흐름인 OAuth 흐름이 사용됩니다. 사용자가 IdP에 로그인하면 자동으로 Tableau Cloud에 로그인됩니다. 아래에 설명된 단계에 따라 EAS를
연결된 앱의 주요 구성 요소
연결된 앱의 다음 구성 요소는 외부 응용 프로그램의 JWT와 함께 작동하여 사용자를 인증하고 내장된 콘텐츠를 표시합니다.
EAS(외부 권한 부여 서버): 일반적으로 사용자와 외부 응용 프로그램 간의 인터페이스 역할을 하는 서버로, 주로 IdP가 이 역할을 수행합니다. 서버는 보호된 Tableau 콘텐츠에 대한 사용자 액세스를 인증하고 권한을 부여합니다.
발급자 URL: EAS 인스턴스를 고유하게 식별하는 URL입니다.
연결된 앱 워크플로우
내장 워크플로우
아래의 다이어그램은 EAS(외부 권한 부여 서버), 외부 응용 프로그램(웹 서버 및 웹 페이지), Tableau 연결 앱 간의 인증이 작동하는 방식을 보여 줍니다.
사용자가 웹 페이지를 방문: 사용자가 웹 페이지의 내장된 콘텐츠를 방문하면 웹 페이지가 외부 응용 프로그램으로 GET 요청을 보냅니다.
외부 응용 프로그램이 요청을 EAS로 리디렉션: 외부 응용 프로그램은 EAS(외부 권한 부여 서버)로 리디렉션되는 웹 페이지로 응답합니다.
EAS로 사용자 인증: EAS를 통해 사용자를 인증하고 권한을 부여합니다.
EAS는 인증 코드로 웹 페이지에 응답: EAS는 인증 코드로 페이지에 응답하고 웹 페이지로 다시 리디렉션합니다.
EAS가 인증 코드를 JWT로 변환: 웹 페이지가 EAS를 호출하여 인증 코드를 JWT로 변환하고, 웹 페이지는 이를 내장된 콘텐츠의 URL에 삽입합니다.
웹 페이지가 Tableau의 콘텐츠를 요청: 웹 페이지가 iFrame을 로드하고 Tableau에 GET 요청을 보냅니다.
Tableau가 토큰 검증: Tableau는 서명이 있는 URL의 JWT 유효성을 검사하고 콘텐츠로 응답하며 JWT에 정의된 내장 범위를 준수합니다.
연결된 앱 만들기
EAS를
| 클레임 | 이름 | 설명 또는 필요한 값 |
"kid" | Key ID | 필수입니다(헤더에 필요). ID 공급자의 고유 키 식별자입니다. |
"iss" | Issuer | 필수입니다(헤더 또는 클레임에 필요). 신뢰할 수 있는 연결된 앱 및 서명 키를 식별하는 고유한 발급자 URI |
"alg" | Algorithm | 필수입니다(헤더에 필요). JWT 서명 알고리즘입니다. 지원되는 알고리즘 이름은 javadoc.io 설명서의 JWSAlgorithm 클래스(영문)(링크가 새 창에서 열림) 페이지에 나열되어 있습니다. |
"sub" | Subject | 인증된 Tableau Cloud 사용자의 사용자 이름 |
"aud" | Audience | 값은 " |
"exp" | Expiration Time | |
"jti" | JWT ID | JWT ID 클레임은 JWT의 고유 식별자를 제공하며 대/소문자를 구분합니다. |
"scp" | Scope | 내장 워크플로우의 경우 지원되는 값은 다음과 같습니다. " 참고:
REST API 권한 부여 워크플로우의 경우 JWT 권한 부여를 지원하는 REST API 메서드를 참조하십시오. 인증을 위해 REST API를 사용하는 메타데이터 API 워크플로우의 경우 유일하게 지원되는 범위는 |
https://tableau.com/oda | On-demand access - claim(기능 사용) | 내장 워크플로우만 해당합니다. 값은 " |
https://tableau.com/groups | On-demand access - claim(그룹 이름 지정) | 내장 워크플로우만 해당합니다. 값은 Tableau Cloud에 있는 하나 이상의 그룹 이름과 일치해야 합니다. 자세한 내용은 아래의 주문형 액세스(내장 워크플로우만 해당) 섹션을 참조하십시오. |
| 동적 그룹 멤버십 | 내장 워크플로우만 해당합니다. 값은 Tableau Cloud에 있는 하나 이상의 그룹 이름과 일치해야 합니다. 자세한 내용은 아래의 동적 그룹 멤버십(내장 워크플로만 해당) 섹션을 참조하십시오. | |
| (사용자 특성) | (사용자 특성 값) | 내장 워크플로우만 해당합니다. 참고:
|
참고: 위의 JWT 클레임은 IETF(Internet Engineering Task Force) 조직에서 배포한 설명서의 등록된 클레임 이름(영문)(링크가 새 창에서 열림) 섹션에 문서화되어 있습니다.
Tableau Cloud에 EAS를 등록하면 EAS와
참고: 일부 EAS는 Tableau 콘텐츠에 대한 응용 프로그램 액세스에 대해 사용자의 승인을 구하는 동의 대화 상자를 표시하는 옵션을 지원합니다. 최상의 사용자 경험을 보장하려면 외부 응용 프로그램의 요청에 사용자 대신 자동으로 동의하도록 EAS를 구성하는 것이 좋습니다.
사이트 수준 EAS 정보
Tableau Server 2024.2부터 사이트 수준 EAS를 구성할 수 있습니다. 사이트 수준에서 EAS를 등록하려면 TSM(Tableau Server Manager)에서 연결된 앱을 사용하도록 설정해야 합니다.
사이트 관리자로 Tableau Cloud에 로그인합니다.
왼쪽 패널에서 설정 > 연결된 앱을 선택합니다.
새 연결된 앱 단추 드롭다운 화살표를 클릭하고 OAuth 2.0 신뢰를 선택합니다.
- 연결된 앱 만들기 대화 상자에서 다음을 수행합니다.
이름 텍스트 상자에 연결된 앱의 이름을 입력합니다.
발급자 URL 텍스트 상자에 EAS의 발급자 URL을 붙여 넣습니다.
연결된 앱 사용을 선택합니다. 연결된 앱은 보안을 위해 앱을 만들 때 기본적으로 사용되지 않도록 설정됩니다.
작업을 마치면 만들기 단추를 클릭합니다.
연결된 앱이 만들어지면 연결된 앱의 사이트 ID를 복사합니다. 사이트 ID는 위의 1단계에서 설명한 JWT의 “aud”(Audience) 클레임에 사용됩니다.
3단계: 다음 단계
내장 워크플로우의 경우
EAS를 사용하도록
Tableau 콘텐츠 내장에 대한 자세한 내용은 다음을 참조하십시오.
- 메트릭을 포함하려면 Tableau 도움말에서 웹 페이지에 메트릭 내장(링크가 새 창에서 열림) 항목을 참조하십시오. (
- Tableau Embedding API v3(링크가 새 창에서 열림)를 사용하여 Tableau 뷰와 메트릭을 내장합니다.
참고: 사용자가 내장된 콘텐츠에 액세스할 때 성공적으로 인증하려면, 타사 쿠키를 허용하도록 브라우저를 구성해야 합니다.
도메인 허용 목록을 사용하여 콘텐츠를 내장할 수 있는 위치 제어
기본적으로 내장에 대한 unrestrictedEmbedding 사이트 설정이 true로 설정되면 무제한 내장이 허용됩니다. 또는 false로 설정하고 allowList 매개 변수를 사용하여 외부 응용 프로그램의 Tableau 콘텐츠를 내장할 수 있는 도메인을 지정할 수 있습니다.
자세한 내용은 다음 중 하나 또는 둘 모두를 참조하십시오.
- 사이트의 내장 설정 업데이트(영문)(링크가 새 창에서 열림) - Tableau REST API 도움말
- 내장 관련 Tableau 사이트 설정(영문)(링크가 새 창에서 열림) - Tableau Embedding API v3 도움말
REST API 권한 부여 워크플로우의 경우
JWT를 구성한 후에는 유효한 JWT를 REST API 로그인 요청에 추가해야 액세스 권한이 부여됩니다. 자세한 내용은 연결된 앱의 액세스 범위를 참조하십시오.
메타데이터 API 워크플로우의 경우
JWT를 구성한 후에는 유효한 JWT를 REST API 로그인 요청에 추가해야 합니다. 자세한 내용은 연결된 앱의 액세스 범위를 참조하십시오.
연결된 앱 관리
2023년 10월부터 내장된 분석 기능(링크가 새 창에서 열림) 사용량 기반 모델로 사이트에 라이선스가 부여된 경우 주문형 액세스를 사용하여 내장된 Tableau 콘텐츠에 대한 액세스를 더 많은 사용자로 확장할 수 있습니다. 주문형 액세스를 사용하면 사용자가 Tableau Cloud 사이트에서 사용자를 프로비저닝할 필요 없이 연결된 앱을 통해 인증된 Tableau 내장 콘텐츠와 상호 작용할 수 있습니다. 주문형 액세스를 사용하면 내장된 콘텐츠에 대한 액세스를 지원하기 위해 Tableau Cloud에서 사용자를 추가하고 관리할 필요가 없습니다.
주문형 액세스 작동 방식
주문형 액세스를 사용하여 내장된 Tableau 콘텐츠에 대한 액세스 권한은 상속되거나(예: 프로젝트 수준에서) 콘텐츠에 직접 적용되는 그룹 수준 사용 권한에 따라 결정됩니다. 사이트 관리자, 프로젝트 소유자 또는 리더, 콘텐츠 소유자 등의 사용자는 콘텐츠에 그룹 수준 사용 권한을 할당할 수 있습니다. 사용자가 주문형 액세스 기능을 통해 활성화된 내장된 콘텐츠에 액세스하면 Tableau는 콘텐츠를 표시하기 전에 JWT에 올바른 그룹 멤버십이 포함되어 있는지 확인합니다.
필수 요건
내장된 콘텐츠에 대한 주문형 액세스를 사용하려면 다음 기준을 충족해야 합니다.
- 내장된 분석 기능(링크가 새 창에서 열림) 모델로 사이트에 라이선스가 부여됨
- 그룹에 주문형 액세스 기능을 사용하도록 설정
- Tableau 콘텐츠에 그룹 사용 권한을 지정
- Tableau 연결된 앱 만들기
- 연결된 앱에서 사용하는 JWT에는
https://tableau.com/oda및https://tableau.com/groups클레임이 포함됩니다. - Tableau 콘텐츠를 외부 응용 프로그램에 내장
이러한 기준이 충족되면 사용자가 주문형 액세스 기능을 통해 활성화된 내장된 Tableau 콘텐츠와 상호 작용할 수 있습니다.
주문형 액세스 기능 사용
그룹에 주문형 액세스 기능을 사용하도록 설정하려면 그룹을 만들거나 편집할 때 주문형 액세스 허용 확인란을 선택해야 합니다. 그룹을 만드는 방법에 대한 자세한 내용은 그룹 만들기와 그룹에 사용자 추가를 참조하십시오.
이 기능은 Tableau REST API를 사용하여 설정할 수도 있습니다. 자세한 내용은 Tableau REST API 도움말의 그룹 만들기(링크가 새 창에서 열림) 및 그룹 업데이트(링크가 새 창에서 열림) 메서드를 참조하십시오.
주문형 액세스를 사용하는 경우의 기능
내장된 Tableau 콘텐츠에 액세스하는 사용자에게는 콘텐츠에 대한 보기 기능(링크가 새 창에서 열림)이 있습니다. 사용자는 그룹에 대해 구성할 수 있는 사용자 지정 기능이나 선택한 템플릿에 관계없이 보기 기능을 갖습니다. 예를 들어 Viewer(뷰어) 역할을 가진 사용자는 특정 데이터 원본에서 해당 기능이 명시적으로 부여된 경우에도 데이터 원본을 다운로드할 수 없습니다.
주문형 액세스 모니터링
Advanced Management(링크가 새 창에서 열림)가 적용된 Tableau Cloud를 사용하면 작업 로그를 사용하여 주문형 액세스 사용량을 모니터링할 수 있습니다. 주문형 액세스를 수집하는 활동 로그의 이벤트에는 뷰 액세스와 로그인이 포함되지만 이에 국한되지는 않습니다. 이러한 이벤트에 대한 자세한 내용은 작업 로그의 site 이벤트 유형 참조를 참조하십시오.
제한 사항
주문형 액세스 워크플로우를 사용하면 내장된 Tableau 콘텐츠에 액세스하는 특정 사용자가 익명으로 그리고 임시로 Tableau Cloud에 액세스할 수 있으므로 주문형 액세스 기능을 통해 활성화된 내장된 콘텐츠에 액세스하는 사용자에게는 다음 기능이 금지됩니다.
- 사용자 지정 뷰 만들기
- 콘텐츠 공유 단추를 사용하여 콘텐츠 공유
- 정보 스냅샷을 이메일로 받기 위한 콘텐츠 구독
참고: 2024년 2월(Tableau 2024.1)부터 주문형 액세스 권한이 있는 사용자는 Tableau REST API 요청을 할 수 있습니다.
구성된 경우 사용자 인증 중에 외부 응용 프로그램은 사용자를 어설션할 그룹((https://tableau.com/groups)과 그룹 이름(예: "Group1" 및 "Group2")이라는 두 개의 사용자 지정 그룹 멤버십 클레임이 포함된 JWT를 전송합니다. Tableau는 JWT의 유효성을 검사한 다음 그룹 및 콘텐츠(사용 권한이 해당 그룹에 따라 달라짐)에 대한 액세스를 허용합니다.
연결된 앱을 사용하는 경우 몇 가지 알려진 문제가 있으며, 이는 향후 릴리스에서 해결될 예정입니다.
툴바 기능: 내장된 콘텐츠에 툴바 매개 변수가 정의되어 있으면 일부 툴바 기능이 작동하지 않습니다. 이 문제를 해결하려면 아래 예와 같이 툴바 매개 변수를 숨기는 것이 좋습니다.
<tableau-viz id='tab-viz' src='https://online.tableau.com/t/<your_site>/...' toolbar='hidden'> </tableau-viz>
게시된 데이터 원본: 데이터베이스 자격 증명이 사용자에게 확인으로 설정된 경우 게시된 데이터 원본이 표시되지 않습니다. 이 문제를 해결하려면 가능한 경우 데이터 원본 소유자가 대신 데이터베이스 자격 증명을 내장하는 것이 좋습니다.
문제 해결
내장된 콘텐츠가 외부 응용 프로그램에 표시되지 않거나 Tableau REST API 권한 부여가 실패하면 브라우저의 개발자 도구를 사용하여
아래의 표를 참조하여 오류 코드 설명 및 가능한 해결 방법을 검토하십시오.
| 오류 코드 | 요약 | 설명 | 잠재적 해결 방법 또는 설명 |
| 5 | SYSTEM_USER_NOT_FOUND | Tableau 사용자를 찾을 수 없음 | sub'(Subject) 클레임 값이 인증된 Tableau Cloud 사용자의 사용자 이름(이메일 주소)인지 확인합니다. 이 값은 대/소문자를 구분합니다. |
| 16 | LOGIN_FAILED | 로그인 실패 | 이 오류는 일반적으로 JWT의 다음 클레임 문제 중 하나로 인해 발생합니다.
|
| 67 | FEATURE_NOT_ENABLED | 주문형 액세스가 지원되지 않음 | 주문형 액세스는 라이선스가 부여된 Tableau Cloud 사이트를 통해서만 사용할 수 있습니다. |
| 142 | EXTERNAL_AUTHORIZATION_SERVER_NOT_FOUND | EAS를 찾을 수 없음 | 이 문제를 해결하려면 올바른 발급자가 호출되는지 확인하십시오. |
| 143 | EXTERNAL_AUTHORIZATION_SERVER_LIMIT_EXCEEDED | EAS 제한 초과 | 사이트가 등록된 외부 권한 부여 서버(EAS)의 최대 허용 수(1)에 도달했습니다. |
| 144 | INVALID_ISSUER_URL | 잘못된 발급자 URL | 발급자 URL이 올바르지 않거나 JWT에서 iss’(Issuer) 특성이 누락되었습니다. |
| 149 | EAS_INVALID_JWKS_URI | JWKS URI 누락 | IdP 메타데이터에 JWKS URI가 없거나 Tableau에 JWKS URI가 구성되지 않았습니다. 이 문제를 해결하려면 올바른 JWKS URI를 구성하십시오. |
| 150 | EAS_RETRIEVE_JWK_SOURCE_FAILED | 키 원본 검색 실패 | 이 문제를 해결하려면 JWKS URI가 올바르게 구성되었는지 확인하십시오. |
| 151 | EAS_RETRIEVE_METADATA_FAILED | issuerUrl에서 메타데이터 검색 실패 | 이 문제를 해결하려면 JWKS URI가 올바르게 구성되었는지 확인하십시오. |
| 10081 | COULD_NOT_RETRIEVE_IDP_METADATA | EAS 메타데이터 끝점이 없음 | 이 문제를 해결하려면 EAS가 올바르게 구성되어 있고 올바른 발급자가 호출되는지 확인하십시오. |
| 10082 | AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED | 발급자가 없음 | 이 문제를 해결하려면 올바른 발급자가 호출되는지 확인하십시오. |
| 10083 | BAD_JWT | JWT 헤더에 문제가 있음 | JWT 헤더에서 'kid'(Secret ID) 또는 'clientId'(Issuer) 클레임이 누락되었습니다. 이 문제를 해결하려면 해당 정보가 포함되어 있는지 확인하십시오. |
| 10084 | JWT_PARSE_ERROR | JWT에 문제가 있음 | 이 문제를 해결하려면 다음을 확인합니다.
|
| 10085 | COULD_NOT_FETCH_JWT_KEYS | JWT에서 키를 찾을 수 없음 | 암호를 찾을 수 없습니다. 이 문제를 해결하려면 올바른 발급자가 호출되는지 확인하십시오. |
| 10087 | BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN | JWT 서명 알고리즘에 문제가 있음 | 이 문제를 해결하려면 서명 알고리즘을 제거하면 됩니다. |
| 10088 | RSA_KEY_SIZE_INVALID | JWT 서명 요구 사항에 문제가 있음 | 이 문제를 해결하려면 EAS 또는 IdP에서 JWT가 2048의 RSA 키 크기로 서명되고 있는지 확인합니다. |
| 10091 | JTI_ALREADY_USED | 고유한 JWT가 필요함 | JWT가 이미 인증 프로세스에서 사용되었습니다. 이 문제를 해결하려면 EAS 또는 IdP에서 새 JWT를 생성해야 합니다. |
| 10092 | NOT_IN_DOMAIN_ALLOW_LIST | 내장된 콘텐츠의 도메인이 지정되지 않음 | 이 문제를 해결하려면 unrestrictedEmbedding 설정이 true로 설정되거나, 사이트의 내장 설정 업데이트(영문)(링크가 새 창에서 열림) 방법을 사용하여 Tableau REST API에서 Tableau 콘텐츠를 내장할 도메인을 domainAllowlist 매개 변수에 포함해야 합니다. |
| 10094 | MISSING_REQUIRED_JTI | JWT ID 누락 | 이 문제를 해결하려면 'jti'(JWT ID)가 JWT에 포함되어 있는지 확인합니다. |
| 10095 | EXTERNAL_AUTHZ_SERVER_DISABLED | EAS 사용 안 함 | 사이트에 등록된 EAS의 연결된 앱이 사용되지 않도록 설정되었습니다. |
| 10096 | JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD | exp'(Expiration Time)가 기본 최대 유효 기간을 초과합니다. 이 문제를 해결하려면 유효한 JWT에 필요한 등록 클레임(링크가 새 창에서 열림)을 검토하고 10분을 초과하지 않는 올바른 값인지 확인하십시오. | |
| 10097 | SCOPES_MALFORMED | Scope 클레임 관련 문제 | 이 오류는 'scp'(Scope) 클레임이 JWT에서 누락되었거나 목록 유형으로 전달되지 않은 경우 발생할 수 있습니다. 이 문제를 해결하려면 'scp'가 JWT에 포함되었고 목록 유형으로 전달되었는지 확인하십시오. JWT 관련 문제 해결 도움말은 auth0 사이트에서 디버거(영문)(링크가 새 창에서 열림)를 참조하십시오. |
| 10098 | JWT_UNSIGNED_OR_ENCRYPTED | JWT가 서명되지 않았거나 암호화되어 있음 | Tableau는 서명되지 않았거나 암호화된 JWT를 지원하지 않습니다. |
| 10099 | SCOPES_MISSING_IN_JWT | Scope 클레임 누락 | JWT에서 필수 'scp'(Scope) 클레임이 누락되었습니다. 이 문제를 해결하려면 'scp'가 JWT에 포함되어 있는지 확인합니다. JWT 관련 문제 해결 도움말은 auth0 사이트에서 디버거(영문)(링크가 새 창에서 열림)를 참조하십시오. |
| 10100 | JTI_PERSISTENCE_FAILED | 예기치 않은 JWT ID 오류 | 'jti'(JWT ID)에 예기치 않은 오류가 있습니다. 이 문제를 해결하려면 새 'jti'를 사용하여 새 JWT를 생성해야 합니다. |
| 10101 | EPHEMERAL_USER_LOGIN_FAILED_SITE_NOT_UBP_ENABLED | 주문형 액세스가 지원되지 않음 | 사이트에는 주문형 액세스를 사용하는 데 필요한 내장된 분석 기능 사용량 기반 모델로 라이선스가 부여되지 않았습니다. 자세한 내용은 라이선스 모델 이해를 참조하십시오. |
| 10102 | EPHEMERAL_USER_NOT_SUPPORTED | iframe-auth 특성을 사용하도록 설정하면 주문형 액세스는 지원되지 않습니다. | 이 오류는 iframe-auth 특성이 사용하도록 설정된 경우 발생할 수 있습니다. 이 문제를 해결하려면 Tableau 내장 API 버전 3.6 이상이 사용되고 있는지 확인하십시오. |
| 10103 | JWT_MAX_SIZE_EXCEEDED | JWT가 최대 크기를 초과함 | 이 오류는 JWT 크기가 8000바이트를 초과하는 경우에 발생할 수 있습니다. 이 문제를 해결하려면 필요한 클레임만 Tableau Cloud에 전달되는지 확인하십시오. |