문제 해결
이 페이지에서 Ogma의 일반적인 설정 및 실행 문제를 진단하세요.
HTTP 기록에 트래픽이 표시되지 않음
확인 사항:
- Ogma 인스턴스가 실행 중입니다.
- 브라우저 또는 애플리케이션의 프록시가 인스턴스 수신 주소를 가리킵니다. 일반적으로
127.0.0.1:8080입니다. - 대상 애플리케이션이 프록시를 우회하지 않습니다.
- VPN, 시스템 프록시, 컨테이너, 에뮬레이터, 모바일 프록시 설정이 테스트 클라이언트 설정을 덮어쓰지 않습니다.
- 현재 프로젝트가 작업 공간에 열려 있습니다.
Ogma 브라우저를 사용하는 경우 새 탭을 열고 프록시 연결 배지가 표시되는지 확인하세요.
HTTPS 요청 실패
확인 사항:
- Ogma CA 인증서가 올바른 신뢰 저장소에 설치되어 있습니다.
- 실제로 사용하는 브라우저 프로필로 CA를 가져왔습니다.
- 대상이 인증서 고정을 사용하지 않습니다.
- TLS 패스스루 규칙이 해당 호스트를 검사에서 제외하지 않습니다.
- 대상이 mTLS를 요구하는 경우 설정 > 클라이언트 인증서에서 클라이언트 인증서 요구 사항이 구성되어 있습니다.
인증서 고정을 사용하는 모바일 또는 데스크톱 애플리케이션에서는 Ogma 외부에서 해당 애플리케이션에 맞는 테스트 설정이 필요할 수 있습니다.
가로채기가 너무 많은 트래픽을 일시 정지함
가로채기 규칙의 적용 범위를 좁히세요.
권장 단계:
- 가로채기를 비활성화합니다.
- 점검 범위를 정의합니다.
- 호스트, 메서드, 경로, 콘텐츠 유형, 헤더에 대한 일치 조건을 추가합니다.
- 가로채기를 다시 활성화합니다.
- 큐 크기를 확인합니다.
큐가 용량에 도달하면 Ogma는 새 트래픽을 전달하여 클라이언트의 교착 상태를 방지합니다.
스캐너 보고에 불필요한 결과가 많음
수동형 스캐너의 불필요한 결과:
- 스캔 전에 점검 범위를 활성화합니다.
- 심각도가 중간, 높음, 치명적인 발견 사항부터 확인합니다.
- 헤더 누락에 관한 발견 사항은 상황에 따라 판단합니다.
- 프로젝트별 증거에 맞게 사용자 지정 수동형 규칙을 사용합니다.
능동형 스캐너의 불필요한 결과:
- 전체 기록을 스캔하기 전에 선택한 요청을 스캔합니다.
- 증거가 되는 요청과 응답 본문을 검토합니다.
- 기준 응답에는 해당 응답 증거가 없었는지 확인합니다.
- 발견 사항의 신뢰도가 "가능성 높음"인지 "확인됨"인지 확인합니다.
플러그인을 로드할 수 없음
확인 사항:
- 플러그인 루트에
manifest.json이 있습니다. - 빌드 후 매니페스트에 지정된 진입점 경로가 존재합니다.
- 플러그인이 일반 JavaScript로 컴파일되어 있습니다.
- 플러그인 패키지에 프런트엔드 자산이 포함되어 있습니다.
- 필요한 권한이 선언되고 부여되어 있습니다.
- 플러그인 로그 탭에
init()또는 브리지 오류가 없습니다. - 플러그인 패키지 크기가 설정된 한도 미만입니다.
MCP 어시스턴트가 Ogma에 접근할 수 없음
확인 사항:
- 내장 HTTP: 설정 > MCP에서 MCP가 실행 중이며 클라이언트가 복사한 Streamable HTTP 엔드포인트를 사용합니다. 일반적으로
http://127.0.0.1:3000/mcp입니다. - 독립 실행형 stdio: 바이너리 경로가 올바르고
--api-url/OGMA_API_URL이 실행 중인 백엔드와 일치합니다. 데스크톱 인스턴스는 동적 API 포트를 사용할 수 있습니다. - 클라이언트가 모든
tools/list커서를 따라 후속 페이지를 가져옵니다. 첫 페이지만으로는 모든 도구를 가져올 수 없습니다. - 쓰기 또는 전송 도구에는 설정에서 명시적으로 부여한 권한이나 독립 실행형 플래그가 필요합니다.
- MCP가 재시작되면 다시 연결합니다. 이전 세션 ID와 확인 토큰은 더 이상 유효하지 않습니다.
MCP 설정을 참조하세요.
Ogma 브라우저가 비어 있거나 위치가 잘못됨
확인 사항:
- 웹 프런트엔드만이 아니라 데스크톱 앱을 실행하고 있습니다.
- 현재 탭의 URL이
about:blank가 아니라 실제 URL입니다. - 브라우저를 별도 창으로 열어 봅니다.
- Ogma 창 크기를 조절하여 브라우저 표시 영역을 강제로 다시 계산합니다.
사용자 지정 JavaScript 또는 CSS로 UI가 깨짐
다음 복구 방법 중 하나를 사용하세요:
- 사용자 지정 UI 초기화를 클릭합니다.
Ctrl+Alt+Shift+R을 누릅니다.
로컬 저장소, 데스크톱 설정, 백엔드 환경 설정에서 사용자 지정 JavaScript와 CSS를 지운 뒤 Ogma를 다시 로드합니다.
데이터 또는 프로젝트가 예상과 다름
확인 사항:
- 올바른 인스턴스가 열려 있습니다.
- 올바른 프로젝트가 활성화되어 있습니다.
- 시작 환경 설정이 다른 인스턴스를 다시 열지 않았습니다.
- 필터나 점검 범위가 예상되는 행을 숨기지 않습니다.
- 정적 자산 숨김이 찾고 있는 콘텐츠 유형을 제외하지 않습니다.
프로젝트 데이터를 직접 변경하기 전에 백업을 만드세요.