Web/Guru

Shopify-App IP-Allowlist: Fristen, Einrichtung und Hosting-Leitfaden für öffentliche Apps

Öffentliche Shopify-Apps brauchen bis 20. November 2026 eine IP-Allowlist (Bulk Operations: 12. November). Fristen, Einrichtung, Egress-IPs je Hoster.

Veröffentlicht
Aktualisiert
November 11, 2026
Lesezeit
12 Min. Lesezeit
Geschrieben von
Webguru
Shopify-App IP-Allowlist: Fristen, Einrichtung und Hosting-Leitfaden für öffentliche Apps
/Auf dieser Seite01 / 12

Jede öffentliche Shopify-App, die die Admin API aufruft, braucht jetzt eine IP-Allowlist: eine Liste der Adressen oder Netzwerke, von denen ihre Admin-API-Anfragen kommen dürfen. Öffentliche Apps, die Bulk Operations ausführen, müssen sie bis zum 12. November 2026 eingerichtet haben, alle anderen öffentlichen Apps bis zum 20. November 2026 (jeweils 23:59 Uhr ET, US-Ostküstenzeit). Nach dem 12. November werden Bulk-Abfragen und Bulk-Mutationen von Apps ohne Allowlist blockiert. Nach dem 20. November werden Apps ohne Allowlist aus dem Shopify App Store entfernt und für neue Installationen gesperrt, und ab dem 1. April 2027 weist Shopify ihre Admin-API-Anfragen ab.

Shopify hat die Pflicht am 5. November 2026 angekündigt. Custom Apps und Apps, die Händler selbst erstellen, sind ausgenommen.

Die Fristen

DatumWas mit einer öffentlichen App ohne IP-Allowlist passiert
12. November 2026, 23:59 Uhr ETBulk-Abfragen und Bulk-Mutationen werden blockiert.
20. November 2026, 23:59 Uhr ETDie App wird aus dem Shopify App Store entfernt und für neue Installationen gesperrt. Händler sehen unter Einstellungen > Apps einen Hinweis. Bestehende Installationen laufen weiter.
15. Januar 2027Händler, die die App nutzen, sehen eine Warnung im Shopify-Adminbereich.
1. April 2027Anfragen an die GraphQL und REST Admin API werden abgewiesen.

Der 15. Januar und der 1. April gelten ebenso für die Pflicht zu ablaufenden Offline-Zugriffstokens (auf Englisch), die mit dem 1. Januar 2027 ein eigenes Datum für die Entfernung aus dem App Store hat. Alle Termine führen wir in unserem Shopify Deprecation Tracker (auf Englisch).

Wer betroffen ist und wer nicht

  • Öffentliche Apps: Pflicht. Shopifys Changelog nennt alle öffentlichen Apps als betroffen. Wenn Ihre App im App Store gelistet ist oder an mehrere Shops verteilt wird, gilt die Pflicht für Sie.
  • Custom Apps: keine Pflicht. Shopifys Anleitung empfiehlt die Allowlist für sie trotzdem ausdrücklich.
  • Apps, die Händler im Dev Dashboard oder im Shopify-Adminbereich erstellen: ausgenommen.

Wenn Sie unsicher sind, zu welcher Art Ihre App gehört, hilft unser Vergleich Custom App vs. Public App (auf Englisch).

Eine Gruppe erwähnt das Changelog gesondert: Apps, deren Admin-API-Aufrufe aus der Infrastruktur des Händlers kommen, etwa von einem Konnektor, den der Händler selbst betreibt. Shopify fordert diese Apps auf, auf eine Architektur umzustellen, bei der Admin-API-Tokens weniger exponiert sind. Im Changelog-Beitrag ist ein Formular verlinkt, über das Sie eine Fristverlängerung beantragen können.

Was die Allowlist bewirkt

Ist die Durchsetzung aktiv, prüft Shopify bei jeder Anfrage an die GraphQL oder REST Admin API, die mit einem Token Ihrer App gestellt wird, die Quell-IP-Adresse. Eine Anfrage von einer Adresse außerhalb der Liste scheitert mit HTTP 403. Dasselbe gilt für Anfragen, deren Quelladresse Shopify nicht bestätigen kann. Ein gestohlenes Token funktioniert dann nur noch aus Ihrem eigenen Netzwerk.

