# Perché GreenOps Studio AI è il Control Plane Definitivo per la Conformità all'EU AI Act

**GreenOps Studio AI** · Designed & Engineered in Italy · Control Plane su **Cloudflare Workers** (placement EU `gcp:europe-west1`)

| Campo | Valore |
| --- | --- |
| **Documento** | `GO-EU-AI-ACT-CP-1.0` |
| **Audience** | CISO, DPO, Compliance Officer, Legal & Procurement |
| **Stack** | Cloudflare Workers · AES-256-GCM · SHA-256 notary ledger · RBAC |
| **Posizionamento** | AI Control Plane Enterprise · LLM Security Gateway · AI FinOps Platform · Edge-Native AI Proxy |
| **Compliance** | EU AI Act Compliance Software · AI Audit Trail SHA-256 · PII Pre-Masking AES-256-GCM |
| **Stato** | Pubblico — documentazione tecnica enterprise |

> Questo articolo descrive **misure tecniche e organizzative** del Control Plane GreenOps rispetto agli obblighi di trasparenza, tracciabilità e gestione del rischio previsti dall’**EU AI Act**. Non costituisce consulenza legale.

---

## 1. Conformità normativa e sicurezza dei prompt all’edge

**GreenOps Studio AI** opera come **AI Control Plane Enterprise** e **Edge-Native AI Proxy**: ogni prompt — chat completion, tool call o query IDP — entra nel **LLM Security Gateway** prima di toccare un modello esterno. Sull’edge europeo (`gcp:europe-west1`) il Worker applica, in ordine, autenticazione Bearer, RBAC `X-User-Role`, sanitizzazione euristica anti-injection/exfil, **PII Pre-Masking AES-256-GCM** e Zero Retention verso upstream. Solo dopo queste gate il traffico può raggiungere Gemini, OpenAI o una GPU locale.

La **conformità normativa** non è un report a posteriori: è enforcement in-line. L’**AI Audit Trail SHA-256** (schema v4, `prevHash → hash`) registra ogni decisione del Control Plane — completion, blocco jailbreak, answer IDP — così DPO e Compliance possono dimostrare logging e tracciabilità previsti dall’**EU AI Act**. Parallelamente l’**AI FinOps Platform** collega costi token e CO₂ allo stesso piano di controllo, perché governance del rischio e governance della spesa condividono lo stesso punto di enforcement.

In pratica, **sicurezza dei prompt all’edge** significa: (1) il plaintext sensibile non lascia Cloudflare Workers in chiaro; (2) i residui PII non mascherati producono `403 upstream_mask_required`; (3) ogni esito è notarizzato e verificabile via `/v1/audit/verify`. Questo è il nucleo di un **EU AI Act Compliance Software** operativo, non documentale.

---

## 2. Il problema: LLM senza Control Plane = rischio normativo

I modelli generativi (Gemini, GPT, runtime locali) producono valore operativo, ma senza un **AI Proxy** intermediario le organizzazioni espongono:

1. **PII in chiaro** verso provider cloud (violazione potenziale GDPR e principi di minimizzazione).  
2. **Assenza di audit trail immutabile** sulle decisioni automatiche e sulle interazioni utente–sistema (obbligo di logging e tracciabilità EU AI Act).  
3. **Costi token non governati** (FinOps) e assenza di evidenze CSRD/ESRS sulle emissioni CO₂ indotte dall’inferenza.  
4. **Superfici RBAC confuso** (FinOps che legge chat, Compliance senza ledger, Admin senza whitelist server-side).

GreenOps Studio AI nasce come **Control Plane LLM enterprise**: ogni richiesta passa da un Worker Cloudflare, viene autenticata, sanitizzata, eventualmente sigillata con **AES-256-GCM**, notarizzata in una catena **SHA-256** e solo allora instradata (smart routing / failover) verso l’upstream.

---

## 3. Architettura edge: Cloudflare Workers come enforcement point

### 3.1 Perché Cloudflare Workers

Il Control Plane è implementato come **Cloudflare Worker** con placement regionale **`gcp:europe-west1`**, allineato all’infrastruttura EU e al principio di **sovranità dei dati**. Il Worker:

- Termina il traffico client con **TLS 1.3** (fallback sicuro a TLS 1.2) sulla rete Cloudflare.  
- Applica policy **Zero Retention** verso upstream: i span sensibili non lasciano l’edge in chiaro.  
- Espone un’API **OpenAI-compatible** (`POST /v1/chat/completions`) così le applicazioni non riscrivono gli SDK.  
- Orchestrazione KV (`GREENOPS_CACHE`, `GREENOPS_ANALYTICS`, `GREENOPS_CHATS`) e indici Vectorize per cache semantica e IDP zero-export.

### 3.2 Catena di controllo su ogni completion

1. **AuthN** — `Authorization: Bearer` o `X-Proxy-Auth` (JWT Studio o chiave gateway).  
2. **RBAC** — `X-User-Role` (User · FinOps · Compliance · Admin) con elevazione Admin solo via whitelist `ADMIN_EMAILS`.  
3. **Sanitizzazione euristica** — injection / exfil rewrite o blocco (`X-GreenOps-Sanitize`).  
4. **Seal PII AES-256-GCM** (WASM) + pre-mask obbligatorio prima di Gemini/OpenAI.  
5. **Cache semantica multi-tier** (exact / bag / cosine / Vectorize) → HIT a costo zero.  
6. **Smart routing / cascade** Flash↔flagship↔GPU locale.  
7. **Append notarile SHA-256** al ledger di audit EU AI Act (`X-Audit-Hash`).

Questo percorso è il cuore del **Control Plane**: non è un wrapper di marketing, è un enforcement point crittografico e di policy.

---

## 4. Crittografia AES-256-GCM e pre-masking PII sull’edge europeo

### 4.1 Seal a riposo e in transito applicativo

GreenOps utilizza **AES-256-GCM** (motore WASM Rust + fallback Web Crypto) per cifrare span sensibili — email, carte, codice fiscale, IBAN, telefoni, secret — in token opachi `[GOENC:v1:…]` prima che il payload raggiunga un LLM esterno.

- Chiave derivata da segreto di sessione / gateway (`deriveSealKeyHex`).  
- Nonce casuale per ogni seal; autenticazione integrata del ciphertext (GCM).  
- Header operativi: `X-GreenOps-Sealed`, `X-PII-Redacted-Count`, `X-GreenOps-Upstream-Mask: required`.  
- Residui in chiaro verso upstream → **`403 upstream_mask_required`**.

### 4.2 Pre-masking obbligatorio (Zero Retention)

Dopo il seal, il Control Plane **deve** sostituire i token cifrati con placeholder (`[EMAIL_PROTECTED]`, `[CARD_REDACTED]`, …) prima della chiamata a Gemini/OpenAI. La cache semantica memorizza fingerprint e bag di token, **non** il prompt plaintext completo. Questa combinazione AES-256-GCM + pre-mask è la risposta tecnica al requisito di **minimizzazione e protezione dei dati** nel contesto di sistemi AI ad alto rischio o ad alto impatto organizzativo.

### 4.3 Post-Quantum ready

Il profilo PQC (`GET /v1/security/pqc`) espone envelope ibridi **ML-KEM-768 + AES-256-GCM** e dichiara il trasporto PQ TLS di Cloudflare — continuità crittografica oltre lo scenario classico.

---

## 5. Notarizzazione SHA-256: audit trail a prova di manomissione

### 5.1 Ledger a blocchi (schema v4)

Ogni evento rilevante — completion LLM, blocco jailbreak, ingest/query/answer **IDP** — appende un blocco alla catena privata:

- Materiale canonico firmato: timestamp, `requestId`, model, tokens, `costUsd`, `co2Grams`, `piiCount`, metadati `risk`, link `idp` (es. `documentSha256`), **`blockHeight`**, **`chainId`**, **`prevHash`**.  
- **`hash = SHA-256(canonicalMaterial)`** — ogni blocco punta crittograficamente al precedente (`prevHash → hash`).  
- Genesis = 64 zeri; head esposto in **`X-Audit-Hash`**.  
- Algoritmo notarile dichiarato: `SHA-256-block-chain`.

### 5.2 Verifica indipendente per Compliance

- `GET /v1/audit/logs` — finestra di blocchi + `chainValid`.  
- `GET/POST /v1/audit/verify` — report con `tamperEvidence` (`hash_mismatch` | `prev_link_broken` | `height_gap`).  

