Créer, protéger et révoquer un mot de passe d’application Bluesky
Donnez un identifiant distinct au bot que vous gérez. Comprenez quand utiliser un mot de passe d’application, quand choisir OAuth et comment remplacer ou révoquer un accès.
Par L’équipe Bluesky.bot
- Publié:
- Modifié:
- Revu:
Choisir le bon type de connexion
Un mot de passe d’application est un identifiant distinct destiné à un client Bluesky, un bot personnel ou un script. Le programme peut ainsi se connecter sans recevoir votre mot de passe principal. Ce secret reste puissant : ne le présentez pas comme une permission limitée à la publication.
Pour un service qui propose une connexion aux comptes d’autres personnes, utilisez OAuth. Ce guide concerne les programmes que vous exploitez vous-même. Bluesky.bot utilise OAuth : vous n’avez pas à saisir un mot de passe d’application dans notre annuaire ou nos pages publiques.
Il vous faut l’accès au compte voulu dans l’application officielle, un stockage privé et un nom clair pour le programme. Cette page ne crée ni ne révoque aucun identifiant.
1. Ouvrir les réglages du bon compte
Basculez d’abord vers le compte du bot. Ouvrez Paramètres → Confidentialité et sécurité → Mots de passe d’application, ou les réglages officiels.
Vérifiez le pseudo connecté avant de créer le secret. Un identifiant généré sur votre compte personnel autorise ce compte, pas celui du bot. Avec un pseudo personnalisé, configurez le pseudo actuel complet.
Les libellés peuvent évoluer selon la version et la langue. Le chemin et le comportement ont été vérifiés dans les sources officielles le 19 novembre 2026 ; aucune création ni session authentifiée n’a été testée pour ce guide.
2. Créer un identifiant par programme
Choisissez Ajouter un mot de passe d’application et un nom explicite, par exemple rss-bot-laptop. Un nom par programme ou appareil facilite le remplacement ultérieur.
L’application peut proposer l’accès aux messages privés. Laissez cette option désactivée pour un bot qui publie uniquement un flux RSS : il n’a pas besoin de lire vos DM. Vérifiez les fonctions réelles du client plutôt que de donner partout les mêmes droits.
Copiez la valeur dans un gestionnaire de mots de passe ou un stockage local protégé. Elle n’est affichée qu’une fois ; la liste enregistrée ne permet pas de la révéler ensuite. En cas de perte, générez un remplacement et révoquez l’ancien identifiant inutilisé.
3. Fournir le secret uniquement au programme local
Utilisez des variables d’environnement ou un fichier local exclu de Git. Cet exemple Bash masque la saisie ; remplacez le pseudo par celui du bot. Il ne lance pas de connexion à lui seul.
export BLUESKY_HANDLE="your-bot.bsky.social"
read -r -s -p "App password: " BLUESKY_APP_PASSWORD
printf '\n'
export BLUESKY_APP_PASSWORDNe placez jamais la valeur dans une URL, un README, une commande copiée dans une issue ou une capture. Une saisie masquée protège l’affichage du terminal, pas contre un programme malveillant : exécutez uniquement du code de confiance.
Si vous utilisez un fichier .env, limitez ses permissions et excluez-le du dépôt. Un dépôt privé ne remplace pas un gestionnaire de secrets. Les noms de variables peuvent être documentés, leurs valeurs restent sur la machine du bot.
Les tutoriels TypeScript et Python expliquent l’utilisation du SDK. Lisez le code et vérifiez ses aperçus ou tests avant d’envoyer quoi que ce soit. Dans le kit RSS, run prévisualise ; run --publish autorise explicitement l’écriture.
4. Configurer le bon serveur de données
Beaucoup de comptes utilisent un PDS exploité par Bluesky, mais le pseudo n’est pas nécessairement l’adresse du serveur. Un domaine personnalisé ou une migration peuvent correspondre à un autre hébergeur.
Résolvez le DID et consultez son service #atproto_pds avec l’outil Whois. Configurez cette adresse HTTPS dans le SDK. Le kit utilise BLUESKY_SERVICE ; d’autres clients nomment autrement ce réglage ou découvrent le service automatiquement.
N’envoyez pas le secret à une adresse trouvée dans un flux, un message ou un commentaire non vérifié. Si une connexion échoue après migration, vérifiez le service actuel avant de multiplier les nouveaux identifiants.
5. Remplacer ou révoquer l’accès d’un programme
Pour une rotation normale, créez un nouvel identifiant clairement nommé, mettez à jour la configuration protégée et vérifiez une opération voulue. Retournez ensuite aux réglages officiels et révoquez l’ancien par son nom.
Après exposition d’un secret, arrêtez le programme, révoquez l’identifiant et examinez l’activité du compte ainsi que les applications connectées. Effacer un fichier ou un commit public ne remplace pas la révocation.
Celle-ci empêche de nouvelles connexions avec ce mot de passe. Ne supposez pas que tous les jetons d’accès déjà délivrés disparaissent instantanément : le cycle des sessions et les identifiants mémorisés par le client comptent aussi. Les connexions OAuth se gèrent séparément ; examinez les deux en cas d’accès indésirable.
Pour nettoyer le shell Bash après une session ponctuelle :
unset BLUESKY_APP_PASSWORDCette commande retire seulement la variable du shell actuel. Elle ne révoque pas le secret, ne l’efface pas d’un fichier et n’annule pas une fuite antérieure.
Dépanner sans communiquer le secret
| Symptôme | Premier contrôle | Étape suivante |
|---|---|---|
| Mauvais compte utilisé | Compte qui a créé l’identifiant | Arrêter et créer le secret depuis le compte voulu |
| Connexion refusée | Pseudo complet, copie, révocation | Vérifier localement puis remplacer si nécessaire |
| Échec après migration | DID et PDS actuels | Configurer le service correct |
| Valeur devenue invisible | Affichage unique déjà fermé | Générer une nouvelle valeur nommée, révoquer l’ancienne |
| Demande du mot de passe principal | OAuth ou identifiant d’application pris en charge | Vérifier la documentation avant de faire confiance |
| Demande de DM pour publier seulement | Fonctions réellement nécessaires | Garder les accès inutiles désactivés |
Pour demander de l’aide, indiquez une erreur, une version et un nom de serveur nettoyé. N’incluez jamais mot de passe, bearer token, refresh token, cookie ou export complet de l’environnement.
Avant de laisser tourner le bot
Nommez le secret, utilisez le bon compte, limitez les privilèges, protégez la configuration, vérifiez le PDS et testez une opération délibérée. Sachez arrêter le programme et révoquer son accès. Pour un bot périodique, suivez la planification persistante ; pour son identité, consultez la vérification du pseudo.
Cette méthode garde le mot de passe principal hors du programme. Elle ne rend pas sûr un client non fiable et n’autorise pas les interactions automatisées non sollicitées.