← 学ぶ

学ぶ

ハンドルと DID:Bluesky のアイデンティティのしくみ

Bluesky のアカウントには 2 つの名前があります。alice.bsky.social のようなハンドルは人が読むドメイン名で、変更できます。did:plc:… のような DID は、ソフトウェアのための永続的な識別子です。互いが互いを指しており、アプリはハンドルを表示する前に双方向を確認します。

最終確認日:2026年11月14日

多くの SNS では、ユーザー名は 1 つの企業のデータベースに入った 1 行にすぎません。Bluesky では、アカウントのアイデンティティは特定のサーバーのものではありません。どのアプリでも自分で確認できる、2 つの公開された名前の上に成り立っています。

1 つのアカウントに 2 つの名前

  • ハンドル は、人が読む名前です。alice.bsky.social のようなドメイン名で、変更できます。アプリでは前に @ を付けて表示されることが多いですが、@ はハンドルの一部ではありません。
  • DID(分散型識別子)は、did:plc:ewvi7nxzyoun6zhxrhs64oiz のような、アカウントの永続的な ID です。W3C の標準で、人ではなくソフトウェアのためのもので、決して変わりません。

DID こそがアカウントの本当のアイデンティティです。アプリはハンドルを DID に解決し、その後はどこでも DID を使います。そのため、ハンドルを変えても投稿とフォロワーはそのまま残り、別の PDS に移っても DID はそのままです。ネットワーク上のデータは at://did:plc:…/app.bsky.feed.post/… のような AT URI で指し示されます。DID で書かれた AT URI は、ハンドルを変えた後も使えます。

did:plc と did:web

DID の標準では、識別子を作成・解決する方法(メソッド)がいくつも認められています。AT Protocol が対応しているのはそのうち 2 つです。

  • did:plc は AT Protocol のために作られたメソッドで、2022 年に Bluesky Social PBC が開発しました。DID そのものは、そのアイデンティティの最初の署名付き操作のハッシュです。アイデンティティを管理するのは、いくつかの ローテーションキー です。新しい PDS のアドレスや新しい署名鍵など、すべての更新にこの鍵で署名します。PLC ディレクトリ はこれらの更新を集め、各 DID の現在の状態を提供し、その履歴の公開ログを保持します。誤った更新や悪意のある更新があっても、優先度の高いローテーションキーで、回復期間(現在は 72 時間)のうちに取り消せます。ブロックチェーンは一切使っていません。
  • did:web はドメイン名に結び付いています。did:web:example.com は example.com が HTTPS で公開します。仕組みは単純ですが、別のドメインに移る方法も、ドメインの管理を失ったときに回復する方法もありません。AT Protocol が受け付けるのはホスト名全体の did:web だけで、パスを含むものは使えません。自分のドメインを持ち続ける自信がある人に向いています。

2 つのうち、より広く使われているのは did:plc です。ローテーションキーと回復期間があるので、サーバーやドメインを失ってもアイデンティティを守れます。

もっと詳しく。 did:plc はディレクトリで誰でも読めます。https://plc.directory/<did> は現在の DID ドキュメントを、https://plc.directory/<did>/log/audit はその履歴を返します。

DID ドキュメント

DID を解決すると、小さな JSON ドキュメントが得られます。これが DID ドキュメント です。AT Protocol にとって重要なのは次の 3 つです。

  1. アカウントが名乗るハンドル。alsoKnownAs の中に、at:// に続けてハンドルを書く形で入っています。
  2. アカウントの公開署名鍵。リポジトリの署名を検証するためのもので、#atproto の項目に入っています。
  3. PDS のアドレス。#atproto_pds のサービスに入っています。

短くした例です。

json
{
  "id": "did:plc:ewvi7nxzyoun6zhxrhs64oiz",
  "alsoKnownAs": ["at://alice.example.com"],
  "verificationMethod": [{ "id": "did:plc:ewvi7nxzyoun6zhxrhs64oiz#atproto", "type": "Multikey" }],
  "service": [{ "id": "#atproto_pds", "type": "AtprotoPersonalDataServer", "serviceEndpoint": "https://pds.example.com" }]
}

署名鍵が署名するのはアカウントのデータだけです。did:plc では、ローテーションキーを兼ねていない限り、署名鍵はアイデンティティを一切管理できません。2 つを分けておくことが推奨されています。

ハンドルの検証のしくみ

ハンドルが信頼されるのは、つながりが双方向で成り立つときだけです。ハンドルが DID を指し、DID ドキュメントがそのハンドルを名乗り返す必要があります。そうでなければ、誰でも他人のアカウントになりすませてしまいます。

  1. ハンドルalice.example.comドメインの DNS レコードか Web 上のファイルが DID を示します。
  2. DIDdid:plc:ewvi7nxz…永続的な識別子。解決すると DID ドキュメントが得られます。
  3. DID ドキュメントat://alice.example.comPDS と署名鍵とともに、ハンドルを名乗り返します。
  4. 双方向が一致アプリはハンドルを表示します。一致しなければ handle.invalid と表示します。
