Commandes de beacon¶

Stentor fournit plus de 120 commandes de beacon organisées en 7 catégories. Les commandes sont exécutées via la console opérateur (cockpit shell) ou par programme via l'API REST. Chaque commande suit le même flux d'exécution : les entrées de l'opérateur sont analysées par le backend, traduites en tâche, mises en file d'attente pour le beacon, transmises via le relais et exécutées sur la cible.

Flux de commandes¶

sequenceDiagram
    participant Op as Operator
    participant BE as Backend
    participant TQ as Task Queue
    participant RL as Relay
    participant BC as Beacon
    participant Mod as Module

    Op->>BE: Shell command or API call
    BE->>TQ: Parse & enqueue task
    Note over TQ: Task waits for<br>beacon poll
    BC->>RL: Check-in (poll for tasks)
    RL->>TQ: Fetch pending tasks
    TQ-->>RL: Return task(s)
    RL-->>BC: Deliver task(s)
    BC->>Mod: Execute module
    Mod-->>BC: Return result
    BC->>RL: Submit result on next check-in
    RL->>BE: Forward result
    BE-->>Op: Display in console / API response

Les commandes sont asynchrones : l'opérateur reçoit immédiatement un ID de tâche et les résultats arrivent lors de l'enregistrement suivant du beacon. Utilisez checkin pour forcer un cycle d'interrogation immédiat.

Sections¶

Référence rapide¶

Les commandes les plus couramment utilisées dans toutes les catégories. Pour la syntaxe complète et des exemples, consultez chaque page de section.

Opérations sur les fichiers¶

Gestion des processus¶

Réseau¶

Évasion¶

Gestion des sessions¶

Utilisation de l'API¶

Toutes les commandes de beacon peuvent être invoquées par programme via l'API REST :

POST /api/v1/cockpit/beacons/:id/shell

Corps de la demande :

{
  "command": "shell whoami",
  "confirmed": true
}

Le champ confirmed reconnaît les commandes potentiellement destructrices (par exemple, exit, clear, injection de processus). L'API renvoie immédiatement un ID de tâche ; interrogez les résultats via WebSocket ou le point de terminaison des résultats de la tâche.

Exemple :

curl -s -X POST "https://stentor.app/api/v1/cockpit/beacons/$BEACON_ID/shell" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command": "ps", "confirmed": true}'

Pour les points de terminaison REST dédiés (bascules de mise en veille, de sortie et d'évasion), consultez les pages de commande individuelles et la section Référence de l'API.