Markdown formatında bax

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 vasitəsilə, Ed25519 açarı ilə HTTP mesaj imzalarından (RFC 9421) istifadə edərək imzalayır. Hər sorğuda üç başlıq olur:

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).

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:

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.

Qeyd

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:

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-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 ünvanına göndərin.