Criar, guardar e revogar uma palavra-passe de aplicação Bluesky
Use uma credencial separada para o bot que gere. Saiba quando usar palavras-passe de aplicação, quando escolher OAuth e como substituir ou revogar um acesso.
Por A equipa do Bluesky.bot
- Publicado:
- Atualizado:
- Revisto:
Escolher a autenticação adequada
Uma palavra-passe de aplicação é uma credencial separada para um cliente Bluesky, bot pessoal ou script. Permite iniciar sessão sem entregar a palavra-passe principal. Continua a ser um segredo poderoso: não corresponde a uma permissão limitada apenas a publicar.
Para um serviço que liga contas de outras pessoas, utilize OAuth. Este guia destina-se a programas que gere diretamente. O Bluesky.bot usa OAuth; não precisa de introduzir uma palavra-passe de aplicação no nosso diretório ou nestas páginas públicas.
Precisa de acesso à conta pretendida na aplicação oficial, armazenamento privado e um nome claro para o programa. Esta página não cria nem revoga credenciais.
1. Abrir as definições da conta correta
Mude primeiro para a conta do bot. Abra Definições → Privacidade e segurança → Palavras-passe de aplicação, ou as definições oficiais.
Confirme o nome de utilizador antes de criar o segredo. Uma credencial gerada na conta pessoal autoriza essa conta, não o bot. Com um domínio próprio, configure o identificador completo e atual.
Os nomes dos menus podem mudar com a versão ou tradução. O caminho e comportamento foram revistos no código oficial a 19 de novembro de 2026; não foi criada uma credencial nem testada uma sessão autenticada.
2. Criar uma credencial por programa
Escolha Adicionar palavra-passe de aplicação e um nome descritivo, como rss-bot-laptop. Um nome por programa ou dispositivo facilita a substituição posterior.
A aplicação pode oferecer acesso a mensagens diretas. Deixe essa opção desligada num bot que apenas publica RSS: não precisa de ler DM. Confirme as funções efetivamente usadas pelo cliente.
Guarde o valor num gestor de palavras-passe ou num armazenamento local protegido. É mostrado uma única vez; a lista guardada não permite revelá-lo depois. Se o perder, crie outro e revogue o antigo.
3. Fornecer o segredo apenas ao programa local
Use variáveis de ambiente ou um ficheiro local excluído do Git. Este exemplo Bash oculta a introdução; substitua o nome da conta. O comando não inicia sessão por si só.
export BLUESKY_HANDLE="your-bot.bsky.social"
read -r -s -p "App password: " BLUESKY_APP_PASSWORD
printf '\n'
export BLUESKY_APP_PASSWORDNão coloque o valor num URL, README, captura ou comando publicado numa issue. A introdução oculta protege o ecrã, não impede um programa malicioso de ler o segredo: execute código de confiança.
Restrinja permissões de ficheiros .env e exclua-os do repositório. Um repositório privado não substitui um gestor de segredos. Os nomes das variáveis podem ser documentados; os valores ficam na máquina do bot.
Os tutoriais TypeScript e Python explicam o SDK. Leia código e testes antes de habilitar envios. No kit RSS, run pré-visualiza e run --publish autoriza expressamente a escrita.
4. Configurar o servidor de dados correto
Muitas contas utilizam um PDS operado pelo Bluesky, mas o nome de utilizador não é necessariamente o endereço do servidor. Um domínio próprio ou migração podem corresponder a outro PDS.
Resolva o DID e consulte o serviço #atproto_pds com a ferramenta Whois. Configure esse URL HTTPS no SDK. O kit usa BLUESKY_SERVICE; outros clientes têm outra definição ou descobrem o serviço automaticamente.
Não envie a credencial para um endereço encontrado num feed, mensagem ou comentário por verificar. Se a ligação falhar após migração, confirme o servidor atual antes de gerar vários segredos novos.
5. Substituir ou revogar o acesso
Numa rotação normal, crie uma credencial nova com nome claro, atualize a configuração protegida e verifique uma operação intencional. Volte depois às definições oficiais e revogue a anterior pelo nome.
Se um segredo for exposto, pare o programa, revogue-o e examine a atividade e aplicações ligadas. Apagar um ficheiro ou commit público não substitui a revogação.
A revogação impede novos inícios de sessão com essa palavra-passe. Não suponha que todos os tokens já emitidos desaparecem imediatamente: sessões e credenciais guardadas no cliente também contam. Ligações OAuth são geridas separadamente; reveja ambas num incidente.
Após uma sessão pontual em Bash:
unset BLUESKY_APP_PASSWORDO comando retira a variável apenas do shell atual. Não revoga a credencial, não a elimina de um ficheiro e não desfaz uma exposição anterior.
Diagnosticar sem partilhar o segredo
| Sintoma | Primeiro controlo | Passo seguinte |
|---|---|---|
| Publicação na conta errada | Conta que criou a credencial | Parar e gerar na conta pretendida |
| Autenticação recusada | Identificador completo, cópia e revogação | Verificar localmente e substituir se necessário |
| Falha após migração | DID e PDS atuais | Configurar o serviço correto |
| Valor deixou de estar visível | A apresentação inicial já terminou | Gerar outro e revogar o antigo |
| Pedido da palavra-passe principal | Suporte de OAuth ou credenciais de aplicação | Consultar documentação antes de confiar |
| Pedido de DM para publicar apenas | Funções reais do cliente | Desativar acessos desnecessários |
Ao pedir ajuda, indique erro, versão e nome de servidor sem dados sensíveis. Nunca inclua palavra-passe, bearer token, refresh token, cookies ou um despejo completo do ambiente.
Antes de deixar o bot autónomo
Dê nome à credencial, use a conta certa, limite privilégios, proteja a configuração, confirme o PDS e teste uma operação deliberada. Saiba parar e revogar. Para um bot periódico, siga o agendamento persistente; para a identidade, consulte a verificação do identificador.
Separar credenciais mantém a palavra-passe principal fora do programa. Não torna seguro um cliente de origem duvidosa nem autoriza interações automáticas não solicitadas.