Referans Guvenlik Modelleri

Güvenlik, rol, rate limit ve koruma alanları

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Bu tablo sabit committeki Pydantic modeli ve JSON Schema’dan üretilmiştir. Kullanım açıklamaları: Kimlik doğrulama, yetkiler, koruma.

“Zorunlu” alanın JSON’da bulunma zorunluluğudur; null kabulü ayrı bir tür kuralıdır. Model() varsayılanı, ilgili modelin bu sayfalardaki varsayılanlarıyla oluşturulmasıdır. Boş liste/nesne varsayılanları her model için ayrı üretilir. —, varsayılan veya o sütunda şema sınırı olmadığını belirtir.

Tablodaki sınırlara ek olarak alanlar arası doğrulayıcılar vardır: izin/public seçimi, URL/host güvenliği, tenant/owner sütunları, cache/idempotency/transaction birlikteliği, şema çakışmaları ve güvenli regex bunlara dahildir. JSON Schema doğrulaması tek başına forge validate yerine geçmez. extra="forbid" nedeniyle bilinmeyen alanlar reddedilir.

SecurityConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
api_key_header	string	Hayır	"X-API-Key"	—
bootstrap_enabled	boolean	Hayır	false	—
bootstrap_admin_key	string | null	Hayır	null	—
bootstrap_one_time	boolean	Hayır	true	—
jwt_enabled	boolean	Hayır	false	—
jwt_provider	enum ["local_hs256","jwks"]	Hayır	"local_hs256"	—
jwt_secret	string | null	Hayır	null	—
jwt_exp_minutes	integer	Hayır	60	min=1
jwt_jwks_url	string | null	Hayır	null	—
jwt_issuer	string | null	Hayır	null	—
jwt_audience	string | list[string] | null	Hayır	null	—
jwt_algorithms	list[string]	Hayır	["RS256","ES256","EdDSA"]	—
jwt_subject_claim	string	Hayır	"sub"	—
jwt_roles_claim	string	Hayır	"roles"	—
jwt_permissions_claim	string	Hayır	"permissions"	—
jwt_tenant_claim	string	Hayır	"tenant_id"	—
jwt_project_claim	string	Hayır	"project"	—
jwt_require_project_claim	boolean	Hayır	true	—
jwt_trust_roles_claim	boolean	Hayır	false	—
jwt_trust_permissions_claim	boolean	Hayır	false	—
jwt_trust_tenant_claim	boolean	Hayır	false	—
jwks_cache_ttl_seconds	integer	Hayır	600	min=30
jwks_timeout_seconds	number	Hayır	5.0	max=30; >=0
jwks_max_response_bytes	integer	Hayır	1048576	min=4096; max=16777216
jwks_allow_private_networks	boolean	Hayır	false	—
jwks_allow_insecure_http	boolean	Hayır	false	—
allow_query_api_key	boolean	Hayır	false	—
allow_websocket_query_api_key	boolean	Hayır	false	—
require_https	boolean	Hayır	false	—
allowed_ips	list[string]	Hayır	[]	—
denied_ips	list[string]	Hayır	[]	—
idempotency_header	string	Hayır	"Idempotency-Key"	—
api_key_cache_ttl_seconds	number	Hayır	2.0	min=0.0; max=60.0
api_key_cache_max_entries	integer	Hayır	10000	min=100; max=1000000

RoleConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
permissions	list[string]	Hayır	[]	—
inherits	list[string]	Hayır	[]	—

RateLimitConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
enabled	boolean	Hayır	true	—
pre_auth_enabled	boolean	Hayır	true	—
pre_auth_requests	integer	Hayır	1200	min=1
pre_auth_window_seconds	integer	Hayır	60	min=1
pre_auth_burst	integer | null	Hayır	300	min=1
requests	integer	Hayır	120	min=1
window_seconds	integer	Hayır	60	min=1
backend	enum ["memory","redis"]	Hayır	"memory"	—
burst	integer | null	Hayır	null	min=1
route_requests	integer | null	Hayır	null	min=1
route_window_seconds	integer | null	Hayır	null	min=1
route_burst	integer | null	Hayır	null	min=1
memory_max_buckets	integer	Hayır	50000	min=100
memory_idle_ttl_seconds	integer	Hayır	600	min=10
memory_cleanup_interval_seconds	integer	Hayır	30	min=1
fail_open	boolean	Hayır	false	—

ProtectionConfig

Alan	Tür	Zorunlu	Varsayılan	Şema sınırları
max_request_body_bytes	integer	Hayır	8388608	min=1024
trusted_proxy_cidrs	list[string]	Hayır	[]	—
max_concurrent_requests	integer	Hayır	1000	min=1
request_timeout_seconds	number	Hayır	30.0	>=0
trusted_hosts	list[string]	Hayır	["*"]	—
gzip_minimum_size	integer	Hayır	1024	min=0
reject_when_saturated	boolean	Hayır	true	—
max_queue_wait_seconds	number	Hayır	1.0	min=0

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/framework/config.py
• main/schemas/project.schema.json
• main/framework/validation.py

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım