# Dvina brauzer agenti

> Sayt sahibləri Dvina xidmətindən istifadə edən şəxslər üçün işləyən brauzeri necə tanıya, yoxlaya, ona icazə verə və ya onu bloklaya bilərlər.

Dvina brauzeri hər dəfə bir şəxs üçün saytlara daxil olur — həmin şəxs Dvina xidmətindən real brauzer tələb edən bir iş istədikdə. Bu səhifə sayt sahibləri üçündür: brauzerin nə etdiyini, sorğularını necə tanımağı və ona necə icazə verməyi və ya onu bloklamağı izah edir.

## Bu nədir

Dvina şəxsi köməkçidir. Dvina hesabına daxil olmuş bir şəxs təklifləri müqayisə etmək və ya istədiyi formanı doldurmaq kimi sayt tələb edən bir iş tapşırdıqda, Dvina bunu həmin şəxsin Dvina kompüterində, öz brauzerində edə bilər. Bu, qrafik interfeysi olmayan brauzer deyil, pəncərəsi olan masaüstü Chromium brauzeridir. Şəxs onun işini canlı izləyə və istənilən vaxt idarəni öz üzərinə götürə bilər.

- **Bir şəxs üçün işləyir.** Hər brauzer Dvina hesabına daxil olmuş bir istifadəçiyə məxsusdur və həmin şəxsin istədiyi işi görür.
- **Saytları avtomatik tarayan bot deyil.** Özbaşına daxil olduğu saytların siyahısı yoxdur. Tapşırıq üçün lazım olan səhifələri addım-addım açır: səhifəni yükləyir, oxuyur, sonra insan kimi orada əməliyyat aparır.
- **Modelləri öyrətmək üçün heç vaxt istifadə edilmir.** Dvina brauzerinin saytınızda oxuduqları yalnız xidmət etdiyi şəxsin sorğusu üçün istifadə olunur. Bunlar heç vaxt süni intellekt modelini öyrətmək üçün istifadə edilmir.
- **Şəxsin öz qərarlarını onun ixtiyarına buraxır.** Parolları və ya kart məlumatlarını daxil etmir. Səhifə şəxsdən hesabına daxil olmağı və ya ödəniş etməyi tələb etdikdə, Dvina dayanır və ondan idarəni öz üzərinə götürməsini istəyir. Şəxsi məlumatlarla bağlı əməliyyatlar, göndərmə, ödəniş və silmə şəxsin təsdiqini gözləyir.
- **İnsan yoxlamalarını həll etmir.** Brauzerdən insanın istifadə etdiyini yoxlayan Cloudflare yoxlaması, Turnstile, reCAPTCHA və ya hCaptcha kimi bir yoxlama ilə qarşılaşdıqda, ona klikləmir, onu həll etmir və ya yenidən yükləmir. Yoxlama öz-özünə tamamlanırsa, Dvina bunu gözləyir. Yoxlama qalırsa, iş dayanır və şəxs brauzerin idarəsini öz üzərinə götürür, yoxlamadan keçir və idarəni geri verir.

## Sorğularını tanıyın

