Agente de navegador do Cloudsurf

O Cloudsurf é um agente de navegador operado pela Shopify. Ele executa navegadores da web na nuvem para que as ferramentas e os agentes de IA da Shopify possam visitar páginas da web e interagir com elas da mesma forma que uma pessoa. Esse tipo de navegação é conhecido como navegação agêntica.

O Cloudsurf só visita uma página quando direcionado por uma ferramenta da Shopify. Ele não rastreia nem indexa a web de forma autônoma. É possível notar o tráfego do Cloudsurf na loja virtual ou em qualquer site público quando uma ferramenta da Shopify faz a navegação para um lojista ou cliente.

As solicitações do Cloudsurf podem incluir uma assinatura do Web Bot Auth e um agente de usuário da Shopify, que é o texto na solicitação responsável por identificar o software que a enviou. É possível usar essas informações para reconhecer o tráfego do Cloudsurf nos logs e em ferramentas de gerenciamento de bots.

Casos de uso do Cloudsurf

As ferramentas da Shopify usam o Cloudsurf para navegar em páginas da web para os seguintes fins:

  • Agentes de IA: o Sidekick e outros agentes de IA da Shopify navegam em páginas da web para concluir tarefas solicitadas por um lojista ou cliente.
  • Testes e verificações de qualidade: as ferramentas da Shopify carregam páginas da web para testá-las, fazer capturas de tela e verificar se há problemas de exibição.

Tráfego do Cloudsurf em lojas virtuais

As visitas do Cloudsurf à loja virtual podem vir de ferramentas da Shopify que você usa, de agentes de IA da Shopify que navegam para clientes, ou de testes e pesquisas internos executados com ferramentas da Shopify. Saiba mais sobre Como identificar a atividade de bots na loja virtual.

Assinaturas do Web Bot Auth

As ferramentas da Shopify que usam o Cloudsurf podem assinar as próprias solicitações com o Web Bot Auth, que usa assinaturas de mensagens HTTP. Uma assinatura válida comprova que a Shopify autorizou a solicitação. Qualquer pessoa pode copiar um agente de usuário, portanto, a assinatura é a forma mais confiável de identificar o tráfego do Cloudsurf.

Nem toda solicitação do Cloudsurf é assinada, pois a assinatura é ativada separadamente para cada ferramenta da Shopify. Se uma solicitação alegar ser do Cloudsurf, mas não tiver uma assinatura válida, não será possível verificar se ela veio da Shopify.

As solicitações assinadas do Cloudsurf usam o valor de Signature-Agent igual a "https://cloudsurf.shopify.io". O Cloudsurf assina cada solicitação para a ferramenta da Shopify que a usa, e cada assinatura expira 60 segundos após ser criada. O Cloudsurf publica as chaves públicas dele em um diretório de chaves em https://cloudsurf.shopify.io/.well-known/http-message-signatures-directory.

As solicitações assinadas incluem os seguintes cabeçalhos HTTP:

Os cabeçalhos do Web Bot Auth que as solicitações assinadas do Cloudsurf incluem, com o valor ou formato de cada cabeçalho
CabeçalhoValor
Signature-Agent"https://cloudsurf.shopify.io"
Signature-InputOs parâmetros de assinatura, incluindo o ID da chave, o algoritmo ed25519, os horários de criação e expiração e a tag web-bot-auth.
AssinaturaA assinatura Ed25519 da solicitação.

O exemplo a seguir ilustra o formato dos cabeçalhos que o Cloudsurf adiciona:

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

O parâmetro keyid em cada assinatura é a impressão digital JSON Web Key (JWK) da chave que a assinou.

Um serviço de gerenciamento de bots que ofereça suporte ao Web Bot Auth pode verificar uma solicitação. O serviço recupera as chaves do diretório de chaves e encontra a chave correspondente ao parâmetro keyid. Em seguida, ele verifica a assinatura e o tempo de expiração. Caso use um serviço de gerenciamento de bots, consulte a documentação dele para saber como permitir bots verificados.

Agentes de usuário do Cloudsurf

Por padrão, o Cloudsurf adiciona o texto Shopify/Cloudsurf (bot; +https://www.shopify.com) ao final do agente de usuário padrão do navegador. Algumas ferramentas da Shopify substituem o agente de usuário inteiro pelo próprio.

Consulte a tabela a seguir para ver exemplos de agentes de usuário no tráfego do Cloudsurf:

Agentes de usuário que o tráfego do Cloudsurf pode conter, listados pela ferramenta da Shopify ou pelo modo que os envia
OrigemAgente de usuárioDetalhes
Cloudsurf<agente de usuário do navegador> Shopify/Cloudsurf (bot; +https://www.shopify.com)O agente de usuário padrão. O início da string é o agente de usuário padrão do navegador que executa a sessão, por isso, muda de acordo com o navegador e a versão.
Emulação de dispositivo móvelUm agente de usuário padrão do iPhone ou AndroidAs ferramentas que testam como uma página é exibida no celular enviam o agente de usuário desse celular, sem o texto do Cloudsurf. Se uma dessas solicitações estiver assinada, será possível verificá-la com o Web Bot Auth.

Os agentes de usuário podem mudar quando as ferramentas da Shopify são atualizadas. Para identificar o tráfego do Cloudsurf de forma confiável, verifique a assinatura do Web Bot Auth em vez de se basear apenas no agente de usuário.