# Agentul de browser Dvina

> Cum pot proprietarii de site-uri să recunoască, să verifice, să permită sau să blocheze browserul pe care Dvina îl folosește pentru persoanele pentru care lucrează.

Browserul Dvina vizitează site-uri pentru câte o persoană, atunci când aceasta îi cere Dvina ceva ce necesită un browser real. Această pagină se adresează proprietarilor de site-uri: ce face browserul, cum îi recunoști cererile și cum îi permiți sau îi blochezi accesul.

## Ce este

Dvina este un asistent personal. Când o persoană conectată la Dvina cere o sarcină care necesită un site web, cum ar fi compararea ofertelor sau completarea unui formular solicitat de ea, Dvina o poate îndeplini în propriul browser, pe computerul Dvina al acelei persoane. Este un browser Chromium pentru desktop, cu fereastră, nu un browser fără interfață grafică, iar persoana îl poate urmări în timp real și poate prelua controlul oricând.

- **Acționează pentru o singură persoană.** Fiecare browser aparține unui singur utilizator conectat la Dvina și lucrează la ceea ce a cerut acea persoană.
- **Nu este un crawler.** Nu are o listă de site-uri pe care le vizitează din proprie inițiativă. Deschide paginile necesare pentru o sarcină, pas cu pas: încarcă o pagină, o citește, apoi acționează pe ea, așa cum ar face o persoană.
- **Nu este folosit niciodată pentru antrenarea modelelor.** Ceea ce citește browserul Dvina pe site-ul tău este folosit doar pentru cererea persoanei pentru care lucrează. Nu este folosit niciodată pentru antrenarea unui model AI.
- **Lasă deciziile personale în seama persoanei.** Nu introduce parole sau date de card. Când o pagină necesită autentificare sau plată, Dvina se oprește și îi cere persoanei să preia controlul. Datele personale, trimiterea, plata și ștergerea necesită acordul persoanei.
- **Nu rezolvă verificările care confirmă că utilizatorul este o persoană.** Când întâlnește o verificare menită să confirme că o persoană navighează, precum verificarea Cloudflare, Turnstile, reCAPTCHA sau hCaptcha, nu face clic pe ea, nu o rezolvă și nu o reîncarcă. Dacă o verificare se încheie de la sine, Dvina așteaptă. Dacă persistă, lucrul se oprește, iar persoana preia controlul browserului, trece de verificare și îi redă controlul.

## Recunoaște cererile browserului

Browserul Dvina semnează fiecare cerere http și https pe care o trimite folosind [Web Bot Auth](https://datatracker.ietf.org/wg/webbotauth/about/), semnături pentru mesaje HTTP ([RFC 9421](https://www.rfc-editor.org/rfc/rfc9421)) cu o cheie Ed25519. Fiecare cerere include trei antete:

```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` identifică Dvina, originea unde sunt publicate cheile sale.
- `Signature-Input` acoperă `@authority` din cerere (gazda ta) și antetul `Signature-Agent`. Valoarea `tag` este `web-bot-auth`.
- Fiecare semnătură este valabilă timp de 60 de secunde, de la `created` la `expires`.
- `keyid` este amprenta JWK a cheii ([RFC 7638](https://www.rfc-editor.org/rfc/rfc7638)).

Browserul trimite propriul user agent al Chromium, același ca în orice browser Chromium pe Linux, de exemplu:

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

Versiunea sa de Chrome se schimbă odată cu actualizările Chromium, iar user agent-ul nu indică nimic despre Dvina. Recunoaște Dvina după semnătură, nu după user agent.

> [!NOTE]
> Prin aplicația pentru desktop, o persoană poate permite Dvina să folosească și un browser de pe propriul computer. Acel browser nu își semnează cererile, iar navigarea sa arată la fel ca navigarea persoanei.

## Verifică o semnătură

Dvina își publică cheia publică în directorul său de chei:

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

Directorul răspunde cu `Content-Type: application/http-message-signatures-directory+json` și un JSON Web Key Set care conține cheia publică Ed25519 a Dvina. Răspunsul este semnat cu aceeași cheie, cu `tag="http-message-signatures-directory"`.

Dacă site-ul tău este pe Cloudflare, Cloudflare verifică pentru tine agenții care își semnează cererile. Pentru a verifica singur o cerere:

1. Verifică dacă `Signature-Agent` este `"https://api.dvina.ai"` și dacă `Signature-Input` conține `tag="web-bot-auth"`.
2. Verifică dacă ora curentă este între `created` și `expires`.
3. Preia directorul de chei și alege cheia a cărei amprentă JWK corespunde cu `keyid`.
4. Construiește baza semnăturii din `@authority`, `signature-agent` și parametrii semnăturii, conform descrierii din RFC 9421, și verifică `Signature` cu acea cheie Ed25519.

Oricine poate trimite aceste antete. Consideră că o cerere provine de la Dvina numai dacă semnătura ei este validată folosind directorul de chei al Dvina.

## Permite sau blochează accesul browserului

Browserul Dvina acționează în timp real pentru o singură persoană: acest tip de trafic este acoperit de presetarea **Agent** din Cloudflare. Dacă site-ul tău folosește Cloudflare:

- **Politici pentru boți AI:** În **Setări de securitate**, alege **Configurează politicile pentru boți AI**. Pentru **Agent**, alege **Permite (nu bloca)**, **Blochează pe paginile cu reclame** sau **Blochează (pe toate paginile)**.
- **Reguli WAF personalizate:** Cererile de la boți verificați și agenți cu semnătură au `cf.client.bot` (`cf.bot_management.verified_bot` dacă folosești Bot Management) setat la true. Folosește acest câmp într-o regulă personalizată pentru a le excepta de la verificări, a le supune unei verificări suplimentare sau a le bloca.
- **Directorul boților verificați:** Vezi agenții verificați de Cloudflare în [Cloudflare Radar](https://radar.cloudflare.com/verified-bots).

Pe orice altă platformă, verifică semnătura conform descrierii de mai sus, apoi permite sau blochează cererile al căror `Signature-Agent` verificat este `"https://api.dvina.ai"`.

## Contactează-ne

Ai întrebări despre browserul Dvina pe site-ul tău sau despre o cerere care nu s-a comportat așa cum este descris pe această pagină? Trimite un e-mail la [support@dvina.ai](mailto:support@dvina.ai) cu adresa site-ului tău și, dacă le ai, ora și valoarea `keyid` ale cererilor.

## Articole conexe

- [Utilizarea computerului](/docs/use-dvina/features/computer-use)
- [Confidențialitate și date](/docs/help/privacy-and-data)