Pokaż jako Markdown

Przeglądarka Dvina odwiedza witryny w imieniu jednej osoby naraz, gdy ta osoba prosi Dvina o coś, co wymaga prawdziwej przeglądarki. Ta strona jest przeznaczona dla właścicieli witryn: wyjaśnia, co robi przeglądarka, jak rozpoznawać jej żądania i jak zezwolić na jej dostęp lub go zablokować.

Czym jest

Dvina to osobisty asystent. Gdy osoba zalogowana do Dvina prosi o wykonanie zadania wymagającego skorzystania z witryny, na przykład porównanie ofert lub wypełnienie wskazanego formularza, Dvina może wykonać je we własnej przeglądarce na komputerze Dvina tej osoby. To desktopowa przeglądarka Chromium z oknem, a nie przeglądarka bez interfejsu graficznego. Użytkownik może obserwować jej działanie na żywo i w każdej chwili przejąć nad nią kontrolę.

  • Działa w imieniu jednej osoby. Każda przeglądarka należy do jednego zalogowanego użytkownika Dvina i wykonuje to, o co ta osoba poprosiła.
  • Nie jest robotem indeksującym. Nie ma listy witryn, które odwiedza z własnej inicjatywy. Otwiera strony potrzebne do wykonania zadania, krok po kroku: ładuje stronę, czyta ją, a następnie wykonuje na niej działania, tak jak człowiek.
  • Nigdy nie służy do trenowania modeli. To, co przeglądarka Dvina odczytuje w Twojej witrynie, jest wykorzystywane wyłącznie do realizacji prośby osoby, w której imieniu działa. Nigdy nie służy do trenowania modelu AI.
  • Pozostawia użytkownikowi jego własne decyzje. Nie wpisuje haseł ani danych kart. Gdy strona wymaga zalogowania się lub zapłaty, Dvina zatrzymuje się i prosi użytkownika o przejęcie kontroli. Dane osobowe, wysyłanie, płatności i usuwanie wymagają zgody użytkownika.
  • Nie przechodzi weryfikacji potwierdzającej, że użytkownik jest człowiekiem. Gdy napotka mechanizm sprawdzający, czy ze strony korzysta człowiek, taki jak weryfikacja Cloudflare, Turnstile, reCAPTCHA lub hCaptcha, nie klika go, nie rozwiązuje ani nie ładuje ponownie. Jeśli weryfikacja kończy się sama, Dvina czeka na jej zakończenie. Jeśli nie, zadanie zostaje wstrzymane, a użytkownik przejmuje przeglądarkę, przechodzi weryfikację i oddaje kontrolę.

Rozpoznawanie żądań

Przeglądarka Dvina podpisuje każde wysyłane żądanie http i https za pomocą Web Bot Auth, czyli podpisów wiadomości HTTP (RFC 9421) z kluczem Ed25519. Każde żądanie zawiera trzy nagłówki:

Signature-Agent: "https://api.dvina.ai"
Signature-Input: sig1=("@authority" "signature-agent");created=<unix time>;expires=<created + 60>;keyid="<key id>";alg="ed25519";nonce="<random>";tag="web-bot-auth"
Signature: sig1=:<Ed25519 signature>:
  • Signature-Agent wskazuje Dvina — origin, pod którym publikowane są jej klucze.
  • Signature-Input obejmuje @authority żądania (Twój host) oraz nagłówek Signature-Agent. Wartość tag to web-bot-auth.
  • Każdy podpis jest ważny przez 60 sekund, od created do expires.
  • keyid to odcisk klucza JWK (RFC 7638).

Przeglądarka wysyła standardowy ciąg user agent Chromium, taki sam jak każda przeglądarka Chromium w systemie Linux, na przykład:

Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36

Wersja Chrome zmienia się wraz z aktualizacjami Chromium, a ciąg user agent nie zawiera żadnej informacji o Dvina. Rozpoznawaj Dvina po podpisie, a nie po ciągu user agent.

Informacja

W aplikacji desktopowej użytkownik może też pozwolić Dvina korzystać z przeglądarki na swoim komputerze. Ta przeglądarka nie podpisuje żądań, a jej ruch wygląda tak, jakby użytkownik sam przeglądał strony.

Weryfikacja podpisu

Dvina publikuje swój klucz publiczny w katalogu kluczy:

https://api.dvina.ai/.well-known/http-message-signatures-directory

Katalog zwraca odpowiedź z Content-Type: application/http-message-signatures-directory+json i zestawem JSON Web Key Set zawierającym klucz publiczny Ed25519 Dvina. Odpowiedź jest podpisana tym samym kluczem, z tag="http-message-signatures-directory".

Jeśli Twoja witryna korzysta z Cloudflare, Cloudflare weryfikuje za Ciebie agentów podpisujących żądania. Aby samodzielnie zweryfikować żądanie:

  1. Sprawdź, czy Signature-Agent ma wartość "https://api.dvina.ai" i czy Signature-Input zawiera tag="web-bot-auth".
  2. Sprawdź, czy bieżący czas mieści się między created a expires.
  3. Pobierz katalog kluczy i wybierz klucz, którego odcisk JWK odpowiada keyid.
  4. Zbuduj bazę podpisu z @authority, signature-agent i parametrów podpisu zgodnie z opisem w RFC 9421, a następnie zweryfikuj Signature za pomocą tego klucza Ed25519.

Każdy może wysłać te nagłówki. Uznaj żądanie za pochodzące od Dvina tylko wtedy, gdy jego podpis przejdzie weryfikację przy użyciu katalogu kluczy Dvina.

Zezwalanie na dostęp lub jego blokowanie

Przeglądarka Dvina działa w czasie rzeczywistym w imieniu jednej osoby — to rodzaj ruchu objęty ustawieniem wstępnym Agent w Cloudflare. Jeśli Twoja witryna korzysta z Cloudflare:

  • Zasady dotyczące botów AI: W Ustawieniach zabezpieczeń wybierz Skonfiguruj zasady dotyczące botów AI. Dla opcji Agent wybierz Zezwalaj (nie blokuj), Blokuj na stronach z reklamami lub Blokuj (na wszystkich stronach).
  • Niestandardowe reguły WAF: Żądania od zweryfikowanych botów i agentów podpisujących żądania mają pole cf.client.bot (cf.bot_management.verified_bot w przypadku Bot Management) ustawione na true. Użyj go w niestandardowej regule, aby pomijać kontrole dla tych żądań, poddawać je dodatkowej weryfikacji lub je blokować.
  • Katalog zweryfikowanych botów: Zobacz agentów weryfikowanych przez Cloudflare w Cloudflare Radar.

Anywhere else, verify the signature as described above, then allow or block requests whose verified Signature-Agent is "https://api.dvina.ai".

Skontaktuj się z nami

Masz pytania dotyczące przeglądarki Dvina w Twojej witrynie albo żądania, które nie zachowało się zgodnie z opisem na tej stronie? Napisz na support@dvina.ai, podając adres swojej witryny oraz — jeśli je masz — czas i keyid żądań.