Senha de App do Bluesky Não Funciona em Cliente de Terceiros: Corrigir

Você criou uma senha de app do Bluesky para acessar um cliente de terceiros como Skeetdeck, Graysky ou um bot personalizado, mas o login falha com erro de autenticação. Isso geralmente acontece porque a senha de app foi gerada incorretamente, o cliente de terceiros espera a senha principal da conta ou a senha de app foi revogada. Este artigo explica por que as senhas de app falham em clientes de terceiros e fornece as etapas exatas para corrigir o problema rapidamente.

Por que uma Senha de App Falha ao Autenticar em um Cliente de Terceiros

O Bluesky usa senhas de app como tokens de uso único que concedem acesso limitado à sua conta. Diferente da senha principal da conta, uma senha de app não pode alterar configurações da conta nem acessar fluxos de autenticação de dois fatores. Quando um cliente de terceiros rejeita a senha de app, uma de três coisas está errada:

Primeiro, a senha de app nunca foi gerada corretamente. Usuários às vezes digitam a senha principal da conta no cliente de terceiros em vez de gerar uma senha de app dedicada. Segundo, a senha de app foi gerada, mas o usuário não a copiou e salvou antes de fechar o diálogo. O Bluesky mostra a senha apenas uma vez. Terceiro, a senha de app foi revogada pelo usuário ou expirou devido a uma redefinição de segurança. Redefinir a senha da sua conta invalida todas as senhas de app existentes.

Clientes de terceiros que usam a API do Bluesky com o endpoint com.atproto.server.createSession exigem a senha de app como campo de senha. Se o cliente enviar a senha principal da conta, o servidor a rejeita porque a senha principal não é permitida para autenticação de token no estilo OAuth. A correção é sempre gerar uma nova senha de app e inseri-la exatamente como mostrada.

Etapas para Gerar e Usar uma Senha de App Funcional

1. Abra as Configurações do Bluesky
   Faça login na sua conta do Bluesky na web ou no aplicativo oficial. Clique no ícone do seu perfil no canto superior direito e selecione Configurações no menu suspenso.
2. Vá para Senhas de App
   No menu Configurações, role até a seção Privacidade e Segurança. Clique em Senhas de App. Se você usa o aplicativo móvel, toque em Configurações e depois em Senhas de App.
3. Adicione uma Nova Senha de App
   Clique ou toque no botão Adicionar Senha de App. Uma caixa de diálogo aparece pedindo um nome. Digite um nome descritivo como Skeetdeck ou Cliente Graysky. Esse nome ajuda a identificar qual cliente usa esta senha.
4. Copie a Senha Gerada
   O Bluesky gera uma sequência de caracteres aleatórios. Clique no botão Copiar ou selecione e copie a senha manualmente. Cole-a em um arquivo de texto temporário ou gerenciador de senhas. Não feche o diálogo até ter colado a senha no cliente de terceiros.
5. Insira a Senha de App no Cliente de Terceiros
   Abra o cliente de terceiros. Na tela de login, digite seu identificador do Bluesky ou endereço de e-mail como nome de usuário. No campo de senha, cole a senha de app que você copiou na etapa anterior. Não use sua senha principal da conta.
6. Salve e Teste o Login
   Clique no botão de login ou entrar. O cliente deve conectar-se ao Bluesky imediatamente. Se falhar, verifique se você colou a senha de app completa sem espaços extras. Se o erro persistir, repita as etapas 1 a 5 com uma nova senha de app.

Se o Bluesky Ainda Rejeitar a Senha de App Após Regeneração

A senha de app foi revogada por uma redefinição de senha

Se você alterou recentemente sua senha principal do Bluesky, todas as senhas de app existentes são revogadas automaticamente. Você deve gerar uma nova senha de app para cada cliente de terceiros. Vá para Configurações > Senhas de App, exclua quaisquer senhas antigas e crie novas seguindo as etapas acima.

O cliente de terceiros usa um endpoint de API desatualizado

Alguns clientes de terceiros mais antigos ainda usam o endpoint com.atproto.server.createAccount para login, que espera a senha principal da conta. Verifique a documentação do cliente para atualizações. Se o cliente não for mais mantido, mude para um cliente compatível, como Skeetdeck ou o aplicativo oficial do Bluesky.

A senha de app contém caracteres que o cliente remove

As senhas de app do Bluesky incluem letras maiúsculas e minúsculas, números e caracteres especiais. Alguns clientes de terceiros removem espaços ou certos caracteres durante a colagem. Digite a senha de app manualmente no campo do cliente em vez de colar. Se a senha tiver um hífen ou sublinhado, verifique se o cliente aceita esses caracteres.

A autenticação de dois fatores está ativada

O Bluesky ainda não oferece suporte à autenticação de dois fatores para clientes de terceiros. Se você tiver 2FA ativado em sua conta, as senhas de app ainda funcionam porque ignoram o requisito de 2FA. Se o cliente solicitar um código 2FA, você está usando a senha principal da conta em vez da senha de app. Gere uma nova senha de app e use apenas ela.

Item	Senha de App	Senha Principal da Conta
Finalidade	Token de uso único para clientes de terceiros	Acesso completo à conta e configurações de segurança
Regeneração após redefinição	Deve criar nova senha após alteração da senha principal	Alterada diretamente pelo usuário
Visibilidade	Mostrada uma vez na criação	Sempre conhecida pelo usuário
Revogável individualmente	Sim, em Configurações > Senhas de App	Não, apenas alterando a senha
Funciona com 2FA	Sim, ignora o 2FA	Não, requer código 2FA

Agora você pode gerar uma senha de app funcional e fazer login em qualquer cliente de terceiros do Bluesky sem erros de autenticação. Se o problema voltar, revogue a senha antiga e crie uma nova em Configurações > Senhas de App. Para segurança avançada, use um gerenciador de senhas para armazenar cada senha de app e rotulá-la com o nome do cliente, para que você possa revogá-la individualmente se um cliente for comprometido.