Özellikler

Dvina'nın tarayıcı ajanı

Web sitesi sahipleri, Dvina'nın kullanıcıları adına kullandığı tarayıcıyı nasıl tanıyabilir, doğrulayabilir, tarayıcıya nasıl izin verebilir veya tarayıcıyı nasıl engelleyebilir?

Markdown olarak gör

Dvina'nın tarayıcısı, bir kullanıcı Dvina'dan gerçek bir tarayıcı gerektiren bir şey istediğinde web sitelerini ziyaret eder ve her seferinde yalnızca o kullanıcı için çalışır. Bu sayfa web sitesi sahipleri içindir: tarayıcının ne yaptığını, isteklerini nasıl tanıyacağınızı ve tarayıcıya nasıl izin vereceğinizi veya tarayıcıyı nasıl engelleyeceğinizi açıklar.

Nedir?

Dvina kişisel bir asistandır. Dvina'da oturum açmış bir kullanıcı, teklifleri karşılaştırmak veya istediği bir formu doldurmak gibi bir web sitesi gerektiren bir iş istediğinde, Dvina bu işi kullanıcının Dvina bilgisayarında, kendine ait bir tarayıcıda yapabilir. Bu, arayüzsüz bir tarayıcı değil, penceresi olan bir masaüstü Chromium tarayıcısıdır. Kullanıcı tarayıcıyı canlı olarak izleyebilir ve istediği zaman kontrolü devralabilir.

  • Tek bir kişi adına çalışır. Her tarayıcı, Dvina'da oturum açmış tek bir kullanıcıya aittir ve o kullanıcının istediği iş üzerinde çalışır.
  • Bir web tarayıcısı (crawler) değildir. Kendi başına ziyaret ettiği sitelerden oluşan bir listesi yoktur. Görevin gerektirdiği sayfaları adım adım açar: bir insanın yaptığı gibi sayfayı yükler, okur, ardından sayfada işlem yapar.
  • Model eğitmek için asla kullanılmaz. Dvina'nın tarayıcısının sitenizde okuduğu içerik yalnızca adına çalıştığı kişinin isteği için kullanılır. Asla bir yapay zekâ modelini eğitmek için kullanılmaz.
  • Kişinin kendi kararlarını ona bırakır. Parola veya kart bilgileri girmez. Bir sayfa kişinin oturum açmasını ya da ödeme yapmasını gerektirdiğinde Dvina durur ve kontrolü devralmasını ister. Kişisel bilgiler, gönderme, ödeme ve silme işlemleri kişinin onayını bekler.
  • İnsan doğrulamasını çözmez. Cloudflare'ın kontrolü, Turnstile, reCAPTCHA veya hCaptcha gibi, tarayıcıyı bir insanın kullandığını doğrulayan bir kontrolle karşılaştığında buna tıklamaz, bunu çözmez veya yeniden yüklemez. Kontrol kendiliğinden tamamlanıyorsa Dvina bekler. Kontrol devam ederse iş durur; kişi tarayıcının kontrolünü devralır, kontrolü geçer ve tarayıcıyı Dvina'ya geri verir.

İsteklerini tanıyın

Dvina'nın tarayıcısı, gönderdiği her http ve https isteğini Web Bot Auth ile, bir Ed25519 anahtarı kullanarak HTTP mesaj imzalarıyla (RFC 9421) imzalar. Her istek üç başlık taşır:

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'yı ve anahtarlarının yayımlandığı kaynağı belirtir.
  • Signature-Input, isteğin @authority değerini (sitenizin ana makinesini) ve Signature-Agent başlığını kapsar. tag değeri web-bot-auth olur.
  • Her imza, created ile expires arasında 60 saniye boyunca geçerlidir.
  • keyid, anahtarın JWK parmak izidir (RFC 7638).

Tarayıcı, Linux üzerindeki herhangi bir Chromium ile aynı olan Chromium'un kendi kullanıcı aracısı bilgisini gönderir. Örneğin:

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

Chrome sürümü Chromium güncellemeleriyle değişir ve kullanıcı aracısı bilgisi Dvina hakkında hiçbir şey belirtmez. Dvina'yı kullanıcı aracısı bilgisinden değil, imzasından tanıyın.

Not

Masaüstü uygulamasıyla kullanıcı, Dvina'nın kendi bilgisayarındaki bir tarayıcıyı kullanmasına da izin verebilir. Bu tarayıcı isteklerini imzalamaz ve kullanıcının kendi gezinmesi gibi görünür.

Bir imzayı doğrulayın

Dvina, açık anahtarını anahtar dizininde yayımlar:

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

Dizin, Content-Type: application/http-message-signatures-directory+json ve Dvina'nın Ed25519 açık anahtarını içeren bir JSON Web Key Set ile yanıt verir. Yanıt, tag="http-message-signatures-directory" ile aynı anahtar kullanılarak imzalanır.

Siteniz Cloudflare üzerindeyse Cloudflare imzalı ajanları sizin için doğrular. Bir isteği kendiniz doğrulamak için:

  1. Signature-Agent değerinin "https://api.dvina.ai" olduğunu ve Signature-Input içinde tag="web-bot-auth" bulunduğunu kontrol edin.
  2. Şu anki zamanın created ile expires arasında olduğunu kontrol edin.
  3. Anahtar dizinini alın ve JWK parmak izi keyid ile eşleşen anahtarı seçin.
  4. RFC 9421'de açıklandığı gibi @authority, signature-agent ve imza parametrelerinden imza tabanını oluşturun ve Signature değerini bu Ed25519 anahtarıyla doğrulayın.

Bu başlıkları herkes gönderebilir. Bir isteği yalnızca imzası Dvina'nın anahtar dizini kullanılarak doğrulandığında Dvina'ya ait kabul edin.

İzin verin veya engelleyin

Dvina'nın tarayıcısı, tek bir kişi adına gerçek zamanlı olarak işlem yapar. Bu trafik türü, Cloudflare'ın Agent ön ayarı kapsamındadır. Siteniz Cloudflare kullanıyorsa:

  • Yapay zekâ bot politikaları: Güvenlik Ayarları bölümünde Yapay zekâ bot politikalarını yapılandır seçeneğini seçin. Agent için İzin ver (engelleme), Reklam içeren sayfalarda engelle veya Engelle (tüm sayfalarda) seçeneğini seçin.
  • WAF özel kuralları: Doğrulanmış botlardan ve imzalı ajanlardan gelen isteklerde cf.client.bot (Bot Management kullanıldığında cf.bot_management.verified_bot) değeri true olarak ayarlanır. Bu istekleri atlamak, doğrulama sorgulamasına tabi tutmak veya engellemek için bu alanı özel bir kuralda kullanın.
  • Doğrulanmış botlar dizini: Cloudflare'ın doğruladığı ajanları Cloudflare Radar üzerinden inceleyin.

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

Bize ulaşın

Dvina'nın tarayıcısının sitenizdeki işleyişiyle ilgili sorularınız mı var? Ya da bu sayfada açıklanandan farklı davranan bir istekle mi karşılaştınız? Sitenizin adresini ve elinizde varsa isteklerin zamanını ve keyid değerini support@dvina.ai adresine e-postayla gönderin.