Cloudsurf-selainagentti

Cloudsurf on Shopifyn ylläpitämä selainagentti. Se suorittaa verkkoselaimia pilvessä, jotta Shopifyn tekoälyagentit ja -työkalut voivat vierailla verkkosivuilla ja olla vuorovaikutuksessa niiden kanssa ihmisen tavoin. Tällaista selausta kutsutaan agenttipohjaiseksi selaukseksi.

Cloudsurf vierailee sivulla vain silloin, kun Shopify-työkalu ohjaa sen sinne. Se ei käy läpi tai indeksoi verkkoa itsenäisesti. Saatat huomata Cloudsurf-liikennettä verkkokaupassasi tai muilla julkisilla verkkosivuilla, kun Shopify-työkalu selaa niitä kauppiaan tai asiakkaan puolesta.

Cloudsurf-pyynnöt voivat sisältää Web Bot Auth -allekirjoituksen ja Shopifyn käyttäjäagentin, joka on pyynnössä oleva teksti, joka tunnistaa sen lähettäneen ohjelmiston. Voit käyttää näitä tietoja Cloudsurf-liikenteen tunnistamiseen lokeissasi ja bottien hallintatyökaluissa.

Cloudsurf-käyttötapaukset

Shopify-työkalut käyttävät Cloudsurfia verkkosivujen selaamiseen seuraaviin tarkoituksiin:

  • Tekoälyagentit: Sidekick ja muut Shopifyn tekoälyagentit selaavat verkkosivuja suorittaakseen kauppiaan tai asiakkaan pyytämiä tehtäviä.
  • Testaus ja laaduntarkistukset: Shopify-työkalut lataavat verkkosivuja testatakseen niitä, ottaakseen kuvakaappauksia ja tarkistaakseen näyttöongelmia.

Cloudsurf-liikenne verkkokaupoissa

Cloudsurf-käynnit verkkokaupassasi voivat olla peräisin käyttämistäsi Shopify-työkaluista, asiakkaiden puolesta selaavista Shopifyn tekoälyagenteista tai Shopify-työkaluilla suoritettavasta sisäisestä testauksesta ja tutkimuksesta. Lue lisää aiheesta Bottitoiminnan tunnistaminen verkkokaupassasi.

Web Bot Auth -allekirjoitukset

Cloudsurfia käyttävät Shopify-työkalut voivat allekirjoittaa pyyntönsä Web Bot Auth -tunnistuksella, joka käyttää HTTP-viestiallekirjoituksia. Kelvollinen allekirjoitus todistaa, että Shopify on valtuuttanut pyynnön. Kuka tahansa voi kopioida käyttäjäagentin, joten allekirjoitus on luotettavin tapa tunnistaa Cloudsurf-liikenne.

Kaikkia Cloudsurf-pyyntöjä ei ole allekirjoitettu, koska allekirjoitus otetaan käyttöön erikseen kullekin Shopify-työkalulle. Jos pyyntö väittää olevansa peräisin Cloudsurfilta, mutta siinä ei ole kelvollista allekirjoitusta, et voi vahvistaa sen olevan peräisin Shopifylta.

Allekirjoitetut Cloudsurf-pyynnöt käyttävät Signature-Agent-arvoa "https://cloudsurf.shopify.io". Cloudsurf allekirjoittaa jokaisen pyynnön sitä käyttävän Shopify-työkalun puolesta, ja jokainen allekirjoitus vanhenee 60 sekuntia sen luomisen jälkeen. Cloudsurf julkaisee julkiset avaimensa avainhakemistossa osoitteessa https://cloudsurf.shopify.io/.well-known/http-message-signatures-directory.

Allekirjoitetut pyynnöt sisältävät seuraavat HTTP-otsikot:

Web Bot Auth -otsikot, jotka sisältyvät allekirjoitettuihin Cloudsurf-pyyntöihin, sekä kunkin otsikon arvo tai muoto
OtsikkoArvo
Signature-Agent"https://cloudsurf.shopify.io"
Signature-InputAllekirjoitusparametrit, mukaan lukien avaimen tunnus, ed25519-algoritmi, luonti- ja vanhenemisajat sekä web-bot-auth-tunniste.
AllekirjoitusPyynnön Ed25519-allekirjoitus.

Seuraava esimerkki havainnollistaa Cloudsurfin lisäämien otsikoiden muotoa:

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>:

Jokaisen allekirjoituksen keyid-parametri on sen allekirjoittaneen avaimen JSON Web Key (JWK) -sormenjälki.

Bottien hallintapalvelu, joka tukee Web Bot Auth -tunnistusta, voi vahvistaa pyynnön. Palvelu hakee avaimet avainhakemistosta ja etsii keyid-parametria vastaavan avaimen. Sen jälkeen se tarkistaa allekirjoituksen ja sen vanhenemisajan. Jos käytät bottien hallintapalvelua, katso sen ohjeistuksesta, miten vahvistetut botit sallitaan.

Cloudsurf-käyttäjäagentit

Oletuksena Cloudsurf lisää tekstin Shopify/Cloudsurf (bot; +https://www.shopify.com) selaimen vakiokäyttäjäagentin loppuun. Jotkin Shopify-työkalut korvaavat koko käyttäjäagentin omallaan.

Seuraavassa taulukossa on esimerkkejä Cloudsurf-liikenteen käyttäjäagenteista:

Käyttäjäagentit, joita Cloudsurf-liikenne voi sisältää, lueteltuna ne lähettävän Shopify-työkalun tai -tilan mukaan
LähdeKäyttäjäagenttiTiedot
Cloudsurf<selaimen käyttäjäagentti> Shopify/Cloudsurf (bot; +https://www.shopify.com)Oletuskäyttäjäagentti. Merkkijonon alku on istuntoa suorittavan selaimen vakiokäyttäjäagentti, joten se muuttuu selaimen ja sen version mukaan.
Mobiililaitteen emulointiIPhonen tai Androidin vakiokäyttäjäagenttiTyökalut, jotka testaavat sivun näkymistä puhelimessa, lähettävät kyseisen puhelimen käyttäjäagentin ilman Cloudsurf-tekstiä. Jos jokin näistä pyynnöistä on allekirjoitettu, voit vahvistaa sen Web Bot Auth -tunnistuksella.

Käyttäjäagentit voivat muuttua, kun Shopify-työkaluja päivitetään. Jotta voit tunnistaa Cloudsurf-liikenteen luotettavasti, vahvista sen Web Bot Auth -allekirjoitus sen sijaan, että vertaisit vain käyttäjäagenttia.