유틸리티 라이선스

MDM으로 배포하기

Jamf Pro, Kandji, Microsoft Intune 같은 기기 관리(MDM) 도구로 Mac 또는 Windows PC를 관리한다면 라이선스 키 파일로 TablePlus를 활성화할 수 있습니다. TablePlus가 시작할 때 파일을 읽고 키를 자동으로 활성화합니다. 조직의 키가 있어야만 TablePlus를 사용할 수 있도록 설정할 수도 있습니다.

최신 macOS용 및 Windows용 TablePlus는 라이선스 키 파일을 지원합니다. Setapp 버전은 이 파일을 읽지 않습니다.

키 파일 만들기

.tplicensekey 라는 일반 텍스트 파일을 만들어 첫 줄에 라이선스 키를 입력합니다.

TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
require: true

require 줄은 선택 사항입니다.

  • require: true 를 지정하면 키를 활성화해야만 TablePlus를 사용할 수 있으며 사용자는 다른 키를 활성화할 수 없습니다.
  • require: false 를 설정하거나 require 줄을 생략하면 TablePlus가 조직의 키를 활성화하려고 합니다. 실패하면 사용자는 자신의 라이선스를 계속 사용하거나 새로 활성화할 수 있습니다.

파일을 작성할 때 다음 사항을 확인하세요.

  • 키는 반드시 첫 줄에 적습니다. key: TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX 형식도 사용할 수 있습니다.
  • require 에는 yes 와 no, 1 과 0, on 과 off 도 사용할 수 있으며 require = true 형식도 지원합니다. 다른 값은 모두 true 로 처리합니다.
  • # 로 시작하는 줄은 주석입니다.

Mac에 키 파일 설치하기

/Users/Shared/.tplicensekey 에 파일을 설치하고 root가 소유하며 root만 쓸 수 있도록 설정합니다(소유자와 그룹 root:wheel, 모드 0644). 그러면 Mac의 모든 사용자를 대상으로 키가 활성화되며 Mac 한 대당 라이선스 한 자리만 사용합니다.

다음 스크립트를 root로 실행합니다. 예를 들어 MDM 정책의 스크립트로 실행할 수 있습니다.

#!/bin/sh
set -e
KEY_FILE="/Users/Shared/.tplicensekey"

# Any user can create files in /Users/Shared: remove whatever is there first
rm -rf "$KEY_FILE"
printf '%s\n' "TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" "require: true" > "$KEY_FILE"
chown root:wheel "$KEY_FILE"
chmod 0644 "$KEY_FILE"

스크립트와 같이 파일을 root 소유로 두고 root만 쓸 수 있게 하세요. TablePlus는 소유자와 관계없이 /Users/Shared 의 키 파일을 적용하므로 사용자가 파일을 수정하거나 삭제할 수 있으면 require 제한을 강제할 수 없습니다.

TablePlus는 활성화된 라이선스를 키 파일 옆의 /Users/Shared/.licensemac 에 저장합니다. 이 파일을 미리 만든다면 모든 사용자에게 쓰기 권한을 부여하세요(모드 0666). 파일이 이미 있지만 사용자가 쓸 수 없으면 “TablePlus couldn't save the license in /Users/Shared.” 메시지가 표시되고 활성화가 실패합니다.

사용자 한 명에게만 적용하려면 ~/Library/Application Support/com.tinyapp.TablePlus/.tplicensekey 에 키 파일을 설치할 수 있습니다. 사용자는 자기 폴더의 파일을 삭제할 수 있으므로 TablePlus는 이 위치에서 require 를 무시합니다.

Windows에 키 파일 설치하기

관리자가 C:\ProgramData\TablePlus\.tplicensekey 에 파일을 만들고 일반 사용자의 권한은 읽기 전용으로 설정합니다. TablePlus가 이 PC의 모든 사용자를 대상으로 키를 활성화하며 PC 한 대당 라이선스 한 자리만 사용합니다.

다음 PowerShell 스크립트를 관리자 또는 SYSTEM으로 실행합니다. 예를 들어 Intune의 플랫폼 스크립트로 배포할 수 있습니다.

