Ajustes generales
Usa Ajustes generales para configurar el nombre de host y el certificado HTTPS de Engine, sincronizar la hora, cambiar opciones de toda la instancia y crear o restaurar copias de seguridad de la configuración.
Elige este módulo cuandoVas a cambiar hostname, TLS, hora, copia de seguridad o restauración, no un único flujo multimedia.
Usa otro módulo cuandoUsa el módulo multimedia correspondiente para un stream, reproductor, grabación, ruta o sala concretos.
/api/application/getAppInfoAntes de empezar
getAppInfo es un método público de lectura. Las operaciones de configuración, certificados, exportación e importación requieren un x-access-token válido. Usa una cuenta con responsabilidad administrativa sobre la instancia y guarda una copia de la configuración actual antes de cambiar la conectividad o importar una base de datos.
Qué puedes hacer
getAppInfoconsulta información de la aplicación y la instancia.updateHttpConfigmodifica los ajustes HTTP y el nombre de host.updateSslCertificateinstala o sustituye el material TLS.updateCustomSettingscambia las opciones compatibles de la instancia.updateNtpConfigurationconfigura la sincronización horaria.exportDbeimportDbpermiten crear y restaurar copias de seguridad de la configuración.
Flujo de ejemplo
- Consulta la información de la aplicación y exporta la base de datos actual.
- Actualiza el nombre de host y la configuración HTTP.
- Instala el certificado TLS correspondiente.
- Comprueba el panel y la API en la dirección HTTPS definitiva.
Casos de uso habituales
- Migrar una instancia de Engine desde una dirección IP a un nombre de host de producción.
- Rotar un certificado TLS próximo a caducar sin reconstruir los flujos multimedia.
- Guardar la configuración antes de una actualización o un cambio de infraestructura.
Límites y resolución de problemas
Un nombre de host, certificado o ajuste HTTP incorrecto puede dejar la instancia inaccesible. La importación de la base de datos puede sustituir la configuración existente: valida primero la copia y la ventana de mantenimiento. Mantén sincronizada la hora del sistema, ya que los certificados, tokens y flujos distribuidos dependen de ella.
Siguientes pasos
Cuando la conectividad sea estable, configura Puertos, Nodos del clúster o el módulo de ingesta que necesite el flujo.
Configurar el límite HTTP y TLS de Engine
Consulta la configuración, elige el modo HTTP necesario e instala el certificado usado por la API y los servicios de medios.
- Consultar la configuraciónGuarda el modo y estado actuales antes de cambiar el listener.
POST /api/application/getAppInfo - Definir el modo HTTPAplica la configuración revisada del listener HTTP o HTTPS.
POST /api/application/updateHTTPConfig - Instalar el certificadoActualiza el certificado solo tras verificar sus nombres y cadena.
POST /api/application/updateSSLCertificate
Cambiar HTTP o certificados puede interrumpir clientes activos. Valida DNS, cadena, puertos y acceso de reversión.
Consulta públicamente los datos de Callaba Engine antes de realizar cambios globales. No requiere token de API.
La respuesta incluye node_app, stack_version_name, stack_version, custom_settings, http_modes, needLicenceKey, las URL de conferencia en global_module_settings y read_preference.
El campo de éxito se llama suceess. El cliente debe leer exactamente ese nombre.
Variante actual del despliegue y campos de versión del stack, obtenidos del registro de la aplicación y del entorno.
Modos actuales de entrega HTTP almacenados en el registro de la aplicación.
Ajustes de aplicación personalizados persistentes.
Indica si el registro de la aplicación todavía no tiene una clave de licencia.
Valores actuales de wss_server_url y turn_server_url utilizados para la conectividad de las conferencias.
Preferencia de lectura de la base de datos ya resuelta; si no está definida, el backend utiliza su constante de lectura primaria.
El backend actual devuelve este campo con el nombre escrito así, suceess, y con el valor true.