12 Kasım 2026 · 7 dk okuma

Shopify Uygulamaları için IP İzin Listesi Artık Zorunlu: shopify.app.toml, ASN Kuralları ve Dev Store Testi

Shopify, Kasım 2026'da halka açık uygulamalar için IP izin listesini zorunlu hale getirdi.

Shopify Uygulamaları için IP İzin Listesi Artık Zorunlu: shopify.app.toml, ASN Kuralları ve Dev Store Testi

Halka açık Shopify uygulamanız Admin API'yi çağırıyorsa ve henüz IP izin listesini açmadıysanız, ya zaten toplu işlem çağrılarını kaçırıyorsunuz (Kasım 12 son tarihi bugün geçti) ya da Uygulama Mağazası'ndan kaldırılmaya sekiz gün kaldı. Çözüm, Dev Panosu geçişi artı ayrı olarak shopify.app.toml dosyasında bir [network_access] bloğudur. Bu iki şey aynı denetim değildir ve bunları karıştırmak şu anda topluluk başlıklarında gördüğüm en yaygın hatadır.

Ana noktalar

  • Halka açık uygulamalar için IP izin listesi 5 Kasım 2026 tarihinde zorunlu hale geldi; toplu işlem uygulaması 12 Kasım'da başladı ve genel uygulama 20 Kasım 2026 saat 23:59 ET'de başlayacak.
  • İzin listesi geçişi Dev Panosi'nda bulunur, shopify.app.toml dosyasında değil. toml dosyası farklı bir amaç için ayrı bir [network_access] bloğu içerir.
  • Sunucusuz uygulamalar (Vercel, Cloudflare Workers, AWS Lambda, vb.) statik IP'ler yerine ASN tabanlı kurallar kullanabilir, en fazla 10 ASN ile en fazla 10 ülke kapsamında.
  • Shopify, uygulamanızın jetonlarını kullanan her GraphQL Admin API ve REST Admin API isteğinde kaynak IP'yi izin listesine karşı kontrol eder.
  • Üretime gitmeden önce [network_access] bildirimlerini network_access_testing özellik önizlemesiyle dev store'da test edebilirsiniz.
  • Son tarihi kaçırırsanız, uygulama dört aşamada kademeli olarak uygulanır ve 1 Nisan 2027'de Admin API istekleri tamamen başarısız olur.

Bunun neden önemli: tehdit modeli

Admin API erişim jetonları her zaman bir Shopify uygulamasının sahip olduğu en değerli kimlik bilgisi olmuştur. Sızan bir jeton daha önce gezegendeki herhangi bir IP'den yeniden kullanılabiliyordu. IP izin listesi bunu değiştirir: Shopify, kapsanan her istekten kaynak IP adresini değerlendirir ve geçerli bir jeton, listeye dahil olmayan bir adres veya ağdan gelirse basitçe reddedilir.

Bu, ödeme verilerini, yerine getirme webhooklerini veya toplu katalog işlemlerini işleyen uygulamalar için özellikle geçerlidir. 10.000 SKU'nun üzerinde mağaza arasında bir katalog senkronizasyon uygulaması yönetirim ve toplu işlem işlem hattı tam olarak Kasım 12 son tarihine ilk olarak ulaşan iş yükü sınıfıdır. Uygulamanız son 180 günde herhangi bir bulkOperationRunQuery veya bulkOperationRunMutation çalıştırdıysa, bu kod yolu kapsam içindedir.

Uygulama zaman çizelgesi

TarihNe olur
12 Kasım 2026İzin listesi olmayan halka açık uygulamalardan toplu sorgular ve mutasyonlar engellenir
20 Kasım 2026Uygulama App Store'dan kaldırılır, yeni yüklemelerden engellenir, Ayarlar > Uygulamalar'da işaretlenir
15 Ocak 2027Satıcılar mevcut yüklemelerde yönetici içi uyarı görürler
1 Nisan 2027İzin listesi olmayan uygulamalardan tüm Admin API istekleri hata döndürür

