Słownik

Dwa rekordy, dzięki którym domena staje się nazwą użytkownika na Bluesky

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •11 min czytania
Dwa rekordy, dzięki którym domena staje się nazwą użytkownika na BlueskyDwa rekordy, dzięki którym domena staje się nazwą użytkownika na Bluesky

TL;DR, szybka odpowiedź

11 min czytania

Domena staje się twoją nazwą użytkownika na Bluesky, gdy udowodnisz, że ją kontrolujesz: rekordem DNS TXT na subdomenie _atproto o wartości did=did:plc:twojdid albo odpowiedzią HTTPS w postaci zwykłego tekstu pod /.well-known/atproto-did, zawierającą sam DID. Specyfikacja AT Protocol ogranicza nazwy do 253 znaków ASCII, w praktyce do 244, i wyklucza domeny najwyższego poziomu .alt, .arpa, .example, .internal, .invalid, .local, .localhost i .onion. Nazwa liczy się dopiero wtedy, gdy dokument DID wskazuje z powrotem na nią.

Czym jest własna domena jako nazwa użytkownika na Bluesky?

Domena, którą posiadasz, staje się twoją nazwą użytkownika (handle) na Bluesky, gdy opublikujesz jeden rekord potwierdzający, że ją kontrolujesz: rekord DNS TXT na subdomenie _atproto albo plik tekstowy serwowany pod /.well-known/atproto-did. Bluesky działa na AT Protocol, a to specyfikacja nazw w tym protokole decyduje, czy twój rekord zadziała. Artykuły pomocy opisują przyciski w aplikacji. Specyfikacja opisuje to, co sieć sprawdza później.

Przeczytaj to, zanim zmienisz cokolwiek w DNS: "Handles are mutable and human-friendly account usernames, in the form of a DNS hostname." Nazwa użytkownika jest nazwą hosta, dlatego mozilla.org działa, a samo mozilla już nie: "'bare' top-level domains are not allowed as handles, even if valid 'hostnames' and 'DNS names.'"

Za każdą nazwą stoi DID, jeden z "the long-term persistent identifiers for accounts in atproto." Wklejasz swój DID do wybranego rekordu, więc tutaj tylko to jest ci potrzebne. Cała reszta o tym, czym jest DID, zasługuje na osobny tekst.

Który rekord opublikować i co w nim wpisać?

Opublikuj jeden z tych dwóch, wstawiając własny DID w miejsce przykładowego.

Metoda DNS TXTMetoda HTTPS well-known
Lokalizacja_atproto.example.comhttps://example.com/.well-known/atproto-did
MechanizmRekord TXTOdpowiedź HTTP GET
Wartośćdid=did:plc:ewvi7nxzyoun6zhxrhs64oizdid:plc:ewvi7nxzyoun6zhxrhs64oiz
Prefiks did=WymaganyNie może występować
Typ treściNie dotyczytext/plain
PrzekierowaniaNie dotyczyDozwolone, "up to a reasonable number of redirect hops"
Status w specyfikacji"recommended and preferred" dla osóbPrzeznaczona dla usług rejestrujących nazwy masowo

Prefiks to najczęstszy błąd przy wklejaniu, a żadna z metod cię przed nim nie ostrzega. Resolwery DNS ignorują "TXT records with values not starting with did=." W HTTPS ten sam prefiks psuje treść odpowiedzi, której specyfikacja oczekuje w formie "the DID... with no prefix or wrapper formatting."

Rekord DNS dla nazwy na domenie głównej example.com:

Type:  TXT
Name:  _atproto
Value: did=did:plc:ewvi7nxzyoun6zhxrhs64oiz
TTL:   300

Dla nazwy na subdomenie, takiej jak alice.example.com, nazwa rekordu to _atproto.alice. Większość paneli DNS sama dopisuje strefę, więc wpisanie pełnego _atproto.alice.example.com daje _atproto.alice.example.com.example.com i błąd, którego nikt nie zgłosi.

Może istnieć tylko jeden rekord: "If multiple valid records with different DIDs are present, resolution should fail." Stary rekord z poprzedniego konta psuje nowy.

Odpowiedź HTTPS, jakiej wymaga specyfikacja, dokładnie w tej postaci:

