Identity - Knowledge of Laravel

概览

在 Bluesky 中，经常需要在 Handle、DID 之间进行相互解析。

从 Handle 解析 DID

通过 API

use Revolution\Bluesky\Facades\Bluesky;

$did = Bluesky::resolveHandle('***.bsky.social')->json('did');

通过 DNS / well-known

从 DNS TXT 记录或 /.well-known/atproto-did 中获取。

use Revolution\Bluesky\Facades\Bluesky;

$did = Bluesky::identity()->resolveHandle('alice.test');

两者看似相似，但行为不同。API 方式会通过网络向 Bluesky 服务查询，而 DNS/well-known 方式则更适合解析自定义域名的 Handle。

从 DID 获取 DID Document

resolveDID 会返回 DID Document。 https://plc.directory/did:plc:ewvi7nxzyoun6zhxrhs64oiz

use Revolution\Bluesky\Facades\Bluesky;

$didDoc = Bluesky::identity()->resolveDID('did:plc:*** 或 did:web:***')->json();

从 DID Document 获取 Handle

DID Document 的 alsoKnownAs 字段中包含 Handle。

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveDID('did:plc:*** 或 did:web:***')->json());
$handle = $didDoc->handle();

使用 resolveIdentity 统一解析

resolveIdentity 结合了 resolveHandle 与 resolveDID，无论传入 DID 还是 Handle 都能进行解析，并返回 DID Document。

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveIdentity('did 或 handle')->json());
$didDoc->id();
$didDoc->handle();

获取公开个人资料

公开个人资料无论从 DID 还是 Handle 都可以解析，响应中会同时包含 DID 和 Handle。

use Revolution\Bluesky\Facades\Bluesky;

$profile = Bluesky::getProfile('did 或 handle');
$profile->json('did');
$profile->json('handle');

获取 PDS URL / serviceEndpoint

DID Document 中的 serviceEndpoint 就是 PDS 的 URL。虽然直接使用的情况不多，但你可以按需获取。

https://***.***.host.bsky.network

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveIdentity('did 或 handle')->json());
$didDoc->pdsUrl();

获取 Authorization Server URL

通过 PDS 解析出 Authorization Server 的 URL。对于在 Bluesky 注册的账号，一般是 https://bsky.social。

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveIdentity('did 或 handle')->json());

$pds = Bluesky::pds()->getProtectedResource($didDoc->pdsUrl());
$pds->authServer();

Source: docs/identity.md

​概览

​从 Handle 解析 DID

​通过 API

​通过 DNS / well-known

​从 DID 获取 DID Document

​从 DID Document 获取 Handle

​使用 resolveIdentity 统一解析

​获取公开个人资料

​获取 PDS URL / serviceEndpoint

​获取 Authorization Server URL

概览

从 Handle 解析 DID

通过 API

通过 DNS / well-known

从 DID 获取 DID Document

从 DID Document 获取 Handle

使用 resolveIdentity 统一解析

获取公开个人资料

获取 PDS URL / serviceEndpoint

获取 Authorization Server URL