---
url: https://docs.ogmabox.com/ru/getting-started.md
description: >-
  Установите Ogma, запустите локальный экземпляр прокси, настройте перехват,
  изучите трафик и переходите к повторной отправке, сканированию и подготовке
  отчётов.
---

# Начало работы {#getting-started}

Ogma — десктопный набор инструментов для перехвата, анализа, повторной отправки, автоматизации, сканирования и документирования трафика веб-приложений.

Эта страница поможет пройти путь от установки до рабочей сессии прокси. Полный сценарий первого теста описан в руководстве [Первый перехват трафика](./guide/first-capture.md).

## Требования {#requirements}

* Поддерживаемая десктопная платформа: Linux, Windows или macOS.
* Браузер или приложение, поддерживающее HTTP-прокси.
* Для анализа HTTPS — локальный сертификат CA Ogma, импортированный в браузер или профиль операционной системы, используемый для тестирования.

## Установка Ogma {#install-ogma}

Скачайте последний релиз с GitHub:

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

Доступные пакеты зависят от релиза:

| Платформа | Пакет | Примечания |
| --- | --- | --- |
| Windows | Установщик NSIS | Рекомендуется для обычного использования. Подпись кода может появиться в будущем релизе. |
| macOS | Пакет приложения или архив | Доступность зависит от артефактов релиза. |
| Linux | AppImage | Портативный пакет с обновлением из приложения. |
| Linux | `.deb` | Рекомендуется для систем семейства Debian/Ubuntu. Обновления устанавливаются заменой пакета. |

## Запуск экземпляра {#start-an-instance}

1. Откройте Ogma.
2. В окне запуска запустите локальный экземпляр.
3. Откройте рабочее пространство. По умолчанию Ogma использует адрес HTTP-прокси `127.0.0.1:8080` и API `127.0.0.1:8181`, если экземпляр не настроен иначе.
4. Создайте или выберите проект, если хотите сохранять данные тестирования отдельно.

## Настройка перехвата {#configure-capture}

Перехватывать трафик можно двумя способами:

| Способ | Когда использовать |
| --- | --- |
| Браузер Ogma | Нужна простейшая настройка. Встроенный браузер уже направляет трафик через Ogma. |
| Внешний браузер или приложение | Нужен определённый профиль браузера, мобильный эмулятор, CLI-инструмент или толстый клиент. Настройте его на использование Ogma как HTTP-прокси. |

Для HTTPS скачайте сертификат CA Ogma в настройках сертификатов и импортируйте его в браузер или профиль операционной системы, используемый с Ogma.

## Первый рабочий сценарий {#first-workflow}

1. Откройте целевое приложение в браузере.
2. Убедитесь, что в разделе **История HTTP** появляются новые строки.
3. Откройте раздел **Область тестирования** и задайте целевой хост или выражение HTTPQL.
4. Отправьте запрос в раздел **Повторная отправка**, чтобы изменить и повторно отправить его.
5. Запустите пассивный анализ перехваченного трафика в разделе **Сканер**.
6. Создавайте записи в разделе **Находки** только при наличии убедительных доказательств.
7. Экспортируйте результаты проверки безопасности или выбранный трафик для отчёта.

## Особенности эксплуатации {#operational-notes}

* Базы проектов, экспортированные данные, журналы, данные плагинов и резервные копии могут содержать учётные данные, токены и внутренний трафик.
* Настройки сертификатов позволяют скачивать и импортировать CA, создавать её резервную копию и генерировать заново.
* Установка и обновление плагинов, а также пакеты из каталога управляются в разделе **Плагины**.

## Обновления {#updates}

Ogma проверяет наличие обновлений в GitHub Releases.

* Сборки с установщиком Windows и Linux AppImage могут поддерживать скачивание и перезапуск из приложения.
* Сборки Linux `.deb` показывают уведомления об обновлениях и ссылку на GitHub Releases.
* Локальные распакованные сборки для разработки автоматически не обновляются.

## Нужна помощь? {#need-help}

* Создайте issue: <https://github.com/ogmabox/ogma/issues/new/choose>
* Присоединитесь к Discord: <https://discord.gg/QNSadmjh6y>