Quickstart

Mise en route en 3 étapes pour un nouveau membre de l’équipe MSSP.

Ce quickstart cible les nouveaux admins/analystes MSSP qui rejoignent l’équipe. Pour les clients PME, voir Onboarding client.

Pré-requis

1. Compte Entra ID actif

   Tu as un compte Entra ID dans le tenant SnakySec avec rôle MSSP_ADMIN ou ANALYST. Si non, demande à un MSSP_ADMIN existant de te provisionner via le portail /dashboard/settings/users.

2. Accès au repo GitLab

   Tu peux accéder à gitlab.com/snakysec-group/mssp-snakysec-multi-tenants en lecture (au minimum). Le repo est privé.

3. Stack locale (optionnel)

   Si tu vas développer ou debugger : Docker Desktop installé, ports 3000/5432/6379/8200/8080 libres, ~10 GB de disque libre.

1. Comprends la topologie

Client (DSI PME)              Admin MSSP (toi)
     │                             │
     ▼                             ▼
┌────────────────────┐    ┌────────────────────┐
│  /portal/*         │    │  /dashboard/*      │
│  read-only views   │    │  full RBAC         │
└─────────┬──────────┘    └─────────┬──────────┘
          │                          │
          └──────────┬───────────────┘
                     │
              ┌──────▼───────┐
              │  Next.js 16  │  HMR + RSC + Turbopack
              │  + NextAuth  │  Entra ID SSO multi-tenant
              └──────┬───────┘
                     │
      ┌──────────────┼──────────────┐
      ▼              ▼              ▼
 ┌────────┐    ┌─────────┐    ┌──────────┐
 │Postgres│    │  Vault  │    │  BullMQ  │
 │ pg16   │    │ Shamir  │    │ + Redis  │
 │+pgbk   │    │  5/3    │    │ workers  │
 └────────┘    └─────────┘    └──────────┘
      │              │              │
      └──────┬───────┴──────────────┘
             ▼
       OVH Gravelines  +  Scaleway Paris
       (backups chiffrés AES-256, Object Lock 90j)

Détails : Architecture et DR — backup strategy.

2. Prends connaissance des conventions

Trois lectures incontournables dans cet ordre :

Glossaire FR/EN canonique

Vocabulaire produit. Tu écris « Écart » en FR, jamais « Finding ». « Lancer » pour un audit, jamais « Trigger ». Linter CI bloque les variantes.

DR Policy

RTO/RPO cibles, qui détient les Shamir keys, comment escalader un incident.

Patterns UI

Card-as-link, breadcrumb obligatoire profondeur >2, tabs URL-synced, toast pour erreurs side-effect. Si tu touches au front, c’est ta bible.

3. Lance ton premier audit reference

1. Login sur snakysec.com

   SSO Entra ID. Si c’est ta première fois, accepte le consent.

2. Vue dashboard

   Tu vois le dashboard MSSP. Si une carte « Audits en cours » apparaît, c’est qu’un audit tourne sur un autre tenant. Sinon, dashboard calme = bon signe.

3. Tenant SnakySec (référence interne)

   Va sur Clients → SnakySec. C’est notre tenant E5 de référence (220 contrôles évalués, ~77% automation). Sert de baseline pour tester le flow.

4. Lancer un audit

   Bouton Lancer un audit en haut à droite. Sélectionne framework=cis, productArea=entra pour un run rapide (~2 min). Le pipeline GitLab CI démarre, le webhook reçoit les résultats, l’import worker fait le mapping en DB.

5. Lecture résultats

   Quand l’audit passe à COMPLETED, va sur Audits → [le run]. Tu vois le score, les écarts par sévérité, le DICT radar, et tu peux exporter le rapport PDF/HTML/Excel. Le tab Compare to previous montre le diff vs la run précédente.

Ne jamais lancer un audit sur un tenant client en production sans son accord écrit. Le scope du contrat client doit explicitement couvrir l’audit en cours. Cf. Onboarding client §Mandate scope.

Pour aller plus loin

Setup local dev

Cloner le repo, lancer make preprod, accéder à app.localhost.

Runbooks DR

Procédures restore Postgres, Vault, artifacts. À lire avant un incident, pas pendant.

Catalogue 220 contrôles

Liste exhaustive avec mappings ISO 27001 / NIS2 / DORA / eIDAS.

Project state

Où en est la V1, quels chantiers actifs.