Shopifys Anleitung nennt einige Sonderfälle:

  • Immer abgewiesen, sobald die Durchsetzung aktiv ist, weil Shopify die Quelladresse nicht bestätigen kann: Tokens, die die Shopify-Flow-Aktion „Send HTTP request“ verwendet, und Tokens für GraphQL-Admin-API-Anfragen aus einem Storefront, das auf Oxygen gehostet wird.
  • Nie abgewiesen: Dev-Preview-Anfragen in Dev Stores, Direct-API-Access-Anfragen aus eingebetteten App-Seiten und Direct-API-Access-Anfragen aus POS UI Extensions.

Was in die Liste eingetragen werden kann

Unter Allow requests from wählen Sie einen von zwei Modi.

ModusWas er akzeptiertGrenzen
IP addressesIPv4- und IPv6-Adressen sowie CIDR-Bereiche, je Zeile ein Eintrag. Ein Eintrag ohne Präfixlänge gilt als einzelne Adresse.Bis zu 100 Einträge. IPv4-Bereiche dürfen höchstens /16 groß sein, IPv6-Bereiche höchstens /32. Nur öffentliche Adressen. Ein Bereich muss mit seiner Netzadresse beginnen (203.0.113.0/24, nicht 203.0.113.7/24).
Networks (ASN)Autonome Systemnummern, mit oder ohne Präfix AS, dazu optional eine Länderliste.Bis zu 10 ASNs und bis zu 10 Länder. Nur öffentliche ASNs.

Zwei Punkte sind in der Praxis wichtig:

  • Stehen Ihre Server hinter einem NAT-Gateway, tragen Sie die öffentlichen Adressen des Gateways ein. Erreichen Ihre Server Shopify über IPv6, gehören auch die IPv6-Adressen in die Liste.
  • Der ASN-Modus ist für Apps mit dynamischen ausgehenden IPs gedacht. Das Netzwerk eines Hosters teilen Sie sich mit dessen anderen Kunden. Wer in einem erlaubten ASN sitzt und ein gestohlenes Token besitzt, könnte es also verwenden. Shopify empfiehlt IP-Adressen, wo immer das möglich ist. Wenn Sie ASNs nutzen, tragen Sie nur die Länder ein, in denen Ihre App läuft. Ohne Länderliste ist das ASN von überall erlaubt. Shopify ordnet ASN und Land anhand von MaxMind-GeoLite-Daten zu und weist eine Anfrage ab, wenn diese Daten für die Adresse kein ASN enthalten.

So finden Sie die ausgehenden IPs Ihrer App

Beginnen Sie mit dem, was Shopify bereits sieht. Öffnen Sie im Dev Dashboard die Logs Ihrer App. Einträge zu GraphQL- und REST-Anfragen lassen sich nach Client IP filtern, und die Logs werden 30 Tage aufbewahrt. So sehen Sie jede Adresse, von der Ihre App zuletzt Anfragen gestellt hat, auch die von Hosts, an die niemand mehr gedacht hat.

Um einen einzelnen Host zu prüfen, führen Sie dort dieses Skript aus (Node.js 18 oder neuer). Es fragt einen von AWS betriebenen Echo-Endpunkt, von welcher Adresse die Anfrage kam:

js
// egress-ip.mjs — auf der Maschine oder Funktion ausführen, die Shopify aufruft
const res = await fetch("https://checkip.amazonaws.com");
console.log("Egress IP:", (await res.text()).trim());

Führen Sie es mehrmals aus, auch nach einem neuen Deployment. Ändert sich die Adresse, hat Ihre Plattform dynamische ausgehende IPs, und Sie brauchen eine der Lösungen unten. Der Echo-Endpunkt meldet nur die Adresse dieser einen Verbindung. Maßgeblich für das, was bei Shopify ankommt, bleiben deshalb die Logs im Dev Dashboard, auch für IPv6.

Das sagen die Dokumentationen der Plattformen selbst:

PlattformAusgehende IPs im StandardSo erhalten Sie Adressen für die Allowlist
VercelDynamisch. Vercel veröffentlicht keinen festen Bereich.Static IPs (Pro und Enterprise) in den Projekteinstellungen unter Networking aktivieren und die Adressen je Region kopieren. Sie stammen aus einem Pool, den sich eine kleine Gruppe von Kunden teilt. Secure Compute (Enterprise) liefert ein dediziertes Adresspaar. Routing Middleware nutzt die statischen IPs nie, Builds nur mit der Option Use for builds.
AWS (EC2, ECS, Lambda)Hängt vom Aufbau ab. Eine Lambda-Funktion, die nicht an Ihre VPC angebunden ist, verlässt AWS nicht über eine von Ihnen reservierte Adresse.Die Workloads in private Subnetze legen und ausgehenden Verkehr über ein öffentliches NAT-Gateway leiten. Das NAT-Gateway hat eine Elastic IP, und diese Adresse tragen Sie ein. Lambda-Funktionen binden Sie an die privaten Subnetze der VPC an.
Google Cloud RunEin regionaler Pool dynamischer Adressen, den sich serverlose Workloads teilen.Den gesamten ausgehenden Verkehr über eine VPC leiten (Direct VPC egress oder Serverless-VPC-Access-Connector), eine statische externe IP reservieren und sie einem Cloud-NAT-Gateway an einem Cloud Router in derselben Region zuweisen.
Fly.ioLaut Fly-Dokumentation sind ausgehende IPs instabil und können sich ändern.Eine statische Egress-IP mit fly ips allocate-egress --app <app-name> -r <region> zuweisen. Jede Zuweisung ist ein IPv4- und IPv6-Paar für eine App in einer Region. Apps in mehreren Regionen brauchen eine je Region.
RenderJeder Service nutzt beliebige Adressen aus Bereichen, die sich alle Services der Region teilen. Die Bereiche stehen beim Service unter Connect > Outbound.Dedicated IPs zum Workspace hinzufügen. Jedes Set besteht aus drei IPv4-Adressen, ist an eine Region gebunden und gehört ausschließlich Ihrem Workspace.
HerokuIn der Common Runtime lässt sich die Absenderadresse nicht steuern.Private Spaces leiten ausgehenden Verkehr über ein NAT-Gateway mit stabilen ausgehenden IPs. Für die Common Runtime verweist Heroku auf Add-ons, die ausgehende Anfragen über eine feste Adresse leiten.
Cloudflare WorkersDie Workers-Dokumentation, die wir geprüft haben, nennt keine statische Adresse für fetch()-Aufrufe an externe Dienste. Cloudflare dokumentiert Dedicated CDN Egress IPs für Anfragen an den eigenen Origin, das ist ein anderer Fall.Shopifys ASN-Modus mit Länderliste nutzen oder die Admin-API-Aufrufe über einen Host oder Proxy mit fester Adresse leiten. Prüfen Sie vorher, ob zehn Länder alle Standorte abdecken, an denen Ihr Worker läuft.

Passt der geteilte Bereich einer Plattform in Shopifys Größengrenzen, können Sie ihn eintragen. Behandeln Sie ihn dann wie ein ASN: Andere Kunden des Hosters senden von denselben Adressen.

ASNs einzelner Hoster nennen wir hier bewusst nicht. Ein Hoster kann mehrere betreiben und weitere hinzufügen. Entnehmen Sie sie der Dokumentation des Hosters oder den Client-IPs in Ihren Dev-Dashboard-Logs.

Einrichtung im Dev Dashboard

Shopifys Anleitung beschreibt das Dev Dashboard als Ort für die Konfiguration. Die Datei shopify.app.toml oder die CLI erwähnt sie für diese Einstellung nicht.

  1. Öffnen Sie Ihre App im Dev Dashboard.
  2. Klicken Sie auf Settings und im Abschnitt IP allowlist auf Manage.
  3. Wählen Sie unter Allow requests from entweder IP addresses oder Networks (ASN).
  4. Tragen Sie Ihre Adressen oder CIDR-Bereiche ein, je Zeile einen Eintrag. Im ASN-Modus tragen Sie die ASNs und die Länder ein.
  5. Klicken Sie unter Test against recent traffic auf Run test. Der Test prüft den Traffic Ihrer App aus den letzten 30 Tagen auf Adressen, die die Liste blockieren würde. Es kann einige Minuten dauern, bis Ihre neuesten Anfragen berücksichtigt sind.
  6. Meldet der Test blockierte Adressen, klären Sie, zu welchem Host sie gehören. Ergänzen Sie die Adressen oder verlagern Sie diesen Traffic, und wiederholen Sie den Test.
  7. Aktivieren Sie Enforcement und klicken Sie auf Save.

