T-SOFT/Uygulama Geliştirme/Ağ İzin Listesi

Ağ İzin Listesi

Uygulamanız T-SOFT API'sine hangi sunuculardan bağlanıyorsa onları bildirin. Liste dolduğunda uygulama sırrınız ya da token'ınız sızsa bile, listede olmayan bir ağdan token alınamaz ve Admin API çağrılamaz.

Kontrol iki yerde yapılır:

  • Token alırken. login.tsoft360.com/oauth/token isteği listedeki bir adresten gelmelidir.
  • Her Admin API isteğinde. Token başka bir yere taşınsa bile, mağaza isteğin kaynağını aynı listeyle karşılaştırır. Liste token'ın içinde imzalı olarak taşınır.

Nasıl ayarlanır

Kaynaklarınızı görün

Partner panelinde uygulamanın Ağ erişimi sekmesini açın. Son 7 günde görülen kaynaklar tablosu, uygulamanızın token aldığı adresleri ve kaç istek yaptığını gösterir.

Listeyi doldurun

Sunucularınızın IP adreslerini ya da aralıklarını ekleyin. Tablodaki bir adresi Ekle ile listeye alabilirsiniz. Sunucusuz ya da IP'si sürekli değişen bir altyapıdaysanız (Cloudflare Workers, AWS Lambda gibi) bulut sağlayıcısının ASN'ini ekleyin.

Tabloyu kontrol edip kaydedin

Kaydetmeden önce tabloda Listede değil rozetli adres kalmadığından emin olun. Liste kaydedildiği anda geçerlidir: listede olmayan kaynaktan gelen token isteği ve API çağrısı 403 döner. Tabloda listede olmayan bir adres varken kaydederseniz panel sizden onay ister.

Değişiklik yeni alınan token'larla geçerli olur. Token'lar 60 dakika yaşadığı için mağazalara yansıması en geç bir saat sürer.

Kurallar

Sınır
IP adresi ve aralıkEn çok 20. Tek adres (203.0.113.10) ya da CIDR aralığı (203.0.113.0/24, 2001:db8::/48).
En geniş aralıkIPv4 için /16, IPv6 için /32. Daha geniş aralıklar kabul edilmez.
ASNEn çok 10. 13335 ya da AS13335 biçiminde. Yalnız aşağıdaki bulut sağlayıcıları kabul edilir.
Boş listeToken alınamaz. Liste zorunludur (aşağıdaki Ne zaman zorunlu bölümü).

Bir istek, kaynak IP'si listedeki bir adrese ya da aralığa düşüyorsa ya da kaynağın ASN'i listedeyse kabul edilir.

Kaynak nasıl belirlenir

Kaynak IP'si, isteğin bağlantısından belirlenir. İstekte gönderdiğiniz X-Forwarded-For ya da benzeri başlıklar dikkate alınmaz. Mağaza Cloudflare arkasındaysa gerçek istemci IP'si yalnız isteğin T-SOFT'un kendi Cloudflare yapılandırmasından geçtiği doğrulandığında kullanılır; başka bir Cloudflare hesabından (ör. bir Worker'dan) gönderilen CF-Connecting-IP başlığı kaynağı değiştirmez.

İzinli ASN'ler

ASN yalnız şu bulut sağlayıcıları için girilebilir; başka bir ASN kaydedilmek istendiğinde 422 döner:

SağlayıcıASNAralıkların kaynağı
Cloudflare (Workers dahil)AS13335cloudflare.com/ips
AWSAS16509, AS14618ip-ranges.json
Google CloudAS396982cloud.json
Microsoft AzureAS8075Azure Service Tags, AzureCloud etiketi

Bir isteğin ASN'i, kaynak IP'si bu sağlayıcıların resmi IP aralığı listelerinde aranarak bulunur. Aynı yol hem token isteğinde (login.tsoft360.com/oauth/token) hem Admin API isteğinde kullanılır; istekte ASN bildiren başlıklar dikkate alınmaz. AWS'nin iki ASN'i aynı ağ sayılır, birini eklemeniz yeter. Listeler T-SOFT tarafında düzenli olarak yenilenir; sağlayıcının yeni eklediği bir aralık kısa bir süre tanınmayabilir.

ASN, o sağlayıcının bütün müşterilerini kapsar: AS16509 eklerseniz AWS'de sunucusu olan herkes ağ kontrolünü geçer, korumayı yalnız uygulama sırrınız sağlar. Sabit çıkış IP'si verebiliyorsanız (NAT gateway, egress IP) IP listesini kullanın.

Barındırma sağlayıcınız bu listede yoksa (ör. kendi sunucunuz, Hetzner, DigitalOcean) sunucunuzun IP adresini ya da aralığını girin.

Reddedilen istek

Listede olmayan bir kaynaktan token isterseniz:

{
  "error": "access_denied",
  "error_description": "This app may not request tokens from this network."
}

Uygulamanın listesi boşsa token isteği yine 403 döner:

{
  "error": "access_denied",
  "error_description": "Network allowlist required: declare the IP/CIDR ranges or ASNs this app calls from in the partner panel before requesting tokens."
}

Admin API isteği listede olmayan kaynaktan geldiğinde 403 döner. İkisi de kalıcıdır, tekrar denemek sonucu değiştirmez. Sunucunuzun çıkış IP'sini listeye ekleyin.

Sunucu taşırken ya da bulut sağlayıcısı değiştirirken yeni çıkış IP'lerini önce listeye ekleyin, trafiği sonra taşıyın.

Ne zaman zorunlu

  • Markete gönderim. Uygulama sırrı oluşturulmuş bir uygulama, ağ izin listesi olmadan markete gönderilemez. Liste, market sayfasındaki gönderim kontrol listesinde yer alır.
  • Token almak. Ağ izin listesi her uygulama için zorunludur; yayında olan, geliştirmede olan ya da yalnız belirli mağazalara dağıtılan uygulamalar da dahil. Listesi boş bir uygulama client_credentials ile token alamaz ve 403 access_denied (Network allowlist required) yanıtı alır. Bu kural T-SOFT'un kendi uygulamaları için de geçerlidir; yalnız uygulama olmayan T-SOFT sistem istemcileri muaftır.
  • Partner paneli. Listesi boş ve sırrı oluşturulmuş uygulamalarda panel, liste tanımlanmadan token alınamayacağını gösterir. Son 7 günde görülen kaynaklar tablosu reddedilen istekleri de listeler; listeyi buradan doldurabilirsiniz.