Bluesky アプリパスワードの作成・保管・取り消し

自分で運用するボットには別の認証情報を用意します。アプリパスワードと OAuth の使い分け、交換、アクセス取り消しを確認します。

著者:Bluesky.botチーム

公開日:
更新日:
確認日:

適切な認証方法を選ぶ

アプリパスワードは、Bluesky クライアント、自分のボット、コマンドライン用スクリプトに渡す別の認証情報です。プログラムへメインパスワードを渡さずログインできます。ただし強い権限を持つ秘密情報であり、「投稿だけ」の権限だと説明してはいけません。

他人のアカウントを接続するサービスには OAuth を使います。このガイドは自分で運用するプログラム向けです。Bluesky.bot のログインも OAuth であり、ディレクトリや公開ガイドにアプリパスワードを入力する必要はありません。

対象アカウントで公式アプリに入れること、値を非公開で保管できること、プログラムを識別する名前が必要です。このページ自体は認証情報を作成・取消ししません。

1. 正しいアカウントの設定を開く

最初にボットのアカウントへ切り替えます。設定 → プライバシーとセキュリティ → アプリパスワードを開くか、公式設定画面へ進みます。

作成前にログイン中のハンドルを確認します。個人アカウントで作った値はそのアカウントを認証し、ボットにはなりません。独自ハンドルの場合も、現在の完全なハンドルを設定してください。

表示名はバージョンや翻訳で変わることがあります。経路と動作は 2026 年 11 月 19 日に公式ソースで確認しましたが、パスワード作成や認証済みセッションの実地テストは行っていません。

2. プログラムごとに作成する

アプリパスワードを追加し、rss-bot-laptop のように用途が分かる名前を付けます。プログラムや端末ごとに名前を分けると、後の交換が容易です。

DM へのアクセスを選べる場合があります。RSS 投稿だけのボットではオフのままにします。投稿に DM の読取りは不要です。利用するクライアントの実際の機能を確認してください。

生成された値をパスワードマネージャーまたは保護したローカル保管先へコピーします。表示は一度だけです。保存済み一覧から後で値を表示することはできません。紛失したら新しい値を作り、不要になった古いものを取り消します。

3. 秘密をローカルプログラムだけに渡す

環境変数か Git から除外した設定ファイルを使います。次の Bash 例は入力を画面に表示しません。ハンドルを置き換えてください。この操作だけではログインしません。

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

URL、README、公開した issue のコマンド、画面写真に値を入れないでください。非表示入力は画面を守りますが、悪意あるプログラムによる読取りは防ぎません。信頼できるコードだけを実行します。

.env ファイルの権限を絞り、リポジトリから除外します。非公開リポジトリは秘密管理の代用品ではありません。変数名は説明できますが、実際の値はボットの実行マシンに置きます。

SDK の使い方は TypeScript と Python の手順を参照します。有効化前にコードとテストを確認してください。RSS キットでは run はプレビューで、run --publish が明示的な書込みです。

4. 正しい個人データサーバーを設定する

多くのアカウントは Bluesky 運営の PDS を使いますが、ハンドルは必ずしもサーバーの URL ではありません。独自ドメインや移行後のアカウントは別の PDS を利用する場合があります。

DID を解決し、Whois ツールで #atproto_pds サービスを調べ、その HTTPS URL を SDK に設定します。キットでは BLUESKY_SERVICE です。他のクライアントでは設定名が異なるか、自動検出します。

フィード、メッセージ、未確認のコメントから拾った URL にパスワードを送らないでください。移行後に接続できなくなったら、認証情報を増やす前に現在のサーバーを確かめます。

5. アクセスを交換・取り消しする

通常の交換では、分かりやすい名前で新しい認証情報を作り、保護した設定を更新して意図した操作を一回確認します。その後、公式設定に戻り古い項目を名前で取り消します。

値が漏れた場合はプログラムを止め、認証情報を取り消し、アカウントの活動と接続アプリを調べます。ファイルや公開コミットを消すだけでは取消しになりません。

取消し後はそのパスワードで新規ログインできません。ただし発行済みアクセストークンがすべて即時に消えるとは限りません。セッションやクライアントの保存情報も関係します。OAuth の接続は別管理なので、問題時には両方を確認します。

一時的な Bash セッションの後は次のように変数を外せます。

bash
unset BLUESKY_APP_PASSWORD

消えるのは現在のシェルの変数だけです。パスワードの取消し、秘密ファイルの削除、過去の漏えいの無効化にはなりません。

秘密を共有せずに問題を調べる

症状最初の確認次の対応
別のアカウントが投稿する値を作ったアカウント停止し、対象のボットで作成する
ログインが拒否される完全なハンドル、コピー、取消し状態ローカルで確認し、必要なら交換する
移行後に失敗する現在の DID と PDS正しいサービスを設定する
値が再表示できない一度だけの表示が終了済み新規作成し、古いものを取り消す
メインパスワードを要求されるOAuth・アプリパスワード対応信頼する前に公式説明を確認する
投稿だけなのに DM を要求される実際に利用する機能不要なアクセスを無効にする

相談時はエラー、バージョン、機密を除いたサーバー名だけを伝えます。パスワード、bearer token、refresh token、cookie、環境変数の全出力は共有しません。

ボットを無人で動かす前に

認証情報に名前を付け、正しいアカウントと必要な権限だけを使い、設定を保護し、PDS と一回の操作を確認します。停止と取消しの方法も確かめます。定期実行は永続キューによる予約投稿、識別確認はハンドルの検証へ進んでください。

別の認証情報を使えばメインパスワードをプログラムに渡さずに済みます。信頼できないプログラムが安全になるわけではなく、望まれない自動応答を許可するものでもありません。

出典