Campagnes C2¶

Les campagnes C2 constituent l'unité organisationnelle de niveau supérieur pour les engagements des équipes rouges chez Stentor. Une campagne regroupe les beacons, les tâches, les informations d'identification et les listeners dans un contexte opérationnel unique, permettant ainsi la création de rapports par engagement, le suivi des activités et l'agrégation des informations d'identification sur toutes les sessions associées.

Aperçu¶

Chaque beacon peut être attribuée à exactement une campagne. Une fois associées, toutes les tâches exécutées via ce beacon et toutes les informations d'identification obtenues à partir de celle-ci sont attribuées à la campagne. Cela alimente le moteur de reporting (PDF, DOCX, CSV, JSON, TSV, XML) et donne aux opérateurs une vue unifiée de l'activité d'engagement.

graph LR
    C[Campaign] --> B1[Beacon 1]
    C --> B2[Beacon 2]
    C --> B3[Beacon 3]
    B1 --> T1[Tasks]
    B2 --> T2[Tasks]
    B3 --> T3[Tasks]
    B1 --> CR1[Credentials]
    B2 --> CR2[Credentials]
    C --> L[Linked Listeners]
    L --> AB[Auto-associate<br/>new beacons]
    C --> R[Reports & Export]

Objet de campagne¶

Campagne CRUD¶

Créer une campagne¶

POST /api/v1/c2/campaigns

curl -s -X POST "https://stentor.app/api/v1/c2/campaigns" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ACME Corp Pentest Q1",
    "description": "Quarterly external penetration test",
    "start_date": "2026-02-01T00:00:00Z",
    "end_date": "2026-02-28T23:59:59Z"
  }' | jq

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "ACME Corp Pentest Q1",
  "description": "Quarterly external penetration test",
  "status": "active",
  "created_by": "operator-uuid",
  "start_date": "2026-02-01T00:00:00Z",
  "end_date": "2026-02-28T23:59:59Z",
  "created_at": "2026-02-21T10:00:00Z",
  "updated_at": "2026-02-21T10:00:00Z",
  "recording_mode": false,
  "beacon_count": 0,
  "credential_count": 0,
  "task_count": 0
}

Les nouvelles campagnes sont créées avec status: "active" par défaut.

Répertorier toutes les campagnes¶

GET /api/v1/c2/campaigns

Renvoie toutes les campagnes de l'opérateur authentifié, classées par ordre d'importance. Chaque campagne de la réponse comprend des valeurs beacon_count, credential_count et task_count en direct calculées via des requêtes par lots.

curl -s "https://stentor.app/api/v1/c2/campaigns" \
  -H "Authorization: Bearer $TOKEN" | jq

Obtenez une campagne¶

GET /api/v1/c2/campaigns/:id

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID" \
  -H "Authorization: Bearer $TOKEN" | jq

Mettre à jour une campagne¶

PUT /api/v1/c2/campaigns/:id

curl -s -X PUT "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ACME Corp Pentest Q1 (Complete)",
    "description": "Engagement completed successfully",
    "status": "archived"
  }' | jq

Supprimer (Archiver) une campagne¶

DELETE /api/v1/c2/campaigns/:id

Les campagnes sont supprimées de manière réversible en définissant leur statut sur archived. Aucune donnée n'est définitivement supprimée.

curl -s -X DELETE "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID" \
  -H "Authorization: Bearer $TOKEN"
# Returns 204 No Content

Association des beacons¶

Les beacons sont attribuées aux campagnes soit manuellement via l'API, soit automatiquement via des listeners liés. Chaque beacon peut appartenir à au plus une campagne à la fois.

Associer un beacon¶

POST /api/v1/c2/campaigns/:id/beacons

curl -s -X POST "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/beacons" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"beacon_id": "beacon-uuid-here"}' | jq

L'association est conservée à la fois dans la base de données et dans le registre des beacons en mémoire.

Dissocier un beacon¶

DELETE /api/v1/c2/campaigns/:id/beacons/:beaconId

curl -s -X DELETE "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/beacons/$BEACON_ID" \
  -H "Authorization: Bearer $TOKEN"
# Returns 204 No Content

Liste des beacons de campagne¶

GET /api/v1/c2/campaigns/:id/beacons

Renvoie toutes les beacons actuellement associées à la campagne à partir du registre des beacons en mémoire.

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/beacons" \
  -H "Authorization: Bearer $TOKEN" | jq

Liaison des listeners¶

Liez les listeners à une campagne afin que toute nouvelle beacon s'enregistrant via cet listener soit automatiquement attribuée à la campagne. Cela élimine le besoin d’associer manuellement chaque nouvelle beacon.

Associer un listener¶

POST /api/v1/c2/campaigns/:id/listeners

