# Browser agent ng Dvina

> Paano matutukoy, mabeberipika, mapapayagan o maha-block ng mga may-ari ng website ang browser na ginagamit ng Dvina para sa mga taong pinaglilingkuran nito.

Bumibisita ang browser ng Dvina sa mga website para sa isang tao sa bawat pagkakataon, kapag may hiniling ang taong iyon sa Dvina na nangangailangan ng aktuwal na browser. Para sa mga may-ari ng website ang pahinang ito: kung ano ang ginagawa ng browser, paano matutukoy ang mga request nito at paano ito papayagan o iba-block.

## Ano ito

Ang Dvina ay isang personal na assistant. Kapag ang isang taong naka-sign in sa Dvina ay humiling ng gawaing nangangailangan ng website, gaya ng paghahambing ng mga alok o pagsagot sa isang form na hiniling niya, magagawa ito ng Dvina sa sarili nitong browser, sa Dvina computer ng taong iyon. Isa itong desktop Chromium na may window, hindi isang headless browser, at maaaring panoorin ng tao ang ginagawa nito nang live at kunin ang kontrol anumang oras.

- **Kumikilos ito para sa isang tao.** Ang bawat browser ay pag-aari ng isang naka-sign in na user ng Dvina at gumagawa ng mga bagay na hiniling ng taong iyon.
- **Hindi ito crawler.** Wala itong listahan ng mga site na kusa nitong binibisita. Binubuksan nito ang mga pahinang kailangan para sa isang gawain, paisa-isang hakbang: nilo-load nito ang isang pahina, binabasa ito, at saka kumikilos dito, tulad ng ginagawa ng isang tao.
- **Hindi kailanman ginagamit para magsanay ng mga modelo.** Ang anumang binabasa ng browser ng Dvina sa iyong site ay ginagamit lang para sa kahilingan ng taong pinaglilingkuran nito. Hindi ito kailanman ginagamit para magsanay ng isang AI model.
- **Ipinauubaya nito sa tao ang mga sarili niyang desisyon.** Hindi ito nagta-type ng mga password o detalye ng card. Kapag kailangan ng pahina na mag-sign in o magbayad ang tao, humihinto ang Dvina at hinihiling na siya ang kumuha ng kontrol. Ang paggamit ng mga personal na detalye, pagpapadala, pagbabayad at pagbubura ay naghihintay ng pahintulot ng tao.
- **Hindi nito nilulutas ang mga pagsusuri kung tao ang gumagamit.** Kapag nakatagpo ito ng pagsusuri kung tao ang nagba-browse, gaya ng pagsusuri ng Cloudflare, Turnstile, reCAPTCHA o hCaptcha, hindi nito ito kini-click, nilulutas o nire-reload. Kapag kusang natatapos ang pagsusuri, hinihintay ito ng Dvina. Kapag nananatili ito, humihinto ang gawain, at kinukuha ng tao ang kontrol sa browser, ipinapasa ang pagsusuri at ibinabalik ang kontrol.

## Tukuyin ang mga request nito

