---
url: https://docs.ogmabox.com/id/getting-started.md
description: >-
  Instal Ogma, mulai instans proksi lokal, konfigurasikan perekaman, periksa
  lalu lintas, lalu lanjutkan ke pengiriman ulang, pemindaian, dan pelaporan.
---

# Mulai Menggunakan Ogma {#getting-started}

Ogma adalah perangkat bantu keamanan web desktop untuk mengintersepsi, memeriksa, mengirim ulang, mengotomatiskan, memindai, dan mendokumentasikan lalu lintas aplikasi web.

Halaman ini memandu Anda dari instalasi baru hingga sesi proksi yang berfungsi. Untuk alur pengujian pertama yang lengkap, lanjutkan ke [Perekaman pertama](./guide/first-capture.md).

## Persyaratan {#requirements}

* Platform desktop yang didukung: Linux, Windows, atau macOS.
* Peramban atau aplikasi yang dapat menggunakan proksi HTTP.
* Untuk pemeriksaan HTTPS, sertifikat CA lokal Ogma harus diimpor ke profil peramban atau sistem operasi yang digunakan untuk pengujian.

## Instal Ogma {#install-ogma}

Unduh rilis terbaru dari GitHub:

<https://github.com/ogmabox/ogma/releases>

Paket yang tersedia bergantung pada rilis:

| Platform | Paket | Catatan |
| --- | --- | --- |
| Windows | Penginstal NSIS | Direkomendasikan untuk pengguna umum. Penandatanganan kode mungkin ditambahkan dalam rilis mendatang. |
| macOS | Bundel aplikasi atau arsip | Ketersediaan bergantung pada artefak rilis. |
| Linux | AppImage | Paket portabel dengan dukungan pembaruan dalam aplikasi. |
| Linux | `.deb` | Direkomendasikan untuk sistem seperti Debian/Ubuntu. Pembaruan diinstal dengan mengganti paket. |

## Mulai Instans {#start-an-instance}

1. Buka Ogma.
2. Di peluncur, mulai instans lokal.
3. Buka ruang kerja. Secara default, Ogma menggunakan listener proksi HTTP `127.0.0.1:8080` dan API `127.0.0.1:8181`, kecuali instans dikonfigurasi berbeda.
4. Buat atau pilih proyek jika Anda ingin menyimpan data pengujian secara persisten dan terpisah.

## Konfigurasikan Perekaman {#configure-capture}

Anda dapat merekam lalu lintas dengan dua cara:

| Metode | Gunakan ketika |
| --- | --- |
| Peramban Ogma | Anda menginginkan pengaturan paling sederhana. Peramban bawaan sudah menggunakan proksi Ogma. |
| Peramban atau aplikasi eksternal | Anda memerlukan profil peramban tertentu, emulator seluler, alat CLI, atau klien desktop. Konfigurasikan agar menggunakan Ogma sebagai proksi HTTP. |

Untuk lalu lintas HTTPS, unduh sertifikat CA Ogma dari pengaturan sertifikat dan impor ke profil peramban atau sistem operasi yang Anda gunakan bersama Ogma.

## Alur Kerja Pertama {#first-workflow}

1. Jelajahi aplikasi target.
2. Pastikan baris baru muncul di **Riwayat HTTP**.
3. Buka **Cakupan Pengujian** dan tentukan host target atau ekspresi HTTPQL.
4. Kirim permintaan ke **Kirim Ulang** untuk mengubah dan mengirimnya kembali.
5. Jalankan analisis pasif **Pemindai** terhadap lalu lintas yang direkam.
6. Buat **Temuan** hanya jika buktinya jelas.
7. Ekspor temuan atau lalu lintas yang dipilih saat menyusun laporan.

## Catatan Operasional {#operational-notes}

* Basis data proyek, ekspor, log, data plugin, dan cadangan dapat berisi kredensial, token, dan lalu lintas internal.
* Pengaturan sertifikat mencakup pengunduhan, impor, pencadangan, dan pembuatan ulang CA.
* Instalasi, pembaruan, dan paket marketplace plugin dikelola dari tampilan **Plugin**.

## Pembaruan {#updates}

Ogma memeriksa GitHub Releases untuk mencari pembaruan.

* Build penginstal Windows dan AppImage Linux dapat mendukung pengunduhan serta mulai ulang dari dalam aplikasi.
* Build `.deb` Linux menampilkan pemberitahuan pembaruan dan tautan ke GitHub Releases.
* Build pengembangan lokal yang tidak dipaketkan tidak diperbarui secara otomatis.

## Perlu Bantuan? {#need-help}

* Buat isu: <https://github.com/ogmabox/ogma/issues/new/choose>
* Bergabung di Discord: <https://discord.gg/QNSadmjh6y>