Federación de la biblioteca entre instancias
La federación de la biblioteca permite que una instancia de Seatmap obtenga contenido de biblioteca desde otra instancia de Seatmap por HTTP. Úsala cuando ejecutas un despliegue self-hosted y quieres consumir la biblioteca de esquemas publicada desde otra instancia sin replicar la base de datos del editor de biblioteca.
Esta página es el resumen orientado al usuario. Para los pasos técnicos de configuración, contacta al equipo de Seatmap o a tu operador.
Roles
- La instancia de origen publica el contenido de la biblioteca. Emite el acceso de federación para las instancias consumidoras.
- La instancia consumidora se configura con la URL de origen y una credencial de acceso. Obtiene el contenido de la biblioteca bajo demanda y lo renderiza junto a sus propias entradas de biblioteca dentro de la instancia.
Una sola instancia puede ser origen, consumidora o ambas.
Cómo funciona
- Un administrador global en la instancia de origen emite el acceso de federación para el consumidor.
- El operador del consumidor almacena la credencial y configura la URL de origen.
- Cuando los usuarios de la instancia consumidora navegan por la biblioteca, las entradas federadas aparecen en la misma cuadrícula que las entradas dentro de la instancia.
- Cuando un usuario copia un recinto federado, la instancia consumidora obtiene el esquema y los recursos desde el origen por HTTPS, los materializa en la base de datos y el almacén de recursos del consumidor y registra la procedencia.
Qué se aplica
- Autenticación: cada solicitud federada lleva la credencial. El origen la verifica antes de servir el contenido.
- Limitación de tasa: la instancia de origen aplica un límite de tasa por credencial (por defecto 60 solicitudes por minuto, configurable).
- Auditoría: cada extracción exitosa y fallida se registra para su revisión en el lado del origen.
- Semántica de instantáneas: las copias federadas quedan congeladas en el momento de copiar. El consumidor es dueño de la copia a partir de ese momento — las actualizaciones del lado del origen nunca se propagan.
Qué no se federa
- Identidad de usuario — la federación es solo de datos. Los usuarios no inician sesión entre instancias.
- Precios, eventos, reservas — igual que en la biblioteca dentro de la instancia. Solo diseños.
- Extracciones de múltiples orígenes — una instancia consumidora tiene como máximo un origen configurado en esta versión.
Notas de operación
- Las credenciales son revocables pero no rotables. Para rotar, revoca la credencial antigua y emite una nueva — el consumidor debe actualizar su configuración.
- Si el origen es inalcanzable, las entradas federadas simplemente no aparecen en el lado del consumidor. Las entradas de biblioteca dentro de la instancia siguen funcionando.
- La procedencia siempre apunta al origen original — incluso si una copia federada se copia de nuevo más tarde dentro de la instancia consumidora, la copia de segundo orden sigue referenciando la instancia original.