Nilalagdaan ng browser ng Dvina ang bawat http at https request na ipinapadala nito gamit ang [Web Bot Auth](https://datatracker.ietf.org/wg/webbotauth/about/), mga HTTP message signature ([RFC 9421](https://www.rfc-editor.org/rfc/rfc9421)) na gumagamit ng Ed25519 key. May tatlong header ang bawat request:

```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>:
```

- Tinutukoy ng `Signature-Agent` ang Dvina, ang origin kung saan inilalathala ang mga key nito.
- Saklaw ng `Signature-Input` ang `@authority` ng request (ang iyong host) at ang `Signature-Agent` header. Ang `tag` ay `web-bot-auth`.
- May bisa ang bawat signature sa loob ng 60 segundo, mula `created` hanggang `expires`.
- Ang `keyid` ay ang JWK thumbprint ng key ([RFC 7638](https://www.rfc-editor.org/rfc/rfc7638)).

Ipinapadala ng browser ang sariling user agent ng Chromium, katulad ng anumang Chromium sa Linux, halimbawa:

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

Nagbabago ang bersyon ng Chrome nito kasabay ng mga update ng Chromium, at walang binabanggit ang user agent tungkol sa Dvina. Tukuyin ang Dvina gamit ang signature nito, hindi ang user agent nito.

> [!NOTE]
> Sa desktop app, maaari ring payagan ng isang tao ang Dvina na gumamit ng browser sa sarili niyang computer. Hindi nilalagdaan ng browser na iyon ang mga request nito at mukhang sariling pagba-browse ng tao.

## Beripikahin ang isang signature

Inilalathala ng Dvina ang public key nito sa key directory nito:

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

Tumutugon ang directory gamit ang `Content-Type: application/http-message-signatures-directory+json` at isang JSON Web Key Set na naglalaman ng Ed25519 public key ng Dvina. Nilalagdaan ang tugon gamit ang parehong key, na may `tag="http-message-signatures-directory"`.

Kung nasa Cloudflare ang iyong site, Cloudflare na ang nagbeberipika ng mga agent na may signature para sa iyo. Para ikaw mismo ang magberipika ng isang request:

1. Tiyaking ang `Signature-Agent` ay `"https://api.dvina.ai"` at may `tag="web-bot-auth"` ang `Signature-Input`.
2. Tiyaking ang kasalukuyang oras ay nasa pagitan ng `created` at `expires`.
3. Kunin ang key directory at piliin ang key na may JWK thumbprint na tumutugma sa `keyid`.
4. Buuin ang signature base mula sa `@authority`, `signature-agent` at mga signature parameter, ayon sa inilalarawan ng RFC 9421, at beripikahin ang `Signature` gamit ang Ed25519 key na iyon.

Kahit sino ay maaaring magpadala ng mga header na ito. Ituring lang na mula sa Dvina ang isang request kapag napatunayang wasto ang signature nito gamit ang key directory ng Dvina.

## Payagan o i-block ito

Kumikilos ang browser ng Dvina nang real time para sa isang tao: ito ang uri ng trapikong saklaw ng preset na **Agent** ng Cloudflare. Kung nasa Cloudflare ang site mo:

- **Mga patakaran para sa AI bot:** Sa **Security Settings**, piliin ang **Configure AI bot policies**. Para sa **Agent**, piliin ang **Allow (do not block)**, **Block on pages with ads** o **Block (on all pages)**.
- **Mga custom na panuntunan sa WAF:** Ang mga request mula sa mga beripikadong bot at agent na may lagda ay may `cf.client.bot` (`cf.bot_management.verified_bot` kung gumagamit ng Bot Management) na nakatakda sa true. Gamitin ito sa isang custom na panuntunan para laktawan, hamunin o i-block ang mga ito.
- **Direktoryo ng mga beripikadong bot:** Tingnan ang mga agent na bineberipika ng Cloudflare sa [Cloudflare Radar](https://radar.cloudflare.com/verified-bots).

Kung hindi sa Cloudflare, beripikahin ang lagda gaya ng inilarawan sa itaas, pagkatapos ay payagan o i-block ang mga request na ang beripikadong `Signature-Agent` ay `"https://api.dvina.ai"`.

## Makipag-ugnayan sa amin

May tanong ka ba tungkol sa browser ng Dvina sa site mo, o may request na hindi gumana ayon sa inilalarawan ng pahinang ito? Mag-email sa [support@dvina.ai](mailto:support@dvina.ai) at isama ang address ng site mo at, kung mayroon ka, ang oras at `keyid` ng mga request.

## Mga kaugnay na paksa

- [Paggamit ng computer](/docs/use-dvina/features/computer-use)
- [Privacy at data](/docs/help/privacy-and-data)