Not: özel uygulamalar (App Store'dan değil doğrudan URL üzerinden yüklenmiş) mandattan muaftır, ancak Shopify onlara da izin listesi eklemeyi şiddetle tavsiye eder.

Anlamanız gereken iki ayrı denetim

Bu çoğu kafa karışıklığının kaynağı. Shopify, Ekim-Kasım 2026 güvenlik itişinde ilgili ancak bağımsız iki özellik gönderdi:

1. IP izin listesi (Dev Panosi)

IP izin listesi, uygulamanızın erişim jetonlarının nerede kullanılabileceğini sınırlar. Uygulama açık olduğunda, Shopify uygulamanızın jetonlarını kullanan her GraphQL Admin API ve REST Admin API isteğinin kaynak IP adresini kontrol eder.

Bu, Dev Panosi'nde, uygulamanızın Ayarlar > IP izin listesi > Yönet altında tamamen yapılandırılmıştır. Henüz shopify.app.toml gösterimi yoktur. Bir geliştirici topluluk forumlarında Shopify'ye IP izin listesinin shopify.app.toml parçası olabilip shopify app deploy ile yayınlanabilip yayınlanamayacağını sordu. Shopify personelinden bu haftaya kadar gelen yanıt, bunun olamayacağıdır: [network_access] uygulamanın konuştuğu ana bilgisayarları kapsarken, uygulamanızın API kimlik bilgileri için IP izin listesi, hangi IP'lerin Admin API'ye jetonlarınızla ulaşabileceğini belirleyen Dev Panosi'nde ayrı bir ayardır.

Bu ayrım CI/CD açısından önemlidir. IP izin listesi pano tarafından yönetilen bir yapılandırmadır; yeni bir uygulama sürümü dağıtmak onu güncellemez.

2. shopify.app.toml dosyasında [network_access] (bildirilen ana bilgisayarlar)

Artık uygulamanızın harici ana bilgisayarlarını ve sunucularını shopify.app.toml dosyasının yeni [network_access] bölümünde bildirebilirsiniz. Normalde Shopify, müşteriler Shopify dışında bir URL'ye gittiğinde onları uyarır; harici ana bilgisayarlarınızı bildirmek bu uyarıyı atlar ve güvenilir yolculuklar için sürtünmeyi kaldırmanızı sağlar. Sunucuları bildirmek, Shopify'nin şüpheli etkinliği tespit etmesine ve uygulamanızı korumasına yardımcı olur.

Bloğun iki özelliği vardır:

  • allowed_navigation_hosts: uygulamanızın müşterileri yönlendirdiği ana bilgisayar adları (harici yönlendirme uyarısını atlar).
  • allowed_sources: uygulamanızın vitrin, ödeme ve yönetici sayfalarına yüklediği veya gönderdiği en fazla 20 HTTPS kaynağı. Shopify bunları şüpheli etkinliği tespit etmek için kullanır.

Minimal bir yapılandırma şöyle görünür:

[network_access]
allowed_navigation_hosts = ["app.example.com"]
allowed_sources = ["https://api.app.example.com"]

Ana bilgisayarlarınızı ve sunucularınızı [network_access] bölümüne ekledikten sonra, shopify app deploy komutunu çalıştırın ve değişiklikleri uygulamak için yeni sürümü yayınlayın.

Bir uyarı: 20 ana bilgisayar sınırı uygulamanız bir CDN, izleme uç noktası ve birden fazla birinci taraf hizmetten yüklüyorsa oldukça sıkı. Kaynakları dikkatli planlayın. Shopify CLI ayrıca kısa süre önce tema uygulaması uzantılarını ana bilgisayar başına [extensions.capabilities.network_access] bloğundan uzaklaştırdı: shopify.app.toml dosyasında [network_access] allowed_sources ile ağ kaynakları bildirin.

Sunucusuz ana bilgisayarlar için ASN tabanlı kurallar

Statik IP adreslerine sahip olmayan uygulamalar (sunucusuz platformlardaki uygulamalar gibi) artık barındırma sağlayıcısının özerk sistem numaralarını (ASN'ler) Dev Panosi'ndeki uygulamanın IP izin listesine ekleyebilir.

ASN, özerk sistemi tanımlar: bir kuruluşun yönettiği ağ, örneğin bir barındırma sağlayıcısı veya ISP. Her istek için Shopify, kaynak IP adresinin ASN'sini ve ülkesini MaxMind'in GeoLite verilerine karşı görünür.

Pratikte:

  • Sağlayıcınızın ASN'sini bulun. Vercel için AS54113'tür (Fastly, bunların kenar ağı). Cloudflare Workers için AS13335'tir. AWS Lambda us-east-1 içinde, ilgili ASN AS16509'dur.
  • Uygulamanızın Ayarları sayfasının IP izin listesi bölümü IP adreslerine veya Ağlara (ASN) izin vermenize sağlar. Ağlar için en fazla 10 ASN girin ve bunları en fazla 10 ülke ile sınırlayın.
  • Son trafiğe karşı test edin, sonra uygulamayı açın. İzin verilen ağlarınız dışından gelen istekler 403 durum kodu ile başarısız olur.

Ülke kapsamı adımı önemlidir. Uygulamanız yalnızca us-east-1'de çalışıyorsa, bulut sağlayıcısının çalıştığı her bölgeden ASN trafiğine izin vermenin bir nedeni yoktur. Mümkün olduğunda IP adreslerine izin listesi ekleyin ve ASN'lere izin listesi eklerseniz, yalnızca uygulamanızın çalıştığı ülkeleri listeleyin.

Statik ve dinamik çıkış: hangi yaklaşımı kullanacağınız

Barındırma türüÖnerilen yaklaşımUzlaşma
VPS / özel sunucuStatik IP veya CIDR bloğuEn dar patlama yarıçapı, denetim açısından en basit
Sabit çıkış IP'li kapsayıcı (örn. Railway, Render statik IP eklentisiyle)Statik IP veya CIDRYukarıdakiyle aynı; sağlayıcınızın NAT ağ geçidi IP'sini kontrol edin
Sunucusuz (Lambda, Workers, Vercel Functions)ASN + ülke kısıtlamasıTek bir IP'den daha geniş; tüm bulut sağlayıcısı aralığını kapsar
NAT ağ geçidiyle yönetilen bulut üzerinde Kubernetes (EKS, GKE)NAT ağ geçidinin statik IP'siPod aralığı değil, ağ geçidinin genel IP'sini kullanın
Öngörülemeyen çıkışlı çok bölgeli sunucusuzBölge başına ASN, her ASN girişi için bir ülkeEn fazla 10 ASN + ülke çifti; büyük dağıtımlarda 10 giriş sınırına ulaşabilir

Gerçek hayat komplikasyonu: arka plan işçileri, cron işleri ve kuyruk tüketicileri genellikle ana web işleminden farklı bir ana bilgisayar veya kapsayıcıda çalışır. Önemli uygulama konuları, giden genel IP adreslerini belirleme, birden fazla üretim sunucusu, arka plan işçileri, cron işleri ve Shopify API'leriyle iletişim kuran diğer hizmetleri işleme içerir. İzin listesini doldurmadan önce Admin API'yi çağıran her işlemi numaralandırın. Uygulamaya 403 zorunluluğundan kaynaklanan HTTP düzeyinde OAuth hatasına benzer şekilde görünür, bu nedenle bir işçiyi kaçırmak kafa karıştırıcı günlükler üretecektir.

Shopify, onaylanmamış ağlardan Admin API çağrıları için HTTP 403 belgeler; yeni 403'leri otomatik olarak OAuth veya erişim kapsamı sorunu olarak değil ağ ilkesi araştırması olarak ele alın.

Gönderişten önce dev store'da test etme

Shopify, geliştiricilerin uygulamanızın ağ erişim yapılandırmasını dev store'da test etmelerine izin veren yeni bir özellik önizlemesi ekledi. Doğru ağların listelenip listelenmediğini doğrular ve eksik ana bilgisayarları veya sunucuları bulur.

Özellik önizlemesi tanımlayıcısı network_access_testing'dir. Ağ erişim testi önizlemesi, uygulamanızın network_access yapılandırmasını çevrimiçi mağazada test etmenize yardımcı olur. Ayrıntılar için "Uygulamanızın ağ erişimini bildirme" belgelerine bakın.

Önizlemede gerçekten olan şey:

  • Önizlemesi açık olan dev store'da Content-Security-Policy-Report-Only başlığı görürsünüz ve bildirilmemiş ana bilgisayarlar konsol uyarıları olarak gösterilir.
  • Önizleme yalnızca uyarır, hiçbir şeyi engellemez.
  • Gezinti bağlantıları için, özellik önizlemesi bildirilen ağ erişim listesinde olmayan ana bilgisayarlara bağlantılar için çıkış uyarısını gösterir ve vitrin sayfası bildirimlenmemiş sunucudan yüklendiğinde veya ilişki kurduğunda konsol uyarısı kaydeder.

Pratik iş akışı:

  1. Tüm kaynakları tahmin etmek için shopify.app.toml dosyasına bir [network_access] bloğu ekleyin.
  2. Yeni bir dev store oluşturun ve network_access_testing özellik önizlemesini etkinleştirin.
  3. Uygulamayı dev store'da yükleyin ve tüm yüzeyleri dolaşın: vitrin, ödeme, uygulama giriş sayfası, uygulama proxy sayfaları.
  4. Tarayıcı konsolunu izleyin. Herhangi bir CSP-Report-Only uyarısı kaçırdığınız bir kaynak gösterir.
  5. Eksik girişleri allowed_sources'a ekleyin, shopify app deploy ile yeniden dağıtın ve tekrarlayın.
  6. Ayrı olarak, Dev Panosi'nde, IP izin listesi uygulamasını açmadan önce son trafiğe karşı test et seçeneğini kullanın. GraphQL API paneline gidebilir, engellenen her IP'yi arayabilir ve istekleri görüntüleyebilirsiniz.

Bilinen boşluk: dev store bir mağazada şeylerin yüklüneceğini söyler, ancak her satıcının kurulumu biraz farklıdır, bu nedenle diğer mağazalarda hiçbir şeyin engellenmeyeceğini gerçekten kanıtlamaz. Dev store testi gerekli ancak yetersiz bir çektir. Uygulama geçişini açmadan önce Dev Panosi'nde üretime açık uygulamanızın gerçek istek günlüğüne karşı "son trafiğe karşı test et" özelliğini çalıştırın.

Satıcı görünürlüğü ve App Store listesinde ne anlama geldiği

Satıcılar artık uygulamanızın güvenlik kurulumunu Ayarlar > Uygulamalar'da görebilir: jetonların son kullanma tarihi ve IP izin listesi. Bu bugün canlı, gelecekteki bir değişiklik değil. Herhangi bir satıcı yüklü uygulamalarını gezinirken, hangi uygulamaların izin listesi etkin olduğunu görebilir. 20 Kasım'da etkilenen uygulamalar Shopify App Store'dan kaldırılacak, yeni yüklemelerden engellenecek ve satıcıların Ayarlar > Uygulamalar altında işaretlenecek, mevcut yüklemeler çalışmaya devam edecek.

Son madde önemli: mevcut yüklemeler 20 Kasım'da bozulmaz. Mevcut yüklemeler için tam cut-off 1 Nisan 2027'dir. Piste gömülü sahibi oldum, ancak satıcı tarafından görülen bayrak ve App Store kaldırması bu tarihten çok önce gerçek ticari risklerdir.

Süresi dolan çevrimdışı erişim jetonlarıyla ilişki

Bu güvenlik itişi, çevrimdışı jeton son kullanma tarihini de hızlandıran Ekim 2026 dalgasının parçasıdır. İki gereksinim bağımsızdır: Shopify'nin uygulama zamanlaması ayrıca çevrimdışı erişim jetonlarının süresini doldurmasını içerir, ancak IP izin listesi bir jetonun yenilenmesini sağlamaz ve jeton rotasyonu onaylanmamış ağı düzeltmez. Ağ kaynağı artık bağımsız bir gereksinimdir. Her ikisi aynı anda işlemeniz gerekiyorsa çevrimdışı jeton geçişi adımları hakkındaki önceki yazıma bakın.

Uygulamayı açmadan önce kontrol listesi

  • Admin API'yi çağıran her işlemi (web sunucusu, arka plan işçi, cron, kuyruk tüketicisi, toplu işlem çalıştırıcısı) harita yapın ve çıkış IP'sini veya ASN'sini kaydedin.
  • Doğru izin listesi türünü seçin: sabit çıkış için statik IP/CIDR, sunucusuz için ASN artı ülke.
  • Uygulamanızın shopify.app.toml dosyasına bir [network_access] bloğu ekleyin, dağıtın ve network_access_testing önizlemesiyle dev store'da test edin.
  • Dev Panosi'nde "son trafiğe karşı test et" komutunu çalıştırın ve tüm beklenmedik blokları temizleyin.
  • Uygulamayı açın. Uygulamanızın hata günlüklerini ilk 30 dakika içinde 403'ler için izleyin.
  • Herhangi bir yeni 403'ü OAuth sorunu olarak değil, ağ ilkesi eksikliği olarak ele alın.
shopifyapp-securityshopify-cliapiserverless

Sıkça sorulan sorular

Özel uygulamalar (App Store'dan değil URL üzerinden yüklenmiş) IP izin listesi gerektirir mi?

Özel uygulamalar zorunlu gereksinimden muaftır, ancak Shopify onlara da IP izin listesi eklemeyi şiddetle tavsiye eder. İzin listesi olmayan sızan bir özel uygulama jetonu, halka açık uygulama jetonu kadar kötüye kullanılabilir.

Statik IP'leri ve ASN kurallarını aynı izin listesinde karıştırabilirim mi?

Hayır. Shopify'nin izin listesi şu anda IP adreslerine veya Ağlara (ASN) izin verir, ancak aynı anda her ikisine birden izin vermez. Barındırmanıza uygun modu seçin ve tüm çıkış kaynaklarınızı o mod içinde yapılandırın.

Shopify, IP izin listesi tarafından engellendiğinde ne HTTP durum kodu döndürür?

Shopify, izin listede olmayan bir IP adresi veya ağdan kaynaklanan herhangi bir Admin API isteği için 403 durum kodu döndürür. Bu HTTP düzeyinde OAuth veya kapsam hatasına benzer şekilde görünür, bu nedenle uygulamayı açtıktan sonra beklenmedik 403'ler gördüğünüzde önce izin listesi yapılandırmasını kontrol edin.

Yedi yıllık Shopify, tek sayfada.

Roller, projeler, teknoloji yığını ve sertifikalar özgeçmişte.

Özgeçmiş PDF indir LinkedIn