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.
export BLUESKY_HANDLE="your-bot.bsky.social"
read -r -s -p "App password: " BLUESKY_APP_PASSWORD
printf '\n'
export BLUESKY_APP_PASSWORDNo 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:
unset BLUESKY_APP_PASSWORDEso 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íntoma | Primera comprobación | Siguiente paso |
|---|---|---|
| Publica la cuenta equivocada | Cuenta que creó la credencial | Detener y generar desde la cuenta correcta |
| Acceso rechazado | Handle completo, copia y revocación | Comprobar localmente y sustituir si es necesario |
| Falla tras migrar | DID y PDS actuales | Configurar el servicio correcto |
| El valor ya no se ve | Ya se cerró la pantalla inicial | Generar otra credencial y revocar la antigua |
| Piden la contraseña principal | Compatibilidad con OAuth o app passwords | Revisar la documentación antes de confiar |
| Piden DM para publicar solamente | Funciones que realmente utiliza el cliente | Desactivar 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.