Versión 1.2.0 · La publicación comercial en Atlassian Marketplace está en preparación. Esta documentación describe las funciones de la versión candidata.
Primer escaneo
- Un administrador instala la app y concede los permisos solicitados en Confluence Cloud.
- Abre Administración de Confluence → Apps → Broken Link Guard.
- En Configuración, elige los espacios que quieres revisar. Una selección vacía abarca los espacios accesibles para la app. Puedes incluir entradas de blog.
- Guarda la configuración e inicia el escaneo. El panel muestra el avance y conserva el último informe terminado.
- Abre los grupos de enlaces para revisar los documentos afectados y las causas encontradas.
Interpretar el informe
La app distingue enlaces correctos, rotos, pendientes de revisión, no verificados y omitidos. Un recurso que Confluence responde como inexistente o restringido requiere revisión: un error 404 por sí solo no demuestra que el contenido se haya eliminado.
El análisis revisa los enlaces que puede extraer del contenido compatible, incluidos destinos de páginas y referencias a adjuntos. Contenido restringido, formatos no compatibles, límites de procesamiento y errores de permisos pueden reducir el alcance. Consulta los avisos del informe antes de considerarlo completo.
Reparar un enlace
- Selecciona un hallazgo y el destino de sustitución.
- Genera una vista previa. Comprueba el documento, el enlace de origen, el destino y el número de coincidencias.
- Confirma la reparación. La app vuelve a comprobar permisos, versión y contenido antes de escribir.
- Abre el documento en Confluence y comprueba el enlace. El historial muestra la confirmación o cualquier resultado incierto.
Una vista previa caduca a los 30 minutos. Si cambia el documento o existe un borrador diferente, crea una nueva vista previa. La app puede bloquear una operación cuando no puede verificar con seguridad su estado.
Revertir y recuperar
Las reparaciones confirmadas ofrecen reversión durante un máximo de siete días, dentro de la conservación disponible. La reversión exige que el documento conserve la versión y el contenido esperados. Si otra persona lo ha editado, el historial de versiones de Confluence permite revisar el cambio manualmente.
Si se interrumpe una operación, consulta su historial y utiliza la comprobación de estado disponible. No repitas una escritura cuando el resultado todavía sea incierto.
Comprobaciones externas opcionales
Están desactivadas inicialmente. Para activarlas, autoriza hasta 20 dominios públicos exactos, sin rutas ni comodines. La app realiza solicitudes HTTPS de tipo HEAD; no envía credenciales de Confluence ni el cuerpo de los documentos.
El servidor de destino recibe la URL solicitada, incluidos ruta y parámetros permitidos, y puede registrarla. Evita autorizar dominios cuyos enlaces incluyan información confidencial. Se bloquean IP literales, direcciones privadas, credenciales en la URL y parámetros comunes de autenticación. Las redirecciones también deben cumplir la lista permitida.
Un primer 404 externo queda pendiente de revisión; requiere otra observación al menos cinco minutos después para confirmarlo. Los servidores que rechazan HEAD o necesitan autenticación pueden quedar sin verificar.
Límites y seguimiento
Puedes seleccionar hasta 10 espacios y procesar bloques de 1 a 500 documentos. El seguimiento semanal genera informes; las reparaciones requieren confirmación del administrador. Los límites de Forge y Confluence pueden pausar, retrasar o impedir una operación. La configuración de bloques permite continuar un escaneo por etapas.
Licencia y ayuda
Se requiere licencia activa o de evaluación para iniciar escaneos y aplicar cambios. Con la licencia inactiva se conserva el acceso administrativo a informes e historial disponibles; la conservación sigue aplicándose.
Contactar con soporte · Datos y conservación
Comprobaciones externas y copias temporales
Al activar las comprobaciones externas de Broken Link Guard, se envía la URL al destino permitido y únicamente el nombre del dominio a Cloudflare 1.1.1.1 mediante DNS por HTTPS. Esta consulta de registros A y AAAA permite rechazar direcciones privadas o reservadas antes de comprobar el enlace. Si no se valida el DNS, no se consulta el destino. La función está desactivada inicialmente. Cloudflare no recibe del programa las rutas, consultas, cuerpos de páginas ni perfiles Atlassian; recibe el dominio y los metadatos de conexión de Forge. Se aplica su política del resolver público. El administrador debe valorar estos destinos y proveedores antes de activar la función.
Las copias para reparación contienen el cuerpo del documento. Se registran los identificadores de cuentas mencionadas mediante etiquetas estructuradas de Confluence para atender las señales de privacidad. Se admite un máximo de 100 cuentas distintas por documento en una vista previa; por encima se solicita edición manual. El texto libre no se convierte en un directorio de personas. La eliminación de una cuenta registrada también elimina los planes y fragmentos de copia vinculados a ella. El registro de privacidad cubre la conservación restante de cada plan.
El almacenamiento persistente utiliza Forge KVS. Broken Link Guard no anuncia el estado PINNED ni una garantía propia de residencia de toda la aplicación mientras conserve la declaración de salida externa configurable. Los servicios DNS, destinos externos, procesamiento transitorio y comunicaciones de soporte no quedan cubiertos por una promesa de almacenamiento exclusivo en una región.