ハンドルの検証のしくみ:ハンドルから DID が、DID から DID ドキュメントが得られ、そのドキュメントがハンドルを名乗り返します。双方向が一致したときだけ、アプリはハンドルを表示します。

ハンドルは、次の 2 つのどちらかの方法で DID を指します。

  1. DNS レコード。 _atproto. にハンドルを続けた名前に TXT レコードを置き、値を did= と DID にします。1 つのハンドルにはこの方法が推奨されています。
  2. Web 上のファイル。 ハンドルのドメインの /.well-known/atproto-did に HTTPS でアクセスすると、DID がプレーンテキストだけで返ってきます。多くのハンドルを扱い、1 つずつ DNS レコードを追加できないサービスのための方法です。
text
_atproto.alice.example.com  TXT  "did=did:plc:ewvi7nxzyoun6zhxrhs64oiz"
text
GET https://alice.example.com/.well-known/atproto-did

did:plc:ewvi7nxzyoun6zhxrhs64oiz

レコードやファイルがなくなったなどの理由で双方向の一致が崩れると、アプリはハンドルの代わりに handle.invalid と表示します。アカウントの DID、投稿、フォロワーはそのままで、もう一度検証できるハンドルが必要になります。

自分のドメインを使う

自分で管理しているドメインやサブドメインなら、どれでもハンドルにできます。Bluesky アプリで自分のドメインを使う設定を選び、表示された DID 入りの DNS レコードを追加してから確認します。手順は Bluesky の ドメインハンドルのガイド に、カスタムハンドルの選択肢 の比較は私たちのガイドにあります。最後に使っていた .bsky.social のハンドルは、あなたのために予約されたままです。

ドメインハンドルはアカウントをあなたの Web サイトに結び付けるので、Bluesky はこれを認証の一つの形としています。ただし、2025 年 4 月に Bluesky が導入した別の仕組みである青い認証バッジとは異なります。

ハンドルのルール

  • 使えるのは ASCII の英字、数字、ハイフンだけで、ドットで区切った 2 つ以上の部分からなります。
  • 各部分は 1〜63 文字で、ハイフンで始めることも終えることもできません。最後の部分(トップレベルドメイン)は数字で始められません。
  • ハンドル全体は 253 文字までですが、_atproto. の DNS レコード名に収まるよう、実際には 244 文字までです。
  • ハンドルは大文字と小文字を区別しません。アプリは小文字で保存し、表示します。
  • .local、.onion、.internal、.localhost、.arpa、.example、.invalid、.alt など、使えないトップレベルドメインがあります。

自分のドメインの下でハンドルを配るサービスは、最小文字数や予約語など、独自のルールを加えることがあります。

Bluesky.bot での使われ方

Bluesky.bot は Web 上のファイルの方法を使っています。name.bluesky.bot の各ハンドルは /.well-known/atproto-did にボットの DID を返し、ボットがそのハンドルに切り替えると、ボットの DID ドキュメントが name.bluesky.bot を名乗り返します。ボットに Bluesky で稼働中 と表示する前に、Bluesky.bot は Bluesky の公開 API に双方向が一致しているかを確認します。ボットの検証のしくみ

よくある質問

自分の DID はどうすればわかりますか?
DID は公開されています。Bluesky アプリで自分のドメインをハンドルにする画面を開くと、追加を求められる DNS レコード(did=did:plc:…)の中に表示されます。開発者は com.atproto.identity.resolveHandle で任意のハンドルを DID に解決でき、did:plc は PLC ディレクトリで調べられます。
ハンドルを変えると DID はどうなりますか?
何も変わりません。DID も、投稿もフォロワーもそのままです。以前のハンドルへのメンションも、引き続きあなたのアカウントにつながります。変わるのは読みやすい名前だけで、新しいハンドルは双方向で検証される必要があります。
handle.invalid とはどういう意味ですか?
アカウントのハンドルと DID が互いを確認できなくなったとき、アプリは handle.invalid と表示します。たとえば、ハンドルを証明していた DNS レコードや Web 上のファイルがなくなった場合です。アカウントの DID、投稿、フォロワーはそのままで、もう一度検証できるハンドルが必要になります。

出典

この解説の根拠となる公式ページです(英語)。

ボットに見分けやすいハンドルを

Bluesky.bot は、ボットアカウントに無料の name.bluesky.bot ハンドルを提供し、ネットワーク全体に証明したうえで、公開ボットディレクトリに掲載します。