Tableau Server Personal Access Token(PAT) 활성화 가이드

1. Personal Access Token(PAT)란?

Tableau Server와 Tableau Cloud에서 사용자 인증을 자동화할 수 있도록 제공하는 비밀번호 기반 인증 대체 방식입니다. PAT는 Tableau REST API 및 Tableau Server Client(TSC) 사용 시 편리하며, 세션을 유지할 필요 없이 스크립트 기반 인증을 수행할 수 있습니다.

 

2. PAT 활성화 및 생성 절차

2.1. Tableau Server 관리자 설정에서 PAT 활성화

PAT를 사용하려면 Tableau Server 또는 Tableau Cloud 관리자가 PAT를 활성화해야 합니다.

1. Tableau Server에 관리자 계정으로 로그인합니다.
2. 사이트 관리 > 설정(Settings)으로 이동합니다.
3. 보안(Security) 섹션에서 “Personal Access Tokens 활성화” 옵션을 체크합니다.
4. “저장(Save)“을 클릭하여 변경 사항을 적용합니다.

2.2. PAT 생성하기

PAT를 생성하려면 다음 단계를 따릅니다.

1) Tableau Cloud / Server에서 PAT 생성

1. Tableau Server 또는 Tableau Cloud에 로그인합니다.
2. 우측 상단 프로필 아이콘을 클릭 후 “내 계정 설정(My Account Settings)” 선택
3. Personal Access Tokens 섹션에서 “새 토큰 생성(Create New Token)” 클릭
4. 토큰 이름을 입력하고 “생성(Create)” 버튼을 클릭
5. 생성된 PAT 값을 복사하여 안전한 곳에 저장합니다. (한 번만 표시됨)

2) PAT 보안 유지

• PAT는 비밀번호처럼 취급해야 하며, 외부에 노출되지 않도록 주의합니다.
• Tableau Server에서 PAT 만료 기간(기본 1년)을 설정할 수 있습니다.
• 만료되면 새로운 PAT를 생성하고 업데이트해야 합니다.

 

3. PAT를 사용한 Tableau Server 인증 (Python 예제)

PAT를 사용하여 Tableau REST API 또는 Tableau Server Client(TSC)에 로그인할 수 있습니다.

Python 코드 예제 (TSC 라이브러리 사용)

import tableauserverclient as TSC

# Tableau Server 정보
my_server_url = "https://your-tableau-server.com/"
my_token_name = "your_token_name"  # 생성한 PAT 이름
my_token_secret = "your_token_value"  # 생성한 PAT 값
my_site_id = ""  # 기본 사이트일 경우 빈 문자열 ("") 사용

# Tableau 인증
tableau_auth = TSC.PersonalAccessTokenAuth(
    token_name=my_token_name,
    personal_access_token=my_token_secret,
    site_id=my_site_id
)
server = TSC.Server(my_server_url, use_server_version=True)

# 로그인 시도
with server.auth.sign_in_with_personal_access_token(tableau_auth):
    print(f"[Logged in successfully to {my_server_url}]")

 

4. PAT 관리 및 삭제

4.1. PAT 만료 및 자동 삭제

• PAT는 관리자가 설정한 기간이 지나면 자동으로 만료됩니다.
• 만료되기 전에 새로운 PAT를 발급하고 기존 PAT를 삭제하는 것이 좋습니다.

4.2. 기존 PAT 삭제 방법

1. Tableau Cloud/Server에 로그인 후 “내 계정 설정(My Account Settings)“으로 이동
2. Personal Access Tokens 섹션에서 기존 PAT 목록 확인
3. 삭제할 PAT 옆의 “삭제(Delete)” 버튼을 클릭

 

5. 주의사항 및 보안 권장 사항

✔ PAT를 코드에 하드코딩하지 말고 환경 변수(.env) 또는 보안 저장소에 저장하세요.
✔ 만료 전에 새로운 PAT를 생성하고, 오래된 PAT는 삭제하세요.
✔ Tableau Server 관리자는 PAT 사용 여부와 만료 기간을 적절히 설정해야 합니다.
✔ PAT를 사용할 때는 최소 권한 원칙을 적용하여 불필요한 권한을 부여하지 마세요.