Je winkel crawlen

Je kunt Web Bot Auth gebruiken om je eigen crawlers, scripts of tools veilig te autoriseren voor toegang tot je openbare Shopify-webshop. Web Bot Auth is gebaseerd op HTTP-berichthandtekeningen die in je Shopify-beheercentrum worden gegenereerd. Je moet de handtekening opnemen in de HTTP-headers van elk verzoek, zodat kan worden geverifieerd dat het verzoek afkomstig is van een geautoriseerde bron.

Je kunt handtekeningen gebruiken met geautomatiseerde eigen tools of tools van externe partijen die toegang hebben tot je webshop voor toegankelijkheids- en SEO-audits, geautomatiseerde tests, data-analyse en vergelijkbare gebruiksscenario's. Je winkel kan zonder handtekeningen worden geïndexeerd door zoekmachines en large language models (LLM's).

Functies van handtekeningen

Handtekeningen hebben de volgende functies:

  • Veilige authenticatie: je kunt cryptografisch veilige handtekeningen genereren voor je crawlers.
  • Vervalbeheer: je kunt instellen dat handtekeningen na een bepaalde periode verlopen. De maximale periode is 3 maanden.
  • Gecentraliseerd beheer: je kunt al je handtekeningen op één plek beheren en bekijken.
  • Aangepaste naamgeving: je kunt elke handtekening een aangepaste naam geven om deze te identificeren.
  • Domeinbereik: elke handtekening wordt gebruikt voor een specifiek domein dat aan je Shopify-winkel gekoppeld moet zijn.

Aandachtspunten voor het aanmaken van handtekeningen

Lees de volgende aandachtspunten door voordat je handtekeningen aanmaakt en gebruikt:

  • Het crawlen van je winkel met handtekeningen is uitsluitend bedoeld voor het analyseren van je online webshop. Handtekeningen verlenen geen toegang tot je Shopify Checkout vanwege de extra beveiligingslagen van de checkout.
  • Gebruik duidelijke en beschrijvende namen voor je handtekeningen.
  • Handtekeningen verlopen automatisch en kunnen niet worden verlengd. Maak een nieuwe handtekening aan en update je tools nadat een handtekening is verlopen.
  • Elke handtekening wordt voor één domein gebruikt, dus je moet opgeven voor welk verbonden domein de handtekening wordt gebruikt. Je kunt alleen domeinen selecteren die met Shopify zijn verbonden.

Een handtekening aanmaken

Je kunt handtekeningen rechtstreeks aanmaken en beheren in je Shopify-beheercentrum.

  1. Ga vanuit het Shopify-beheercentrum naar Webshop > Voorkeuren.

  2. Klik in de sectie Crawlertoegang op Handtekening aanmaken.

  3. Voer in het veld Naam een beschrijvende naam voor je handtekening in.

  4. Selecteer in het veld Domein het domein waarvoor je deze handtekening wilt gebruiken.

  5. Selecteer in de sectie Geldig voor een vervalperiode voor je handtekening.

  6. Klik op Aanmaken.

  7. Optioneel: klik naast elke waarde op Kopiëren om je zojuist aangemaakte Signature-Input- en Signature-waarden te kopiëren.

Nadat een handtekening is verlopen, is deze niet meer geldig. Je kunt een verlopen handtekening niet vernieuwen, maar je kunt wel een nieuwe aanmaken.

Een handtekening aan verzoeken toevoegen

Je kunt je handtekeningen kopiëren en ze vervolgens aan de HTTP-headers van je verzoeken toevoegen. Elke handtekening bestaat uit 3 HTTP-headers die je moet opnemen.

Namen en waarden van HTTP-headers die vereist zijn om crawlerverzoeken met een handtekening te authenticeren
HeadernaamHeaderwaarde
Signature-InputVoeg de waarde van je signature-input toe.
SignatureVoeg de waarde van je handtekening toe.
Signature-AgentDe Signature-Agent-waarde is een tekenreeks met een geldige URI van de agent. Gebruik "https://shopify.com" (met aanhalingstekens) voor deze waarde.

Raadpleeg de volgende documentatie voor instructies over het toevoegen van aangepaste headers:

Handtekeningen bekijken

Je kunt de volgende informatie over je bestaande handtekeningen bekijken in je Shopify-beheercentrum:

  • Naam van de handtekening
  • Bijbehorend domein
  • Eerste paar tekens van de Signature-Input- en Signature-waarden
  • Signature-Agent-waarde
  • Vervaldatum en status van de handtekening
  1. Ga vanuit het Shopify-beheercentrum naar Webshop > Voorkeuren.

  2. Bekijk informatie over je handtekeningen in de sectie Toegang voor crawlers.

Problemen met handtekeningen oplossen

Selecteer het probleem met de handtekening en volg de stappen voor probleemoplossing.

Authenticatieproblemen oplossen

Als je crawler rate-limiting-fouten ontvangt, is je handtekening niet geldig. Controleer de volgende informatie:

  • Controleer of je de juiste indeling voor de handtekening gebruikt in de HTTP-headers.
  • Zorg ervoor dat de Signature-Input-, Signature- en Signature-Agent-headers bij elke aanvraag worden meegestuurd.
  • Controleer of de handtekening niet is verlopen. Controleer de vervaldatum in je Shopify-beheercentrum.
  • Crawl het domein dat aan de handtekening is gekoppeld.
Verloren handtekeningen herstellen

Als je je handtekening bent kwijtgeraakt, kun je deze herstellen door de volgende stappen te voltooien:

  1. Ga in je Shopify-beheercentrum naar Webshop > Voorkeuren.
  2. Zoek in de sectie Crawlertoegang je handtekening in de lijst.
  3. Klik op Kopiëren om de waarden voor Signature-Input, Signature en Signature-Agent naar je klembord te kopiëren.
Vervaldatum van handtekening wijzigen

Je kunt de vervaldatum van je handtekening niet meer wijzigen nadat je deze hebt aangemaakt. Als je een andere vervaldatum wilt instellen, maak je een nieuwe handtekening aan met de gewenste vervaldatum en update je vervolgens je services om de nieuwe handtekening te gebruiken.

De oude handtekening is nog steeds geldig en blijft werken tot de oorspronkelijke vervaldatum.