---
url: https://docs.ogmabox.com/fr/guide/first-capture.md
description: >-
  Capturez vos premiers échanges HTTP et HTTPS dans Ogma avec le navigateur
  intégré ou un navigateur externe, puis définissez le périmètre et examinez
  l'historique.
---

# Première capture {#first-capture}

Ce guide vous accompagne jusqu'à votre première capture de trafic réussie dans Ogma.

## 1. Démarrer Ogma {#\_1-start-ogma}

1. Ouvrez Ogma.
2. Démarrez l'instance locale depuis le lanceur.
3. Ouvrez l'espace de travail.
4. Vérifiez que l'indicateur de santé de l'instance signale un fonctionnement normal.

Le proxy local écoute par défaut sur `127.0.0.1:8080`. L'API écoute par défaut sur `127.0.0.1:8181`.

## 2. Choisir une méthode de capture {#\_2-choose-a-capture-method}

### Navigateur Ogma {#ogma-browser}

Utilisez le navigateur Ogma pour capturer du trafic le plus rapidement possible.

1. Cliquez sur **Ouvrir le navigateur Ogma**.
2. Saisissez l'URL cible.
3. Parcourez l'application normalement.
4. Revenez dans **Historique HTTP** et vérifiez que des requêtes apparaissent.

Utilisez un profil de navigateur dédié pour isoler les paramètres de proxy, de certificat et de session de vos autres activités.

### Navigateur ou outil externe {#external-browser-or-tool}

Utilisez un navigateur externe, un émulateur mobile, un client en ligne de commande ou un client lourd lorsque la cible nécessite un environnement d'exécution particulier.

Configurez le proxy de l'application :

| Paramètre | Valeur |
| --- | --- |
| Hôte du proxy HTTP | `127.0.0.1` |
| Port du proxy HTTP | `8080` ou le port d'écoute de l'instance |
| Proxy HTTPS | Même hôte et même port |

Pour Firefox ou Chromium, un profil dédié isole l'autorité de certification d'Ogma et ses paramètres de proxy des autres profils du navigateur.

## 3. Activer l'inspection HTTPS {#\_3-enable-https-inspection}

1. Ouvrez **Paramètres > Certificat**.
2. Téléchargez le certificat de l'autorité de certification d'Ogma.
3. Importez-le dans le magasin de confiance du navigateur de test ou du système d'exploitation.
4. Redémarrez le navigateur si nécessaire.
5. Parcourez une cible HTTPS et vérifiez que le trafic déchiffré apparaît dans **Historique HTTP**.

Vous pourrez ensuite gérer, remplacer ou régénérer le certificat de l'autorité de certification depuis **Paramètres > Certificat**.

## 4. Définir le périmètre {#\_4-define-scope}

Le périmètre permet de concentrer les données du proxy sur la cible et facilite la gestion des filtres, des analyses du scanner, des recherches, de l'automatisation et des exports.

1. Ouvrez **Périmètres**.
2. Créez une configuration prédéfinie pour l'hôte cible, le domaine ou une expression HTTPQL.
3. Activez cette configuration.
4. Utilisez les filtres tenant compte du périmètre dans Historique HTTP, Recherche, Scanner, Automatisation (Automate) et les workflows MCP.

Exemple d'expression HTTPQL :

```text
req.host:example.com OR req.host:api.example.com
```

## 5. Examiner le trafic capturé {#\_5-inspect-captured-traffic}

Utilisez ces vues pour un premier examen :

| Vue | Fonction |
| --- | --- |
| **Historique HTTP** | Tableau principal des requêtes et réponses. Ajoutez des étiquettes et des couleurs, filtrez, examinez les corps et envoyez le trafic vers d'autres outils. |
| **Arborescence du site** | Vue d'ensemble de la surface web capturée, organisée par hôte et chemin. |
| **Points d’accès** | Points de terminaison d'API extraits et points de terminaison découverts dans le JavaScript. |
| **Historique WS / SSE** | Connexions et messages WebSocket, ainsi que flux d'événements envoyés par le serveur. |
| **Recherche** | Recherche dans les historiques avec des filtres HTTPQL. |

## 6. Poursuivre les tests {#\_6-continue-testing}

Une fois la capture opérationnelle :

* Envoyez une requête intéressante vers [Rejeu (Replay)](./replay-automation.md).
* Effectuez des vérifications passives dans [Analyse de sécurité](./scanning.md).
* Consignez les preuves confirmées dans **Constats**.
* Exportez les preuves sélectionnées depuis **Exports**.

## Diagnostic rapide {#quick-diagnostics}

| Symptôme | Vérification |
| --- | --- |
| Aucun trafic n'apparaît | Vérifiez que le proxy du navigateur ou de l'application pointe vers le port d'écoute de l'instance Ogma en cours d'exécution. |
| Les sites HTTPS ne fonctionnent pas | Vérifiez que l'autorité de certification d'Ogma est approuvée dans le bon profil de navigateur ou magasin de confiance du système d'exploitation. |
| Seul du trafic sans rapport apparaît | Activez le périmètre et utilisez les filtres correspondants. |
| Les requêtes contournent Ogma | Vérifiez les paramètres de proxy du système, le DNS sur HTTPS du navigateur, le routage fractionné du VPN et les paramètres de proxy propres à l'application. |