Dvina-selain käy verkkosivustoilla yhden henkilön puolesta kerrallaan, kun tämä pyytää Dvina-avustajalta jotakin, johon tarvitaan oikea selain. Tämä sivu on tarkoitettu verkkosivustojen omistajille: mitä selain tekee, miten tunnistat sen pyynnöt ja miten sallit tai estät sen käytön.

Mikä se on

Dvina on henkilökohtainen avustaja. Kun Dvina-palveluun kirjautunut henkilö pyytää tehtävää, johon tarvitaan verkkosivustoa, kuten tarjousten vertailua tai lomakkeen täyttämistä, Dvina voi hoitaa sen omassa selaimessaan kyseisen henkilön Dvina-tietokoneella. Selain on ikkunallinen Chromiumin työpöytäversio, ei ilman käyttöliittymää toimiva selain. Henkilö voi seurata sen toimintaa reaaliajassa ja ottaa sen hallintaansa milloin tahansa.

  • Se toimii yhden henkilön puolesta. Jokainen selain kuuluu yhdelle kirjautuneelle Dvina-käyttäjälle ja tekee tämän pyytämiä tehtäviä.
  • Se ei ole indeksointirobotti. Sillä ei ole luetteloa sivustoista, joilla se kävisi oma-aloitteisesti. Se avaa tehtävän vaatimat sivut vaihe kerrallaan: lataa sivun, lukee sen ja toimii sitten sen sisällön perusteella, kuten ihminenkin.
  • Sisältöä ei koskaan käytetä mallien kouluttamiseen. Dvina-selaimen sivustoltasi lukemaa sisältöä käytetään vain sen henkilön pyyntöön, jonka puolesta selain toimii. Sitä ei koskaan käytetä tekoälymallin kouluttamiseen.
  • Se jättää henkilön omat päätökset hänelle itselleen. Se ei kirjoita salasanoja tai korttitietoja. Kun sivu edellyttää kirjautumista tai maksamista, Dvina pysähtyy ja pyytää henkilöä ottamaan selaimen hallintaansa. Henkilötietojen käyttö, lähettäminen, maksaminen ja poistaminen odottavat henkilön hyväksyntää.
  • Se ei ratkaise ihmisen tekemää käyttöä varmistavia tarkistuksia. Kun se kohtaa tarkistuksen, jolla varmistetaan selaajan olevan ihminen, kuten Cloudflaren tarkistuksen, Turnstilen, reCAPTCHAn tai hCaptchan, se ei napsauta, ratkaise tai lataa sitä uudelleen. Jos tarkistus menee läpi itsestään, Dvina odottaa sitä. Jos tarkistus jää näkyviin, työ pysähtyy. Henkilö ottaa selaimen hallintaansa, läpäisee tarkistuksen ja luovuttaa selaimen takaisin.

Tunnista selaimen pyynnöt

Dvina-selain allekirjoittaa jokaisen lähettämänsä http- ja https-pyynnön Web Bot Auth -menetelmällä käyttäen HTTP-viestiallekirjoituksia (RFC 9421) ja Ed25519-avainta. Jokaisessa pyynnössä on kolme otsaketta:

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 yksilöi Dvina-palvelun eli alkuperän, jossa sen avaimet julkaistaan.
  • Signature-Input kattaa pyynnön @authority-arvon (sivustosi isäntä) ja Signature-Agent-otsakkeen. tag-arvo on web-bot-auth.
  • Jokainen allekirjoitus on voimassa 60 sekuntia, created-ajankohdasta expires-ajankohtaan.
  • keyid on avaimen JWK-sormenjälki (RFC 7638).

Selain lähettää Chromiumin oman user agent -tunnisteen, joka on sama kuin millä tahansa Linuxissa toimivalla Chromium-selaimella, esimerkiksi:

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

Sen Chrome-versio muuttuu Chromiumin päivitysten mukana, eikä user agent -tunniste kerro mitään Dvina-palvelusta. Tunnista Dvina allekirjoituksesta, älä user agent -tunnisteesta.

Huomio

Työpöytäsovelluksella henkilö voi myös antaa Dvina-avustajan käyttää omalla tietokoneellaan olevaa selainta. Tämä selain ei allekirjoita pyyntöjään, ja sen käyttö näyttää henkilön omalta selaamiselta.

Varmenna allekirjoitus

Dvina julkaisee julkisen avaimensa avainhakemistossaan:

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

Hakemisto palauttaa vastauksen, jonka sisältötyyppi on Content-Type: application/http-message-signatures-directory+json ja joka sisältää Dvina-palvelun julkisen Ed25519-avaimen JSON Web Key Set -muodossa. Vastaus allekirjoitetaan samalla avaimella, ja siinä käytetään parametria tag="http-message-signatures-directory".

Jos sivustosi käyttää Cloudflarea, Cloudflare varmentaa allekirjoitetut agentit puolestasi. Näin varmennat pyynnön itse:

  1. Tarkista, että Signature-Agent on "https://api.dvina.ai" ja että Signature-Input sisältää parametrin tag="web-bot-auth".
  2. Tarkista, että nykyinen aika on created- ja expires-ajankohtien välissä.
  3. Hae avainhakemisto ja valitse avain, jonka JWK-sormenjälki vastaa keyid-arvoa.
  4. Muodosta allekirjoituksen pohja arvoista @authority ja signature-agent sekä allekirjoituksen parametreista RFC 9421:n mukaisesti ja varmenna Signature kyseisellä Ed25519-avaimella.

Kuka tahansa voi lähettää nämä otsakkeet. Käsittele pyyntöä Dvina-palvelun lähettämänä vain, jos sen allekirjoitus varmentuu Dvina-palvelun avainhakemiston avulla.

Salli tai estä selaimen käyttö

Dvina-selain toimii reaaliaikaisesti yhden henkilön puolesta. Tällaisen liikenteen kattaa Cloudflaren Agent-esiasetus. Jos sivustosi käyttää Cloudflarea:

  • Tekoälybottien käytännöt: Valitse Security Settings -asetuksista Configure AI bot policies. Valitse Agent-kohdassa Allow (do not block), Block on pages with ads tai Block (on all pages).
  • WAF:n mukautetut säännöt: Vahvistettujen bottien ja allekirjoitettujen agenttien pyynnöissä cf.client.bot (cf.bot_management.verified_bot, jos käytössä on Bot Management) on asetettu arvoon true. Käytä sitä mukautetussa säännössä ohittaaksesi tarkistukset, vaatiaksesi lisävarmennuksen tai estääksesi pyynnöt.
  • Vahvistettujen bottien hakemisto: Katso Cloudflaren vahvistamat agentit Cloudflare Radarista.

Muissa ympäristöissä tarkista allekirjoitus edellä kuvatulla tavalla ja salli tai estä sitten pyynnöt, joiden vahvistettu Signature-Agent on "https://api.dvina.ai".

Ota yhteyttä

Onko sinulla kysyttävää Dvina-selaimen toiminnasta sivustollasi, tai oletko havainnut pyynnön, joka ei toiminut tällä sivulla kuvatulla tavalla? Lähetä sähköpostia osoitteeseen support@dvina.ai ja kerro sivustosi osoite sekä pyyntöjen ajankohta ja keyid, jos ne ovat tiedossasi.