---
url: https://docs.ogmabox.com/it/troubleshooting.md
description: >-
  Diagnostica problemi comuni di configurazione di Ogma, acquisizione tramite
  proxy, intercettazione HTTPS, esecuzione desktop, plugin, MCP, scanner ed
  esportazione.
---

# Risoluzione dei problemi {#troubleshooting}

Usa questa pagina per diagnosticare problemi comuni di configurazione ed esecuzione di Ogma.

## Non appare traffico nella Cronologia HTTP {#no-traffic-appears-in-http-history}

Verifica che:

1. L'istanza di Ogma sia in esecuzione.
2. Il proxy del browser o dell'applicazione punti al listener dell'istanza, di solito `127.0.0.1:8080`.
3. L'applicazione bersaglio non stia aggirando il proxy.
4. Le impostazioni di VPN, proxy di sistema, container, emulatore o proxy mobile non stiano sovrascrivendo quelle del client di test.
5. Il progetto attivo sia aperto nell'area di lavoro.

Se usi il Browser Ogma, apri una nuova scheda e conferma che l'indicatore **Tramite proxy** sia visibile.

## Le richieste HTTPS non riescono {#https-requests-fail}

Verifica che:

* Il certificato della CA di Ogma sia installato nell'archivio di fiducia corretto.
* Tu abbia importato la CA nel profilo del browser effettivamente in uso.
* Il bersaglio non usi il pinning dei certificati.
* Le regole di passaggio diretto TLS non escludano l'host.
* I requisiti dei certificati client siano configurati in **Impostazioni > Certificati client** se il bersaglio richiede mTLS.

Per applicazioni mobili o desktop con pinning dei certificati, potrebbe essere necessaria una configurazione di test specifica dell'applicazione al di fuori di Ogma.

## Intercettazione mette in pausa troppo traffico {#intercept-pauses-too-much-traffic}

Usa regole di intercettazione più restrittive.

Passaggi consigliati:

1. Disabilita l'intercettazione.
2. Definisci l'ambito.
3. Aggiungi condizioni di corrispondenza per host, metodo, percorso, tipo di contenuto o intestazione.
4. Riabilita l'intercettazione.
5. Controlla la dimensione della coda.

Se la coda raggiunge la capacità massima, Ogma inoltra il nuovo traffico per evitare il blocco del client.

## Lo scanner genera troppo rumore {#scanner-reports-too-much-noise}

Per il rumore dello scanner passivo:

* Attiva l'ambito prima della scansione.
* Concentrati prima sui rilievi di sicurezza di gravità media, alta e critica.
* Valuta i rilievi sulle intestazioni mancanti in base al contesto.
* Usa regole passive personalizzate per evidenze specifiche del progetto.

Per il rumore dello scanner attivo:

* Scansiona richieste selezionate prima di scansionare tutta la cronologia.
* Esamina le richieste di prova e i corpi delle risposte.
* Conferma che le evidenze della risposta non fossero presenti nella risposta di riferimento.
* Controlla se il livello di confidenza del rilievo è probabile o confermato.

## I plugin non si caricano {#plugins-do-not-load}

Verifica che:

1. La directory principale del plugin contenga `manifest.json`.
2. I percorsi dei punti di ingresso nel manifesto esistano dopo la compilazione.
3. Il plugin sia compilato in JavaScript standard.
4. Le risorse del frontend siano incluse nel pacchetto del plugin.
5. I permessi necessari siano dichiarati e concessi.
6. La scheda dei log del plugin non contenga errori di `init()` o del bridge.
7. La dimensione del pacchetto del plugin sia inferiore al limite configurato.

## L'assistente MCP non riesce ad accedere a Ogma {#mcp-assistant-cannot-see-ogma}

Controlla quanto segue:

* HTTP integrato: MCP è in esecuzione in **Impostazioni > MCP** e il client usa l'endpoint Streamable HTTP copiato, normalmente `http://127.0.0.1:3000/mcp`.
* Stdio autonomo: il percorso del binario è corretto e `--api-url` / `OGMA_API_URL` corrisponde al backend in esecuzione. Le istanze desktop possono usare una porta API dinamica.
* Il client segue tutti i cursori di `tools/list`; la prima pagina da sola non contiene tutti gli strumenti.
* Gli strumenti di scrittura o invio richiedono permessi espliciti in Impostazioni o opzioni della riga di comando del server autonomo.
* Riconnettiti dopo i riavvii di MCP. I vecchi ID di sessione e token di conferma non sono più validi.

Consulta [Configurazione di MCP](./mcp-setup.md).

## Il Browser Ogma è vuoto o posizionato male {#ogma-browser-is-blank-or-mispositioned}

Controlla quanto segue:

* Stai eseguendo l'applicazione desktop, non solo il frontend web.
* La scheda attiva ha un URL reale invece di `about:blank`.
* Prova ad aprire il browser in una finestra separata.
* Ridimensiona la finestra di Ogma per forzare il ricalcolo delle dimensioni e della posizione del browser.

## JavaScript o CSS personalizzati compromettono l'interfaccia {#custom-javascript-or-css-breaks-the-ui}

Usa uno dei percorsi di ripristino:

* Fai clic su **Reimposta interfaccia personalizzata**.
* Premi `Ctrl+Alt+Shift+R`.

Questo elimina JavaScript e CSS personalizzati dall'archiviazione locale, dalle impostazioni desktop e dalle preferenze del backend, quindi ricarica Ogma.

## I dati o il progetto sembrano errati {#data-or-project-looks-wrong}

Verifica che:

* Sia aperta l'istanza corretta.
* Sia attivo il progetto corretto.
* Le preferenze di avvio non abbiano riaperto un'istanza diversa.
* I filtri o l'ambito non nascondano le righe previste.
* L'occultamento delle risorse statiche non escluda il tipo di contenuto che cerchi.

Crea un backup prima di modificare manualmente i dati del progetto.