Veri Modeli, API ve Olay Sözleşmeleri — Trust Pro Cloud & Application Security

Tüm ürün ailelerinin entegrasyon kurabilmesi için bulut ve uygulama varlıklarına tekil kimlik vermek gerekir. Canonical veri modeli her sinyali zorla tek tabloya dönüştürmez: kaynak olayları olduğu gibi saklanır; analiz katmanında kararlı varlık ve ilişki anahtarlarına bağlanır.

Varlık	Önerilen temel alanlar
Tenant	tenant_id, region_policy, retention_policy, kms_key_ref
CloudAsset	asset_id, provider_id, type, region, observed_at, owner, tags
Application	app_id, repos[], services[], criticality, data_class
Identity	principal_id, provider, type, effective_permissions, last_seen
Deployment	deploy_id, commit, artifact_digest, env, release_gate
Finding	finding_id, fingerprint, severity, exploitability, confidence, status
Evidence	evidence_ref, source_uri, hash, observed_at, redaction_level
PolicyDecision	policy_id, version, input_hash, decision, effective_scope
Remediation	ticket_id, assignee, change_ref, retest_ref, closure_state
Incident	case_id, timeline_refs[], response_approval, custody_hash
AIRecommendation	model_version, prompt_template, evidence_refs, proposed_action, confidence
Integration	connector_id, scopes, last_success_at, lag, health_status

Olay sözleşmesi: cloud.security.finding.created

API katmanında güvenlik şartları

Teknik API başlığı	Gereksinim
Kimlik	OAuth2/OIDC, mTLS opsiyonları, signed service-to-service token.
Yetki	RBAC+ABAC; nesne ve tenant bazında row-level isolation.
Hız & kota	Tenant, role, endpoint ve işleme sınıfına göre rate budget.
Idempotency	Bulgu/aksiyon import ve iş emri create için idempotency key.
Listeleme	Cursor pagination ve filtre predicate whitelist.
Event export	Webhook signing, retry, replay window ve DLQ.
Audit	Who, what, when, policy_version ve outcome bilgisi.
Sürüm	SemVer + compatibility + breaking change notice.
Veri yaşam döngüsü	Export/delete request, privacy review ve retention policy.
Aksiyon onayı	Riskli write API için ayrı approval token ve revocation.