Wenn etwas ausfällt, schalten Sie Enforcement wieder aus und speichern. Shopify behält die Liste, sodass Sie sie korrigieren und die Durchsetzung erneut einschalten können. Shopifys Beiträge beschreiben die Pflicht als das Einschalten der Allowlist. Planen Sie deshalb so, dass die Durchsetzung vor Ihrer Frist aktiv ist. Dass eine gespeicherte Liste mit ausgeschalteter Durchsetzung genügt, steht nirgends.

Wenn Ihre App Bulk Operations ausführt, prüfen Sie eine weitere Einstellung. Seit dem 6. November 2026 muss für Apps von Partnern der Zugriff auf Bulk Operations im Partner Dashboard freigeschaltet sein, unter Apps > Ihre App > API access requests > Run bulk operations. Apps, die bereits Bulk Operations ausgeführt haben, erhielten den Zugriff automatisch. Ein Operationstyp, der 31 Tage lang nicht genutzt wurde, verliert ihn aber und muss neu freigeschaltet werden.

Vor der Frist testen

  • Führen Sie den Traffic-Test nach einer normalen Betriebswoche aus, damit geplante Jobs und monatliche Synchronisierungen in den geprüften 30 Tagen enthalten sind.
  • Lösen Sie nach dem Einschalten jeden Pfad einmal von Hand aus: eine eingebettete Admin-Seite, einen Webhook-gesteuerten Job, einen Cron-Sync, eine Bulk Operation.
  • Stellen Sie eine GraphQL-Admin-API-Anfrage von einem Rechner außerhalb der Liste und bestätigen Sie, dass sie 403 zurückgibt. Diese Prüfung empfiehlt Shopifys Anleitung.
  • Beobachten Sie die Logs im Dev Dashboard einige Tage lang auf 403-Antworten und unbekannte Client-IPs, und prüfen Sie sie danach in festen Abständen.

Protokollieren Sie 403-Antworten auch im eigenen Code, mit genug Kontext, um den sendenden Host zu erkennen. Shopify dokumentiert den Statuscode, aber nicht den Antworttext, und ein 403 kann andere Ursachen haben, etwa einen fehlenden Access Scope. Das folgende Beispiel schreibt den Antworttext deshalb mit, ohne sich auf seinen Inhalt zu verlassen:

```js
import os from "node:os";

async function egressIp() {
const res = await fetch("https://checkip.amazonaws.com");

return (await res.text()).trim();

}

export async function adminGraphql(shop, accessToken, query, variables = {}) {
const version = process.env.SHOPIFY_API_VERSION;

const res = await fetch(https://${shop}/admin/api/${version}/graphql.json, {

method: "POST",

headers: {

"Content-Type": "application/json",

"X-Shopify-Access-Token": accessToken,

},

body: JSON.stringify({ query, variables }),

});

if (res.status === 403) {
const body = await res.text();

console.error(JSON.stringify({

event: "shopify_admin_403",

shop,

host: os.hostname(),

egressIp: await egressIp().catch(() => "unknown"),

body: body.slice(0, 500),

hint: "Fehlt egressIp in der IP-Allowlist der App? Adresse ergänzen oder Job verlagern.",

}));

throw new Error(Admin API returned 403 for ${shop});

}

if (!res.ok) throw new Error(Admin API returned ${res.status} for ${shop});
return res.json();

}

```

