Blueskyの「無効なハンドル」:原因と直し方

無効なハンドルは、名前とアカウントを双方向に確認できないときに表示されます。DNSを変えたり新しいアカウントを作ったりする前に、どの確認が失敗したのか調べましょう。

著者:Bluesky.botチーム

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

まず確認すること

Blueskyでは、ハンドルがアカウントのDIDを指し、そのDID文書も同じハンドルを名乗る必要があります。APIの handle.invalid は、この対応を確認できないときの値です。取得すべきドメイン名ではありません。アプリに古いキャッシュが表示されている場合もあります。Handle仕様 が双方向の確認を定めています。

今のハンドルを確認する

このGETフォームは既存のチェッカーを開きます。別のアカウントを指している場合は、移動先で期待するDIDを追加してください。ログインは不要です。

⚠無効なハンドル

Blueskyアプリの実際のエラー文

  • ハンドルの変更に失敗しました。もう一度試してください。
  • 無効なハンドルです。他のものを試してください。
  • ハンドルを解決できません

アプリの翻訳を2026年11月16日に確認しました。以後のバージョンでは文言が変わる場合があります。 出典

引用した文言は、2026年11月16日に確認したBlueskyアプリの特定バージョンの翻訳です。保存や検証の失敗という表示だけでは、どのDNSレコードが原因かは分かりません。

双方向の確認の仕組み

ハンドルを双方向に確認する仕組み
  1. 1. ハンドル → DNS TXTまたはHTTPSの証明
  2. 2. 証明 → アカウントのDID
  3. 3. DID文書 → alsoKnownAs: at://ハンドル

順方向には どちらか一つ の方法で十分です。_atproto.<ハンドル> のTXT値を did= で始めるか、HTTPSファイルにDIDだけを返します。そのDID文書が at://<ハンドル> を名乗ることも必要です。ハンドルとDID と DID仕様 でIDの仕組みを確認できます。

どちらの確認が失敗していますか?

  1. DNSにもHTTPSにもDIDがない: TXTの名前と値、またはファイルのステータスと本文を確認します。通信エラーは「確認できなかった」という意味で、名前が放棄された証拠ではありません。
  2. 別のDIDが返る: 使いたいアカウントのDIDと比較します。例のDIDをコピーしたり、別のアカウントのドメインを変更したりしないでください。
  3. DIDは正しいが、逆方向は別のハンドル: そのアカウントでハンドルを選び直します。DNSだけを変えてもDID文書は更新されません。
  4. 双方向が正しいのに古い表示: AppViewの結果を比較し、キャッシュの更新を待ってアカウント設定から再検証します。
  5. アカウントが削除・無効化・停止されている: DNSでは復旧できません。まずホスティング先でアカウントの状態を解決します。

TXTがない、または登録する名前が違う

表示される結果: dns: missing、または見つかった場所を伴う dns: wrong_host。example.com ゾーンで you.example.com を使う場合、相対的なTXT名は _atproto.you です。管理画面によってはゾーンを自動追加するため、完全な名前を入れると _atproto.you.example.com.example.com になります。

対処: 入力欄の文字だけでなく、実際にできた 完全なホスト名 を確認します。_atproto.you.example.com にDIDの証明を一つ置きます。有効なHTTPSの証明があればTXTは必須ではありません。Blueskyの公式案内 にもサブドメインの例があります。

以下は 実際のチェッカーの処理に、制御したテスト応答を渡して得た出力 です。架空のDIDと、文書用に予約された example.com の名前を使っています。ライブDNSの記録、利用者の実例、プロジェクトの本物のドメインの検査ではありません。各出力に由来を記載しています。DNSやアカウントは変更せず、稼働中のテスト用ドメインがない場合の初期方針に従っています。

記録した例:TXTもHTTPSの証明もない
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"missing-txt.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "missing-txt.example.com"
  },
  "report": {
    "domain": "missing-txt.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.missing-txt",
      "fullName": "_atproto.missing-txt.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://missing-txt.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_missing"
  }
}
記録した例:管理画面がゾーンを二重に追加した
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"wrong-host.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.wrong-host.example.com.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "wrong-host.example.com"
  },
  "report": {
    "domain": "wrong-host.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "wrong_host",
        "details": {
          "where": "doubled",
          "name": "_atproto.wrong-host.example.com.example.com",
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ]
        }
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.wrong-host",
      "fullName": "_atproto.wrong-host.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://wrong-host.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_wrong_host"
  }
}

値の形式が違う、または別のアカウントのDID

