Pemecahan Masalah

Gunakan halaman ini untuk mendiagnosis masalah umum pada pengaturan dan pengoperasian Ogma.

Tidak Ada Lalu Lintas di Riwayat HTTP

Periksa hal berikut:

1. Instans Ogma sedang berjalan.
2. Proksi peramban atau aplikasi mengarah ke listener instans, biasanya 127.0.0.1:8080.
3. Aplikasi target tidak menghindari proksi.
4. Pengaturan VPN, proksi sistem, container, emulator, atau proksi seluler tidak menimpa pengaturan klien pengujian.
5. Proyek aktif terbuka di ruang kerja.

Jika menggunakan Peramban Ogma, buka tab baru dan pastikan lencana Melalui proksi terlihat.

Permintaan HTTPS Gagal

Periksa hal berikut:

• Sertifikat CA Ogma terinstal di penyimpanan sertifikat tepercaya yang benar.
• Anda mengimpor CA ke profil peramban yang benar-benar digunakan.
• Target tidak menggunakan certificate pinning.
• Aturan penerusan TLS tanpa intersepsi tidak mengecualikan host.
• Persyaratan sertifikat klien dikonfigurasi di Pengaturan > Sertifikat Klien jika target memerlukan mTLS.

Untuk aplikasi seluler atau desktop yang menggunakan certificate pinning, Anda mungkin memerlukan pengaturan pengujian khusus aplikasi di luar Ogma.

Intersepsi Menjeda Terlalu Banyak Lalu Lintas

Gunakan aturan intersepsi yang lebih spesifik.

Langkah yang direkomendasikan:

1. Nonaktifkan intersepsi.
2. Tentukan cakupan.
3. Tambahkan kondisi pencocokan untuk host, metode, path, jenis konten, atau header.
4. Aktifkan kembali intersepsi.
5. Pantau ukuran antrean.

Jika antrean mencapai kapasitasnya, Ogma meneruskan lalu lintas baru agar klien tidak mengalami deadlock.

Pemindai Melaporkan Terlalu Banyak Hasil yang Mengganggu

Untuk hasil pemindai pasif yang mengganggu:

• Aktifkan cakupan sebelum memindai.
• Fokus terlebih dahulu pada temuan tingkat sedang, tinggi, dan kritis.
• Perlakukan temuan tentang header yang tidak ada sesuai konteksnya.
• Gunakan aturan pasif khusus untuk bukti yang spesifik bagi proyek.

Untuk hasil pemindai aktif yang mengganggu:

• Pindai permintaan terpilih sebelum memindai seluruh riwayat.
• Tinjau permintaan pembuktian dan isi respons.
• Pastikan bukti dalam respons belum ada di respons acuan.
• Periksa apakah tingkat keyakinan temuan adalah kemungkinan besar atau terkonfirmasi.

Plugin Tidak Dapat Dimuat

Periksa hal berikut:

1. Direktori root plugin berisi manifest.json.
2. Path titik masuk dalam manifes tersedia setelah build.
3. Plugin dikompilasi menjadi JavaScript biasa.
4. Aset frontend disertakan dalam paket plugin.
5. Izin yang diperlukan telah dideklarasikan dan diberikan.
6. Tab log plugin tidak memuat kesalahan init() atau bridge.
7. Ukuran paket plugin berada di bawah batas yang dikonfigurasi.

Asisten MCP Tidak Dapat Mengakses Ogma

Periksa hal berikut:

• HTTP tertanam: MCP berjalan di Pengaturan > MCP dan klien menggunakan endpoint Streamable HTTP yang disalin, biasanya http://127.0.0.1:3000/mcp.
• Stdio mandiri: path biner benar dan --api-url / OGMA_API_URL sesuai dengan backend yang berjalan. Instans desktop dapat menggunakan port API dinamis.
• Klien mengikuti setiap kursor tools/list; halaman pertama saja tidak memuat semua alat.
• Alat penulisan atau pengiriman memerlukan izin eksplisit di Pengaturan, atau flag untuk mode mandiri.
• Hubungkan kembali setelah MCP dimulai ulang. ID sesi dan token konfirmasi lama tidak lagi valid.

Lihat Pengaturan MCP.

Peramban Ogma Kosong atau Salah Posisi

Periksa hal berikut:

• Anda menjalankan aplikasi desktop, bukan hanya frontend web.
• Tab aktif memiliki URL sebenarnya, bukan about:blank.
• Coba buka peramban sebagai jendela terpisah.
• Ubah ukuran jendela Ogma untuk memicu penghitungan ulang batas tampilan peramban.

JavaScript atau CSS Kustom Merusak UI

Gunakan salah satu cara pemulihan berikut:

• Klik Reset antarmuka kustom.
• Tekan Ctrl+Alt+Shift+R.

Tindakan ini menghapus JavaScript dan CSS kustom dari penyimpanan lokal, pengaturan desktop, dan preferensi backend, lalu memuat ulang Ogma.

Data atau Proyek Tampak Salah

Periksa hal berikut:

• Instans yang benar sedang terbuka.
• Proyek yang benar sedang aktif.
• Preferensi saat memulai aplikasi tidak membuka kembali instans lain.
• Filter atau cakupan tidak menyembunyikan baris yang diharapkan.
• Pengaturan penyembunyian aset statis tidak mengecualikan jenis konten yang Anda cari.

Buat cadangan sebelum mengubah data proyek secara manual.