HTTP/1.1 200 OK
Content-Length: 33
Content-Type: text/plain
Date: Wed, 14 Jun 2023 00:47:21 GMT
 
did:plc:ewvi7nxzyoun6zhxrhs64oiz

Akapit dalej, w tej samej sekcji, specyfikacja łagodzi własny wymóg: "The response Content-Type header does not need to be strictly verified." Mimo to serwuj text/plain, bo nie wiesz, który resolwer czyta który wiersz.

Swój DID znajdziesz w aplikacji. Poradnik Bluesky podaje ścieżkę "Settings", potem "Account", potem "Handle", a host rekordu pokazuje jako _atproto z wartością "did=did:plc:[your value here]".

Jakie są zasady składni nazwy użytkownika?

Jest siedem zasad i nazwa musi spełniać wszystkie:

  1. Cała nazwa składa się wyłącznie ze znaków ASCII i ma najwyżej 253 znaki.
  2. Segmenty oddzielają kropki ASCII, a segmentów musi być co najmniej dwa.
  3. Bez kropek na początku i na końcu, bez końcowej kropki ze składni DNS.
  4. Każdy segment ma od 1 do 63 znaków: litery ASCII a-z, cyfry 0-9 i łączniki -.
  5. Segment nie może zaczynać się ani kończyć łącznikiem.
  6. Ostatni segment, czyli domena najwyższego poziomu, nie może zaczynać się od cyfry.
  7. Wielkość liter nie ma znaczenia, a nazwy są normalizowane do małych liter.

O ostatniej zasadzie: "the handle input string BlueskyWeb.xyz should be normalized, stored, and displayed as blueskyweb.xyz." Jeśli twoja marka pisze się wielkimi literami, nazwa użytkownika i tak będzie mała.

Referencyjne wyrażenie regularne ze specyfikacji:

/^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$/

253 to liczba z nagłówków, ale nie ta, pod którą warto projektować. W wytycznych implementacyjnych ukryta jest mniejsza: "handles should be limited to at most 244 characters... because DNS verification works with the prefix _atproto., which adds 9 characters." Wszystko między 245 a 253 znakami jest zgodne z sekcją o składni, ale nie da się tego rozwiązać przez DNS, a wyjście awaryjne znajduje się w innej sekcji: "The HTTPS method will work for such handles."

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Przykłady, które specyfikacja uznaje za poprawne, obok tych, które odrzuca:

Poprawna składniaNiepoprawna składniaDlaczego druga kolumna nie przechodzi
jay.bsky.socialjo@hn.test@ nie jest dozwolonym znakiem
8.cnjohn..testPusty segment między kropkami
a.cojohn.0TLD zaczyna się od cyfry
XX.LCS.MIT.EDUorgTylko jeden segment
xn--notarealidn.comname.org.Kropka na końcu
name.t--txn--bcher-.tldSegment kończy się łącznikiem

Domeny międzynarodowe działają tylko w formie zakodowanej: "Such handles must be stored and transmitted in encoded ASCII form."

Budżet długości nazwy
Maksimum według specyfikacji253 znaki
Bezpiecznie dla DNS TXT244 znaki
Prefiks _atproto9 znaków
Metoda DNS TXT zabiera 9 z 253 dozwolonych znaków, zanim w ogóle zacznie się twoja domena, dlatego bezpieczny pułap spada do 244.

Które TLD nigdy nie będą nazwą użytkownika na Bluesky?

Osiem domen najwyższego poziomu jest wykluczonych z góry. Ze specyfikacji: "the initial list of disallowed TLDs includes: .alt, .arpa, .example, .internal, .invalid, .local, .localhost, .onion."

Sposób, w jaki zawodzą, jest celowy i dość osobliwy. Zastrzeżone TLD "should not fail syntax validation... but they must immediately fail any attempt at registration, resolution, etc." Dlatego laptop.local i blah.arpa przechodzą test wyrażenia regularnego, a przy rozwiązywaniu zawsze kończą się błędem. Walidator oparty wyłącznie na regexie uzna taką nazwę za poprawną, dopóki sieć jej nie odrzuci.