Dvina brauzeri göndərdiyi hər http və https sorğusunu [Web Bot Auth](https://datatracker.ietf.org/wg/webbotauth/about/) vasitəsilə, Ed25519 açarı ilə HTTP mesaj imzalarından ([RFC 9421](https://www.rfc-editor.org/rfc/rfc9421)) istifadə edərək imzalayır. Hər sorğuda üç başlıq olur:

```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` Dvina xidmətini, yəni açarlarının dərc olunduğu mənbə ünvanını göstərir.
- `Signature-Input` sorğunun `@authority` dəyərini (sizin hostunuzu) və `Signature-Agent` başlığını əhatə edir. `tag` dəyəri `web-bot-auth` olur.
- Hər imza `created` vaxtından `expires` vaxtına qədər 60 saniyə etibarlıdır.
- `keyid` açarın JWK barmaq izidir ([RFC 7638](https://www.rfc-editor.org/rfc/rfc7638)).

Brauzer Linux üzərində işləyən istənilən Chromium ilə eyni olan, Chromium-un öz user agent sətrini göndərir, məsələn:

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

Onun Chrome versiyası Chromium yeniləmələri ilə birlikdə dəyişir və user agent sətrində Dvina haqqında heç nə göstərilmir. Dvina brauzerini user agent sətrinə görə deyil, imzasına görə tanıyın.

> [!NOTE]
> Masaüstü tətbiq vasitəsilə şəxs Dvina xidmətinə öz kompüterindəki brauzerdən istifadə etməyə də icazə verə bilər. Həmin brauzer sorğularını imzalamır və şəxsin adi brauzer istifadəsi kimi görünür.

## İmzanı yoxlayın

Dvina açıq açarını öz açar kataloqunda dərc edir:

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

Kataloq `Content-Type: application/http-message-signatures-directory+json` və Dvina xidmətinin Ed25519 açıq açarını ehtiva edən JSON Web Key Set ilə cavab verir. Cavab eyni açarla, `tag="http-message-signatures-directory"` ilə imzalanır.

Saytınız Cloudflare üzərindədirsə, Cloudflare imzalanmış agentləri sizin üçün yoxlayır. Sorğunu özünüz yoxlamaq üçün:

1. `Signature-Agent` dəyərinin `"https://api.dvina.ai"` olduğunu və `Signature-Input` daxilində `tag="web-bot-auth"` olduğunu yoxlayın.
2. Cari vaxtın `created` və `expires` arasında olduğunu yoxlayın.
3. Açar kataloqunu əldə edin və JWK barmaq izi `keyid` ilə uyğun gələn açarı seçin.
4. RFC 9421-də təsvir olunduğu kimi, `@authority`, `signature-agent` və imza parametrlərindən imza bazasını qurun və həmin Ed25519 açarı ilə `Signature` imzasını yoxlayın.

Bu başlıqları hər kəs göndərə bilər. Sorğunu yalnız imzası Dvina açar kataloquna əsasən təsdiqləndikdə Dvina sorğusu kimi qəbul edin.

## İcazə verin və ya bloklayın

Dvina-nın brauzeri bir nəfər üçün real vaxtda fəaliyyət göstərir: bu, Cloudflare-in **Agent** hazır ayarının əhatə etdiyi trafik növüdür. Saytınız Cloudflare-dədirsə:

- **Süni intellekt botları üçün siyasətlər:** **Təhlükəsizlik ayarları** bölməsində **Süni intellekt botları üçün siyasətləri konfiqurasiya et** seçimini seçin. **Agent** üçün **İcazə ver (bloklama)**, **Reklam olan səhifələrdə blokla** və ya **Blokla (bütün səhifələrdə)** seçimini seçin.
- **WAF fərdi qaydaları:** Təsdiqlənmiş botlardan və imzalanmış agentlərdən gələn sorğularda `cf.client.bot` (Bot Management ilə `cf.bot_management.verified_bot`) true olaraq təyin edilir. Fərdi qaydada bundan istifadə edərək həmin sorğuları yoxlamadan keçirə, əlavə yoxlamaya yönləndirə və ya bloklaya bilərsiniz.
- **Təsdiqlənmiş botlar kataloqu:** Cloudflare-in təsdiqlədiyi agentlərə [Cloudflare Radar](https://radar.cloudflare.com/verified-bots)-da baxın.

Anywhere else, verify the signature as described above, then allow or block requests whose verified `Signature-Agent` is `"https://api.dvina.ai"`.

## Bizimlə əlaqə saxlayın

Dvina-nın brauzerinin saytınızda işləməsi ilə bağlı sualınız var, yaxud sorğu bu səhifədə təsvir olunduğu kimi işləməyib? Saytınızın ünvanını və əlinizdə varsa, sorğuların vaxtını və `keyid` dəyərini [support@dvina.ai](mailto:support@dvina.ai) ünvanına göndərin.

## Əlaqəli mövzular

- [Kompüterdən istifadə](/docs/use-dvina/features/computer-use)
- [Məxfilik və məlumatlar](/docs/help/privacy-and-data)