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
| Datum | Was mit einer öffentlichen App ohne IP-Allowlist passiert |
|---|---|
| 12. November 2026, 23:59 Uhr ET | Bulk-Abfragen und Bulk-Mutationen werden blockiert. |
| 20. November 2026, 23:59 Uhr ET | Die 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 2027 | Händler, die die App nutzen, sehen eine Warnung im Shopify-Adminbereich. |
| 1. April 2027 | Anfragen 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.
| Modus | Was er akzeptiert | Grenzen |
|---|---|---|
| IP addresses | IPv4- 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:
// 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:
| Plattform | Ausgehende IPs im Standard | So erhalten Sie Adressen für die Allowlist |
|---|---|---|
| Vercel | Dynamisch. 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 Run | Ein 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.io | Laut 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. |
| Render | Jeder 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. |
| Heroku | In 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 Workers | Die 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.
- Öffnen Sie Ihre App im Dev Dashboard.
- Klicken Sie auf Settings und im Abschnitt IP allowlist auf Manage.
- Wählen Sie unter Allow requests from entweder IP addresses oder Networks (ASN).
- Tragen Sie Ihre Adressen oder CIDR-Bereiche ein, je Zeile einen Eintrag. Im ASN-Modus tragen Sie die ASNs und die Länder ein.
- 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.
- 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.
- 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
403zurü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-Allowlist | Ablaufende Offline-Zugriffstokens | |
|---|---|---|
| Bulk Operations blockiert | 12. November 2026 | Entfällt |
| Aus dem App Store entfernt, keine neuen Installationen | 20. November 2026 | 1. Januar 2027 |
| Warnung für Händler im Adminbereich | 15. Januar 2027 | 15. Januar 2027 |
| Admin-API-Anfragen scheitern | 1. April 2027 | 1. 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
- Shopify changelog: IP allowlists are now required for public apps
- Shopify changelog: App security updates, IP allowlist is now required
- Shopify: IP allowlist setup guide (Dev Dashboard)
- Shopify: Monitoring and logs in the Dev Dashboard
- Shopify changelog: App security updates, October 2026
- Shopify changelog: Migrate to expiring offline access tokens before January 2027
- Shopify changelog: Partner apps must enable bulk operations before use
- Vercel: Static IPs
- AWS: NAT gateways
- AWS: Internet access for VPC-connected Lambda functions
- Google Cloud: Static outbound IP address for Cloud Run
- Fly.io: Egress IP addresses
- Render: Outbound IP addresses
- Render: Dedicated IPs
- Heroku: Networking
- Heroku: Private Spaces
- Cloudflare: Dedicated CDN Egress IPs with other products