curl -s -X POST "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/listeners" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"listener_id": "listener-uuid-here"}' | jq

Dissocier un listener¶

DELETE /api/v1/c2/campaigns/:id/listeners/:listenerId

curl -s -X DELETE "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/listeners/$LISTENER_ID" \
  -H "Authorization: Bearer $TOKEN"
# Returns 204 No Content

Liste des listeners liés¶

GET /api/v1/c2/campaigns/:id/listeners

Renvoie un tableau de chaînes UUID d'écoute.

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/listeners" \
  -H "Authorization: Bearer $TOKEN" | jq

Journal d'activité¶

Le journal d'activité fournit une vue chronologique paginée de toutes les tâches exécutées sur chaque beacon de la campagne.

GET /api/v1/c2/campaigns/:id/activity

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/activity?limit=25&offset=0" \
  -H "Authorization: Bearer $TOKEN" | jq

{
  "tasks": [
    {
      "id": "task-uuid",
      "beacon_id": "beacon-uuid",
      "task_type": "shell",
      "data": "{\"command\":\"whoami\"}",
      "status": "completed",
      "output": "CORP\\jdoe",
      "created_at": "2026-02-21T14:30:00Z",
      "completed_at": "2026-02-21T14:30:01Z"
    }
  ],
  "total": 342
}

Les tâches sont classées les plus récentes en premier. Le champ total active l'interface utilisateur de pagination en signalant le nombre complet de tâches sur toutes les beacons de campagne.

Agrégation d'informations d'identification¶

Récupérez toutes les informations d'identification collectées à partir de n'importe quelle beacon de la campagne en une seule requête.

GET /api/v1/c2/campaigns/:id/credentials

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/credentials" \
  -H "Authorization: Bearer $TOKEN" | jq

Objet d'identification¶

Mode d'enregistrement¶

Activez le mode d'enregistrement sur une campagne pour la signaler pour une journalisation améliorée des activités.

POST /api/v1/c2/campaigns/:id/record-mode

curl -s -X POST "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/record-mode" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}' | jq

Réponse : {"recording_mode": true}

Exportation de campagne¶

Exportez les données de campagne dans plusieurs formats et types de rapports via un seul point de terminaison.

GET /api/v1/c2/campaigns/:id/export?format=<format>&type=<type>

Formats¶

Types de rapports¶

Options DOCX¶

Le format DOCX prend en charge des paramètres de requête supplémentaires pour la personnalisation :

Exemples¶

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/export?format=pdf&type=full" \
  -H "Authorization: Bearer $TOKEN" \
  -o campaign-report.pdf

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/export?format=json&type=ttp" \
  -H "Authorization: Bearer $TOKEN" | jq

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/export?format=csv&type=activity" \
  -H "Authorization: Bearer $TOKEN" \
  -o activity.csv

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/export?format=docx&type=full&mask_emails=true&mask_passwords=true&title=Engagement+Report" \
  -H "Authorization: Bearer $TOKEN" \
  -o engagement-report.docx

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/export?format=xml&type=indicators" \
  -H "Authorization: Bearer $TOKEN" \
  -o indicators.xml

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/export?format=tsv&type=sessions" \
  -H "Authorization: Bearer $TOKEN" \
  -o sessions.tsv

Pour des informations détaillées sur le contenu des rapports, voir Rapports de campagne.

Rapports spécialisés¶

Rapport d'ingénierie sociale¶

Un point de terminaison dédié pour le rapport d'ingénierie sociale au format JSON (séparé du point de terminaison d'exportation) :

GET /api/v1/c2/campaigns/:id/report/social-eng

curl -s "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/report/social-eng" \
  -H "Authorization: Bearer $TOKEN" | jq

Rapports de modèles personnalisés¶

Restituez les données de campagne via un modèle Go personnalisé pour des besoins de reporting sur mesure.

Exécuter le modèle :

POST /api/v1/c2/campaigns/:id/report/custom

curl -s -X POST "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/report/custom" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"template": "Campaign: {{.Name}} | Beacons: {{len .Beacons}}"}' | jq

Valider le modèle (essai à sec) :

POST /api/v1/c2/campaigns/:id/report/validate-template

curl -s -X POST "https://stentor.app/api/v1/c2/campaigns/$CAMPAIGN_ID/report/validate-template" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"template": "{{.Name}}"}' | jq

Réponse : {"valid": true, "error": ""} ou {"valid": false, "error": "template: ...: unexpected ..."}.

Référence API¶

Voir aussi¶

• Rapports de campagne – Types de rapports, formats et détails du contenu
• Intégration MITRE ATT&CK -- Suivi des techniques et export du navigateur
• Artefacts -- IOC enregistrés automatiquement lors de l'exécution de tâches
• Journal d'audit -- Piste d'audit des actions de l'opérateur