Rozwiązywanie problemów

Użyj tej strony do diagnozowania typowych problemów konfiguracji i działania Ogma.

Brak ruchu w Historii HTTP

Sprawdź, czy:

1. Instancja Ogma działa.
2. Proxy przeglądarki lub aplikacji wskazuje nasłuch instancji, zwykle 127.0.0.1:8080.
3. Badana aplikacja nie omija proxy.
4. Ustawienia VPN, proxy systemowego, kontenera, emulatora lub proxy urządzenia mobilnego nie nadpisują ustawień klienta testowego.
5. Aktywny projekt jest otwarty w obszarze roboczym.

Jeśli używasz Przeglądarki Ogma, otwórz nową kartę i potwierdź widoczność oznaczenia Przez proxy.

Żądania HTTPS nie działają

Sprawdź, czy:

• Certyfikat CA Ogma jest zainstalowany we właściwym magazynie zaufanych certyfikatów.
• CA został zaimportowany do rzeczywiście używanego profilu przeglądarki.
• Badany system nie używa przypinania certyfikatów.
• Reguły przekazywania TLS bez inspekcji nie wykluczają hosta.
• Wymagania certyfikatów klienta są skonfigurowane w Ustawienia > Certyfikaty klienta, jeśli cel wymaga mTLS.

Dla aplikacji mobilnych lub desktopowych z przypinaniem certyfikatów może być potrzebna konfiguracja testowa właściwa dla danej aplikacji, poza Ogma.

Przechwytywanie wstrzymuje zbyt wiele ruchu

Użyj węższych reguł przechwytywania.

Zalecane kroki:

1. Wyłącz przechwytywanie.
2. Zdefiniuj zakres testów.
3. Dodaj warunki dopasowania hosta, metody, ścieżki, typu treści lub nagłówka.
4. Włącz przechwytywanie ponownie.
5. Obserwuj rozmiar kolejki.

Jeśli kolejka osiągnie limit pojemności, Ogma przekazuje nowy ruch, aby uniknąć zakleszczenia klienta.

Skaner zgłasza zbyt wiele szumu

W przypadku szumu ze skanera pasywnego:

• Aktywuj zakres testów przed skanowaniem.
• Najpierw skup się na ustaleniach o średniej, wysokiej i krytycznej wadze.
• Traktuj ustalenia dotyczące brakujących nagłówków jako zależne od kontekstu.
• Używaj niestandardowych reguł pasywnych dla dowodów właściwych dla projektu.

W przypadku szumu ze skanera aktywnego:

• Skanuj wybrane żądania przed skanowaniem całej historii.
• Przeglądaj żądania dowodowe i treści odpowiedzi.
• Potwierdź, że dowód z odpowiedzi nie występował w odpowiedzi bazowej.
• Sprawdź poziom pewności ustalenia: czy jest ono prawdopodobne czy potwierdzone.

Wtyczki się nie wczytują

Sprawdź, czy:

1. Katalog główny wtyczki zawiera manifest.json.
2. Ścieżki punktów wejścia z manifestu istnieją po kompilacji.
3. Wtyczka jest skompilowana do zwykłego JavaScript.
4. Zasoby frontendu są dołączone do pakietu wtyczki.
5. Wymagane uprawnienia są zadeklarowane i przyznane.
6. Karta Dzienniki wtyczki nie zawiera błędów init() ani mostka komunikacyjnego.
7. Rozmiar pakietu wtyczki jest poniżej skonfigurowanego limitu.

Asystent MCP nie widzi Ogma

Sprawdź następujące kwestie:

• Wbudowane HTTP: MCP działa w Ustawienia > MCP, a klient używa skopiowanego punktu końcowego Streamable HTTP, zwykle http://127.0.0.1:3000/mcp.
• Samodzielne stdio: ścieżka pliku wykonywalnego jest prawidłowa, a --api-url / OGMA_API_URL odpowiada działającemu backendowi. Instancje desktopowe mogą używać dynamicznego portu API.
• Klient obsługuje każdy kursor tools/list; sama pierwsza strona nie zawiera wszystkich narzędzi.
• Narzędzia zapisu lub wysyłania wymagają jawnych uprawnień w Ustawieniach lub flag trybu samodzielnego.
• Po restarcie MCP połącz się ponownie. Stare identyfikatory sesji i tokeny potwierdzenia nie są już ważne.

Zobacz Konfiguracja MCP.

Przeglądarka Ogma jest pusta lub nieprawidłowo umieszczona

Sprawdź następujące kwestie:

• Uruchomiona jest aplikacja desktopowa, a nie tylko frontend webowy.
• Aktywna karta ma rzeczywisty URL zamiast about:blank.
• Spróbuj otworzyć przeglądarkę jako osobne okno.
• Zmień rozmiar okna Ogma, aby wymusić ponowne obliczenie granic widoku przeglądarki.

Niestandardowy JavaScript lub CSS zakłóca interfejs

Użyj jednego ze sposobów przywrócenia działania:

• Kliknij Zresetuj własny interfejs.
• Naciśnij Ctrl+Alt+Shift+R.

Usuwa to niestandardowy JavaScript i CSS z pamięci lokalnej, ustawień aplikacji desktopowej i preferencji backendu, a następnie przeładowuje Ogma.

Dane lub projekt wyglądają nieprawidłowo

Sprawdź, czy:

• Otwarta jest właściwa instancja.
• Aktywny jest właściwy projekt.
• Preferencje uruchamiania nie otworzyły ponownie innej instancji.
• Filtry lub zakres testów nie ukrywają oczekiwanych wierszy.
• Ukrywanie zasobów statycznych nie wyklucza szukanego typu treści.

Utwórz kopię zapasową przed ręcznymi zmianami danych projektu.