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.tomldosyası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]bildirimlerininetwork_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
| Tarih | Ne olur |
|---|---|
| 12 Kasım 2026 | İzin listesi olmayan halka açık uygulamalardan toplu sorgular ve mutasyonlar engellenir |
| 20 Kasım 2026 | Uygulama App Store'dan kaldırılır, yeni yüklemelerden engellenir, Ayarlar > Uygulamalar'da işaretlenir |
| 15 Ocak 2027 | Satı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-1iç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şım | Uzlaşma |
|---|---|---|
| VPS / özel sunucu | Statik IP veya CIDR bloğu | En 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 CIDR | Yukarı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'si | Pod aralığı değil, ağ geçidinin genel IP'sini kullanın |
| Öngörülemeyen çıkışlı çok bölgeli sunucusuz | Bölge başına ASN, her ASN girişi için bir ülke | En 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-Onlybaş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ışı:
- Tüm kaynakları tahmin etmek için
shopify.app.tomldosyasına bir[network_access]bloğu ekleyin. - Yeni bir dev store oluşturun ve
network_access_testingözellik önizlemesini etkinleştirin. - Uygulamayı dev store'da yükleyin ve tüm yüzeyleri dolaşın: vitrin, ödeme, uygulama giriş sayfası, uygulama proxy sayfaları.
- Tarayıcı konsolunu izleyin. Herhangi bir
CSP-Report-Onlyuyarısı kaçırdığınız bir kaynak gösterir. - Eksik girişleri
allowed_sources'a ekleyin,shopify app deployile yeniden dağıtın ve tekrarlayın. - 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.tomldosyasına bir[network_access]bloğu ekleyin, dağıtın venetwork_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.
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.