表示される結果: dns: invalid_value、no_prefix、leading_space。TXTの 値 は自分の完全なDIDを使った did=did:plc:… です。プロフィールURLではありません。値に実際に含まれる引用符や空白は認識を妨げることがあります。DNSツールが表示上付ける引用符と、保存された文字は別です。

対処: 使いたいアカウントのハンドル設定でDIDを取得します。余計な書式や競合する古いTXTを除きます。構文が正しいDIDでも別のアカウントかもしれません。変更する前にチェッカーで 期待するアカウント を指定してください。二つ目の例はドメインの証明自体は有効でも、そのアカウントとは一致しません。

記録した例:値がDIDとして無効
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"malformed-txt.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.malformed-txt.example.com": [
        [
          "did=not-a-did"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "malformed-txt.example.com"
  },
  "report": {
    "domain": "malformed-txt.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "invalid_value",
        "details": {
          "values": [
            "did=not-a-did"
          ]
        }
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.malformed-txt",
      "fullName": "_atproto.malformed-txt.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://malformed-txt.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_no_prefix"
  }
}
記録した例:ドメインが別のDIDを指す
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"wrong-account.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.wrong-account.example.com": [
        [
          "did=did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
      "alsoKnownAs": [
        "at://wrong-account.example.com"
      ]
    },
    "appviewHandle": "wrong-account.example.com"
  },
  "report": {
    "domain": "wrong-account.example.com",
    "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "dns",
    "verification": "verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
          ],
          "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
          "handle": "wrong-account.example.com"
        }
      },
      {
        "id": "expected",
        "status": "fail",
        "reason": "mismatch",
        "details": {
          "dids": [
            "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
            "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ]
        }
      },
      {
        "id": "appview",
        "status": "fail",
        "reason": "unresolved",
        "details": {
          "handle": "wrong-account.example.com",
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      }
    ],
    "record": {
      "name": "_atproto.wrong-account",
      "fullName": "_atproto.wrong-account.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://wrong-account.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "did_mismatch"
  }
}

DNSとHTTPSで異なるDIDが返る

表示される結果: agreement: disagree。対処: 両方を同じアカウントにそろえるか、使っていない古い方法を削除します。仕様では両方が応答するとDNSが優先されます。不一致だけで、正しいDNS → DID → ハンドルの関係が無効になるわけではありません。チェッカーも競合と verification の結果を分けて表示します。

記録した例:DNSが優先され、ファイルだけが古い
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"disagree-methods.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.disagree-methods.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 200,
      "text": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
      "contentType": "text/plain",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://disagree-methods.example.com"
      ]
    },
    "appviewHandle": "disagree-methods.example.com"
  },
  "report": {
    "domain": "disagree-methods.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "both",
    "verification": "verified",
    "ok": false,
    "problems": 1,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ],
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "found",
        "details": {
          "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
          "redirects": 0
        }
      },
      {
        "id": "agreement",
        "status": "fail",
        "reason": "disagree",
        "details": {
          "dids": [
            "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
            "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
          ]
        }
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "disagree-methods.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "pass",
        "reason": "ok",
        "details": {
          "handle": "disagree-methods.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.disagree-methods",
      "fullName": "_atproto.disagree-methods.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://disagree-methods.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_https_conflict"
  }
}

HTTPSがウェブページ・ログイン・プロキシの確認画面を返す

表示される結果: https: html、401 / 403、または到達不能。ブラウザーでトップページを開けても証明にはなりません。対処: https://<ハンドル>/.well-known/atproto-did で、公開のHTTPS応答としてDIDだけを text/plain で返します。リダイレクト後の最終ステータスと本文を確認してください。例外はこの公開証明のパスに限定し、他のアプリ画面の保護を外さないでください。

仕様は合理的な回数の リダイレクトを許可 しています。有効な証明に到達するリダイレクト自体は失敗ではありません。ログイン画面、HTML、循環する転送とは区別します。有効なDNSの証明があれば、使わないHTTPS側の問題は警告になる場合もあります。

