OmniRoute/docs/i18n/te/docs/security/COMPLIANCE.md

Compliance & Audit (తెలుగు)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

ప్రామాణిక మూలం: src/lib/compliance/, src/app/api/compliance/ చివరిగా నవీకరించబడింది: 2026-06-28 — v3.8.40

OmniRoute పరిపాలనా చర్యలు, ప్రామాణీకరణ ఈవెంట్లు, ప్రొవైడర్ క్రెడెన్షియల్ జీవితచక్ర మార్పులు మరియు MCP టూల్ ఆహ్వానాలను SQLite-ఆధారిత ఆడిట్ పట్టికల్లో నమోదు చేస్తుంది. ఏమేమి లాగ్ చేయబడతాయి, అవి ఎక్కడ ఉంటాయి, ఎంతకాలం నిల్వ ఉంచబడతాయి, API కీలు లాగింగ్ నుండి ఎలా వైదొలగగలవు మరియు డేటాను ఎలా క్వెరీ చేయాలి అనే అంశాలను ఈ పేజీ వివరిస్తుంది.

దీని అమలు src/lib/compliance/index.ts (T-43 — "అనుగుణ్యత నియంత్రణలు") మరియు src/lib/compliance/providerAudit.tsలో ఉంటుంది. ఆడిట్ రైట్లు ఎప్పుడూ ఎర్రర్ను త్రో చేయవు: ఏదైనా వైఫల్యం సంభవించినప్పుడు కాల్ నిశ్శబ్దంగా విస్మరించబడుతుంది, తద్వారా ఆడిట్ లాగింగ్ ప్రధాన రిక్వెస్ట్ ప్రవాహానికి అంతరాయం కలిగించదు.

లాగ్ చేయబడేవి

పరిపాలనా ఆడిట్ ఈవెంట్లు (audit_log)

logAuditEvent({ action, actor, target, details, ... })కు చేసే ప్రతి కాల్ ఒక వరుసను సృష్టిస్తుంది. చర్య స్ట్రింగ్లు domain.verb (లేదా domain.verb.outcome) నమూనాను అనుసరిస్తాయి. సోర్స్ ట్రీలో నిర్ధారించబడిన చర్య రకాలు:

చర్య	మూలం
auth.login.success	src/app/api/auth/login/route.ts
auth.login.failed	src/app/api/auth/login/route.ts
auth.login.locked	src/app/api/auth/login/route.ts
auth.login.error	src/app/api/auth/login/route.ts
auth.login.misconfigured	src/app/api/auth/login/route.ts
auth.login.setup_required	src/app/api/auth/login/route.ts
auth.logout.success	src/app/api/auth/logout/route.ts
provider.credentials.created	src/app/api/providers/route.ts
provider.credentials.updated	src/app/api/providers/[id]/route.ts
provider.credentials.revoked	src/app/api/providers/[id]/route.ts
provider.credentials.batch_revoked	src/app/api/providers/route.ts
sync.token.created	src/app/api/sync/tokens/route.ts
sync.token.revoked	src/app/api/sync/tokens/[id]/route.ts
compliance.cleanup	src/lib/compliance/index.ts

