Eine App-Proxy-Route, die logged_in_customer_id liest, aber den Parameter signature nie prüft, kann von jedem direkt aufgerufen werden, der so die Punkte, die Wunschliste oder die Bestellungen eines anderen Kunden liest. Eine Webhook-Route, die X-Shopify-Hmac-Sha256 nie prüft, akzeptiert gefälschte orders/create- und customers/redact-Ereignisse von jedem, der die URL findet. Ein VITE_SHOPIFY_ADMIN_API_TOKEN liefert Ihr Admin-Token an jeden Besucher aus. Dieser Skill findet diese und zehn weitere Fehler in Shopify-Apps, bevor Sie deployen, und sagt Ihnen, wie Sie jeden davon beheben.

Ihr Agent führt einen Scanner auf shopify.app.toml und shopify.app.*.toml, shopify.extension.toml und shopify.theme.toml, .env-Dateien, Shopify-Konfigurationen in YAML und JSON (für Token-Präfixe) sowie auf JavaScript-, TypeScript-, Python-, Ruby- und PHP-Code aus, der Shopify erwähnt (React-Router- und Remix-Templates, Express, Next.js, Flask, Rails, Laravel). Er weiß, was die offiziellen Bibliotheken für Sie verifizieren (authenticate.webhook, authenticate.public.appProxy, shopify.webhooks.validate, processWebhooks, validateHmac mit dem appProxy-Signator, ShopifyApp::WebhookVerification und AppProxyVerification, PHP Registry::process, das ältere Shopify.Webhooks.Registry.process und Koa receiveWebhook), meldet REVIEW statt BLOCK, wenn eine Prüfung in einer Middleware oder einem Router liegen könnte, die er nicht lesen kann, und folgt bei einem Ordner-Scan einem in einer anderen Datei definierten Verifizierungs-Helfer, egal ob er aufgerufen, als Routen-Middleware übergeben oder als Decorator verwendet wird. Er prüft API-Versionen anhand des 12-monatigen Support-Zeitraums von Shopify mit dem Datum des Scans. Er liest .gitignore, sodass ein Secret in einer von git ignorierten .env-Datei in einer Zeile gezählt statt gemeldet wird. Kommentare und Testdateien werden übersprungen, und nichts wird ausgeführt oder an Shopify gesendet. Er liefert BLOCK, REVIEW oder NOT FLAGGED mit Datei, Zeile, Begründung und einem sichereren Ansatz. Tokens und Secrets werden niemals ausgegeben.

Was geprüft wird

BLOCK (vor der Auslieferung beheben)

• H01: shpat_-, shpca_-, shppa_-, shpss_-, shprt_- oder shptka_-Tokens, Client-Secrets und Admin- oder private Storefront-Tokens, die in Code, Konfigurations- oder Env-Dateien stehen, die git committen würde (in JavaScript-, TypeScript-, Python-, Ruby- und PHP-Form), einschließlich literaler Fallback-Werte für Umgebungsvariablen
• H02: eine Datei, die den gesamten Anfragepfad aufbaut und Shopify-Webhooks verarbeitet, ohne dass irgendetwas X-Shopify-Hmac-Sha256 prüft
• H03: dasselbe für App-Proxy-Handler, die den Parameter signature nie prüfen
• H04: Admin-Tokens, private Storefront-Tokens oder das Client-Secret in Variablen, die im Browser sichtbar sind (NEXT_PUBLIC_, VITE_, PUBLIC_, REACT_APP_, EXPO_PUBLIC_ und andere)

REVIEW (vor dem Release prüfen)

• H11: eine Produktions-App-Konfiguration, die nicht alle drei verpflichtenden Compliance-Webhooks abonniert, während die App einige davon aufführt, einen im Code verarbeitet oder den Vertrieb über den App Store angibt (die Template-Voreinstellung, die der Befund benennt)
• H12: eingeschränkte oder genehmigungspflichtige Scopes: read_all_orders, write_themes, read_users, Payment-Mandate-, Gateway- und Session-Scopes, read_customer_payment_methods, eigene Scopes für Abonnementverträge
• H13: Admin-, Storefront- oder Webhook-API-Versionen, die Shopify nicht mehr unterstützt, oder unstable
• H14: use_legacy_install_flow = true
• H15: localhost, Cloudflare- oder ngrok-Tunnel oder unverschlüsselte http-URLs in einer bereitgestellten App-Konfiguration
• H16: Webhook- oder App-Proxy-Handler, deren Signaturprüfung, falls vorhanden, in einer Middleware, einem Router oder einem Helfer liegt, dem der Scan nicht folgen kann
• H17: selbst geschriebene HMAC-Prüfungen, die mit == vergleichen oder neu serialisiertes JSON statt des Roh-Bodys signieren
• H18: selbst geschriebene OAuth-Callbacks ohne sichtbare Prüfung von hmac, State-Nonce oder verankerter Shop-Domain (Client-Credentials-, Token-Exchange- und Refresh-Token-Anfragen bleiben unberührt)
• H19: veraltete Script-Tags (write_script_tags, scriptTagCreate, scriptTagUpdate, REST ScriptTag)

Was enthalten ist

• Der Scanner (Python 3.9+, nur Standardbibliothek)
• Ein Regelleitfaden mit Begründung, sichererem Ansatz und Link zur Shopify-Dokumentation für jede Regel
• Eine riskante und eine sichere Shopify-Beispiel-App (App-Konfiguration, Extension-Konfiguration, React-Router-Serverdatei, Express-Backend, Router, Helfer und Env-Datei) sowie der echte Bericht, den der Scanner für die riskante erzeugt

Grenzen

Er liest jede Datei so, wie sie geschrieben ist: Einstellungen im Dev Dashboard oder Partner Dashboard, Umgebungswerte sowie Middleware oder Helfer außerhalb des gescannten Ordners werden nicht erkannt. Code, der weder Shopify noch einen Shopify-Header noch logged_in_customer_id erwähnt, wird nicht gelesen. Liquid-Theme-Dateien sowie Go- oder Java-Apps werden nicht geprüft, und YAML- oder JSON-Dateien werden nur auf Token-Präfixe gelesen. Ob eine App im App Store gelistet ist, lässt sich aus Dateien nicht erkennen, daher benötigt die Compliance-Prüfung Hinweise aus dem Projekt. Die Ergebnisse für API-Versionen ändern sich, wenn Shopify sie ausmustert. NOT FLAGGED ist keine Garantie.

Inhalt

Eine ZIP-Datei mit 25 Dateien: SKILL.md, der Scanner in scripts/ (8 Python-Dateien), references/rules.md (jede Regel mit Begründung und sichererem Ansatz) und examples/ (14 Beispieldateien plus report.md, die echte Scanner-Ausgabe für das riskante Beispiel).

Anwendung: Dies ist ein Agent-Skill: ein Ordner mit einer SKILL.md-Datei und Python-Skripten, die ein KI-Coding-Agent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacken Sie ihn in den Skills-Ordner Ihres Agenten (für Claude Code: ~/.claude/skills/) und bitten Sie Ihren Agenten dann, Ihr Projekt zu prüfen. Die Skripte laufen auch eigenständig mit Python 3.9 oder neuer, ohne dass etwas installiert werden muss. Sie lesen nur Ihre Dateien: kein Netzwerkzugriff, und nichts wird irgendwohin gesendet.