$folder = Join-Path $env:ProgramData "TablePlus"
$file = Join-Path $folder ".tplicensekey"

New-Item -ItemType Directory -Force -Path $folder | Out-Null
# A user may have created the folder first: it becomes the administrators' again, with the default permissions
icacls $folder /setowner "*S-1-5-32-544" | Out-Null
icacls $folder /reset | Out-Null

Remove-Item -Force -ErrorAction SilentlyContinue $file
Set-Content -Path $file -Encoding ASCII -Value "TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "require: true"
# Users can read the key file, but not change or remove it
icacls $file /inheritance:r /grant:r "*S-1-5-18:F" "*S-1-5-32-544:F" "*S-1-5-32-545:R" | Out-Null

스크립트와 같이 관리자가 폴더를 소유하고 일반 사용자는 키 파일을 읽을 수만 있게 하세요. TablePlus는 작성자와 관계없이 C:\ProgramData\TablePlus 의 키 파일을 적용하므로 사용자가 파일을 수정하거나 삭제할 수 있으면 require 제한을 강제할 수 없습니다.

TablePlus는 활성화된 라이선스를 키 파일 옆의 C:\ProgramData\TablePlus\.licensewindows 에 저장하고 PC의 모든 사용자가 변경할 수 있게 합니다. 사용자는 기본 권한 설정대로 C:\ProgramData\TablePlus 에 파일을 만들 수 있어야 합니다. 키 파일이 있으면 모든 사용자의 TablePlus가 같은 기기 ID를 사용하므로 사용자 수와 관계없이 PC 한 대당 한 자리만 사용합니다.

사용자 한 명에게만 적용하려면 %LOCALAPPDATA%\com.tinyapp.TablePlus\.tplicensekey 에 키 파일을 설치할 수 있습니다. 사용자는 자기 폴더의 파일을 삭제할 수 있으므로 TablePlus는 이 위치에서 require 를 무시합니다.

사용자에게 표시되는 내용

Mac 또는 PC의 상태 TablePlus 시작 시 동작
라이선스 없음 사용자에게 묻지 않고 조직의 키를 활성화합니다.
사용자가 입력한 라이선스 있음 조직이 이 Mac 또는 PC의 TablePlus를 관리한다고 알리고 사용자 키를 조직의 키로 교체해 활성화합니다. 사용자가 쓰던 라이선스 자리는 다른 기기에서 사용할 수 있습니다.
조직의 키로 이미 활성화됨 아무 작업도 하지 않습니다. 라이선스 창에서 Unlink This Mac (Windows에서는 Unlink This Device) 버튼이 숨겨집니다.

require: true 로 설정하면 다음과 같이 동작합니다.

  • 키가 활성화될 때까지 TablePlus는 어떤 창이나 연결도 열기 전에 “Activating license key”를 표시합니다. 실패하면 이유와 함께 Try Again 및 Quit 를 표시합니다. 사용 가능한 자리가 없거나 업데이트 기간이 끝났으면 Email License Owner, 버전이 라이선스에서 허용하는 것보다 최신이면 Download the Old Build, 해당 빌드의 배포가 철회되었으면 Download TablePlus 도 표시합니다. 라이선스 서버에 연결할 수 없는 동안에는 1분마다, 그 밖의 경우에는 15분마다 자동으로 다시 시도합니다.
  • 사용자는 다른 키를 활성화할 수 없습니다. 라이선스 창(Mac은 TablePlus > Register license..., Windows는 Preferences > License)에는 일부가 가려진 조직의 키가 표시되며 해당 키만 활성화할 수 있습니다.
  • 사용 중인 세션이 중간에 멈추지는 않습니다. TablePlus가 열린 상태에서 Mac이나 PC가 라이선스를 잃으면 조직의 키를 다시 활성화하고, 실패하면 알림을 표시합니다. 이 경우 다음 실행부터 TablePlus가 차단됩니다.
  • 처음 실행할 때 tableplus.com에 연결할 수 있어야 합니다.

