# Wakala wa kivinjari wa Dvina

> Jinsi wamiliki wa tovuti wanavyoweza kutambua, kuthibitisha, kuruhusu au kuzuia kivinjari ambacho Dvina hutumia kwa niaba ya watu inaowafanyia kazi.

Kivinjari cha Dvina hutembelea tovuti kwa niaba ya mtu mmoja kwa wakati, mtu huyo anapoiomba Dvina kufanya jambo linalohitaji kivinjari halisi. Ukurasa huu ni kwa wamiliki wa tovuti: unaeleza kivinjari hufanya nini, jinsi ya kutambua maombi yake na jinsi ya kukiruhusu au kukizuia.

## Ni nini

Dvina ni msaidizi binafsi. Mtu aliyeingia kwenye Dvina anapoiomba kufanya kazi inayohitaji tovuti, kama kulinganisha ofa au kujaza fomu aliyoomba ijazwe, Dvina inaweza kuifanya katika kivinjari chake chenyewe, kwenye kompyuta ya Dvina ya mtu huyo. Ni Chromium ya eneo-kazi yenye dirisha, si kivinjari kisicho na kiolesura, na mtu huyo anaweza kufuatilia kinachoendelea moja kwa moja na kuchukua udhibiti wakati wowote.

- **Hufanya kazi kwa niaba ya mtu mmoja.** Kila kivinjari ni cha mtumiaji mmoja aliyeingia kwenye Dvina na hufanya kazi aliyoomba mtu huyo.
- **Si kitambazi cha wavuti.** Hakina orodha ya tovuti za kutembelea chenyewe. Hufungua kurasa zinazohitajika kwa kazi, hatua moja baada ya nyingine: hupakia ukurasa, kuusoma, kisha kuchukua hatua ndani yake, kama mtu anavyofanya.
- **Hakitumiki kamwe kufunza modeli.** Kile ambacho kivinjari cha Dvina husoma kwenye tovuti yako hutumika tu kutimiza ombi la mtu kinayemfanyia kazi. Hakitumiki kamwe kufunza modeli ya AI.
- **Humwachia mtu maamuzi yake mwenyewe.** Hakiandiki nywila au taarifa za kadi. Ukurasa unapohitaji mtu aingie kwenye akaunti au alipe, Dvina husimama na kumwomba achukue udhibiti. Taarifa binafsi, kutuma, kulipa na kufuta husubiri idhini ya mtu huyo.
- **Hakitatui ukaguzi wa kuthibitisha kuwa mtumiaji ni binadamu.** Kinapokutana na ukaguzi wa kuthibitisha kuwa anayevinjari ni mtu, kama ukaguzi wa Cloudflare, Turnstile, reCAPTCHA au hCaptcha, hakiubofyi, hakiutatui wala hakiupakii upya. Ukaguzi unapokamilika wenyewe, Dvina huusubiri. Ukaguzi unapobaki, kazi husimama, na mtu huchukua udhibiti wa kivinjari, kupita ukaguzi na kukirudishia Dvina.

## Tambua maombi yake

