# Agent preglednika koji koristi Dvina

> Kako vlasnici web-stranica mogu prepoznati, provjeriti, dopustiti ili blokirati preglednik kojim se Dvina koristi za osobe za koje radi.

Preglednik kojim se Dvina koristi posjećuje web-stranice za jednu po jednu osobu, kada ta osoba zatraži od Dvina nešto za što je potreban pravi preglednik. Ova je stranica namijenjena vlasnicima web-stranica: opisuje što preglednik radi, kako prepoznati njegove zahtjeve te kako ga dopustiti ili blokirati.

## Što je to

Dvina je osobni asistent. Kada osoba prijavljena u Dvina zatraži zadatak za koji je potrebna web-stranica, poput usporedbe ponuda ili ispunjavanja obrasca koji je zatražila, Dvina to može obaviti u vlastitom pregledniku, na računalu Dvina te osobe. To je stolni Chromium s prozorom, a ne preglednik bez grafičkog sučelja. Osoba može uživo pratiti njegov rad i preuzeti kontrolu u bilo kojem trenutku.

- **Radi za jednu osobu.** Svaki preglednik pripada jednom prijavljenom korisniku Dvina i radi na onome što je ta osoba zatražila.
- **Nije alat za automatsko pretraživanje weba.** Nema popis web-stranica koje samostalno posjećuje. Otvara stranice potrebne za zadatak, korak po korak: učita stranicu, pročita je, a zatim na njoj obavi radnju, kao što bi to učinila osoba.
- **Nikad se ne koristi za treniranje modela.** Ono što preglednik kojim se Dvina koristi pročita na vašoj web-stranici upotrebljava se isključivo za zahtjev osobe za koju radi. Nikad se ne koristi za treniranje AI modela.
- **Osobne odluke prepušta samoj osobi.** Ne upisuje lozinke ni podatke o karticama. Kada stranica zahtijeva prijavu ili plaćanje, Dvina staje i traži od osobe da preuzme kontrolu. Osobni podaci, slanje, plaćanje i brisanje čekaju odobrenje osobe.
- **Ne rješava provjere kojima se potvrđuje da je korisnik čovjek.** Kada naiđe na provjeru kojom se potvrđuje da preglednik koristi osoba, poput provjere Cloudflare, Turnstile, reCAPTCHA ili hCaptcha, ne klikće na nju, ne rješava je niti je ponovno učitava. Ako provjera prolazi sama od sebe, Dvina čeka da završi. Ako ostane, rad se zaustavlja, a osoba preuzima preglednik, prolazi provjeru i vraća kontrolu.

## Prepoznajte njegove zahtjeve

Preglednik kojim se Dvina koristi potpisuje svaki http i https zahtjev koji šalje pomoću [Web Bot Auth](https://datatracker.ietf.org/wg/webbotauth/about/), potpisa HTTP poruka ([RFC 9421](https://www.rfc-editor.org/rfc/rfc9421)) s ključem Ed25519. Svaki zahtjev sadrži tri zaglavlja:

```http
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` navodi Dvina, izvorište na kojem su objavljeni ključevi.
- `Signature-Input` obuhvaća `@authority` zahtjeva (vaš host) i zaglavlje `Signature-Agent`. Vrijednost `tag` je `web-bot-auth`.
- Svaki potpis vrijedi 60 sekundi, od `created` do `expires`.
- `keyid` je JWK otisak ključa ([RFC 7638](https://www.rfc-editor.org/rfc/rfc7638)).

Preglednik šalje vlastiti korisnički agent Chromium, isti kao i bilo koji Chromium na Linuxu, primjerice:

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

Njegova verzija Chrome mijenja se s ažuriranjima Chromium, a korisnički agent ne navodi ništa o Dvina. Prepoznajte Dvina po potpisu, a ne po korisničkom agentu.

> [!NOTE]
> Uz aplikaciju za računalo osoba može dopustiti da Dvina koristi i preglednik na njezinu vlastitom računalu. Taj preglednik ne potpisuje svoje zahtjeve i izgleda kao da osoba sama pregledava web.

## Provjerite potpis

Dvina objavljuje svoj javni ključ u svojem imeniku ključeva:

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

Imenik vraća odgovor s `Content-Type: application/http-message-signatures-directory+json` i skupom JSON Web Key Set koji sadrži javni ključ Ed25519 za Dvina. Odgovor je potpisan istim ključem, uz `tag="http-message-signatures-directory"`.

Ako vaša web-stranica koristi Cloudflare, Cloudflare za vas provjerava potpisane agente. Da biste sami provjerili zahtjev:

1. Provjerite je li `Signature-Agent` jednak `"https://api.dvina.ai"` i sadrži li `Signature-Input` vrijednost `tag="web-bot-auth"`.
2. Provjerite je li trenutačno vrijeme između `created` i `expires`.
3. Dohvatite imenik ključeva i odaberite ključ čiji JWK otisak odgovara vrijednosti `keyid`.
4. Sastavite osnovu potpisa od `@authority`, `signature-agent` i parametara potpisa, kako je opisano u RFC 9421, te provjerite `Signature` tim ključem Ed25519.

Svatko može poslati ta zaglavlja. Smatrajte da zahtjev dolazi od Dvina samo ako se njegov potpis potvrdi pomoću imenika ključeva Dvina.

## Dopustite ili blokirajte preglednik

Preglednik Dvina djeluje u stvarnom vremenu za jednu osobu: to je vrsta prometa koju obuhvaća Cloudflareova unaprijed definirana postavka **Agent**. Ako vaša web-stranica koristi Cloudflare:

- **Pravila za AI botove:** U odjeljku **Sigurnosne postavke** odaberite **Konfiguriraj pravila za AI botove**. Za **Agent** odaberite **Dopusti (nemoj blokirati)**, **Blokiraj na stranicama s oglasima** ili **Blokiraj (na svim stranicama)**.
- **Prilagođena pravila WAF-a:** Za zahtjeve provjerenih botova i potpisanih agenata vrijednost `cf.client.bot` (`cf.bot_management.verified_bot` uz Bot Management) postavljena je na true. Upotrijebite je u prilagođenom pravilu kako biste ih izuzeli iz provjera, zatražili dodatnu provjeru ili ih blokirali.
- **Imenik provjerenih botova:** Agente koje Cloudflare provjerava pogledajte na stranici [Cloudflare Radar](https://radar.cloudflare.com/verified-bots).

U svim ostalim slučajevima provjerite potpis kako je opisano iznad, a zatim dopustite ili blokirajte zahtjeve čija je provjerena vrijednost `Signature-Agent` jednaka `"https://api.dvina.ai"`.

## Obratite nam se

Imate pitanja o pregledniku Dvina na svojoj web-stranici ili o zahtjevu koji se nije ponašao kako je opisano na ovoj stranici? Pošaljite e-poruku na [support@dvina.ai](mailto:support@dvina.ai) s adresom svoje web-stranice te, ako su vam dostupni, vremenom i vrijednošću `keyid` za te zahtjeve.

## Povezano

- [Upotreba računala](/docs/use-dvina/features/computer-use)
- [Privatnost i podaci](/docs/help/privacy-and-data)