Configuración inicial - MisInstalaciones

Para controlar una instalación remota desde Instalaciones necesitas dos cosas: activar la API en la instalación remota y crear en ella una clave API para el panel. Después das de alta la instalación con su dirección web y esa clave.

El panel se conecta a la instalación remota solo a través de su API: no tienes que instalar nada en ella.

⚙️ Antes de empezar

• La instalación remota debe ser accesible por https://.
• Para activar y desactivar plugins, la instalación remota necesita la versión 2026.1 del programa o superior; para ver su versión, la 2026.4 o superior.
• Necesitas un usuario administrador en la instalación remota.

🔌 1. Activa la API en la instalación remota

1. En la instalación remota, ve al menú Administrador → Panel de control.
2. En la pestaña Por defecto, marca Activar API.
3. Pulsa Guardar.

🔑 2. Crea una clave API para el panel

1. En el mismo Panel de control de la instalación remota, abre la pestaña Claves API y pulsa Nuevo.
2. Escribe una Descripción que la identifique, por ejemplo «Panel de instalaciones», y guarda.
3. Copia la Clave API generada: la necesitarás en el paso 3.
4. Abre la pestaña Reglas y da permisos a estos recursos:
   • users, roles y roleusers: Permitir ACCESO.
   • plugins: Permitir ACCESO y Permitir AÑADIR (sin este último no podrás activar ni desactivar plugins).
   • visorerrores, si usas el plugin VisorErrores: Permitir ACCESO y, para poder borrar errores, Permitir BORRADO.
5. Pulsa Guardar.

También puedes marcar Acceso completo, pero una clave limitada a estos recursos es más segura.

⚠️ Trata la clave como una contraseña: quien la tenga puede hacer en la instalación remota todo lo que permitan sus reglas.

🖥️ 3. Da de alta la instalación en el panel

1. En tu instalación, ve al menú Administrador → Instalaciones y pulsa Nuevo.
2. Rellena Nombre, Dirección web (con https://, por ejemplo https://mi-empresa.com) y Clave API. Observaciones es opcional.
3. Pulsa Guardar.
4. Pulsa Test de conexión. Si todo está bien, verás el aviso «Conexión correcta con la instalación remota.».

Al guardar se cargan las pestañas Plugins, Acerca de y Usuarios con los datos de la instalación remota.

🐞 Pestañas de VisorErrores

Si la instalación remota tiene activado el plugin VisorErrores 1.6 o superior, aparecen además las pestañas Visor de Errores y Logs de base de datos. Con versiones anteriores o sin el plugin no se muestran, y el resto del panel funciona igual.

❗ Si algo no funciona

• «No se pudo conectar con la instalación»: revisa la dirección web y la clave, y comprueba que Activar API está marcado y que la clave está activa.
• «La URL debe empezar por https://»: cambia la dirección web a https://.
• No aparecen las pestañas de VisorErrores: comprueba que VisorErrores 1.6 o superior está activado en la instalación remota.
• «No se pudieron consultar los datos de VisorErrores...»: añade el recurso visorerrores a las reglas de la clave.
• Error al activar o desactivar un plugin: añade Permitir AÑADIR al recurso plugins.