Kivinjari cha Dvina huweka saini kwenye kila ombi la http na https linalotuma kwa kutumia [Web Bot Auth](https://datatracker.ietf.org/wg/webbotauth/about/), saini za ujumbe wa HTTP ([RFC 9421](https://www.rfc-editor.org/rfc/rfc9421)) zenye ufunguo wa Ed25519. Kila ombi lina vichwa vitatu:

```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` hutaja Dvina, anwani ya asili ambako funguo zake huchapishwa.
- `Signature-Input` inajumuisha `@authority` ya ombi (mwenyeji wako) na kichwa cha `Signature-Agent`. `tag` ni `web-bot-auth`.
- Kila saini ni halali kwa sekunde 60, kuanzia `created` hadi `expires`.
- `keyid` ni alama ya utambulisho ya JWK ya ufunguo ([RFC 7638](https://www.rfc-editor.org/rfc/rfc7638)).

Kivinjari hutuma user agent ya Chromium yenyewe, sawa na Chromium yoyote kwenye Linux, kwa mfano:

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

Toleo lake la Chrome hubadilika kadiri Chromium inavyosasishwa, na user agent haitaji chochote kuhusu Dvina. Tambua Dvina kwa saini yake, si kwa user agent yake.

> [!NOTE]
> Kwa kutumia programu ya eneo-kazi, mtu anaweza pia kuiruhusu Dvina kutumia kivinjari kwenye kompyuta yake mwenyewe. Kivinjari hicho hakiweki saini kwenye maombi yake na huonekana kama mtu huyo anavinjari mwenyewe.

## Thibitisha saini

Dvina huchapisha ufunguo wake wa umma katika saraka yake ya funguo:

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

Saraka hujibu kwa `Content-Type: application/http-message-signatures-directory+json` na JSON Web Key Set yenye ufunguo wa umma wa Ed25519 wa Dvina. Jibu huwekewa saini kwa ufunguo huohuo, likiwa na `tag="http-message-signatures-directory"`.

Ikiwa tovuti yako iko kwenye Cloudflare, Cloudflare hukuthibitishia mawakala wenye saini. Ili kuthibitisha ombi mwenyewe:

1. Hakikisha kuwa `Signature-Agent` ni `"https://api.dvina.ai"` na kwamba `Signature-Input` ina `tag="web-bot-auth"`.
2. Hakikisha kuwa muda wa sasa uko kati ya `created` na `expires`.
3. Pata saraka ya funguo na uchague ufunguo ambao alama yake ya utambulisho ya JWK inalingana na `keyid`.
4. Unda msingi wa saini kwa kutumia `@authority`, `signature-agent` na vigezo vya saini, kama RFC 9421 inavyoeleza, kisha uthibitishe `Signature` kwa ufunguo huo wa Ed25519.

Mtu yeyote anaweza kutuma vichwa hivi. Chukulia ombi kuwa la Dvina tu ikiwa saini yake imethibitishwa kwa kutumia saraka ya funguo ya Dvina.

## Kiruhusu au kizuie

Kivinjari cha Dvina hufanya kazi papo hapo kwa ajili ya mtu mmoja: hii ndiyo aina ya trafiki inayoshughulikiwa na mpangilio wa **Agent** wa Cloudflare. Ikiwa tovuti yako inatumia Cloudflare:

- **Sera za boti za AI:** Katika **Mipangilio ya Usalama**, chagua **Sanidi sera za boti za AI**. Kwa **Agent**, chagua **Ruhusu (usizuie)**, **Zuia kwenye kurasa zenye matangazo** au **Zuia (kwenye kurasa zote)**.
- **Sheria maalumu za WAF:** Maombi kutoka kwa boti zilizothibitishwa na mawakala wenye saini huwa na `cf.client.bot` (`cf.bot_management.verified_bot` ikiwa unatumia Bot Management) iliyowekwa kuwa true. Itumie katika sheria maalumu ili kuyaondolea ukaguzi, kuyataka yapitie uthibitishaji au kuyazuia.
- **Orodha ya boti zilizothibitishwa:** Angalia mawakala ambao Cloudflare huthibitisha kwenye [Cloudflare Radar](https://radar.cloudflare.com/verified-bots).

Kwingineko, thibitisha saini kama ilivyoelezwa hapo juu, kisha ruhusu au zuia maombi ambayo `Signature-Agent` yake iliyothibitishwa ni `"https://api.dvina.ai"`.

## Wasiliana nasi

Una maswali kuhusu kivinjari cha Dvina kwenye tovuti yako, au kuna ombi ambalo halikufanya kazi kama ilivyoelezwa kwenye ukurasa huu? Tuma barua pepe kwa [support@dvina.ai](mailto:support@dvina.ai) ukiambatanisha anwani ya tovuti yako na, ikiwa unazo, muda na `keyid` ya maombi hayo.

## Yanayohusiana

- [Matumizi ya kompyuta](/docs/use-dvina/features/computer-use)
- [Faragha na data](/docs/help/privacy-and-data)