記録した例:DIDの代わりにHTMLを返す
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"https-html.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 200,
      "text": "<html><body>Home page</body></html>",
      "contentType": "text/html",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "https-html.example.com"
  },
  "report": {
    "domain": "https-html.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "html",
        "details": {
          "status": 200,
          "redirects": 0
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.https-html",
      "fullName": "_atproto.https-html.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-html.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "https_bad_body"
  }
}
記録した例:認証が必要
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"https-login.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 401,
      "text": "Authentication required",
      "contentType": "text/plain",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "https-login.example.com"
  },
  "report": {
    "domain": "https-login.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "could_not_check",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "status",
        "details": {
          "status": 401
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.https-login",
      "fullName": "_atproto.https-login.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-login.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": null
  }
}
記録した例:ブラウザー確認が必要
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"https-challenge.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 403,
      "text": "<html><body>Browser verification required</body></html>",
      "contentType": "text/html",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "https-challenge.example.com"
  },
  "report": {
    "domain": "https-challenge.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "could_not_check",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "status",
        "details": {
          "status": 403
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.https-challenge",
      "fullName": "_atproto.https-challenge.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-challenge.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": null
  }
}
正常な比較例:リダイレクト先の証明が有効
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"https-redirect.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 200,
      "text": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "contentType": "text/plain",
      "redirects": 1
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://https-redirect.example.com"
      ]
    },
    "appviewHandle": "https-redirect.example.com"
  },
  "report": {
    "domain": "https-redirect.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "https",
    "verification": "verified",
    "ok": true,
    "problems": 0,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "found",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "redirects": 1
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "https-redirect.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "pass",
        "reason": "ok",
        "details": {
          "handle": "https-redirect.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.https-redirect",
      "fullName": "_atproto.https-redirect.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-redirect.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "ok"
  }
}

DID文書が古いハンドルを名乗っている

表示される結果: DNSは正しいDIDでも document: claims_other。対処: 目的のアカウントでログインし、完全なドメインを設定で再検証・再選択します。別アカウントでの変更や、未完了のホスティング移行により古い値が残る場合があります。保存前にアカウントを確認してください。このガイドではPDS移行自体の修復は扱いません。

記録した例:逆方向がold.example.comを名乗る
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"reverse-claim.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.reverse-claim.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://old.example.com"
      ]
    },
    "appviewHandle": "reverse-claim.example.com"
  },
  "report": {
    "domain": "reverse-claim.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "dns",
    "verification": "not_verified",
    "ok": false,
    "problems": 1,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ],
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "fail",
        "reason": "claims_other",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "old.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "pass",
        "reason": "ok",
        "details": {
          "handle": "reverse-claim.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.reverse-claim",
      "fullName": "_atproto.reverse-claim.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://reverse-claim.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "doc_not_claiming"
  }
}

証明は正しいがアプリの表示が古い

表示される結果: verification: verified と appview: old_handle、またはアプリ間の違い。対処: 現在の証明とDID文書を確認した上で、設定 → アカウント → ハンドル、独自ドメインの選択と検証をやり直します。Blueskyの案内 にある手順であり、キャッシュ消去を保証する操作ではありません。DNSのTTLやIDサービスのキャッシュがあるため、反映時間を一律には約束できません。

記録した例:証明は有効だがAppViewの名前が古い
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"stale-appview.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.stale-appview.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://stale-appview.example.com"
      ]
    },
    "appviewHandle": "old.example.com"
  },
  "report": {
    "domain": "stale-appview.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "dns",
    "verification": "verified",
    "ok": false,
    "problems": 1,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ],
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "stale-appview.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "fail",
        "reason": "old_handle",
        "details": {
          "handle": "old.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.stale-appview",
      "fullName": "_atproto.stale-appview.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://stale-appview.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "appview_stale"
  }
}

.bluesky.botの名前を解放・変更した

当サービスの証明はHTTPSです。name.bluesky.bot 用のDNSを自分で追加する必要はありません。名前を解放するとその申請は取り消されます。別のハンドルに変えただけなら、予約が残ったまま定期確認に障害が記録される場合があります。確認済みの失敗が繰り返されると有効状態が外れ、公開掲載には14日間の猶予が設けられる場合があります。同意して確認を済ませた通知先には、障害ごとに一回のメールが届くことがあります。ボットの確認 に状態と操作の説明があります。

対処: ボットの管理画面で、アカウントが有効で名前をまだ所有しているか確認し、切り替え・再確認を行います。解放済みなら空いている名前を選びます。診断ページは予約を復元できません。以下は予約済みの例示ドメインで証明がない状態を再現したもので、実在の .bluesky.bot を照会していません。

記録した例:解放した名前に順方向の証明がない
取得日

入力

Controlled fixture: checkHandleSetup({"domain":"released-handle.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

取得した出力

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "released-handle.example.com"
  },
  "report": {
    "domain": "released-handle.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.released-handle",
      "fullName": "_atproto.released-handle.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://released-handle.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_missing"
  }
}

当サービスの確認で観測する状態

記録された障害の原因別内訳

集計日

