연결된 앱 - 직접 신뢰의 문제 해결
내장된 콘텐츠가 사용자 지정 응용 프로그램에 표시되지 않거나 Tableau REST API 권한 부여가 실패하면 브라우저의 개발자 도구를 사용하여 내장된 콘텐츠를 표시하는 데 사용된 Tableau의 연결된 앱
참고: 세션 토큰이 유효하려면 외부 응용 프로그램의 시계와 외부 응용 프로그램을 호스트하는 서버의 시계가 UTC(협정 세계시)로 설정되어야 합니다. 두 클록이 다른 표준 시간대를 사용하는 경우 연결된 앱을 신뢰할 수 없게 됩니다.
아래의 표를 참조하여 오류 코드 설명 및 가능한 해결 방법을 검토하십시오.
| 오류 코드 | 요약 | 설명 | 잠재적 해결 방법 또는 설명 |
| 5 | SYSTEM_USER_NOT_FOUND | Tableau 사용자를 찾을 수 없음 | sub'(Subject) 클레임 값이 인증된 Tableau Cloud 사용자의 사용자 이름(이메일 주소)인지 확인합니다. 이 값은 대/소문자를 구분합니다. |
| 16 | LOGIN_FAILED | 로그인 실패 | 이 오류는 일반적으로 JWT의 다음 클레임 문제 중 하나로 인해 발생합니다.
|
| 67 | FEATURE_NOT_ENABLED | 주문형 액세스가 지원되지 않음 | 주문형 액세스는 라이선스가 부여된 Tableau Cloud 사이트를 통해서만 사용할 수 있습니다. |
| 126 | CONNECTED_APP_NOT_FOUND | 연결된 앱을 찾을 수 없음 | 이 문제를 해결하려면 연결된 앱이 사용되도록 설정되어 있고 JWT에서 올바른 클라이언트 ID(연결 앱 ID라고도 함)가 참조되는지 확인합니다. |
| 127 | CONNECTED_APP_SECRET_NOT_FOUND | 연결된 앱의 암호를 찾을 수 없음 | 이 문제를 해결하려면 JWT에서 올바르게 연결된 앱의 암호 ID와 암호 값이 참조되는지 확인합니다. |
| 128 | CONNECTED_APP_SECRET_LIMIT_EXCEEDED | 암호의 최대 제한 수에 도달함 | 연결된 앱에는 최대 2개의 암호가 허용됩니다. 이 오류는 세 번째 암호를 만들려고 할 때 발생할 수 있습니다. 이 문제를 해결하려면 새 암호를 만들기 전에 연결된 앱에서 암호를 삭제하십시오. |
| 133 | INVALID_CONNECTED_APP_DOMAIN_SAFELIST | 도메인 허용 목록에 잘못된 문자가 하나 이상 포함되어 있음 | 이 오류는 도메인 허용 목록에 하나 이상의 잘못된 문자가 포함되어 있을 때 발생할 수 있습니다. |
| 10083 | BAD_JWT | JWT 헤더에 문제가 있음 | JWT 헤더에서 'kid'(Secret ID) 또는 'clientId'(Issuer) 클레임이 누락되었습니다. 이 문제를 해결하려면 해당 정보가 포함되어 있는지 확인하십시오. |
| 10084 | JWT_PARSE_ERROR | JWT에 문제가 있음 | 이 문제를 해결하려면 다음을 확인합니다.
|
| 10085 | COULD_NOT_FETCH_JWT_KEYS | JWT에서 키를 찾을 수 없음 | 암호를 찾을 수 없습니다. 이 문제를 해결하려면 JWT 헤더에 올바른 'kid'(암호 ID)가 사용되는지 확인합니다. |
| 10089 | CONNECTED_APP_NOT_FOUND | 연결된 앱을 찾을 수 없음 | 이 문제를 해결하려면 발급자가 올바른 연결된 앱 ID(클라이언트 ID라고도 함)를 호출하는지 확인합니다. |
| 10090 | CONNECTED_APP_DISABLED | 연결된 앱이 사용되지 않도록 설정됨 | 신뢰할 수 있는지 확인하는 데 사용되는 연결된 앱이 사용되지 않도록 설정되었습니다. 이 문제를 해결하려면 연결된 앱을 사용하도록 설정하십시오. |
| 10091 | JTI_ALREADY_USED | 고유한 JWT가 필요함 | JWT가 이미 인증 프로세스에서 사용되었습니다. 이 문제를 해결하려면 새 JWT가 생성되어야 합니다. |
| 10092 | NOT_IN_DOMAIN_ALLOW_LIST | 내장된 콘텐츠의 도메인이 지정되지 않음 | 이 문제를 해결하려면 unrestrictedEmbedding 설정이 true로 설정되거나, 사이트의 내장 설정 업데이트(영문)(링크가 새 창에서 열림) 방법을 사용하여 Tableau REST API에서 Tableau 콘텐츠를 내장할 도메인을 domainAllowlist 매개 변수에 포함해야 합니다. |
| 10094 | MISSING_REQUIRED_JTI | JWT ID 누락 | 이 문제를 해결하려면 'jti'(JWT ID)가 JWT에 포함되어 있는지 확인합니다. |
| 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 크기가 8,000바이트를 초과하는 경우 발생할 수 있습니다. 이 문제를 해결하려면 필요한 클레임만 Tableau Cloud에 전달되는지 확인하십시오. |
| 10105 | ORIGIN_HEADER_NOT_A_VALID_URI | 잘못된 Origin 헤더 | 이 오류는 1) 도메인 허용 목록에 URL이 지정되어 있고 2) Origin 헤더에 유효한 URL이 포함되어 있지 않기 때문에 발생할 수 있습니다. |
| 10106 | ORIGIN_HEADER_NOT_SET | 누락된 Origin 헤더 | 이 오류는 1) 도메인 허용 목록에 URL이 지정되어 있고 2) Origin 헤더가 설정되지 않았기 때문에 발생할 수 있습니다. |