Wo Allowlists typischerweise scheitern

  • Serverless-Funktionen mit wechselnden IPs. Im Test funktioniert die Funktion, später scheitert sie von einer neuen Adresse aus. Geben Sie der Plattform statische ausgehende IPs, oder nutzen Sie den ASN-Modus mit Länderliste.
  • Hintergrund-Worker auf einem anderen Host. Die Web-App läuft auf einer Plattform, Queue-Worker oder Cronjobs auf einer anderen. Jeder Host, der die Admin API aufruft, muss mit seinen Adressen in der Liste stehen. Der häufigste Fall sind Webhook-Worker (auf Englisch), weil sie nach einer Zustellung wieder die Admin API aufrufen.
  • Lokale Entwicklung. Dev-Preview-Anfragen in Dev Stores werden nie abgewiesen. Ein Skript auf Ihrem Laptop, das das Token eines echten Shops verwendet, stellt dagegen eine normale Admin-API-Anfrage von Ihrer Büro- oder Heimadresse und erhält ein 403. Ein Tunnel ändert daran nichts: Er leitet eingehenden Verkehr zu Ihrem Rechner, Ihre ausgehenden Anfragen gehen weiter über Ihren eigenen Anschluss.
  • CI-Jobs. Eine Pipeline, die mit App-Tokens von gehosteten Runnern aus die Admin API aufruft, sendet von Adressen, die Sie nicht kontrollieren. Leiten Sie diese Aufrufe über Ihr Backend oder über einen Runner mit fester Adresse.
  • Andere Dienste, die das Token Ihrer App verwenden. Ein ETL-Tool, der Server eines Händlers oder ein Partnersystem mit Ihrem Token ruft aus dem eigenen Netzwerk auf. Entweder kommen dessen Adressen in Ihre Liste, oder der Aufruf wandert in Ihr Backend. Die Flow-Aktion „Send HTTP request“ und auf Oxygen gehostete Storefronts lassen sich gar nicht freigeben.
  • IPv6. Die IPv4-Adresse steht in der Liste, der Host erreicht Shopify aber über IPv6.
  • Neue Region oder Failover. Auf den meisten Plattformen hat jede Region eigene ausgehende Adressen. Tragen Sie sie ein, bevor der Traffic umzieht.

Wie das zu den ablaufenden Offline-Tokens passt

Die beiden Pflichten ergänzen sich. Die Allowlist begrenzt, von wo ein Token verwendet werden kann, ablaufende Tokens begrenzen, wie lange ein abgeflossenes Token gültig bleibt. Shopifys Anleitung empfiehlt beides zusammen.

IP-AllowlistAblaufende Offline-Zugriffstokens
Bulk Operations blockiert12. November 2026Entfällt
Aus dem App Store entfernt, keine neuen Installationen20. November 20261. Januar 2027
Warnung für Händler im Adminbereich15. Januar 202715. Januar 2027
Admin-API-Anfragen scheitern1. April 20271. April 2027 (HTTP 403)

Händler sehen schon jetzt unter Einstellungen > Apps, ob die Tokens einer App ablaufen und ob eine IP-Allowlist aktiv ist. Eine fehlende Allowlist fällt ihnen also auf, bevor die erste Anfrage scheitert. Die Token-Umstellung dauert länger, weil sie jeden installierten Shop betrifft. Unser Leitfaden zu ablaufenden Offline-Zugriffstokens (auf Englisch) beschreibt diese Migration Schritt für Schritt.

Was Shopifys Dokumentation offenlässt

Wir haben die Changelog-Beiträge und die Anleitung am 11. November 2026 geprüft. Diese Punkte beantworten sie nicht:

  • Den Antworttext einer blockierten Anfrage. Dokumentiert ist nur der Status 403.
  • Wie schnell eine gespeicherte Änderung oder der Enforcement-Schalter wirkt.
  • Welche Rolle im Dev Dashboard die Allowlist bearbeiten darf.
  • Ob sich die Allowlist über shopify.app.toml, die CLI oder eine API verwalten lässt.
  • Ob außer der GraphQL und der REST Admin API noch etwas geprüft wird. Die Anleitung nennt nur diese beiden.

Wenn einer dieser Punkte für Ihre Umstellung wichtig ist, testen Sie ihn in einem Development Store und verlassen Sie sich auf keine Annahme.

Brauchen Sie Unterstützung vor der Frist?

Wir entwickeln und betreuen öffentliche und individuelle Shopify-Apps. Bei dieser Umstellung erfassen wir jeden Host, der die Admin API aufruft, richten statische ausgehende IPs ein, wo die Plattform sie braucht, konfigurieren und testen die Allowlist und erledigen die Migration auf ablaufende Tokens im selben Durchgang. Mehr dazu auf unserer Seite zur Shopify-App-Entwicklung, oder schreiben Sie uns zu Ihrer App.

