MDM で配布する
Jamf Pro、Kandji、Microsoft Intune などのデバイス管理(MDM)ツールで Mac や Windows PC を管理している場合、ライセンスキーファイルを配布して TablePlus を有効化できます。TablePlus は起動時にファイルを読み込み、自動でキーを有効化します。組織のキーを必須に設定すると、そのキーがない限り TablePlus を使用できません。
ライセンスキーファイルは、最新版の macOS 版と Windows 版の TablePlus で使用できます。Setapp 版は読み込みに対応していません。
キーファイルを作成する
.tplicensekey という名前のプレーンテキストファイルを作成し、1 行目にライセンスキーを記入します。
TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
require: true
require の行は省略できます。
require: trueを指定すると、キーを有効化するまで TablePlus を使用できず、ユーザーが別のキーを有効化することもできません。require: falseを指定するかrequireの行を省略すると、TablePlus は組織のキーの有効化を試みます。失敗した場合は、ユーザー自身のライセンスを引き続き利用したり、新たに有効化したりできます。
ファイルの記述方法も確認してください。
- キーは必ず 1 行目に記入します。
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 1 台でライセンスを 1 枠使用します。
以下のスクリプトを 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の制限を強制できません。
有効化したライセンスはキーファイルと同じ場所の /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 1 台でライセンスを 1 枠使用します。
以下の 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の制限を強制できません。
有効化したライセンスはキーファイルと同じ場所の C:\ProgramData\TablePlus\.licensewindows に保存され、PC のどのユーザーも変更できます。ユーザーは C:\ProgramData\TablePlus 内にファイルを作成できる必要があり、既定のアクセス許可で作成できます。キーファイルを配置すると全ユーザーが同じデバイス ID を使うため、ユーザー数にかかわらず PC 1 台で使用するのは 1 枠です。
ユーザーごとに %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 時間以内に新しいキーが有効になります。それまでは以前のライセンスを使い続けられます。
- ライセンスマネージャーでキーを再発行した場合は、キーファイルも新しいキーに更新します。有効化済みの Mac や PC は引き続き使用できますが、有効化が必要なデバイスでは古いキーは使えません。
require: trueを指定していると、そのデバイスでは TablePlus がブロックされます。 - 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 のアップデートを管理します。