Cómo recuperar el acceso de administrador de Confluence a través de la base de datos - Guía de emergencia

Considere este escenario: Es lunes por la mañana y un equipo necesita agregar un nuevo miembro a un espacio crucial de Confluence. ¿El problema? El único administrador acaba de comenzar unas vacaciones de dos semanas completamente desconectado. Para cualquiera en esta situación, el pánico podría apoderarse... hasta que recuerden tener acceso al servidor donde se ejecuta Confluence. Este escenario hipotético ilustra cuándo la siguiente solución técnica podría ser necesaria.

Lo que necesita primero

Antes de comenzar, asegúrese de tener:

• Acceso al servidor donde se ejecuta la base de datos de Confluence.
• El nombre de usuario y la contraseña para conectarse a la base de datos de Confluence. (¡Pista! Consulte el archivo confluence.cfg.xml).
• El nombre de usuario de Confluence que desea convertir en administrador.

Paso 1: Encuentre los detalles de su base de datos de Confluence

Confluence almacena la información de conexión de su base de datos en un archivo llamado confluence.cfg.xml. Este archivo se encuentra generalmente en el directorio 'home' de Confluence en su servidor (a menudo algo como /var/atlassian/application-data/confluence).

Encuentre el archivo:

Si conoce la ruta del directorio 'home' de Confluence, puede usar un comando como este (reemplace /path/to/confluence/home con la ruta real):

find /path/to/confluence/home -name \"confluence.cfg.xml\"

Si no está seguro de dónde se encuentra el directorio 'home' de Confluence, intente buscar desde el directorio raíz (esto puede llevar un tiempo) o navegue a un directorio principal probable (como /var/atlassian o /opt) y busque desde allí:

# Navegue primero a un directorio principal potencial, luego ejecute:
find . -name \"confluence.cfg.xml\"

Este comando busca el archivo en el directorio actual (.) y todos sus subdirectorios.

Lea el archivo:

Una vez que lo encuentre, abra confluence.cfg.xml. Busque líneas como estas:

<property name=\"hibernate.connection.url\">jdbc:postgresql://your-db-host:5432/confluence</property>
<property name=\"hibernate.connection.username\">confluenceuser</property>
<property name=\"hibernate.connection.password\">yourpassword</property>

Estas líneas le indican el tipo de base de datos (como PostgreSQL o MySQL), la dirección del servidor (your-db-host), el nombre de la base de datos, el nombre de usuario y la contraseña que necesita para conectarse.

Paso 2: Conéctese a la base de datos

Ahora, use los detalles que encontró para iniciar sesión en la base de datos.

Si es PostgreSQL:

psql -h your-db-host -U confluenceuser -d confluence

Si es MySQL:

mysql -h your-db-host -u confluenceuser -p confluence

Ingrese la contraseña cuando se le solicite.

Paso 3: Obtenga el ID de usuario y el ID del grupo de administradores

Necesita dos piezas de información de la base de datos: el ID del usuario y el ID del grupo de administradores.

Encuentre el ID del usuario (user_key):

Ejecute este comando SQL. Reemplace 'your-username' con el nombre de usuario real de Confluence que desea convertir en administrador:

SELECT user_key FROM cwd_user WHERE user_name = 'your-username';

Anote el user_key que le da (será un número).

Encuentre el ID del grupo de administradores:

Ejecute este comando SQL:

SELECT id FROM cwd_group WHERE group_name = 'confluence-administrators';

Anote el id que le da (este es el ID del grupo de administradores).

Paso 4: Agregue el usuario al grupo de administradores

Este es el paso crucial donde vincula al usuario con el grupo de administradores.

Encuentre el próximo ID disponible para el enlace:

Ejecute esto para ver el ID actual más alto en la tabla de membresía:

SELECT MAX(id) FROM cwd_membership;

Tome el número que le da y sume 1. Por ejemplo, si muestra 1000, usará 1001. Este será el ID único para el nuevo enlace.

Cree el enlace:

Ejecute el siguiente comando `INSERT`. **Reemplace cuidadosamente** `NEXT_MEMBERSHIP_ID` con el ID que acaba de calcular (por ejemplo, `1001`), `ADMIN_GROUP_ID` con el ID del grupo de administradores que encontró y `USER_KEY` con el ID del usuario que encontró. Además, reemplace `'your-username'` con el nombre de usuario real nuevamente.

INSERT INTO cwd_membership (id, parent_id, child_user_id, membership_type, group_type, parent_name, lower_parent_name, child_name, lower_child_name) 
VALUES (NEXT_MEMBERSHIP_ID, ADMIN_GROUP_ID, USER_KEY, 'GROUP_USER', 'GROUP', 'confluence-administrators', 'confluence-administrators', 'your-username', 'your-username');

Ejemplo:

-- ¡Asegúrese de usar los ID reales que encontró!
INSERT INTO cwd_membership (id, parent_id, child_user_id, membership_type, group_type, parent_name, lower_parent_name, child_name, lower_child_name) 
VALUES (1001, 4587522, 241106945, 'GROUP_USER', 'GROUP', 'confluence-administrators', 'confluence-administrators', 'jane.doe', 'jane.doe');

(Nota: Si recibe un error sobre columnas faltantes, su versión de Confluence podría ser diferente. Es posible que solo necesite `id`, `parent_id` y `child_user_id` en la declaración `INSERT`. Verifique la estructura de su tabla si es necesario).

Paso 5: Reinicie Confluence

El cambio no funcionará hasta que reinicie Confluence.

Opción 1: Usando systemd (común en Linux)

sudo systemctl restart confluence

Opción 2: Usando los scripts de Confluence

cd /path/to/confluence/bin  # Vaya al directorio bin de Confluence
./shutdown.sh
./startup.sh             # Espere un poco después de apagar antes de iniciar

Una vez que Confluence vuelva a estar en línea, ¡el usuario que seleccionó debería poder iniciar sesión con derechos de administrador completos!

Consejos rápidos y advertencias

• ¡Haga una copia de seguridad primero! En serio, siempre haga una copia de seguridad de su base de datos antes de cambiar algo directamente.
• La base de datos importa: Los comandos SQL podrían necesitar pequeños ajustes si usa Oracle o SQL Server en lugar de PostgreSQL/MySQL.
• Verifique los nombres: Si los comandos fallan, verifique los nombres de las tablas (cwd_user, cwd_group, cwd_membership) ya que podrían variar ligeramente entre las versiones de Confluence.
• Tenga cuidado: Está omitiendo las comprobaciones de seguridad normales. Asegúrese absolutamente de que está otorgando derechos de administrador a la cuenta de usuario correcta.
• Revise sus políticas: Esta técnica solo debe usarse en situaciones de emergencia cuando tenga la autorización adecuada. Muchas organizaciones tienen políticas sobre el acceso a la base de datos y los derechos de administrador. Asegúrese siempre de seguir las reglas de gobierno de TI de su empresa y de tener la aprobación adecuada antes de realizar estos cambios.
• Documente sus acciones: Si utiliza este método, documente lo que hizo, cuándo y por qué. La transparencia es clave al realizar cambios a nivel de sistema como este.

Conclusión

Perder el acceso de administrador a su instancia de Confluence puede ser una situación estresante, especialmente cuando el trabajo crítico depende de ella. Si bien el método descrito en esta guía debe considerarse como último recurso, proporciona a los administradores de TI una solución de emergencia viable cuando existe la autorización adecuada. Recuerde que la prevención es siempre mejor que la cura; implementar una gestión adecuada del acceso de administrador y la documentación puede ayudar a evitar estas situaciones por completo.