Qualsiasi manomissione ex post di un record KV spezza la catena: è esattamente il tipo di **evidenza immutabile** che Legal e Compliance richiedono per dimostrare logging e tracciabilità ai sensi dell’EU AI Act (banche, assicurazioni, PA).

### 5.3 Collegamento IDP zero-export

Le risposte documentali estrattive (senza export verso LLM cloud) generano blocchi `provider: idp` con digest documento firmati — la stessa catena SHA-256 copre **chat e Intelligent Document Processing**.

---

## 6. Allineamento agli obblighi EU AI Act (vista Control Plane)

| Esigenza normativa / operativa | Capacità GreenOps Studio AI |
| --- | --- |
| Trasparenza e logging delle interazioni AI | Ledger SHA-256 + `X-Audit-Hash` + `/v1/audit/verify` |
| Protezione dati / minimizzazione | AES-256-GCM seal + pre-mask + Zero Retention su Cloudflare Workers EU |
| Separazione dei doveri | RBAC `X-User-Role` + Admin whitelist `ADMIN_EMAILS` |
| Governance costi e impatto ambientale | FinOps headers USD/CO₂, ESG ledger CSRD, payback ROI |
| Resilienza operativa | Failover multi-provider ms, hedge GPU locale, air-gap kill-switch |
| Documentazione per procurement | Legal pack Admin, due diligence, OpenAPI validation |

Il Control Plane non “sostituisce” la conformità organizzativa: **fornisce le prove tecniche** (crittografia, notarizzazione, RBAC, edge EU) su cui DPO e counsel costruiscono policy, DPIA e contratti.

---

## 7. FinOps e ESG nello stesso piano di controllo

Conformità e costi non sono trade-off. Su ogni HIT/MISS il Worker emette telemetria FinOps (`X-GreenOps-Cost-Saved-USD`, `X-GreenOps-CO2-Saved-G`, `X-GreenOps-Route`) e alimenta catene ESG parallele. Cache semantica, smart routing e compressione prompt riducono spend e carbon **prima** che un modello premium venga invocato — evidenza esportabile per filer CSRD/ESRS.

---

## 8. Come adottarlo senza riscrivere il codice

1. Puntare l’SDK OpenAI-compatible a `https://greenops-ai-proxy.copycomp-ai.workers.dev/v1/chat/completions`.  
2. Inviare `Authorization: Bearer <chiave>` (o registrarsi su [greenopsstudio.com](https://www.greenopsstudio.com/register)).  
3. Opzionale: `X-User-Role`, chiavi BYO, `X-Local-LLM-Url` per hedge GPU.  
4. Compliance: leggere `/v1/audit/logs` e validare con `/v1/audit/verify`.  
5. Security review: `/v1/security/pqc`, due diligence enterprise, legal pack Admin.

---

## 9. Conclusione

**GreenOps Studio AI** è l’**AI Control Plane Enterprise** definitivo per la conformità all’EU AI Act perché concentra su **Cloudflare Workers** (edge UE) i pilastri di un **LLM Security Gateway**, di un’**AI FinOps Platform** e di un **Edge-Native AI Proxy**:

1. **PII Pre-Masking AES-256-GCM** con Zero Retention — sicurezza dei prompt all’edge.  
2. **AI Audit Trail SHA-256** a blocchi, verificabile — **EU AI Act Compliance Software**.  
3. **Governance operativa** (RBAC, FinOps, failover, IDP zero-export) senza forzare una riscrittura applicativa.

Designed & Engineered in Italy — qualità, etica, trasparenza.

---

### Riferimenti rapidi

- Studio: [https://www.greenopsstudio.com/](https://www.greenopsstudio.com/)  
- Docs hub: [https://www.greenopsstudio.com/docs.html](https://www.greenopsstudio.com/docs.html)  
- Due diligence: [https://greenops-ai-proxy.copycomp-ai.workers.dev/docs/enterprise-due-diligence](https://greenops-ai-proxy.copycomp-ai.workers.dev/docs/enterprise-due-diligence)  
- Audit verify: `GET /v1/audit/verify` · PQC: `GET /v1/security/pqc` · OpenAPI: `GET /swagger`