Trzy pozycje mają dodatkowe warunki:

  • .onion jest zablokowana z podanego powodu, a nie na stałe: "Resolution of handles via Tor would require ecosystem-wide support, so they are currently disallowed." Sekcja o przyszłych zmianach dodaje, że ".onion handles would be allowed at some point in the future."
  • .invalid jest zarezerwowana dla jednej wartości specjalnej, handle.invalid, którą API zwraca "to indicate that there is no bi-directionally valid handle for the given DID."
  • .test nie ma na liście wykluczonych, ale też nie da się jej używać. "may be used in atproto development, but should fail in real-world environments."

Zwróć uwagę na słowo "initial". Lista nie jest przedstawiona jako ostateczna, a specyfikacja odsyła do sekcji Wikipedii o domenach zastrzeżonych, zamiast prowadzić własny rejestr. Osiem nazw to wszystko, do czego protokół zobowiązuje się na piśmie, a granica poza nimi leży na stronie, której nikt z projektu AT Protocol nie kontroluje.

Programista uruchamia w terminalu polecenie sprawdzające rekordy DNS domeny.

Jak rozwiązać nazwę użytkownika do jej DID?

Sprawdź to na prawdziwym koncie, a obie połowy weryfikacji odbędą się na twoich oczach. Wszystkie poniższe wartości zostały rozwiązane 10 września 2026 roku.

Zacznij od rekordu DNS dla bsky.app, własnej nazwy Bluesky:

dig +short TXT _atproto.bsky.app
"did=did:plc:z72i7hdynmk6r22z27h6tvur"

Usuń prefiks did= i masz DID. Endpoint samego protokołu, który klienci wywołują zamiast samodzielnie odpytywać DNS, zwraca tę samą odpowiedź:

curl -s "https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=bsky.app"
{ "did": "did:plc:z72i7hdynmk6r22z27h6tvur" }

Teraz pobierz dokument DID, czyli drugą połowę weryfikacji:

curl -s https://plc.directory/did:plc:z72i7hdynmk6r22z27h6tvur
{
  "@context": ["https://www.w3.org/ns/did/v1", "https://w3id.org/security/multikey/v1", "https://w3id.org/security/suites/secp256k1-2019/v1"],
  "id": "did:plc:z72i7hdynmk6r22z27h6tvur",
  "alsoKnownAs": ["at://bsky.app"],
  "verificationMethod": [
    {
      "id": "did:plc:z72i7hdynmk6r22z27h6tvur#atproto",
      "type": "Multikey",
      "controller": "did:plc:z72i7hdynmk6r22z27h6tvur",
      "publicKeyMultibase": "zQ3shQo6TF2moaqMTrUZEM1jeuYRQXeHEx4evX9751y2qPqRA"
    }
  ],
  "service": [
    {
      "id": "#atproto_pds",
      "type": "AtprotoPersonalDataServer",
      "serviceEndpoint": "https://puffball.us-east.host.bsky.network"
    }
  ]
}

Wszystko rozstrzyga pole alsoKnownAs z wartością at://bsky.app. Nazwa wskazała DID, a dokument DID wskazuje z powrotem na nazwę. Specyfikacja wymaga obu kierunków: "The link between handle and DID must be confirmed bidirectionally, otherwise anybody could create handle aliases for third-party accounts." Opublikowanie rekordu TXT z cudzym DID nic ci nie da, bo dokument DID tej osoby nie wymienia twojej domeny.

Gdy nazwy nie da się rozwiązać, endpoint odpowiada jednym komunikatem:

{ "error": "InvalidRequest", "message": "Unable to resolve handle" }

Przychodzi on ze statusem HTTP 400 i jest taki sam przy braku rekordu, przy poprawnej nazwie na zastrzeżonym TLD i przy domenie, która nie istnieje. Diagnozuj przez dig i curl, a nie na podstawie odpowiedzi API.

Cztery nazwy rozwiązane tego dnia, wszystkie potwierdzone w obu kierunkach w plc.directory:

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

NazwaDIDMetoda, która odpowiedziała
bsky.appdid:plc:z72i7hdynmk6r22z27h6tvurDNS TXT
mozilla.orgdid:plc:jxrrsbtaptoynkhm2tdvxohgDNS TXT
theverge.comdid:plc:7exlcsle4mjfhu3wnhcgizz6DNS TXT
jay.bsky.socialdid:plc:mfm3grjeffxyfuxj3uiisfuzHTTPS well-known

