# Agen browser Dvina

> Cara pemilik situs web mengenali, memverifikasi, mengizinkan, atau memblokir browser yang digunakan Dvina untuk orang yang dibantunya.

Browser Dvina mengunjungi situs web untuk satu orang pada satu waktu, saat orang tersebut meminta Dvina melakukan sesuatu yang memerlukan browser sungguhan. Halaman ini ditujukan untuk pemilik situs web: apa yang dilakukan browser, cara mengenali permintaannya, serta cara mengizinkan atau memblokirnya.

## Apa itu browser Dvina

Dvina adalah asisten pribadi. Saat seseorang yang sudah masuk ke Dvina meminta tugas yang memerlukan situs web, seperti membandingkan penawaran atau mengisi formulir yang mereka minta, Dvina dapat melakukannya di browser sendiri, pada komputer Dvina milik orang tersebut. Browser ini adalah Chromium desktop dengan jendela, bukan browser headless, dan orang tersebut dapat memantau aktivitasnya secara langsung serta mengambil alih kapan saja.

- **Bertindak untuk satu orang.** Setiap browser dimiliki oleh satu pengguna yang sudah masuk ke Dvina dan mengerjakan apa yang diminta pengguna tersebut.
- **Bukan crawler.** Tidak ada daftar situs yang dikunjunginya atas inisiatif sendiri. Browser membuka halaman yang diperlukan untuk tugas, satu langkah demi satu langkah: memuat halaman, membacanya, lalu melakukan tindakan di halaman tersebut, seperti yang dilakukan seseorang.
- **Tidak pernah digunakan untuk melatih model.** Apa yang dibaca browser Dvina di situs Anda hanya digunakan untuk memenuhi permintaan orang yang dibantunya. Konten tersebut tidak pernah digunakan untuk melatih model AI.
- **Keputusan pribadi tetap di tangan orang tersebut.** Browser tidak mengetik kata sandi atau detail kartu. Saat suatu halaman mengharuskan orang tersebut masuk atau membayar, Dvina berhenti dan meminta mereka mengambil alih. Pengisian detail pribadi, pengiriman, pembayaran, dan penghapusan menunggu persetujuan orang tersebut.
- **Tidak menyelesaikan verifikasi manusia.** Saat menemukan pemeriksaan untuk memastikan bahwa yang menjelajah adalah manusia, seperti pemeriksaan Cloudflare, Turnstile, reCAPTCHA, atau hCaptcha, browser tidak mengekliknya, menyelesaikannya, atau memuatnya ulang. Jika pemeriksaan selesai dengan sendirinya, Dvina menunggu hingga selesai. Jika pemeriksaan tetap muncul, pekerjaan dihentikan, lalu orang tersebut mengambil alih browser, melewati pemeriksaan, dan menyerahkan kendali kembali.

## Kenali permintaannya

Browser Dvina menandatangani setiap permintaan http dan https yang dikirimnya menggunakan [Web Bot Auth](https://datatracker.ietf.org/wg/webbotauth/about/), yaitu tanda tangan pesan HTTP ([RFC 9421](https://www.rfc-editor.org/rfc/rfc9421)) dengan kunci Ed25519. Setiap permintaan menyertakan tiga header:

```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` mengidentifikasi Dvina, yaitu origin tempat kuncinya dipublikasikan.
- `Signature-Input` mencakup `@authority` permintaan (host Anda) dan header `Signature-Agent`. Nilai `tag` adalah `web-bot-auth`.
- Setiap tanda tangan berlaku selama 60 detik, dari `created` hingga `expires`.
- `keyid` adalah thumbprint JWK dari kunci tersebut ([RFC 7638](https://www.rfc-editor.org/rfc/rfc7638)).

Browser mengirim user agent bawaan Chromium, sama seperti Chromium lainnya di Linux, misalnya:

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

Versi Chrome-nya mengikuti pembaruan Chromium, dan user agent tidak menyebutkan Dvina. Kenali Dvina dari tanda tangannya, bukan user agent-nya.

> [!NOTE]
> Dengan aplikasi desktop, seseorang juga dapat mengizinkan Dvina menggunakan browser di komputer mereka sendiri. Browser tersebut tidak menandatangani permintaannya dan terlihat seperti aktivitas menjelajah orang itu sendiri.

## Verifikasi tanda tangan

Dvina memublikasikan kunci publiknya di direktori kunci:

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

Direktori tersebut memberikan respons dengan `Content-Type: application/http-message-signatures-directory+json` dan JSON Web Key Set yang berisi kunci publik Ed25519 milik Dvina. Respons ditandatangani dengan kunci yang sama, dengan `tag="http-message-signatures-directory"`.

Jika situs Anda menggunakan Cloudflare, Cloudflare memverifikasi agen bertanda tangan untuk Anda. Untuk memverifikasi permintaan sendiri:

1. Pastikan `Signature-Agent` bernilai `"https://api.dvina.ai"` dan `Signature-Input` memiliki `tag="web-bot-auth"`.
2. Pastikan waktu saat ini berada di antara `created` dan `expires`.
3. Ambil direktori kunci dan pilih kunci yang thumbprint JWK-nya cocok dengan `keyid`.
4. Susun basis tanda tangan dari `@authority`, `signature-agent`, dan parameter tanda tangan, sesuai penjelasan RFC 9421, lalu verifikasi `Signature` dengan kunci Ed25519 tersebut.

Siapa pun dapat mengirim header ini. Anggap permintaan berasal dari Dvina hanya jika tanda tangannya berhasil diverifikasi menggunakan direktori kunci Dvina.

## Izinkan atau blokir browser

Browser Dvina bekerja secara real time untuk satu orang: jenis lalu lintas yang tercakup dalam preset **Agent** Cloudflare. Jika situs Anda menggunakan Cloudflare:

- **Kebijakan bot AI:** Di **Security Settings**, pilih **Configure AI bot policies**. Untuk **Agent**, pilih **Allow (do not block)**, **Block on pages with ads**, atau **Block (on all pages)**.
- **Aturan kustom WAF:** Permintaan dari bot terverifikasi dan agen bertanda tangan memiliki `cf.client.bot` (`cf.bot_management.verified_bot` jika menggunakan Bot Management) yang diatur ke true. Gunakan nilai ini dalam aturan kustom untuk melewati pemeriksaan, memberikan tantangan, atau memblokir permintaan tersebut.
- **Direktori bot terverifikasi:** Lihat agen yang diverifikasi Cloudflare di [Cloudflare Radar](https://radar.cloudflare.com/verified-bots).

Jika situs Anda tidak menggunakan Cloudflare, verifikasi tanda tangan seperti dijelaskan di atas, lalu izinkan atau blokir permintaan yang nilai `Signature-Agent` terverifikasinya adalah `"https://api.dvina.ai"`.

## Hubungi kami

Ada pertanyaan tentang browser Dvina di situs Anda, atau permintaan yang tidak berjalan seperti yang dijelaskan di halaman ini? Kirim email ke [support@dvina.ai](mailto:support@dvina.ai) dengan menyertakan alamat situs Anda serta, jika tersedia, waktu dan `keyid` permintaan tersebut.

## Terkait

- [Penggunaan komputer](/docs/use-dvina/features/computer-use)
- [Privasi dan data](/docs/help/privacy-and-data)