require: false 로 설정하면 조직의 키를 활성화하지 못해도 사용자는 자신의 라이선스를 유지하거나 새로 활성화할 수 있습니다. TablePlus는 다음 실행 시 조직의 키를 다시 시도합니다.

기능 및 업데이트 제한하기

라이선스 관리자의 TablePlus policy 항목에서 키마다 설정한 정책이 해당 키로 활성화한 모든 Mac과 Windows PC에 적용됩니다.

  • Disable MCP Server, Disable AI Chat, Disable crash reports 는 각각 해당 기능을 비활성화합니다. 기능이 있던 자리에는 “Disabled by the license owner”가 표시됩니다.
  • Disable query history 를 사용하면 쿼리 기록 저장을 중지합니다. History 탭에 “Disabled by the license owner”가 표시되며 MCP 클라이언트는 기록을 읽을 수 없습니다. 기존 기록은 Mac에 그대로 남습니다.
  • Updates - macOS 로 Mac의 버전을, Updates - Windows 로 Windows PC의 버전을 지정한 버전으로 유지합니다. Auto 는 라이선스가 허용하는 최신 버전으로 업데이트합니다.

TablePlus는 시작할 때와 이후 6시간마다 정책 변경을 확인합니다. Mac이나 PC가 라이선스를 잃어도 키 파일이 설치되어 있는 동안에는 마지막 정책을 유지합니다. 정책 항목이 보이지 않으면 해당 키에 기능을 활성화해 달라고 문의하세요.

라이선스 관리자: https://tableplus.com/license-manager/access-link

MDM 도구가 TablePlus 업데이트를 설치한다면 라이선스 범위에 포함된 버전이나 Updates - macOS 또는 Updates - Windows 에서 선택한 버전만 설치하세요. 업데이트 기간이 끝난 후 출시된 버전은 활성화할 수 없으며 require: true 를 설정한 경우 이전 빌드를 설치할 때까지 TablePlus가 차단됩니다.

키 변경 또는 제거하기

  • 키 변경: 파일을 교체합니다. 다음 실행 시 또는 6시간 이내에 TablePlus가 새 키를 활성화합니다. 새 키가 활성화될 때까지 기존 라이선스가 계속 작동합니다.
  • 라이선스 관리자에서 키 재발급: 키 파일도 새 키로 업데이트하세요. 이미 활성화된 Mac과 PC는 계속 작동하지만 새로 활성화해야 하는 기기는 이전 키를 사용할 수 없으며 require: true 로 설정되어 있으면 차단됩니다.
  • Mac 또는 PC 등록 해제: 키 파일을 삭제하거나 내용을 비웁니다. 다음 실행 또는 확인 시 TablePlus가 기기 등록을 해제하고 라이선스 자리를 반환하며 제한을 해제합니다.

문제 해결

메시지 해결 방법
All seats on this license are in use. 라이선스 관리자에서 더 이상 사용하지 않는 기기를 제거하거나 사용 가능 기기 수를 늘리세요.
This license key isn't valid. 파일의 키를 확인하세요. 키를 재발급한 직후라면 특히 주의하세요.
This version of TablePlus was released after the license's updates ended. 이전 빌드를 설치하거나 라이선스를 갱신하세요.
TablePlus couldn't reach the license server. Mac 또는 PC에서 tableplus.com에 연결할 수 있는지 확인하세요.
TablePlus couldn't save the license in /Users/Shared. /Users/Shared/.licensemac 를 제거하거나 모든 사용자가 해당 파일에 쓸 수 있게 하세요.
TablePlus couldn't save the license in C:\ProgramData\TablePlus. 사용자가 C:\ProgramData\TablePlus 에 파일을 만들 수 있는지 확인하고 그 위치에 사용자가 변경할 수 없는 .licensewindows 파일이 있으면 삭제하세요.

로컬 관리자는 여전히 키 파일을 삭제할 수 있습니다. 모든 Mac과 PC에서 키 파일을 지원하는 버전을 유지하려면 MDM 도구로 TablePlus 업데이트를 관리하세요.