Ten podział to projekt specyfikacji działający zgodnie z zapisem. Organizacje z panelem DNS korzystają z rekordu TXT. Nazwa odpowiadająca przez HTTPS to subdomena bsky.social, czyli przypadek "large-scale web services which may not have the infrastructure to automate the registration of thousands or millions of DNS TXT records", dla którego powstała ta metoda.

Żądanie https://mozilla.org/.well-known/atproto-did zwraca stronę HTML z błędem 404, a theverge.com zachowuje się tak samo. Obie nazwy rozwiązują się bez problemu. Odpowiedzieć musi tylko jedna metoda, a 404 na ścieżce, której nie używasz, niczym nie grozi.

Gdzie psują się nazwy użytkownika oparte na własnej domenie?

ObjawPrzyczynaRozwiązanie
Nazwa odrzucona, rekord DNS wygląda dobrzeNazwa rekordu to _atproto.example.com.example.com, bo panel dopisuje strefęW polu nazwy wpisz samo _atproto
Rozwiązywanie zawodzi po zmianie nazwyNadal opublikowany jest stary rekord TXT z innym DIDUsuń go, bo "If multiple valid records with different DIDs are present, resolution should fail"
Nazwa dłuższa niż 244 znaki nie działa_atproto. dodaje 9 znaków i wypycha zapytanie poza 253Użyj metody HTTPS, którą specyfikacja wskazuje dla tego przypadku
Ścieżka well-known zwraca HTML aplikacjiTrasa typu catch-all we frameworku odpowiada przed plikiem statycznymObsłuż tę ścieżkę przed trasą catch-all, z nagłówkiem Content-Type: text/plain
Dwie metody dają różne wynikiIstnieją rekord TXT i plik well-known wskazujące różne DIDSpecyfikacja mówi, że "the DNS TXT result should be preferred"; mimo to usuń nieaktualny wpis
Nazwa wyświetla się jako handle.invalidNazwa przestała się rozwiązywać po wcześniejszej weryfikacjiOpublikuj rekord ponownie; specyfikacja ostrzega, że PDS "may prevent repo mutation", gdy konto jest w tym stanie
Zmiana jeszcze nie jest widocznaPamięć podręczna, bo usługi "cache handle resolution results internally, up to some lifetime"Poczekaj i rozwiąż nazwę ponownie, a przed zmianą ustaw krótki TTL

Przekierowania zasługują na osobną uwagę, bo inne specyfikacje well-known ich zakazują, a ta nie: "HTTP redirects (eg, 301, 302) are allowed, up to a reasonable number of redirect hops." Przekierowanie z domeny głównej na www jest w porządku. Przekierowanie kończące się błędem 404 już nie, a tak się dzieje, gdy domena główna przekierowuje na www, gdzie pliku nigdy nie wdrożono.

Ktoś sprawdza na telefonie kolejkę zaplanowanych postów w mediach społecznościowych.

Co dzieje się z zaplanowanymi postami, gdy zmienia się nazwa użytkownika?

Nic, a powód tkwi w samej konstrukcji. Twoim kontem jest DID, który protokół nazywa trwałym, a nazwa użytkownika to zmienna etykieta rozwiązywana na nowo za każdym razem, gdy klient jej potrzebuje. Przejście z you.bsky.social na yourbrand.com nie narusza DID, więc kolejka zbudowana w narzędziu do planowania postów na Bluesky przetrwa zmianę, podobnie jak liczby w narzędziu do analityki Bluesky. To zachowanie protokołu, a nie coś, co narzędzie do publikacji daje lub odbiera.

Zmieniają się za to dwie rzeczy. Posty, które już opublikujesz, wyświetlają się pod nową nazwą, bo klienci pokazują nazwę rozwiązaną na bieżąco, a nie zamrożoną w chwili publikacji. A każdy tekst ze starą nazwą staje się nieaktualny, co boli najbardziej, gdy publikujesz ten sam post w kilku sieciach naraz, a nazwa z Bluesky siedzi w opisie współdzielonym z X, LinkedInem i Threads. Przed zmianą przeszukaj zaplanowane szkice pod kątem starej nazwy. Pięć minut w kalendarzu treści wobec miesiąca opublikowanych postów do poprawiania później.

