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 업데이트를 관리하세요.