ユーティリティ ライセンス

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 のアップデートを管理します。