Najczęściej zadawane pytania

Czy potrzebuję zarówno rekordu DNS, jak i pliku well-known?

Nie. Wystarczy jeden, a specyfikacja nazywa metodę DNS TXT "the recommended and preferred resolution method for individual handle configuration." Jeśli opublikujesz oba i będą wskazywać różne DID, resolwery wybiorą odpowiedź z DNS. Usuń nieaktualny wpis, zamiast zostawiać konflikt.

Dlaczego rekord TXT wymaga did=, a plik HTTPS nie?

Obie metody są parsowane inaczej. DNS stosuje RFC-1464 do przechowywania atrybutów w rekordach TXT, więc wartość to klucz i wartość, a resolwery ignorują "TXT records with values not starting with did=." Metoda HTTPS zwraca "the DID as the HTTP body with no prefix or wrapper formatting", więc ten sam prefiks sprawia, że treści nie da się odczytać.

Czy do testów mogę użyć domeny .local lub .internal?

Nie. Obie są na liście wykluczonych, a zastrzeżone TLD "must immediately fail any attempt at registration, resolution, etc.", choć przechodzą walidację składni. Do programowania przeznaczona jest domena .test, a i tak specyfikacja oczekuje, że będzie "fail in real-world environments."

Jak długa może być nazwa użytkownika na Bluesky?

253 znaki ASCII według zasad składni, 244 w praktyce. Prefiks _atproto. używany przy weryfikacji DNS "adds 9 characters, and that overall name needs to be valid." Powyżej 244 znaków działa tylko metoda HTTPS.

Czym jest handle.invalid i dlaczego to widzę?

To wartość zwracana przez API, gdy DID nie ma działającej nazwy, używana "to indicate that there is no bi-directionally valid handle for the given DID." Pojawia się, gdy nazwa, która wcześniej się rozwiązywała, przestaje działać. Ponowne opublikowanie poprawnego rekordu ją usuwa.

Czy zmiana nazwy użytkownika psuje linki, które ludzie już udostępnili?

Nie. Poradnik Bluesky podaje, że "Any tags or mentions with your old handle will still point to your account", bo wzmianki przechowują DID, a nie tekst nazwy. Od grudnia 2024 roku twoja poprzednia nazwa .bsky.social jest też zarezerwowana dla ciebie i nie wraca do puli.

Dlaczego opublikowanie cudzego DID w moim rekordzie TXT nie działa?

Protokół sprawdza powiązanie w obu kierunkach. Twój rekord może wskazywać dowolny DID, ale dokument DID musi też wskazywać z powrotem na twoją domenę w polu alsoKnownAs, za pomocą URI at://. Właśnie dlatego dokument DID samego Bluesky zawiera at://bsky.app. Bez pasującego powiązania zwrotnego każdy mógłby tworzyć aliasy dla cudzych kont, więc rekord TXT z cudzym DID do niczego nie prowadzi.

Czy mogę publikować pod własną domeną od razu po dodaniu rekordu?

Nie zawsze od razu. Usługi przez pewien czas przechowują wyniki rozwiązywania nazw w pamięci podręcznej, więc nieaktualna odpowiedź może się utrzymywać, nawet gdy rekord jest już poprawny. TTL w przykładowym rekordzie DNS powyżej wynosi 300 sekund, a ustawienie krótkiego TTL przed zmianą i ponowne rozwiązanie nazwy po niej skraca to oczekiwanie.

Co dzieje się ze starą nazwą .bsky.social po przejściu na własną domenę?

Pozostaje zarezerwowana dla ciebie. Od grudnia 2024 roku Bluesky zatrzymuje twoją poprzednią nazwę .bsky.social, zamiast zwracać ją do puli po przejściu na własną domenę, więc nikt inny nie może jej przejąć.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy przekierowanie z domeny głównej na www zepsuje weryfikację nazwy?

Samo w sobie nie. Specyfikacja dopuszcza przekierowania HTTP do rozsądnej liczby przeskoków, więc przekierowanie ścieżki well-known z domeny głównej na www jest w porządku. Weryfikacja zawiedzie tylko wtedy, gdy przekierowanie trafi tam, gdzie pliku nigdy nie wdrożono, bo przekierowanie kończące się błędem 404 niczego nie rozwiązuje.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły