Řešení problémů

Na této stránce najdete postupy pro diagnostiku běžných problémů s nastavením a provozem Ogma.

V historii HTTP se nezobrazuje žádný provoz

Ověřte, že:

1. Instance Ogma běží.
2. Proxy prohlížeče nebo aplikace směřuje na naslouchací adresu instance, obvykle 127.0.0.1:8080.
3. Cílová aplikace neobchází proxy.
4. Nastavení VPN, systémové proxy, kontejneru, emulátoru nebo mobilní proxy nepřepisuje nastavení testovacího klienta.
5. Aktivní projekt je otevřený v pracovním prostoru.

Pokud používáte prohlížeč Ogma, otevřete novou kartu a ověřte, že je viditelný štítek Přes proxy.

Požadavky HTTPS selhávají

Ověřte, že:

• Certifikát CA Ogma je nainstalován ve správném úložišti důvěryhodných certifikátů.
• CA jste importovali do skutečně používaného profilu prohlížeče.
• Cíl nepoužívá certificate pinning.
• Pravidla pro předávání TLS bez dešifrování nevylučují daného hostitele.
• Pokud cíl vyžaduje mTLS, jsou požadavky na klientské certifikáty nastaveny v Nastavení > Klientské certifikáty.

U mobilních nebo desktopových aplikací s certificate pinning může být nutné zvláštní testovací nastavení dané aplikace mimo Ogma.

Zachytávání pozastavuje příliš mnoho provozu

Použijte užší pravidla zachytávání.

Doporučené kroky:

1. Vypněte Zachytávání.
2. Vymezte rozsah testování.
3. Přidejte podmínky shody pro hostitele, metodu, cestu, typ obsahu nebo hlavičku.
4. Znovu zapněte Zachytávání.
5. Sledujte velikost fronty.

Pokud fronta dosáhne své kapacity, Ogma nový provoz předává dál, aby nedošlo k zablokování klienta.

Skener hlásí příliš mnoho šumu

Při šumu z pasivního skeneru:

• Před skenováním aktivujte rozsah testování.
• Nejdříve se zaměřte na nálezy se střední, vysokou a kritickou závažností.
• Nálezy chybějících hlaviček posuzujte podle kontextu.
• Pro důkazy specifické pro projekt používejte vlastní pasivní pravidla.

Při šumu z aktivního skeneru:

• Před skenováním celé historie skenujte vybrané požadavky.
• Zkontrolujte důkazní požadavky a těla odpovědí.
• Ověřte, že důkaz v odpovědi nebyl přítomen již ve výchozí odpovědi.
• Zkontrolujte, zda je nález označen jako pravděpodobný, nebo potvrzený.

Pluginy se nenačítají

Ověřte, že:

1. Kořenová složka pluginu obsahuje manifest.json.
2. Cesty vstupních bodů uvedené v manifestu po sestavení existují.
3. Plugin je zkompilován do běžného JavaScriptu.
4. Balíček pluginu obsahuje frontendové prostředky.
5. Požadovaná oprávnění jsou deklarována a udělena.
6. Karta protokolů pluginu neobsahuje chyby init() ani chyby komunikačního můstku.
7. Velikost balíčku pluginu je pod nastaveným limitem.

MCP asistent nevidí Ogma

Ověřte následující:

• Vestavěné HTTP: MCP běží v Nastavení > MCP a klient používá zkopírovaný koncový bod Streamable HTTP, obvykle http://127.0.0.1:3000/mcp.
• Samostatné stdio: cesta k binárnímu souboru je správná a --api-url / OGMA_API_URL odpovídá běžícímu backendu. Desktopové instance mohou používat dynamický port API.
• Klient zpracovává každý kurzor tools/list; samotná první stránka neobsahuje všechny nástroje.
• Nástroje pro zápis nebo odesílání vyžadují výslovná oprávnění v nastavení nebo přepínače samostatného procesu.
• Po restartu MCP se znovu připojte. Staré identifikátory relací a potvrzovací tokeny již nejsou platné.

Viz Nastavení MCP.

Prohlížeč Ogma je prázdný nebo nesprávně umístěný

Zkontrolujte následující:

• Spouštíte desktopovou aplikaci, nejen webový frontend.
• Aktivní karta má skutečnou URL místo about:blank.
• Zkuste otevřít prohlížeč v samostatném okně.
• Změňte velikost okna Ogma, aby se přepočítaly rozměry prohlížeče.

Vlastní JavaScript nebo CSS narušuje rozhraní

Použijte jeden z postupů obnovení:

• Klikněte na Obnovit vlastní rozhraní.
• Stiskněte Ctrl+Alt+Shift+R.

Tím se odstraní vlastní JavaScript a CSS z lokálního úložiště, desktopového nastavení i předvoleb backendu a Ogma se znovu načte.

Data nebo projekt vypadají nesprávně

Ověřte, že:

• Je otevřena správná instance.
• Je aktivní správný projekt.
• Předvolby spuštění neotevřely jinou instanci.
• Filtry nebo rozsah testování neskrývají očekávané řádky.
• Skrývání statických prostředků nevylučuje hledaný typ obsahu.

Před ručními změnami dat projektu vytvořte zálohu.