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.
Tällä sivulla
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:
| Otsikko | Arvo |
|---|---|
| Signature-Agent | "https://cloudsurf.shopify.io" |
| Signature-Input | Allekirjoitusparametrit, mukaan lukien avaimen tunnus, ed25519-algoritmi, luonti- ja vanhenemisajat sekä web-bot-auth-tunniste. |
| Allekirjoitus | Pyynnö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:
| Lähde | Käyttäjäagentti | Tiedot |
|---|---|---|
| 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 emulointi | IPhonen tai Androidin vakiokäyttäjäagentti | Työ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.