Ejen pelayar Cloudsurf

Cloudsurf ialah ejen pelayar yang dikendalikan oleh Shopify. Ejen ini menjalankan pelayar web di awan supaya ejen AI Shopify dan alat boleh melawat laman web dan berinteraksi dengan laman tersebut seperti yang dilakukan oleh manusia. Jenis pelayaran ini dikenali sebagai pelayaran ejen.

Cloudsurf melawat halaman hanya apabila diarahkan oleh alat Shopify. Ejen ini tidak merangkak atau mengindeks web secara sendirinya. Anda mungkin menyedari trafik Cloudsurf pada kedai dalam talian anda atau pada mana-mana laman web awam apabila alat Shopify membuat semak imbas untuk pedagang atau pelanggan.

Permintaan Cloudsurf boleh membawa tandatangan Web Bot Auth dan ejen pengguna Shopify, iaitu teks dalam permintaan yang mengenal pasti perisian yang menghantarnya. Anda boleh menggunakan butiran ini untuk mengecam trafik Cloudsurf dalam log anda dan dalam alat pengurusan bot.

Kes penggunaan Cloudsurf

Alat Shopify menggunakan Cloudsurf untuk menyemak imbas laman web bagi tujuan yang berikut:

  • Ejen AI: Sidekick dan ejen AI Shopify yang lain menyemak imbas laman web untuk melengkapkan tugas yang diminta oleh pedagang atau pelanggan.
  • Ujian dan semakan kualiti: Alat Shopify memuatkan laman web untuk menguji laman tersebut, merakam tangkapan skrin dan menyemak sebarang masalah paparan.

Trafik Cloudsurf pada kedai dalam talian

Lawatan Cloudsurf ke kedai dalam talian anda mungkin datang daripada alat Shopify yang anda gunakan, daripada ejen AI Shopify yang membuat semak imbas untuk pelanggan atau daripada pengujian dalaman dan penyelidikan yang dijalankan dengan alat Shopify. Ketahui lebih lanjut tentang Mengenal pasti aktiviti bot pada kedai dalam talian anda.

Tandatangan Web Bot Auth

Alat Shopify yang menggunakan Cloudsurf boleh menandatangani permintaannya dengan Web Bot Auth, yang menggunakan tandatangan mesej HTTP. Tandatangan yang sah membuktikan bahawa Shopify membenarkan permintaan. Sesiapa sahaja boleh menyalin ejen pengguna, jadi tandatangan merupakan cara yang paling boleh diharap untuk mengenal pasti trafik Cloudsurf.

Bukan setiap permintaan Cloudsurf ditandatangani, kerana penandatanganan dihidupkan secara berasingan untuk setiap alat Shopify. Jika permintaan mengaku berasal daripada Cloudsurf tetapi tiada tandatangan yang sah, maka anda tidak dapat mengesahkan bahawa permintaan itu datang daripada Shopify.

Permintaan Cloudsurf yang ditandatangani menggunakan nilai Signature-Agent "https://cloudsurf.shopify.io". Cloudsurf menandatangani setiap permintaan bagi alat Shopify yang menggunakannya dan setiap tandatangan tamat tempoh dalam masa 60 saat selepas dicipta. Cloudsurf menerbitkan kunci awamnya dalam direktori kunci di https://cloudsurf.shopify.io/.well-known/http-message-signatures-directory.

Permintaan yang ditandatangani menyertakan pengepala HTTP yang berikut:

Pengepala Web Bot Auth yang disertakan pada permintaan Cloudsurf yang ditandatangani, dengan nilai atau format setiap pengepala
PengepalaNilai
Signature-Agent"https://cloudsurf.shopify.io"
Signature-InputParameter tandatangan, termasuk ID kunci, algoritma ed25519, masa penciptaan dan tamat tempoh, serta tag web-bot-auth.
TandatanganTandatangan Ed25519 bagi permintaan tersebut.

Contoh yang berikut menggambarkan format pengepala yang ditambahkan oleh Cloudsurf:

Signature-Agent: "https://cloudsurf.shopify.io"
Signature-Input: sig1=("@authority" "signature-agent");created=<timestamp>;keyid="<key ID>";alg="ed25519";expires=<timestamp>;nonce="<nonce>";tag="web-bot-auth"
Signature: sig1=:<signature>:

Parameter keyid dalam setiap tandatangan ialah cap ibu jari JSON Web Key (JWK) bagi kunci yang menandatanganinya.

Perkhidmatan pengurusan bot yang menyokong Web Bot Auth boleh mengesahkan sesuatu permintaan. Perkhidmatan tersebut mendapatkan semula kunci daripada direktori kunci dan mencari kunci yang sepadan dengan parameter keyid. Kemudian, perkhidmatan menyemak tandatangan dan masa tamat tempohnya. Jika anda menggunakan perkhidmatan pengurusan bot, sila rujuk dokumentasinya untuk mengetahui cara membenarkan bot yang disahkan.

Ejen pengguna Cloudsurf

Secara lalai, Cloudsurf menambahkan teks Shopify/Cloudsurf (bot; +https://www.shopify.com) pada hujung ejen pengguna standard pelayar. Sesetengah alat Shopify menggantikan keseluruhan ejen pengguna dengan ejen penggunanya sendiri.

Semak jadual yang berikut untuk mengetahui tentang contoh ejen pengguna dalam trafik Cloudsurf:

Ejen pengguna yang boleh dibawa oleh trafik Cloudsurf, disenaraikan berdasarkan alat Shopify atau mod yang menghantar setiap satunya
SumberEjen penggunaButiran
Cloudsurf<ejen pengguna pelayar> Shopify/Cloudsurf (bot; +https://www.shopify.com)Ejen pengguna lalai. Permulaan rentetan ialah ejen pengguna standard pelayar tempat sesi dijalankan, jadi rentetan ini berubah mengikut pelayar dan versinya.
Emulasi peranti mudah alihEjen pengguna iPhone atau Android standardAlat yang menguji cara halaman dipaparkan pada telefon menghantar ejen pengguna telefon tersebut, tanpa teks Cloudsurf. Jika salah satu daripada permintaan ini ditandatangani, maka anda boleh mengesahkannya dengan Web Bot Auth.

Ejen pengguna boleh berubah apabila alat Shopify dikemas kini. Untuk mengenal pasti trafik Cloudsurf dengan andal, sahkan tandatangan Web Bot Auth trafik tersebut dan bukan sekadar memadankannya pada ejen pengguna sahaja.