# Poarta de protecție a sistemului (/ro/docs/api/gateway/os-gate)

Politica efectivă a organizației pentru excepțiile de la verificările de protecție și evenimentul de audit trimis când o excepție este acordată sau revocată.

Două endpoint-uri susțin [poarta de protecție a sistemului](../../agents/os-protection-gate.mdx). Ambele cer o cheie API `codai_` ca token Bearer.

`GET /v1/policy` întoarce `{ "os_gate": { "allow_override": boolean } }`, combinat peste toate organizațiile din care faci parte: dacă **oricare** dintre ele interzice excepțiile, răspunsul este `false`. Răspunsul are `Cache-Control: private, max-age=300`; clienții îl păstrează în cache și folosesc ultima valoare offline. O pană a bazei de date dă `503 policy_unavailable` — păstrează valoarea din cache, nu presupune niciodată o valoare permisivă.

`POST /v1/os-gate/events` înregistrează o acordare sau o revocare în jurnalul de audit al contului (`os_gate.override`). Corpul strict conține doar `action`, `checks` (între 1 și 16 id-uri de verificări cunoscute), `surface`, `app_version` și `at`; niciun detaliu de detecție. Răspunde `202 { "ok": true }`.

Aceleași operații există în SDK-uri: `client.osGate.policy()` / `client.osGate.recordEvent(event)` în TypeScript și `client.os_gate.policy()` / `client.os_gate.record_event(...)` în Python. Serverul MCP expune politica prin unealta `os_gate_policy`, doar pentru citire (setul `account`); evenimentul de audit este telemetrie a dispozitivului și nu are unealtă MCP.

<OpenAPIPage
  document="./openapi/ro/gateway.yaml"
  operations={[
    { path: '/v1/policy', method: 'get' },
    { path: '/v1/os-gate/events', method: 'post' },
  ]}
/>