Token de migración de Bluesky no válido: causas y solución

Cuando intentas mover tu cuenta de Bluesky a un nuevo host o dominio, es posible que veas un error de “Migration token invalid”. Este error detiene el proceso de transferencia de la cuenta y te deja atrapado en tu proveedor actual. La causa raíz es casi siempre una discrepancia en la generación o aplicación del token dentro del sistema de autenticación de Bluesky. Este artículo explica por qué el token se vuelve no válido y proporciona soluciones paso a paso para resolver el problema.

Por qué el token de migración se vuelve no válido en Bluesky

El token de migración de Bluesky es una cadena criptográfica que demuestra que eres el propietario de la cuenta de Bluesky y que deseas moverla a un nuevo dominio o proveedor de alojamiento. Bluesky genera este token dentro de la configuración de tu cuenta. El token incluye una marca de tiempo y una firma vinculada a tus credenciales de cuenta actuales.

El token se vuelve no válido por tres razones principales:

• Expiración del token: El token caduca 15 minutos después de su generación. Si lo generas y luego esperas demasiado para usarlo, Bluesky lo rechaza como no válido.
• Discrepancia en el registro DNS: El registro TXT que agregas a la configuración DNS de tu nuevo dominio debe coincidir exactamente con lo que Bluesky espera. Un error tipográfico en el nombre o valor del registro hace que el token sea no válido.
• Cambio de credenciales de la cuenta: Si cambias tu contraseña o tu handle después de generar el token, la firma del token ya no coincide con tu cuenta. Bluesky invalida el token anterior inmediatamente.

Pasos para generar y aplicar un token de migración válido

1. Verifica tu handle y dominio actuales
   Abre Bluesky en un navegador web. Ve a Configuración > Cuenta. Verifica que tu handle actual sea el que deseas migrar desde. Si cambiaste tu contraseña recientemente, espera 10 minutos antes de generar un token para evitar discrepancias de firma.
2. Genera el token de migración
   En Configuración > Cuenta, desplázate a la sección Migración. Haz clic en “Generar token de migración”. Un cuadro de diálogo muestra la cadena del token. Cópiala inmediatamente a tu portapapeles. No cierres el cuadro de diálogo ni navegues a otra página.
3. Agrega el registro TXT a tu nuevo dominio
   Inicia sesión en tu registrador de dominios o proveedor de alojamiento DNS. Crea un nuevo registro TXT con los siguientes valores:
   Nombre: _atproto.yournewdomain.com
   Valor: did=plc:yourdid (reemplaza yourdid con tu DID de Bluesky, que se encuentra en Configuración > Cuenta)
   TTL: 300 segundos (5 minutos) o el valor más bajo permitido.
4. Espera la propagación del DNS
   Los cambios de DNS pueden tardar hasta 15 minutos en propagarse a nivel mundial. Usa una herramienta como whatsmydns.net para verificar si el registro TXT es visible globalmente. No continúes hasta que el registro aparezca como publicado.
5. Ingresa el token en el nuevo host
   Si estás migrando a un PDS autoalojado, abre la interfaz de administración del PDS y pega el token en el formulario de migración. Si te estás mudando a un host compatible con Bluesky diferente, sigue las instrucciones de migración de ese host. El token debe ingresarse dentro de los 15 minutos posteriores a su generación. Si el token ha caducado, vuelve al paso 2 y genera un token nuevo.
6. Confirma la migración
   Después de ingresar el token, Bluesky verifica el registro TXT del DNS. Si el registro coincide, tu handle de cuenta cambia al nuevo dominio. Verás un mensaje de confirmación en Configuración > Cuenta. Tu handle anterior queda disponible para su liberación.

Si Bluesky aún muestra Token no válido después de la solución principal

Token caducado durante la propagación del DNS

La propagación del DNS puede tardar más que la ventana de validez de 15 minutos del token. Si generaste el token antes de que el registro DNS fuera visible globalmente, el token caduca antes de que puedas usarlo. Genera un token nuevo después de confirmar que el registro TXT está activo. Luego aplica el token nuevo inmediatamente.

El registro DNS tiene un error tipográfico o un valor incorrecto

Vuelve a verificar el nombre y el valor del registro TXT. El nombre debe ser _atproto.yournewdomain.com exactamente. El valor debe comenzar con did=plc: seguido de tu DID exacto. Un guion bajo faltante o un DID incorrecto hacen que el token sea no válido. Elimina el registro incorrecto y agrega uno corregido. Espera la propagación y genera un token nuevo.

El handle de la cuenta ya está reclamado por otro usuario

Si el handle del nuevo dominio ya está en uso por otra cuenta de Bluesky, la migración falla con un error de token no válido. Bluesky no permite que dos cuentas usen el mismo handle. Verifica que el handle esté disponible buscándolo en la aplicación de Bluesky. Si está ocupado, elige un handle diferente o contacta al propietario actual para que lo libere.

Token de migración de Bluesky: Generación de token vs Verificación DNS

Elemento	Generación de token	Verificación DNS
Propósito	Demuestra que controlas la cuenta de Bluesky	Demuestra que controlas el nuevo dominio
Método	Bluesky genera una cadena criptográfica firmada	Agregas un registro TXT a la configuración DNS de tu dominio
Expiración	15 minutos después de la generación	Sin expiración, pero debe estar presente en el momento de la migración
Fallo común	Token usado después de la expiración o después de un cambio de contraseña	Registro TXT faltante, mal nombrado o con valor DID incorrecto

Ahora puedes resolver el error “Migration token invalid” generando un token nuevo después de la propagación del DNS y verificando que el registro TXT sea correcto. Para futuras migraciones, confirma siempre que el DNS esté completamente propagado antes de generar el token. Si planeas migrar varias cuentas, genera y aplica los tokens uno a la vez para evitar confusiones con diferentes valores DID.