ప్రతి ఎంట్రీ action, actor (డిఫాల్ట్గా "system"), target, details/metadata (JSON), ip_address, resource_type, status, request_id మరియు timestampను నమోదు చేస్తుంది. సున్నితమైన కీలు (apiKey, accessToken, refreshToken, password, *token/*secret/*apikeyతో సరిపోలే ఏదైనా, మొదలైనవి) వరుస రాయబడటానికి ముందు పునరావృతంగా "[redacted]"తో మాస్క్ చేయబడతాయి.

MCP టూల్ కాల్లు (mcp_tool_audit)

ప్రతి MCP టూల్ ఆహ్వానం open-sse/mcp-server/audit.ts ద్వారా ఒక వరుసను రాస్తుంది. స్కీమా (src/lib/db/migrations/002_mcp_a2a_tables.sql నుండి):

కాలమ్	గమనికలు
id	స్వయంచాలకంగా పెరుగుతుంది
tool_name	MCP టూల్ ఐడెంటిఫైయర్
input_hash	ఇన్పుట్ యొక్క sha256 (పేలోడ్ నిల్వ చేయబడదు)
output_summary	సంక్షిప్తంగా కుదించిన సారాంశం
duration_ms	గడిచిన వాస్తవ సమయం
api_key_id	కాలర్ (శూన్యంగా ఉండవచ్చు)
success	1 / 0
error_code	వైఫల్యంపై తుది ఎర్రర్ కోడ్
created_at	ISO టైమ్స్టాంప్

రిక్వెస్ట్ / వినియోగ లాగ్లు

ఇవి కార్యాచరణ టెలిమెట్రీకి చెందినవి (ఖచ్చితంగా పరిపాలనా ఆడిట్ కాదు), కానీ ఇవి అదే నిల్వకాల పైప్లైన్ను పంచుకుంటాయి:

• usage_history — ప్రతి రిక్వెస్ట్కు వినియోగ సమగ్రత
• call_logs — ప్రతి రిక్వెస్ట్కు పూర్తి లాగ్ (వరుస పరిమితికి లోబడి ఉంటుంది, క్రింద చూడండి)
• proxy_logs — ప్రాక్సీ ట్రాఫిక్ లాగ్ (వరుస పరిమితికి లోబడి ఉంటుంది)
• request_detail_logs — పాత వివరణాత్మక రిక్వెస్ట్ లాగ్ (ఉనికిలో ఉంటే ఇప్పటికీ తొలగించబడుతుంది)

నిల్వ స్కీమా

మొదటిసారి ఉపయోగించినప్పుడు ensureAuditLogSchema() ద్వారా audit_log అవసరమైన సమయంలో సృష్టించబడుతుంది:

CREATE TABLE IF NOT EXISTS audit_log (
  id            INTEGER PRIMARY KEY AUTOINCREMENT,
  timestamp     TEXT NOT NULL DEFAULT (datetime('now')),
  action        TEXT NOT NULL,
  actor         TEXT NOT NULL DEFAULT 'system',
  target        TEXT,
  details       TEXT,
  ip_address    TEXT,
  resource_type TEXT,
  status        TEXT,
  request_id    TEXT,
  metadata      TEXT
);

timestamp, action, actor, resource_type, status, మరియు request_idపై ఇండెక్స్లు సృష్టించబడతాయి. పాత DBలలో లేని కాలమ్లు అవసరమైనప్పుడు ALTER TABLE ద్వారా జోడించబడతాయి.

నిలుపుదల & శుభ్రపరచడం

రెండు వేర్వేరు నిలుపుదల వ్యవధులు పాటించబడతాయి:

పర్యావరణ వేరియబుల్	డిఫాల్ట్	దేనికి వర్తిస్తుంది
APP_LOG_RETENTION_DAYS	7	audit_log, mcp_tool_audit
CALL_LOG_RETENTION_DAYS	7	usage_history, call_logs, proxy_logs, request_detail_logs
CALL_LOGS_TABLE_MAX_ROWS	100000	call_logs కోసం వరుసల పరిమితి కుదింపు
PROXY_LOGS_TABLE_MAX_ROWS	100000	proxy_logs కోసం వరుసల పరిమితి కుదింపు

cleanupExpiredLogs() నిలుపుదల ప్రక్రియను అమలు చేస్తుంది. సర్వర్ ప్రారంభమైనప్పుడు ఇది src/instrumentation-node.ts నుండి అమలు చేయబడుతుంది. ప్రతి అమలు ఒక్కో పట్టికకు సంబంధించిన తొలగింపు సంఖ్యలతో compliance.cleanup ఆడిట్ ఈవెంట్ను లాగ్ చేస్తుంది. ఎక్కువసేపు రైట్ లాక్లు ఏర్పడకుండా ఉండేందుకు ప్రాక్సీ/కాల్ లాగ్ కుదింపు బ్యాచ్లుగా (BATCH_SIZE = 5000) జరుగుతుంది.

మాన్యువల్ అభ్యర్థన-చరిత్ర శుభ్రపరచడం నిలుపుదల ప్రక్రియకు వేరుగా ఉంటుంది. అభ్యర్థన లాగ్ల పేజీ POST /api/settings/purge-request-historyను కాల్ చేస్తుంది; ఇది call_logs, పాత request_detail_logs, మరియు ${DATA_DIR}/call_logs/ కింద ఉన్న స్థానిక అభ్యర్థన ఆర్టిఫాక్ట్లను తొలగిస్తుంది.

డిఫాల్ట్లు src/lib/logEnv.tsలో నిర్వచించబడ్డాయి (DEFAULT_APP_LOG_RETENTION_DAYS = 7, DEFAULT_CALL_LOG_RETENTION_DAYS = 7).

noLog నిలిపివేత ఎంపిక (ఒక్కో API కీకి)

API కీల దిగువస్థాయి కాల్ ట్రాఫిక్ లాగ్ కాకుండా ఉండేందుకు వాటికి ఫ్లాగ్ను అమర్చవచ్చు. ఈ ఫ్లాగ్ api_keys పట్టికలో (no_log INTEGER DEFAULT 0) ఉంటుంది మరియు వేగవంతమైన పాత్ లుకప్ల కోసం ఇన్-మెమరీ సెట్లోనూ ప్రతిబింబించబడుతుంది.

# లాగ్ చేయని కీని సృష్టించండి (నిర్వహణ ప్రమాణీకరణ అవసరం)
curl -X POST http://localhost:20128/api/keys \
  -H "Cookie: auth_token=..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Privacy key", "noLog": true}'

సహాయకాలు (src/lib/compliance/index.ts):

• setNoLog(apiKeyId, true|false) — ఇన్-మెమరీ ఎంట్రీని ఆన్ లేదా ఆఫ్ చేయండి
• isNoLog(apiKeyId) — అభ్యర్థన పాత్లో తనిఖీ చేయబడుతుంది; అది సాధ్యం కాకపోతే api_keys.no_log నుండి 30 s పాటు క్యాష్ చేసిన రీడ్ను ఉపయోగిస్తుంది
• NO_LOG_API_KEY_IDS (పర్యావరణ వేరియబుల్, కామాలతో వేరు చేసినవి) — బూట్ సమయంలో ఇన్-మెమరీ సెట్లో ముందుగానే లోడ్ చేయబడతాయి; కాలమ్ను నేరుగా మార్చలేనప్పుడు ఉపయోగకరం

నిర్వాహక ఆడిట్ ఈవెంట్లు (లాగిన్, ప్రొవైడర్ మార్పులు, MCP టూల్ కాల్లు మొదలైనవి) noLog వల్ల ప్రభావితం కావు — ఒక్కో అభ్యర్థనకు సంబంధించిన ట్రాఫిక్ లాగింగ్ మాత్రమే నిలిపివేయబడుతుంది.

REST API

ఎండ్పాయింట్	పద్ధతి	వివరణ	ప్రామాణీకరణ
/api/compliance/audit-log	GET	ఫిల్టర్లతో పేజీలుగా విభజించిన అడ్మిన్ ఆడిట్ నమోదులు	management
/api/mcp/audit	GET	పేజీలుగా విభజించిన MCP సాధన ఆడిట్ నమోదులు	(open-sse)
/api/mcp/audit/stats	GET	సమగ్రపరచిన MCP ఆడిట్ గణాంకాలు	(open-sse)

ప్రస్తుతం CSV ఎగుమతి ఎండ్పాయింట్ అందించబడటం లేదు — డ్యాష్బోర్డ్ నుండి ఎగుమతి చేయండి లేదా SQLite డేటాబేస్ను నేరుగా క్వెరీ చేయండి.

/api/compliance/audit-logను క్వెరీ చేయడం

మద్దతు ఉన్న క్వెరీ పారామీటర్లు (అన్నీ ఐచ్ఛికం, టెక్స్ట్ ఫిల్టర్లన్నీ LIKE %value% సరిపోలికను ఉపయోగిస్తాయి):

• action, actor, target, resourceType (లేదా resource_type), status, requestId (లేదా request_id)
• from / since, to / until — ISO టైమ్స్టాంప్లు
• limit (డిఫాల్ట్ 50, కనిష్ఠం 1, గరిష్ఠం 500)
• offset (డిఫాల్ట్ 0, గరిష్ఠం 10_000)

ప్రతిస్పందన ఒక JSON అరే. పేజినేషన్ మెటాడేటా హెడర్లలో అందించబడుతుంది: x-total-count, x-page-limit, x-page-offset.

curl "http://localhost:20128/api/compliance/audit-log?action=provider.credentials&from=2026-05-01" \
  -H "Cookie: auth_token=..."

డ్యాష్బోర్డ్

డ్యాష్బోర్డ్ /dashboard/audit వద్ద ఆడిట్ డేటాను అందిస్తుంది (src/app/(dashboard)/dashboard/audit/page.tsx). ఈ పేజీలో రెండు ట్యాబ్లు ఉన్నాయి:

• అనుగుణ్యత (ComplianceTab.tsx) — /api/compliance/audit-log నుండి అడ్మిన్ ఆడిట్ ఈవెంట్లు. ఈవెంట్ రకం, తీవ్రత (సమాచారం / హెచ్చరిక / అత్యంత తీవ్రమైనది, చర్య + స్థితి నుండి ఉత్పన్నమవుతుంది), తేదీ పరిధి ఆధారంగా ఫిల్టర్ చేస్తుంది. తీవ్రత చర్య/స్థితి స్ట్రింగ్ల నుండి క్లయింట్ వైపు గణించబడుతుంది.
• MCP (McpAuditTab.tsx) — /api/mcp/audit నుండి MCP సాధన ఆడిట్, సాధన పేరు మరియు విజయం/వైఫల్యం ఆధారంగా ఫిల్టర్లతో.

రెండు ట్యాబ్లు 50 (అనుగుణ్యత) మరియు 25 (MCP) పేజీ పరిమాణాలతో పేజినేట్ చేస్తాయి.

ప్రొవైడర్ క్రెడెన్షియల్ సహాయకాలు

src/lib/compliance/providerAudit.ts, క్రెడెన్షియల్ ఈవెంట్లను విడుదల చేసేటప్పుడు ప్రొవైడర్-నిర్వహణ రూట్లు ఉపయోగించే ఆకృతి సహాయకాలను అందిస్తుంది:

• summarizeProviderConnectionForAudit(connection) — కనెక్షన్ స్నాప్షాట్ detailsలో వ్రాయబడటానికి ముందు apiKey, accessToken, refreshToken, idToken, మరియు providerSpecificData.consoleApiKeyను తొలగిస్తుంది.
• getProviderAuditTarget(connection) — target ఫీల్డ్ కోసం స్థిరమైన "<provider>:<name|id>" స్ట్రింగ్ను రూపొందిస్తుంది.
• extractProviderWarnings(...payloads) — విధానం/భద్రతా హెచ్చరికల కోసం ప్రొవైడర్ ప్రతిస్పందనలను స్కాన్ చేస్తుంది ([sanitizer], prompt injection detected, content has been filtered, safety filter, policy violation) మరియు గరిష్ఠంగా 5 సరిపోలికలను చూపిస్తుంది, ప్రతిదీ 400 అక్షరాలకు కుదించబడుతుంది.

ఉత్తమ పద్ధతులు

• PII (చట్టపరమైన, వైద్యపరమైన మొదలైనవి)ను నిర్వహించే API కీలకు noLog: trueతో గుర్తు పెట్టండి.
• మీ నిల్వ విధానానికి అనుగుణంగా APP_LOG_RETENTION_DAYS / CALL_LOG_RETENTION_DAYSను సర్దుబాటు చేయండి. 7-రోజుల డిఫాల్ట్లు జాగ్రత్తతో నిర్ణయించబడినవి.
• మీ అనుగుణ్యత కార్యక్రమం కోరే వ్యవధిలో ఆడిట్ పట్టికను ప్లాట్ఫారమ్ వెలుపలికి (sqlite3 dump) ఎగుమతి చేయండి — అంతర్నిర్మిత ఆర్కైవింగ్ అందుబాటులో లేదు.
• బ్రూట్-ఫోర్స్ గుర్తింపు కోసం auth.login.failed మరియు auth.login.locked సంఖ్యలను ట్రాక్ చేయండి.
• కొత్త అడ్మిన్ ఎండ్పాయింట్లను జోడించేటప్పుడు, స్థిరమైన domain.verb.outcome చర్య స్ట్రింగ్తో logAuditEvent({ ... })ను కాల్ చేసి, అభ్యర్థన సందర్భాన్ని getAuditRequestContext(request) ద్వారా పంపండి, తద్వారా IP మరియు requestId స్వయంచాలకంగా సంగ్రహించబడతాయి.

ఇవి కూడా చూడండి

• docs/security/GUARDRAILS.md — PII మాస్కింగ్, ప్రాంప్ట్ ఇంజెక్షన్
• docs/frameworks/MCP-SERVER.md — MCP సాధనాల కేటలాగ్ మరియు స్కోప్లు
• docs/reference/ENVIRONMENT.md — పూర్తి env var సూచన
• మూలం: src/lib/compliance/, src/app/api/compliance/, src/app/api/mcp/audit/, src/lib/logEnv.ts