Deinen Shop crawlen

Du kannst Web Bot Auth verwenden, um deine eigenen Crawler, Skripte oder Tools sicher für den Zugriff auf deinen öffentlichen Shopify-Onlineshop zu autorisieren. Web Bot Auth basiert auf HTTP-Nachrichtensignaturen, die in deinem Shopify-Adminbereich generiert werden. Du musst die Signatur in die HTTP-Header jeder Anfrage einbeziehen, damit verifiziert werden kann, dass die Anfrage von einer autorisierten Quelle stammt.

Du kannst Signaturen mit automatisierten internen oder externen Tools verwenden, die für Prüfungen der Zugänglichkeit und für SEO-Audits, automatisierte Tests, Datenanalysen und ähnliche Anwendungsfälle auf deinen Onlineshop zugreifen. Dein Shop kann von Suchmaschinen und Large Language Models (LLMs) auch ohne Signaturen indexiert werden.

Signaturfunktionen

Signaturen bieten die folgenden Funktionen:

  • Sichere Authentifizierung: Du kannst kryptografisch sichere Signaturen für deine Crawler generieren.
  • Ablaufsteuerung: Du kannst festlegen, dass Signaturen nach einem bestimmten Zeitraum ablaufen. Der maximale Zeitraum beträgt 3 Monate.
  • Zentrale Verwaltung: Du kannst all deine Signaturen an einem Ort verwalten und anzeigen.
  • Benutzerdefinierte Benennung: Du kannst jeder Signatur einen benutzerdefinierten Namen geben, um sie zu identifizieren.
  • Domain-Geltungsbereich: Jede Signatur wird für eine bestimmte Domain verwendet, die mit deinem Shopify-Shop verbunden sein muss.

Überlegungen zum Erstellen von Signaturen

Bevor du Signaturen erstellst und verwendest, beachte die folgenden Überlegungen:

  • Das Crawlen deines Shops mit Signaturen ist nur für die Analyse deiner Online-Storefront gedacht. Signaturen gewähren aufgrund der zusätzlichen Sicherheitsebenen des Checkouts keinen Zugriff auf deinen Shopify Checkout.
  • Verwende klare und aussagekräftige Namen für deine Signaturen.
  • Signaturen laufen automatisch ab und können nicht verlängert werden. Erstelle eine neue Signatur und aktualisiere deine Tools, nachdem eine Signatur abgelaufen ist.
  • Jede Signatur wird für eine Domain verwendet, daher musst du angeben, für welche verbundene Domain die Signatur verwendet werden soll. Du kannst nur Domains auswählen, die mit Shopify verbunden wurden.

Signatur erstellen

Du kannst Signaturen direkt in deinem Shopify-Adminbereich erstellen und verwalten.

  1. Gehe in deinem Shopify-Adminbereich zu Onlineshop > Einstellungen.

  2. Klicke im Abschnitt Crawler-Zugriff auf Signatur erstellen.

  3. Gib in das Feld Name einen aussagekräftigen Namen für deine Signatur ein.

  4. Wähle im Feld Domain die Domain aus, für die du diese Signatur verwenden möchtest.

  5. Wähle im Abschnitt Gültig für einen Gültigkeitszeitraum für deine Signatur aus.

  6. Klicke auf Erstellen.

  7. Optional: Um deine neu erstellten Werte für Signature-Input und Signature zu kopieren, klicke neben dem jeweiligen Wert auf Kopieren.

Nachdem eine Signatur abgelaufen ist, ist sie nicht mehr gültig. Du kannst eine abgelaufene Signatur nicht verlängern, aber du kannst eine neue erstellen.

Anfragen eine Signatur hinzufügen

Du kannst deine Signaturen kopieren und sie dann den HTTP-Headern deiner Anfragen hinzufügen. Jede Signatur besteht aus 3 HTTP-Headern, die du einbeziehen musst.

Namen und Werte für HTTP-Header, die erforderlich sind, um Crawler-Anfragen mit einer Signatur zu authentifizieren
Header-NameHeader-Wert
Signature-InputFüge deinen Signatur-Input-Wert hinzu.
SignatureFüge deinen Signaturwert hinzu.
Signature-AgentDer Wert für Signature-Agent ist ein String, der eine gültige URI des Agenten enthält. Verwende für diesen Wert „https://shopify.com“ (mit Anführungszeichen).

Anweisungen zum Hinzufügen benutzerdefinierter Header findest du in der folgenden Dokumentation:

Signaturen anzeigen

Du kannst die folgenden Informationen über deine bestehenden Signaturen in deinem Shopify-Adminbereich einsehen:

  • Signaturname
  • Zugehörige Domain
  • Erste paar Zeichen der Werte für Signature-Input und Signature
  • Wert für Signature-Agent
  • Ablaufdatum und Status der Signatur
  1. Gehe in deinem Shopify-Adminbereich zu Onlineshop > Einstellungen.

  2. Überprüfe im Abschnitt Crawler-Zugriff die Informationen zu deinen Signaturen.

Fehlerbehebung bei Signaturen

Wähle das Signaturproblem aus und befolge die Schritte zur Fehlerbehebung.

Fehlerbehebung bei Authentifizierungsproblemen

Wenn dein Crawler Fehler aufgrund von Ratenbegrenzungen erhält, ist deine Signatur nicht gültig. Überprüfe die folgenden Informationen:

  • Vergewissere dich, dass du das korrekte Signaturformat in den HTTP-Headern verwendest.
  • Stelle sicher, dass die Header Signature-Input, Signature und Signature-Agent bei jeder Anfrage gesendet werden.
  • Überprüfe, ob die Signatur nicht abgelaufen ist. Sieh dir das Ablaufdatum in deinem Shopify-Adminbereich an.
  • Crawle die Domain, die mit der Signatur verknüpft ist.
Verlorene Signaturen wiederherstellen

Wenn du deine Signatur verloren hast, kannst du sie wiederherstellen, indem du die folgenden Schritte ausführst:

  1. Gehe in deinem Shopify-Adminbereich zu Onlineshop > Einstellungen.
  2. Suche im Abschnitt Crawler-Zugriff deine Signatur in der Liste.
  3. Klicke auf Kopieren, um die Werte für Signature-Input, Signature und Signature-Agent in deine Zwischenablage zu kopieren.
Ablaufdatum einer Signatur ändern

Du kannst das Ablaufdatum deiner Signatur nach dem Erstellen nicht mehr ändern. Um ein anderes Ablaufdatum festzulegen, erstelle eine neue Signatur mit dem gewünschten Ablaufdatum und aktualisiere dann deine Dienste, um die neue Signatur zu verwenden.

Die alte Signatur ist weiterhin gültig und funktioniert bis zum ursprünglichen Ablaufdatum.