確認で観測した状態記録された障害数記録された障害に占める割合(%)
Blueskyがアカウントの別のハンドルを表示寄与した件数が5未満、または計測履歴がないため非公開。寄与した件数が5未満、または計測履歴がないため非公開。
Blueskyがhandle.invalidを返す寄与した件数が5未満、または計測履歴がないため非公開。寄与した件数が5未満、または計測履歴がないため非公開。
申請した名前が別のDIDを指す寄与した件数が5未満、または計測履歴がないため非公開。寄与した件数が5未満、または計測履歴がないため非公開。
アカウントが提供されていない寄与した件数が5未満、または計測履歴がないため非公開。寄与した件数が5未満、または計測履歴がないため非公開。

現在公開中のディレクトリ掲載ボットに限り、最大90日間の完了したUTC日を対象にします。毎日の全確認結果ではなく、障害への移行の記録です。値のある原因に寄与したボットが5件未満の場合、内訳全体を非表示にします。欠測値はゼロではありません。

集計日

公開中の有効なハンドル
56
観測されたハンドルの稼働率(%)
100
計測時間に寄与した公開ボット
56
観測された完了日数
2
復旧時間の中央値(時間)
寄与した件数が5未満、または計測履歴がないため非公開。
復旧した事例
寄与した件数が5未満、または計測履歴がないため非公開。
日次再確認の成功率(%)
寄与した件数が5未満、または計測履歴がないため非公開。
成功したボット日数
寄与した件数が5未満、または計測履歴がないため非公開。
観測したボット日数
寄与した件数が5未満、または計測履歴がないため非公開。
日次再確認に寄与した公開ボット数
寄与した件数が5未満、または計測履歴がないため非公開。
観測がある完了済みUTC日数
寄与した件数が5未満、または計測履歴がないため非公開。
この集計期間の最初の観測からの暦日数
寄与した件数が5未満、または計測履歴がないため非公開。

現在公開中のディレクトリのボットを対象とします。稼働率は、記録された障害のない観測分数の割合であり、確認の成功率ではありません。復旧時間は直近の完了したUTC90日間の有効な解消記録を使い、未解消の事例を除きます。過去の履歴は補いません。

成功率は成功したボット日数を観測したボット日数で割った値です。各ボットについて、UTC日ごとの最後の確定的な自動日次再確認だけを数えます。手動確認、初回・確認待ちの検証、比較用チェック、ネットワークの不確実な応答、障害対策で除外した失敗は含めません。昨日までの完了済みUTC日を最大90日使い、観測がない日を成功とは扱いません。暦日数はその期間内の最初の記録から数えます。寄与するボットが5件未満、または成功・失敗の空でないグループの寄与ボットが5件未満なら、率と件数をまとめて非公開にします。収集は導入後に始まり、過去は復元しません。応答時間は未計測です。

対象は 現在公開中のディレクトリ掲載ボット と条件を満たす猶予期間中の掲載に限り、最大90日間の完了したUTC日です。Bluesky全体や当サービスの全申請ではありません。shows_other_handle、handle_invalid、resolves_elsewhere、account_gone は観測した症状で、DNSの根本原因を実証した分類ではありません。ここからDNS管理画面の操作ミスの割合は推定しません。復旧時間の中央値には未復旧の障害を含めず、未観測の履歴も補いません。小さな集団がある場合は内訳全体を非表示にします。

まだ解決しない場合

アカウントやアプリについては Blueskyのサポート、.bluesky.bot の申請については 当サービスへの連絡 を利用してください。失敗した確認と日時を伝え、パスワードやOAuthトークンは送らないでください。DNS管理を避けたいボット運営者には、ボット用ハンドル と 無料の選択肢 を紹介しています。個人アカウントのドメイン修復にボット用ハンドルは不要です。

ボットのハンドルを確認

よくある質問

無効なハンドルになるとフォロワーを失いますか?
ハンドルの無効化だけで投稿やフォロワーが消えることはありません。アカウントはDIDで識別されます。同じアカウントで証明を修正するか、別のハンドルを選んでください。
DNSの反映にはどのくらいかかりますか?
一定の時間はありません。DNSとIDサービスのキャッシュに古い応答が残る場合があります。権威サーバーのレコードを確認し、TTLが切れてから再確認してください。値を何度も変えると診断が難しくなります。
サブドメインを使えますか?
はい。example.comのゾーンでyou.example.comを使う場合、TXT名は_atproto.you、完全な名前は_atproto.you.example.comです。証明とDID文書には完全なハンドルが必要です。
一部のアプリだけで無効と表示されるのはなぜですか?
アプリやIDサービスによってキャッシュを更新する時刻が異なることがあります。現在のDNSまたはHTTPSの証明、DID文書、AppViewの結果を比べてから、ドメインがまだ壊れているか判断してください。

出典