Desplegar con MDM
Si gestionas Mac o PC con Windows mediante una herramienta de gestión de dispositivos (MDM) como Jamf Pro, Kandji o Microsoft Intune, puedes activar TablePlus con un archivo de clave de licencia. TablePlus lo lee al iniciarse y activa la clave automáticamente. También puedes exigir la clave de tu organización para que TablePlus solo se pueda usar con ella.
Las últimas versiones de TablePlus para macOS y Windows admiten archivos de clave de licencia. La versión de Setapp no los lee.
Crear el archivo de clave
Crea un archivo de texto sin formato llamado .tplicensekey y escribe tu clave de licencia en la primera línea.
TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
require: true
La línea require es opcional.
- Con
require: true, TablePlus solo se puede usar una vez activada la clave y los usuarios no pueden activar otra. - Con
require: falseo sin la línearequire, TablePlus intenta activar tu clave. Si no lo consigue, el usuario puede conservar su propia licencia o activar una.
Al escribir el archivo, ten en cuenta lo siguiente.
- Deja la clave en la primera línea. También puedes escribirla como
key: TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. requiretambién admiteyesyno,1y0, oonyoff. La sintaxisrequire = truetambién funciona. Cualquier otro valor se interpreta comotrue.- Las líneas que empiezan por
#son comentarios.
Instalar el archivo de clave en un Mac
Instala el archivo en /Users/Shared/.tplicensekey. Debe pertenecer a root y solo root debe poder escribir en él (propietario y grupo root:wheel, modo 0644). TablePlus activa la clave para todos los usuarios del Mac y consume un solo puesto por Mac.
Ejecuta este script como root, por ejemplo desde una política de 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"
Al igual que en el script, root debe ser el propietario del archivo y tener acceso exclusivo de escritura. TablePlus aplica el archivo de clave de
/Users/Sharedindependientemente de quién sea el propietario. Si un usuario puede modificarlo o eliminarlo, la restricciónrequiredeja de ser efectiva.
TablePlus guarda la licencia activada junto al archivo de clave, en /Users/Shared/.licensemac. Si creas ese archivo de antemano, permite que todos los usuarios escriban en él (modo 0666). Si el archivo existe y el usuario no puede escribir en él, la activación falla con el mensaje «TablePlus couldn't save the license in /Users/Shared.».
También puedes instalar un archivo de clave para un solo usuario en ~/Library/Application Support/com.tinyapp.TablePlus/.tplicensekey. Como los usuarios pueden eliminar los archivos de su propia carpeta, TablePlus ignora require en esa ubicación.
Instalar el archivo de clave en Windows
Un administrador debe crear el archivo en C:\ProgramData\TablePlus\.tplicensekey y dar a los usuarios acceso de solo lectura. TablePlus activa la clave para todos los usuarios del PC y consume un solo puesto por equipo.
Ejecuta este script de PowerShell como administrador o como SYSTEM, por ejemplo como script de plataforma de 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
Como en el script, los administradores deben ser los propietarios de la carpeta y los usuarios solo deben poder leer el archivo de clave. TablePlus aplica el archivo de
C:\ProgramData\TablePluscon independencia de quién lo haya creado. Si los usuarios pueden modificarlo o eliminarlo, la restricciónrequiredeja de ser efectiva.
TablePlus guarda la licencia activada junto al archivo de clave, en C:\ProgramData\TablePlus\.licensewindows, y permite que cualquier usuario del PC la modifique. Los usuarios deben poder crear archivos en C:\ProgramData\TablePlus, como permiten los permisos predeterminados. Cuando el archivo de clave está instalado, todos los usuarios de TablePlus comparten el mismo ID de dispositivo y el PC consume un solo puesto, independientemente del número de usuarios.
También puedes instalar un archivo de clave para un solo usuario en %LOCALAPPDATA%\com.tinyapp.TablePlus\.tplicensekey. Como los usuarios pueden eliminar archivos de su propia carpeta, TablePlus ignora require en esa ubicación.
Qué ven los usuarios
| Estado en el Mac o PC | Qué hace TablePlus al iniciarse |
|---|---|
| No hay licencia | Activa la clave de tu organización sin preguntar. |
| Hay una licencia introducida por el usuario | Informa de que la organización gestiona TablePlus en ese Mac o PC y activa la clave de la organización en lugar de la del usuario. El puesto de la licencia anterior queda libre para otro dispositivo. |
| La clave de la organización ya está activa | No hace nada. La ventana de licencia oculta Unlink This Mac (Unlink This Device en Windows). |
Con require: true, TablePlus se comporta de la siguiente manera.
- Mientras se activa la clave, TablePlus muestra «Activating license key» antes de abrir cualquier ventana o conexión. Si falla, explica el motivo y ofrece Try Again y Quit. También ofrece Email License Owner si no quedan puestos o terminó el periodo de actualizaciones, Download the Old Build si la versión es demasiado reciente para la licencia y Download TablePlus si se ha retirado esa compilación. Reintenta automáticamente cada minuto mientras no pueda conectar con el servidor de licencias, y cada 15 minutos en los demás casos.
- Los usuarios no pueden activar otra clave. Al solicitar una clave, la ventana de licencia (TablePlus > Register license... en Mac y Preferences > License en Windows) muestra la de tu organización parcialmente oculta y solo permite activar esa.
- TablePlus no interrumpe las sesiones en curso. Si el Mac o PC pierde la licencia mientras TablePlus está abierto, intenta reactivar la clave de la organización y muestra un aviso si falla. En ese caso, el bloqueo se aplica a partir del siguiente inicio.
- En el primer inicio es necesario poder conectar con tableplus.com.
Con require: false, si la clave de la organización no se puede activar, los usuarios conservan su licencia o pueden activar una propia. TablePlus vuelve a intentar activar la clave de la organización en el siguiente inicio.
Restringir funciones y actualizaciones
En el gestor de licencias, la sección TablePlus policy de una clave se aplica a todos los Mac y PC con Windows activados con esa clave.
- Disable MCP Server, Disable AI Chat y Disable crash reports desactivan las funciones correspondientes. En su lugar los usuarios ven «Disabled by the license owner».
- Disable query history impide que TablePlus registre el historial de consultas. La pestaña History muestra «Disabled by the license owner» y los clientes MCP no pueden leer el historial. El historial ya registrado se conserva en el Mac.
- Updates - macOS mantiene los Mac en la versión elegida y Updates - Windows hace lo mismo en los PC con Windows. Auto los actualiza a la versión más reciente que permita la licencia.
TablePlus comprueba los cambios al iniciarse y cada 6 horas. Si un Mac o PC pierde la licencia, mantiene la última política mientras el archivo de clave siga instalado. Si no ves la sección de políticas, pídenos que la habilitemos para tu clave.
Gestor de licencias: https://tableplus.com/license-manager/access-link
Si tu herramienta MDM instala las actualizaciones de TablePlus, instala únicamente versiones cubiertas por la licencia, o la elegida en Updates - macOS o Updates - Windows. Las versiones publicadas después de finalizar el periodo de actualizaciones no se pueden activar. Con
require: true, TablePlus queda bloqueado hasta que se instale una compilación anterior.
Cambiar o eliminar la clave
- Cambiar la clave. Sustituye el archivo. TablePlus activa la nueva clave la próxima vez que se inicie o en un plazo de 6 horas. La licencia anterior sigue funcionando hasta entonces.
- Rotar la clave en el gestor de licencias. Actualiza también el archivo con la clave nueva. Los Mac y PC ya activados siguen funcionando. Un equipo que necesite activarse no puede usar la clave anterior y queda bloqueado con
require: true. - Liberar un Mac o PC. Elimina el archivo de clave o déjalo vacío. En el siguiente inicio o comprobación, TablePlus da de baja el equipo, libera su puesto y levanta las restricciones.
Solución de problemas
| Mensaje | Solución |
|---|---|
| All seats on this license are in use. | Elimina los dispositivos que ya no uses en el gestor de licencias o añade puestos. |
| This license key isn't valid. | Comprueba la clave del archivo, sobre todo si acabas de rotarla. |
| This version of TablePlus was released after the license's updates ended. | Instala una compilación anterior o renueva la licencia. |
| TablePlus couldn't reach the license server. | Comprueba que el Mac o PC pueda conectar con tableplus.com. |
| TablePlus couldn't save the license in /Users/Shared. | Elimina /Users/Shared/.licensemac o permite que todos los usuarios escriban en ese archivo. |
| TablePlus couldn't save the license in C:\ProgramData\TablePlus. | Comprueba que los usuarios puedan crear archivos en C:\ProgramData\TablePlus y elimina cualquier archivo .licensewindows de esa carpeta que no puedan modificar. |
Los administradores locales pueden eliminar el archivo de clave. Para mantener todos los Mac y PC en una versión compatible con estos archivos, gestiona las actualizaciones de TablePlus con la herramienta MDM.