---
url: https://docs.ogmabox.com/id/troubleshooting.md
description: >-
  Diagnosis masalah umum pada pengaturan Ogma, perekaman melalui proksi,
  intersepsi HTTPS, runtime desktop, plugin, MCP, pemindai, dan ekspor.
---

# Pemecahan Masalah {#troubleshooting}

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

## Tidak Ada Lalu Lintas di Riwayat HTTP {#no-traffic-appears-in-http-history}

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 {#https-requests-fail}

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 {#intercept-pauses-too-much-traffic}

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 {#scanner-reports-too-much-noise}

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 {#plugins-do-not-load}

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 {#mcp-assistant-cannot-see-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](./mcp-setup.md).

## Peramban Ogma Kosong atau Salah Posisi {#ogma-browser-is-blank-or-mispositioned}

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 {#custom-javascript-or-css-breaks-the-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 {#data-or-project-looks-wrong}

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.