---
url: https://docs.ogmabox.com/cs/getting-started.md
description: >-
  Nainstalujte Ogma, spusťte lokální instanci proxy, nastavte zachytávání,
  prohlížejte provoz a přejděte k opakovanému odesílání, skenování a tvorbě
  zpráv.
---

# Začínáme {#getting-started}

Ogma je desktopová sada nástrojů pro zachytávání, prohlížení, opakované odesílání, automatizaci, skenování a dokumentování provozu webových aplikací.

Tato stránka vás provede od nové instalace k funkční relaci proxy. Celý postup prvního testu najdete v průvodci [První zachycení provozu](./guide/first-capture.md).

## Požadavky {#requirements}

* Podporovaná desktopová platforma: Linux, Windows nebo macOS.
* Prohlížeč nebo aplikace, která může používat HTTP proxy.
* Pro dešifrování a kontrolu provozu HTTPS lokální certifikát CA Ogma importovaný do profilu prohlížeče nebo operačního systému používaného pro testování.

## Instalace Ogma {#install-ogma}

Stáhněte si nejnovější vydání z GitHubu:

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

Dostupné balíčky závisí na konkrétním vydání:

| Platforma | Balíček | Poznámky |
| --- | --- | --- |
| Windows | Instalátor NSIS | Doporučeno pro běžné uživatele. Podepisování kódu může být přidáno v budoucím vydání. |
| macOS | Balíček aplikace nebo archiv | Dostupnost závisí na souborech daného vydání. |
| Linux | AppImage | Přenosný balíček s podporou aktualizací přímo v aplikaci. |
| Linux | `.deb` | Doporučeno pro systémy typu Debian/Ubuntu. Aktualizace se instalují nahrazením balíčku. |

## Spuštění instance {#start-an-instance}

1. Otevřete Ogma.
2. V úvodním spouštěči spusťte lokální instanci.
3. Otevřete pracovní prostor. Pokud není instance nastavena jinak, Ogma ve výchozím nastavení naslouchá jako HTTP proxy na `127.0.0.1:8080` a poskytuje API na `127.0.0.1:8181`.
4. Pokud chcete trvale uchovávat oddělená testovací data, vytvořte nebo vyberte projekt.

## Nastavení zachytávání {#configure-capture}

Provoz můžete zachytávat dvěma způsoby:

| Způsob | Kdy jej použít |
| --- | --- |
| Prohlížeč Ogma | Chcete nejjednodušší nastavení. Vestavěný prohlížeč již používá proxy Ogma. |
| Externí prohlížeč nebo aplikace | Potřebujete konkrétní profil prohlížeče, mobilní emulátor, nástroj CLI nebo tlustého klienta (thick client). Nastavte v něm Ogma jako HTTP proxy. |

Pro provoz HTTPS stáhněte certifikát CA Ogma z nastavení certifikátů a importujte jej do profilu prohlížeče nebo operačního systému, který s Ogma používáte.

## První pracovní postup {#first-workflow}

1. Procházejte cílovou aplikaci.
2. Ověřte, že v **Historii HTTP** přibývají nové řádky.
3. Otevřete **Rozsahy testování** a definujte cílového hostitele nebo výraz HTTPQL.
4. Odešlete požadavek do **Opakovaného odesílání**, upravte jej a odešlete znovu.
5. Spusťte pasivní analýzu zachyceného provozu ve **Skeneru**.
6. Vytvářejte **Nálezy** pouze tehdy, když jsou důkazy jasné.
7. Při tvorbě zprávy exportujte nálezy nebo vybraný provoz.

## Provozní poznámky {#operational-notes}

* Databáze projektů, exporty, protokoly, data pluginů a zálohy mohou obsahovat přihlašovací údaje, tokeny a interní provoz.
* Nastavení certifikátů zahrnuje stažení, import, zálohování a opětovné vygenerování CA.
* Instalace a aktualizace pluginů i balíčky z katalogu pluginů se spravují v zobrazení **Zásuvné moduly**.

## Aktualizace {#updates}

Ogma kontroluje aktualizace na GitHub Releases.

* Verze s instalátorem pro Windows a Linux AppImage mohou podporovat stažení a restart přímo v aplikaci.
* Verze Linux `.deb` zobrazují oznámení o aktualizacích a odkazují na GitHub Releases.
* Lokální rozbalené vývojové verze se automaticky neaktualizují.

## Potřebujete pomoc? {#need-help}

* Nahlaste problém: <https://github.com/ogmabox/ogma/issues/new/choose>
* Připojte se na Discord: <https://discord.gg/QNSadmjh6y>
