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/tokenisteğ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.
Kurallar
| Sınır | |
|---|---|
| IP adresi ve aralık | En çok 20. Tek adres (203.0.113.10) ya da CIDR aralığı (203.0.113.0/24, 2001:db8::/48). |
| En geniş aralık | IPv4 için /16, IPv6 için /32. Daha geniş aralıklar kabul edilmez. |
| ASN | En çok 10. 13335 ya da AS13335 biçiminde. Yalnız aşağıdaki bulut sağlayıcıları kabul edilir. |
| Boş liste | Token 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ı | ASN | Aralıkların kaynağı |
|---|---|---|
| Cloudflare (Workers dahil) | AS13335 | cloudflare.com/ips |
| AWS | AS16509, AS14618 | ip-ranges.json |
| Google Cloud | AS396982 | cloud.json |
| Microsoft Azure | AS8075 | Azure 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.
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.
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_credentialsile token alamaz ve403 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.