Vis som Markdown

Dvina-browseren besøger websteder på vegne af én person ad gangen, når personen beder Dvina om noget, der kræver en rigtig browser. Denne side er til webstedsejere: Her kan du læse, hvad browseren gør, hvordan du genkender dens anmodninger, og hvordan du tillader eller blokerer den.

Hvad er det?

Dvina er en personlig assistent. Når en person, der er logget ind på Dvina, beder om en opgave, der kræver et websted, f.eks. at sammenligne tilbud eller udfylde en formular, kan Dvina gøre det i sin egen browser på personens Dvina-computer. Det er Chromium til desktop med et vindue, ikke en headless-browser, og personen kan følge med live og overtage når som helst.

  • Den handler på vegne af én person. Hver browser tilhører én bruger, der er logget ind på Dvina, og arbejder på det, personen har bedt om.
  • Den er ikke en crawler. Den har ingen liste over websteder, den besøger på egen hånd. Den åbner de sider, en opgave kræver, ét trin ad gangen: Den indlæser en side, læser den og handler derefter på den, ligesom et menneske gør.
  • Bruges aldrig til at træne modeller. Det, Dvina-browseren læser på dit websted, bruges kun til at opfylde anmodningen fra den person, den arbejder for. Det bruges aldrig til at træne en AI-model.
  • Den lader personen træffe sine egne beslutninger. Den indtaster ikke adgangskoder eller kortoplysninger. Når en side kræver, at personen logger ind eller betaler, stopper Dvina og beder personen om at overtage. Personlige oplysninger, afsendelse, betaling og sletning kræver personens godkendelse.
  • Den løser ikke kontroller af, om brugeren er et menneske. Når den møder en kontrol af, om et menneske bruger browseren, f.eks. en kontrol fra Cloudflare, Turnstile, reCAPTCHA eller hCaptcha, klikker den ikke på den, løser den ikke og genindlæser den ikke. Hvis kontrollen afsluttes af sig selv, venter Dvina på det. Hvis den bliver ved med at være der, stopper arbejdet, og personen overtager browseren, gennemfører kontrollen og giver browseren tilbage.

Genkend dens anmodninger

Dvina-browseren signerer hver http- og https-anmodning, den sender, med Web Bot Auth, HTTP-meddelelsessignaturer (RFC 9421) med en Ed25519-nøgle. Hver anmodning indeholder tre headere:

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 angiver Dvina som den origin, hvor nøglerne er offentliggjort.
  • Signature-Input dækker anmodningens @authority (din vært) og headeren Signature-Agent. tag er web-bot-auth.
  • Hver signatur er gyldig i 60 sekunder, fra created til expires.
  • keyid er nøglens JWK-fingeraftryk (RFC 7638).

Browseren sender Chromiums egen user agent, den samme som enhver Chromium-browser på Linux, for eksempel:

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

Dens Chrome-version følger opdateringerne til Chromium, og dens user agent siger intet om Dvina. Genkend Dvina på signaturen, ikke på dens user agent.

Bemærk

Med desktopappen kan en person også lade Dvina bruge en browser på sin egen computer. Den browser signerer ikke sine anmodninger og ligner personens egen browsing.

Verificer en signatur

Dvina offentliggør sin offentlige nøgle i sit nøglekatalog:

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

Kataloget svarer med Content-Type: application/http-message-signatures-directory+json og et JSON Web Key Set med den offentlige Ed25519-nøgle fra Dvina. Svaret er signeret med den samme nøgle og med tag="http-message-signatures-directory".

Hvis dit websted bruger Cloudflare, verificerer Cloudflare signerede agenter for dig. Sådan verificerer du selv en anmodning:

  1. Check that Signature-Agent is "https://api.dvina.ai" and that Signature-Input has tag="web-bot-auth".
  2. Check that the time now is between created and expires.
  3. Get the key directory and pick the key whose JWK thumbprint matches keyid.
  4. Build the signature base from @authority, signature-agent and the signature parameters, as RFC 9421 describes, and verify the Signature with that Ed25519 key.

Alle kan sende disse headere. Betragt kun en anmodning som en anmodning fra Dvina, hvis dens signatur kan verificeres mod nøglekataloget fra Dvina.

Tillad eller bloker den

Dvina's browser handler i realtid på vegne af én person: den type trafik, som Cloudflares forudindstilling Agent dækker. Hvis dit websted bruger Cloudflare:

  • Politikker for AI-bots: Vælg Konfigurer politikker for AI-bots under Sikkerhedsindstillinger. For Agent skal du vælge Tillad (blokér ikke), Blokér på sider med annoncer eller Blokér (på alle sider).
  • Brugerdefinerede WAF-regler: Anmodninger fra verificerede bots og signerede agenter har cf.client.bot (cf.bot_management.verified_bot med Bot Management) sat til true. Brug feltet i en brugerdefineret regel til at lade dem passere, kræve en kontrol eller blokere dem.
  • Oversigt over verificerede bots: Se de agenter, som Cloudflare verificerer, i Cloudflare Radar.

Hvis dit websted ikke bruger Cloudflare, skal du verificere signaturen som beskrevet ovenfor og derefter tillade eller blokere anmodninger, hvor den verificerede Signature-Agent er "https://api.dvina.ai".

Kontakt os

Har du spørgsmål om Dvina's browser på dit websted, eller har du oplevet en anmodning, der ikke opførte sig som beskrevet på denne side? Send en e-mail til support@dvina.ai med dit websteds adresse og, hvis du har dem, tidspunktet og anmodningernes keyid.