Logo

Shopify-Anwendung IP-Whitelist-Deadline naht: Konfiguration bis zum 20. November erforderlich

avatar jayce 16 Nov 2026

Am 27. Oktober empfahl Shopify lediglich die Konfiguration der IP-Whitelist für öffentliche Anwendungen; im Changelog vom 5. November wurde die Formulierung jedoch auf “erforderlich” geändert. Alle öffentlichen Anwendungen, die die Admin-API aufrufen, müssen bis zum 20. November 2026 um 23:59 Uhr (Eastern Time) aktiviert sein; für Anwendungen, die Bulk-Operationen verwenden, eine Woche früher, am 12. November.

Der Grund steht zu Beginn der Ankündigung: Die Hochsaison steht bevor.

Was überprüft Shopify

Nach der Aktivierung der Durchsetzung überprüft Shopify die Quell-IP jeder GraphQL- und REST-Admin-API-Anfrage, die mit deinem App-Token gesendet wird. Ist die IP nicht in der Whitelist, wird ein 403-Fehler zurückgegeben; bei nicht bestätigbaren Quelladressen ebenfalls 403. Die Folgen eines Token-Lecks sinken von “Konto verloren” auf “kann nur auf deinem eigenen Server verwendet werden”.

Es gibt zwei Arten von Anfragen, die auch ohne Konfiguration nicht durchkommen: Das Access-Token, das in der Send HTTP request-Aktion von Shopify Flow enthalten ist, sowie Anfragen an die Admin-API, die mit einem Token von einem von Oxygen gehosteten Storefront gesendet werden, da die Quell-IP nicht bestätigt werden kann. Diese Teams müssen auf serverseitige Weiterleitungen umstellen. Dev-Store-Vorschau, eingebettete Seiten und POS-UI-Erweiterungen haben immer direkten API-Zugriff und werden nie blockiert.

Statische IP in zehn Minuten konfiguriert, serverless über ASN

Der Zugang erfolgt über das Dev-Dashboard: Öffne die Anwendung, gehe zu Einstellungen, und klicke im IP-Whitelist-Bereich auf Verwalten.

Ein Beispiel: Ein unabhängiger Shop, der maßgeschneiderte Haustierporträts anbietet, hat die Backend-Anwendung auf zwei EC2-Instanzen laufen, mit einer festen Ausgangs-IP. Einfach beide Adressen eintragen. Regeln: Maximal 250 Einträge, jeweils eine pro Zeile; IPv4-Maske /16 oder enger, IPv6 /32 oder enger; nur öffentliche Adressen eintragen, Maschinen hinter NAT tragen die Gateway-Adresse ein; der Bereich muss von der Netzwerkadresse ausgehen, 203.0.113.0/24 ist in Ordnung, 203.0.113.7/24 nicht; für IPv6-Ausgänge müssen auch die IPv6-Adressen aufgeführt werden.

Wenn die Anwendung auf Vercel oder AWS Lambda läuft, ändert sich die Ausgangs-IP bei jeder Anfrage, daher erfolgt die Freigabe über ASN: Maximal 10 ASN, AS-Präfix ist optional, es wird empfohlen, auch das Land zur Eingrenzung auszuwählen, maximal 10. Shopify verwendet die MaxMind GeoLite-Daten zur Bestimmung des Herkunftsstandorts, und da ASN ein gemeinsames Netzwerk ist, befinden sich auch Server anderer Unternehmen im Freigabebereich. Wenn eine feste IP verfügbar ist, sollte kein ASN verwendet werden.

Führe zunächst keinen Enforcement-Test durch, klicke auf Test ausführen. Shopify spielt deinen tatsächlichen Traffic der letzten 30 Tage ab. Wenn es Adressen gibt, die blockiert werden, passe sie an und teste erneut. Wenn alles sauber ist, aktiviere Enforcement und speichere. Schließlich sende eine Admin-API-Anfrage außerhalb der Whitelist und stelle sicher, dass du einen 403-Fehler erhältst, um die Konfiguration abzuschließen.

Kettenreaktion bei verpasster Frist

Ab dem 20. November werden nicht konfigurierten Anwendungen aus dem App Store entfernt und die Installation neuer Anwendungen wird verboten. Händler sehen in den Einstellungen > Apps eine Markierung; bereits installierte Shops können vorerst normal weiterarbeiten. Am 15. Januar 2027 beginnt eine Warnung im Händler-Admin. Am 1. April 2027 werden Admin-API-Anfragen direkt abgelehnt, und die Anwendung wird eingestellt.

Custom Apps fallen ebenfalls unter diese Regelung: Um in einem externen Shop zu installieren, muss die Konfiguration ab dem 20. November erfolgen; für bereits in externen Shops installierte Anwendungen muss die Konfiguration bis zum 1. Januar 2027 nachgeholt werden. Anwendungen, die nur in den eigenen Shops verwendet werden, sind nicht zwingend erforderlich; die offizielle Formulierung ist “stark empfohlen”.

Händler können jetzt in den Einstellungen > Apps die Sicherheitskonfiguration der Anwendung sehen, einschließlich des Token-Typs und ob eine Whitelist vorhanden ist, alles auf einen Blick. Käufer sehen dies nicht, aber die Personen, die technische Entscheidungen für den Shop treffen, können dies sehen.

Die ASN-Bestimmung hängt von den Daten von MaxMind ab; Randadressen, bei denen ASN oder Land nicht ermittelt werden können, werden direkt abgelehnt, die offizielle Fehlerrate wurde nicht angegeben. Der Testlauf deckt nur 30 Tage ab; ob das stabil genug ist, habe ich noch nicht überprüft. Nach der Konfiguration sollte man in der ersten Woche die API-Protokolle im Auge behalten.

Referenzen:

  • https://shopify.dev/changelog/blog/app-security-updates-ip-allowlist-is-now-required
  • https://shopify.dev/docs/apps/build/dev-dashboard/ip-allowlist
Tags
App Security
IP Allowlist
Admin API
shopify
跨境电商
Kontaktieren Sie uns