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ó.

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

Nã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:

bash
unset BLUESKY_APP_PASSWORD

O 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

SintomaPrimeiro controloPasso seguinte
Publicação na conta erradaConta que criou a credencialParar e gerar na conta pretendida
Autenticação recusadaIdentificador completo, cópia e revogaçãoVerificar localmente e substituir se necessário
Falha após migraçãoDID e PDS atuaisConfigurar o serviço correto
Valor deixou de estar visívelA apresentação inicial já terminouGerar outro e revogar o antigo
Pedido da palavra-passe principalSuporte de OAuth ou credenciais de aplicaçãoConsultar documentação antes de confiar
Pedido de DM para publicar apenasFunções reais do clienteDesativar 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.

Fontes