Quellen

/Schlagwörter#Shopify#Apps#Admin API#Sicherheit

Geschrieben von

Webguru

Shopify-Entwicklungsteam

Webguru.pk ist ein Shopify-Entwicklungsteam aus Lahore, Pakistan, das Shops, individuelle Apps und Integrationen für Marken weltweit entwickelt.

/Teilen

Brauchen Sie dabei Unterstützung?

Wir planen, bauen und reparieren genau solche Lösungen für Shopify-, SaaS- und KI-Produkte.

/faqs

Shopify-App IP-Allowlist: Häufige Fragen

Öffentliche Apps, die Bulk Operations ausführen, brauchen sie bis zum 12. November 2026, 23:59 Uhr ET, alle anderen öffentlichen Apps bis zum 20. November 2026, 23:59 Uhr ET. Apps ohne Allowlist werden dann aus dem Shopify App Store entfernt und für neue Installationen gesperrt. Ab dem 15. Januar 2027 sehen Händler eine Warnung im Adminbereich, und ab dem 1. April 2027 werden Admin-API-Anfragen öffentlicher Apps ohne Allowlist abgewiesen.

Nein. Die Pflicht gilt für öffentliche Apps. Custom Apps und Apps, die Händler im Dev Dashboard oder im Shopify-Adminbereich erstellen, sind ausgenommen. Shopifys Anleitung empfiehlt die Allowlist aber auch für Custom Apps.

Im Dev Dashboard. Öffnen Sie Ihre App, klicken Sie auf Settings und im Abschnitt IP allowlist auf Manage. Wählen Sie IP addresses oder Networks (ASN), tragen Sie Ihre Werte ein, führen Sie den Test gegen den aktuellen Traffic aus, aktivieren Sie Enforcement und speichern Sie. Eine Einstellung in shopify.app.toml oder in der CLI beschreibt Shopifys Anleitung dafür nicht.

Im IP-Modus bis zu 100 IPv4- oder IPv6-Adressen und CIDR-Bereiche, je Zeile ein Eintrag. IPv4-Bereiche dürfen höchstens /16 groß sein, IPv6-Bereiche höchstens /32, und es sind nur öffentliche Adressen erlaubt. Im Netzwerk-Modus bis zu 10 autonome Systemnummern (ASNs) und bis zu 10 Länder.

Admin-API-Anfragen von außerhalb der Allowlist scheitern mit HTTP 403, ebenso Anfragen, deren Quelladresse Shopify nicht bestätigen kann. Shopifys Anleitung dokumentiert den Statuscode, aber nicht den Antworttext. Protokollieren Sie bei einem 403 deshalb die vollständige Antwort und den sendenden Host.

Sie haben zwei Möglichkeiten. Sie geben der Plattform statische ausgehende Adressen, etwa über eine Static-IP-Funktion, ein NAT-Gateway oder einen Proxy mit fester Adresse, und tragen diese ein. Oder Sie nutzen Shopifys Modus Networks (ASN), der das Netzwerk Ihres Hosters erlaubt, und ergänzen die Länder, in denen Ihre App läuft. Shopify empfiehlt IP-Adressen, wo immer möglich, weil Sie sich das Netzwerk eines Hosters mit dessen anderen Kunden teilen.

Dev-Preview-Anfragen in Dev Stores werden nie abgewiesen. Skripte, die von Ihrem eigenen Rechner aus mit dem Token eines echten Shops die Admin API aufrufen, gelten als normale Anfragen und erhalten ein 403, solange Ihre Adresse nicht in der Liste steht.

Nein, es sind zwei getrennte Pflichten mit unterschiedlichen ersten Fristen. Die Allowlist ist im November 2026 fällig, ablaufende Offline-Zugriffstokens bis zum 1. Januar 2027. Die späteren Stufen sind gemeinsam: Warnungen für Händler ab dem 15. Januar 2027 und scheiternde Admin-API-Anfragen ab dem 1. April 2027.

Ihre öffentliche App hat noch keine IP-Allowlist?

Wir erfassen jeden Host, der die Admin API aufruft, richten bei Bedarf statische ausgehende IPs ein und konfigurieren und testen die Allowlist vor Ihrer Frist.

oder schreiben Sie an+44 7882 755642