Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Proteggi la tua chiave API: non esporla mai lato client

Lezione 6 di 12 Aggiornata il 28 luglio 2026 Avanzato
In questa pagina
  1. Una chiave API è una password
  2. Vettori di esposizione comuni
  3. Architettura proxy: la soluzione
  4. Archiviazione sicura delle chiavi
  5. Cosa fare se la tua chiave è compromessa
  6. Punti chiave

Una chiave API è una password

La tua chiave API xAI funziona come una password con accesso completo al tuo account. Chiunque la possieda può effettuare chiamate API a tue spese, accedere ai tuoi modelli e potenzialmente compromettere i tuoi dati. In cosa differisce da una password standard? Una chiave rubata può essere utilizzata in silenzio: non noterai nulla finché non arriverà la fattura o finché il tuo team finanziario non lancerà un allarme. La regola è semplice e assoluta: non esporre mai una chiave API lato client.

Vettori di esposizione comuni

Il caso più frequente è l’inclusione diretta della chiave nel JavaScript frontend:

// PERICOLO - NON farlo MAI
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Una volta distribuito, questo codice è visibile a chiunque utilizzi gli strumenti di sviluppo del browser. Basta aprire la scheda Network per leggere la chiave in chiaro nelle intestazioni della richiesta.

Un vettore più insidioso, perché offre un falso senso di sicurezza: le variabili d’ambiente frontend. Le variabili con prefisso NEXT_PUBLIC_, VITE_ o REACT_APP_ vengono incluse nel bundle JavaScript al momento della compilazione e sono quindi pubbliche. Lo sviluppatore crede di aver “tenuto la chiave fuori dal codice”; in realtà, è semplicemente compilata al suo interno:

# PERICOLO - questa variabile sarà nel bundle
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

I repository Git costituiscono il terzo vettore classico. Anche un commit eliminato rimane nella cronologia di Git: se hai commesso per errore una chiave, riscrivere la cronologia non basta, perché cloni e fork potrebbero averla conservata. Considerala compromessa e revocala. Infine, le chiavi fuoriescono anche attraverso percorsi indiretti, più difficili da immaginare ma molto comuni: log dell’applicazione che tracciano le intestazioni complete, messaggi di errore visualizzati all’utente o strumenti di monitoraggio che catturano le richieste in uscita.

Architettura proxy: la soluzione

L’unico approccio sicuro consiste nel far passare tutte le chiamate attraverso il tuo backend:

Client (browser/mobile)
    ↓ richiesta senza chiave API
Tuo Backend (server)
    ↓ aggiunge la chiave API (variabile d'ambiente)
API xAI
    ↓ risposta
Tuo Backend
    ↓ inoltra la risposta (filtrata se necessario)
Client

Ecco un proxy minimale in Python:

# Backend Python (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Variabile solo lato server

@app.route("/api/chat", methods=["POST"])
def proxy_chat():
    user_message = request.json.get("message")

    response = requests.post(
        "https://api.x.ai/v1/chat/completions",
        headers={"Authorization": f"Bearer {XAI_KEY}"},
        json={
            "model": "grok-4.3",
            "messages": [{"role": "user", "content": user_message}]
        }
    )

    return jsonify(response.json())

Oltre a proteggere la chiave, che non viene mai trasmessa al client, il proxy ti offre un punto di controllo reso impossibile dalle chiamate dirette. Puoi filtrare le richieste: limitazione della frequenza (rate limiting) per impedire a un client di prosciugare la tua quota, validazione dell’input, moderazione dei contenuti. Controlli quali modelli sono accessibili, impedendo a un client dirottato di chiamare un modello costoso e generare costi imprevisti. Puoi registrare le chiamate per l’audit, una necessità centrale per un responsabile della conformità. Infine, puoi memorizzare nella cache alcune risposte per ridurre i costi sulle richieste ripetitive.

Archiviazione sicura delle chiavi

Lato server, la base di partenza è la variabile d’ambiente, caricata da un file .env che non deve mai essere committato su Git:

# File .env (MAI committare su Git)
XAI_API_KEY=xai-your-secret-key

Aggiungi sistematicamente questi file al tuo .gitignore:

# .gitignore
.env
.env.local
.env.production

Per gli ambienti di produzione, un file .env posizionato su un server rimane un processo manuale fragile: preferisci un gestore di segreti dedicato. Le opzioni collaudate includono AWS Secrets Manager o SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, oppure Doppler e Infisical per strutture più leggere. Cosa offrono questi strumenti in più rispetto a un file piatto: rotazione automatica delle chiavi, audit degli accessi (chi ha letto quale segreto e quando) e crittografia a riposo. Questi sono elementi che puoi presentare così come sono durante un audit di sicurezza, mentre un file di testo su una macchina non prova nulla.

Cosa fare se la tua chiave è compromessa

Se sospetti che una chiave sia stata esposta, l’ordine delle operazioni conta tanto quanto le operazioni stesse. Revoca la chiave nella console xAI (console.x.ai) prima di tutto: ogni minuto in cui la chiave compromessa rimane attiva è un minuto di possibile sfruttamento, e la continuità del servizio si gestisce dopo, non prima. Quindi genera una nuova chiave e aggiorna i tuoi backend per ripristinare il servizio.

L’incidente non è ancora chiuso. Esegui un audit dell’utilizzo cercando chiamate API sospette nella tua cronologia di fatturazione: un picco in una finestra temporale insolita, un utilizzo attribuito a un modello che non usi. Identifica la fonte della perdita, altrimenti la nuova chiave seguirà lo stesso percorso della vecchia. Concludi scansionando il tuo codice con strumenti come gitleaks o truffleHog, che attraversano anche la cronologia di Git e spesso rivelano altri segreti dimenticati da tempo.

Punti chiave

  • Una chiave API è una password con accesso completo al tuo account
  • Sempre far passare le chiamate API attraverso il tuo backend
  • Le variabili NEXT_PUBLIC_, VITE_, REACT_APP_ sono pubbliche
  • Utilizza un gestore di segreti in produzione
  • Se una chiave è compromessa, revocala immediatamente ed esegui un audit dell’utilizzo