Crear, guardar y revocar una contraseña de aplicación de Bluesky

Usa una credencial separada para el bot que administras. Aprende cuándo encajan las contraseñas de aplicación, cuándo usar OAuth y cómo sustituir o revocar el acceso.

Por El equipo de Bluesky.bot

Publicado:
Actualizado:
Revisado:

Elegir el tipo de acceso adecuado

Una contraseña de aplicación es una credencial separada para un cliente Bluesky, bot personal o script. Permite entrar sin entregar la contraseña principal de la cuenta. Sigue siendo un secreto potente: no es una autorización limitada exclusivamente a publicar.

Si tu servicio conecta cuentas de otras personas, utiliza OAuth. Esta guía se dirige a programas que tú administras. Bluesky.bot usa OAuth; no necesitas pegar una contraseña de aplicación en nuestro directorio ni en estas páginas públicas.

Necesitas acceso a la cuenta correcta en la aplicación oficial, un lugar privado para guardar la nueva credencial y un nombre reconocible para el programa. La página no crea ni revoca credenciales por ti.

1. Abrir los ajustes de la cuenta correcta

Cambia primero a la cuenta del bot. Abre Ajustes → Privacidad y seguridad → Contraseñas de aplicación, o entra en los ajustes oficiales.

Comprueba el handle antes de crear el secreto. Una credencial generada desde tu cuenta personal autoriza esa cuenta, no la del bot. Si utiliza un dominio propio, configura el handle completo y actual.

Los nombres de los menús pueden variar por versión o traducción. La ruta y el comportamiento se revisaron en el código oficial el 19 de noviembre de 2026; no se creó una contraseña ni se probó una sesión autenticada.

2. Crear una credencial por programa

Elige Añadir contraseña de aplicación y un nombre descriptivo, como rss-bot-laptop. Un nombre por programa o dispositivo facilita su sustitución posterior.

La aplicación puede ofrecer acceso a mensajes directos. Déjalo desactivado para un bot que solo publica RSS: no necesita leer tus DM. Comprueba las funciones reales de cada cliente.

Guarda el valor generado en un gestor de contraseñas o almacén local protegido. Se muestra una sola vez; la lista de credenciales guardadas no permite revelarlo después. Si lo pierdes, crea otro y revoca el antiguo.

3. Entregar el secreto solo al programa local

Utiliza variables de entorno o un archivo local excluido de Git. Este ejemplo Bash oculta lo que escribes; sustituye el handle. El comando por sí mismo no abre una sesión.

bash
export BLUESKY_HANDLE="your-bot.bsky.social"
read -r -s -p "App password: " BLUESKY_APP_PASSWORD
printf '\n'
export BLUESKY_APP_PASSWORD

No pongas el valor en una URL, README, captura o comando publicado en una incidencia. Ocultar la entrada protege la pantalla, no evita que un programa malicioso lea el secreto: ejecuta código de confianza.

Restringe los permisos de cualquier archivo .env y exclúyelo del repositorio. Un repositorio privado no sustituye a un gestor de secretos. Puedes documentar nombres de variables; sus valores deben permanecer en la máquina del bot.

Los tutoriales de TypeScript y Python explican cómo usa la credencial el SDK. Lee el código y sus pruebas antes de habilitar envíos. En el kit RSS, run previsualiza y run --publish autoriza expresamente la escritura.

4. Configurar el servidor de datos correcto

Muchas cuentas utilizan un PDS operado por Bluesky, pero el handle no es necesariamente la dirección del servidor. Un dominio personalizado o una migración pueden corresponder a otro PDS.

Resuelve el DID y comprueba el servicio #atproto_pds con la herramienta Whois. Configura esa URL HTTPS en el SDK. El kit usa BLUESKY_SERVICE; otros clientes tienen otro ajuste o descubren el servicio automáticamente.

No envíes la contraseña a una dirección encontrada en un feed, mensaje o comentario sin verificar. Si una conexión falla después de migrar, comprueba primero el servidor actual.

5. Rotar o revocar el acceso

Para una rotación rutinaria, crea una credencial nueva con nombre claro, actualiza la configuración protegida y verifica una operación intencionada. Después vuelve a los ajustes oficiales y revoca la anterior por su nombre.

Si se expone el secreto, detén el programa, revócalo y revisa actividad y aplicaciones conectadas. Borrar un archivo o commit público no sustituye a la revocación.

Revocar impide nuevas conexiones con esa contraseña. No supongas que todos los tokens ya emitidos desaparecen inmediatamente: también influyen las sesiones y credenciales almacenadas por el cliente. Las conexiones OAuth se gestionan por separado; revisa ambas en un incidente.

Después de una sesión puntual en Bash:

bash
unset BLUESKY_APP_PASSWORD

Eso elimina la variable del shell actual. No revoca la contraseña ni la borra de un archivo, y tampoco deshace una filtración previa.

Diagnosticar sin compartir el secreto

SíntomaPrimera comprobaciónSiguiente paso
Publica la cuenta equivocadaCuenta que creó la credencialDetener y generar desde la cuenta correcta
Acceso rechazadoHandle completo, copia y revocaciónComprobar localmente y sustituir si es necesario
Falla tras migrarDID y PDS actualesConfigurar el servicio correcto
El valor ya no se veYa se cerró la pantalla inicialGenerar otra credencial y revocar la antigua
Piden la contraseña principalCompatibilidad con OAuth o app passwordsRevisar la documentación antes de confiar
Piden DM para publicar solamenteFunciones que realmente utiliza el clienteDesactivar permisos innecesarios

Al solicitar ayuda, comparte solo el error, versión y nombre de servidor saneado. Nunca incluyas contraseña, bearer token, refresh token, cookies ni un volcado del entorno.

Antes de dejar el bot funcionando

Nombra la credencial, utiliza la cuenta correcta, limita privilegios, protege la configuración, verifica el PDS y prueba una operación deliberada. Aprende a detener y revocar. Para publicaciones periódicas consulta la programación persistente; para la identidad, la verificación del handle.

La credencial separada mantiene la contraseña principal fuera del programa. No convierte un cliente no fiable en seguro ni autoriza interacciones automáticas no solicitadas.

Fuentes