PHISHCASE / Documentation

Documentation PhishCase

Vous recevez un message, cherchez à le qualifier ou coordonnez une équipe ? Commencez par votre tâche, puis gardez les preuves, la décision et la prochaine étape au même endroit.

Dans l’application : lecture pour les utilisateurs autorisés ; écritures pour les analystes et administrateurs. Les comptes et données PhishCase restent indépendants de SafeScan.

Que souhaitez-vous faire ?

Vue d’ensemble

PhishCase transforme un message suspect en enquête traçable : original préservé, qualification humaine, corrélations expliquées et prochaines actions suivies. Vous pouvez consulter une enquête, analyser un email ou coordonner une équipe sans suivre le même parcours. Community fonctionne en auto-hébergement ; Cloud ajoute comptes, organisations et gouvernance. Les comptes PhishCase restent indépendants de ceux de SafeScan. Les inscriptions commerciales publiques restent fermées pendant la préparation du service.

Déposer un nouveau message

Commencez dans Réception et déposez un EML/MSG. Chaque email est conservé directement avec son original et son analyse. Une campagne est facultative. Le dépôt exige un rôle analyste ou administrateur.

  1. Sélectionnez un EML ou MSG original, ou plusieurs fichiers : jusqu’à 20 fichiers de 20 Mo chacun. Conservez le contexte du signalement séparément.
  2. Déposez les fichiers. L’accusé de réception confirme leur prise en charge ; le worker poursuit le traitement si vous fermez le navigateur.
  3. Ouvrez le message reçu ou retrouvez-le dans Emails. Sélectionnez ensuite les messages utiles pour créer une campagne ou les rattacher à une campagne existante.
  4. Si le traitement échoue, consultez son motif avant une relance explicite. Évitez de réimporter une copie uniquement parce que le traitement est encore en cours.
À l’arrivée

L’original est conservé avec son empreinte et un identifiant d’analyse. Un résultat automatique ne constitue pas encore une décision humaine.

Guide technique dans le dépôt ↗

Emails indépendants

Emails conserve les messages déposés, même sans campagne. Chaque message possède son original, ses pièces jointes, son analyse, son verdict et ses réponses au signalant. Sélectionnez un ou plusieurs emails pour créer une campagne ou les rattacher à une campagne existante. Un email peut appartenir à plusieurs campagnes ; le détacher conserve ses preuves et son verdict.

Guide technique dans le dépôt ↗

Qualifier le message

Ouvrez l’analyse pour lire l’original neutralisé à côté des résultats et de la décision humaine. Le corps n’exécute aucun HTML et ne charge aucune ressource distante. Les preuves, IoC/corrélations et détails techniques restent accessibles dans leurs onglets ; le suivi regroupe les prochaines actions et la réponse au signalant.

La vérification cryptographique DKIM est une action distincte. Un administrateur doit activer DKIM_LOOKUP_ENABLED en Community, ou la permission DKIM de l’organisation en Cloud, dans un mode autorisant les recherches. Le bouton explique que sélecteur et domaine seront envoyés au résolveur DNS ; le message reste local. Le résultat indique une signature valide, invalide, absente ou une vérification indisponible, sans modifier votre verdict.

  1. Lisez le message et comparez expéditeur, Reply-To, liens affichés et destination extraite. Consultez les pièces jointes et les empreintes sans les exécuter.
  2. Relisez les en-têtes, le trajet Received et les observations locales. SPF/DKIM/DMARC reçus sont des déclarations ; ils ne constituent pas une vérification indépendante.
  3. Choisissez parmi huit verdicts : légitime, spam, phishing, vol d’identifiants, livraison de malware, fraude BEC, suspect ou non concluant.
  4. Ajoutez votre niveau de confiance et une justification fondée sur les preuves, puis enregistrez la décision.
  5. Pour réviser une conclusion, rouvrez la décision et relisez l’historique. Exportez JSON, rapport HTML ou package de preuves selon le besoin.
À l’arrivée

La décision de l’analyste reste distincte des résultats automatiques. Son auteur et ses versions sont conservés ; une nouvelle décision concurrente exige de recharger l’historique.

Guide technique dans le dépôt ↗

Travailler à plusieurs analystes

Campagnes distingue Mes campagnes et Équipe. L’attribution organise qui mène l’enquête ; elle ne rend pas la campagne privée et ne sépare pas les droits au sein d’une même équipe. Les organisations Cloud restent séparées.

  1. Consultez Mes campagnes pour reprendre votre travail, ou Équipe pour retrouver une enquête commune.
  2. Attribuez la campagne à un analyste actif et consignez le contexte dans les notes et l’historique. Répartissez les prochaines étapes avec des actions nommées.
  3. Si un collègue a changé la campagne, une action, un brouillon ou un rapprochement pendant votre lecture, rechargez la version demandée avant de reformuler votre modification.
  4. Pour une décision concurrente, relisez le nouvel historique avant de conclure ou de rouvrir. Une version périmée est refusée au lieu d’écraser le travail enregistré.
À l’arrivée

Le responsable, les décisions et les changements restent traçables. Aucun mécanisme ne fusionne les campagnes automatiquement.

Guide technique dans le dépôt ↗

IoC et corrélation

IoC donne accès aux URL, domaines, IP et empreintes extraits, à leurs occurrences et aux emails d’origine. Les raisons de similarité expliquent les éléments partagés : domaine, URL, empreinte, expéditeur ou sujet. Vérifiez l’original, puis documentez l’interprétation dans une campagne. Une correspondance ne prouve ni malveillance ni attribution ; aucun regroupement automatique n’est effectué.

Campagnes

Une campagne regroupe les emails utiles à une investigation collective. Elle porte le nom, la description, les tags, le responsable, la priorité, le statut, les notes, les actions et l’historique. Mes campagnes et Équipe permettent de répartir le travail. Rattachez les emails après examen des similarités ; consultez leurs IoC et leurs verdicts propres. Détacher un email retire seulement la relation. Les modifications exigent la version lue pour préserver le travail des autres analystes.

Guide technique dans le dépôt ↗

Documenter un rapprochement

Depuis une campagne, ou Explorer → Renseignement, documentez un rapprochement possible avec une fuite ou une campagne connue. Enregistrez les sources, faits, limites, hypothèses et votre confiance. Une référence reste du texte et ne déclenche aucun chargement distant.

  1. Saisissez une référence de source et la date d’observation. Les références restent du texte ; leur saisie ne déclenche aucun chargement distant.
  2. Décrivez les faits observés, puis les éléments contradictoires qui pourraient contredire le rapprochement.
  3. Formulez l’hypothèse et votre confiance de 0 à 100. Cette valeur est votre appréciation, pas un score calculé ni une preuve de correspondance.
  4. Liez la campagne concernée, enregistrez et revoyez la fiche lorsque de nouveaux éléments apparaissent.
À l’arrivée

Une hypothèse dispose de sources, de faits et d’éléments contradictoires lisibles. Les correspondances IoC restent des observations distinctes.

Guide technique dans le dépôt ↗

Suivre les prochaines actions

Ajoutez les actions dans le suivi de la campagne ou consultez Actions pour les retrouver dans l’ensemble de l’espace. Elles servent à transformer une conclusion en travail suivi : vérifier un accès, préserver une preuve ou contacter une personne.

  1. Donnez un titre précis à l’action, choisissez son responsable parmi les utilisateurs actifs et indiquez une échéance si elle est connue.
  2. Enregistrez son état : à faire, en cours, terminée ou annulée. La liste et la campagne conservent le même enregistrement.
  3. Pour terminer, documentez la preuve ou le résultat obtenu. Pour annuler, notez le motif ; ces informations sont obligatoires.
  4. Si la campagne est close, rouvrez-la avant de créer ou modifier une action. Si une autre version a été enregistrée, rechargez-la.
À l’arrivée

Une action conserve son responsable, son échéance, son état et son résultat. Les actions encore à faire ou en cours empêchent la clôture de la campagne.

Guide technique dans le dépôt ↗

Répondre au signalant

Préparez le retour au signalant dans le suivi de l’analyse ou de la campagne. Saisissez explicitement son adresse : l’expéditeur du message suspect n’est jamais sélectionné automatiquement comme destinataire. Un brouillon reste possible sans transport d’envoi.

En Community, l’administrateur configure SMTP_HOST et SMTP_FROM, puis SMTP_PORT et les identifiants SMTP_USERNAME/SMTP_PASSWORD si nécessaires. STARTTLS est utilisé par défaut ; SMTP_SSL=true sélectionne TLS implicite. Cloud réutilise son transport SMTP ou Mailgun configuré. La politique de recherche d’IoC ne constitue pas une configuration d’envoi de réponses.

  1. Si la réponse est liée à une analyse, enregistrez d’abord une décision analyste active.
  2. Renseignez le destinataire, l’objet et le brouillon. Choisissez Créer le brouillon et prévisualiser, ou Enregistrer et prévisualiser pour une modification.
  3. Relisez l’adresse et le texte dans la prévisualisation. Même une chaîne qui ressemble à du HTML reste du texte.
  4. Quand le transport est configuré, choisissez Envoyer cette réponse pour transmettre exactement la version prévisualisée. Cette étape reste toujours explicite.
À l’arrivée

Accepté signifie pris en charge par le transport, sans preuve de livraison ni de lecture. Une réponse acceptée ne peut plus être modifiée ou renvoyée.

Guide technique dans le dépôt ↗

Résoudre un envoi interrompu

Un délai expiré peut produire un résultat incertain ; une interruption de service peut laisser une réponse en transmission. Aucun nouvel envoi automatique n’est tenté. Rapprochez le résultat avec les journaux du transport avant de décider de la suite.

  1. Ouvrez la réponse concernée puis Rapprocher le résultat d’envoi. Cette opération nécessite un rôle analyste ou administrateur.
  2. Vérifiez les journaux SMTP ou Mailgun et choisissez une acceptation confirmée, ou un échec confirmé sans acceptation. Ne déduisez pas un échec de la seule absence de message dans la boîte du destinataire.
  3. Renseignez la preuve ou la référence du contrôle puis enregistrez le résultat vérifié. L’opérateur, la date, la preuve et la révision sont conservés.
  4. Après un échec vérifié, vous pouvez modifier le brouillon, le prévisualiser puis l’envoyer explicitement. Le rapprochement lui-même ne transmet rien.
À l’arrivée

Une acceptation vérifiée débloque la clôture sans affirmer la livraison. Une modification concurrente est refusée ; un résultat tardif ne remplace pas le rapprochement déjà enregistré.

Guide technique dans le dépôt ↗

Clore une enquête maîtrisée

Le statut de la campagne organise le travail ; il ne remplace ni le résultat du traitement d’un message ni la qualification de l’analyste. La clôture vérifie les tâches et les messages encore en attente.

  1. Vérifiez que les messages ont fini leur traitement et que chaque analyse terminée dispose d’une décision humaine active.
  2. Terminez ou annulez les actions restantes avec leur résultat ou leur motif.
  3. Rapprochez les réponses encore en transmission. Une acceptation vérifiée ne vaut pas preuve de livraison.
  4. Enregistrez le statut clos. Si la clôture est refusée, revenez à l’élément indiqué et traitez-le avant de réessayer.
À l’arrivée

La campagne ne peut être close avec une action en attente, un message en traitement, une analyse terminée non qualifiée ou une réponse en transmission. Rouvrez-la pour reprendre le travail.

Guide technique dans le dépôt ↗

Prendre en main Cloud

Lorsque les inscriptions sont ouvertes, saisissez votre compte et le nom d’organisation, puis validez le lien reçu par email. L’essai inclut 14 jours et 30 analyses. L’espace Cloud permet de gérer membres, intégrations, abonnement et politique de rétention selon le rôle et l’offre ; les webhooks et les opérations de purge disposent d’une API administrateur. L’organisation active détermine les données visibles. La facturation est actuellement testée avec un simulateur ; les paiements réels et inscriptions commerciales restent fermés.

Comptes et sessions

Utilisez un mot de passe unique et activez MFA. Community démarre par un administrateur créé au terminal ; Cloud utilise une vérification email et des invitations. Les sessions utilisent des cookies HttpOnly ; les écritures du navigateur exigent une protection CSRF. Les jetons API sont personnels, limités dans le temps et affichés une seule fois. La réinitialisation des identifiants révoque les sessions obsolètes. SSO/OIDC/SAML/LDAP restent prévus, sans connexion IdP livrée dans cette version.

La navigation Profil donne accès à Mon compte et aux fonctions administrateur autorisées. Explorer regroupe la vue d’ensemble, les analyses, la recherche et le renseignement ; les cinq entrées principales restent Réception, Emails, IoC, Campagnes et Actions. Les menus sont utilisables au clavier et se ferment avec Échap. Les guides courts des principales tâches sont facultatifs et rejouables.

Authentification multifacteur

Dans les paramètres du compte, démarrez la configuration TOTP, ajoutez le secret à votre application d’authentification puis confirmez avec un code valide. Rangez les codes de récupération séparément ; chacun ne s’utilise qu’une fois. Ne les envoyez pas au support. La clé de chiffrement applicative doit accompagner la sauvegarde sécurisée pour récupérer les secrets MFA. Perdre le téléphone et les codes demande une procédure de récupération administrée.

Rôles et sièges

Un lecteur consulte les données accessibles sans les modifier. Un analyste importe des messages et mène les investigations. Un administrateur gère les membres et la configuration. En Cloud, seuls les administrateurs et analystes, ainsi que leurs invitations en attente, consomment les sièges 3/10/25 ; les lecteurs en sont exclus. La console opérateur SaaS expose des métadonnées d’exploitation, sans conférer automatiquement un accès aux emails des clients.

Enrichissements et partage

Le parsing initial reste local dans tous les modes. Déclenchez un enrichissement depuis une analyse existante, après lecture des données envoyées. Une recherche transmet l’IoC sélectionné ; une soumission envoie le fichier choisi ou demande au provider de visiter une URL. Une absence de résultat ne provoque jamais une soumission automatique. Community lit les clés dans les secrets serveur ; Cloud utilise les paramètres administrateur propres à l’organisation, avec clés chiffrées et permissions séparées.

Guide technique dans le dépôt ↗

VirusTotal

La recherche de fichier envoie son SHA-256, pas son contenu. Les recherches URL, domaine et IP transmettent ces valeurs. Les soumissions fichier/URL exigent le mode connected et une permission distincte ; les résultats en attente se consultent explicitement. Les compteurs inconnu, inoffensif, suspect et malveillant restent séparés. Cette intégration utilise l’API standard, pas Private Scanning. Vérifiez auprès du fournisseur les droits et usages de votre licence avant tout usage commercial.

Guide technique dans le dépôt ↗

urlscan.io

Recherchez un scan existant ou soumettez explicitement une URL extraite. La visibilité par défaut est private ; un refus de votre offre ne provoque jamais de repli silencieux vers public. Unlisted ne signifie pas privé. Les résultats peuvent inclure titre, domaine, IP, score et redirections partielles. Les captures et rapports externes nécessitent une action explicite et peuvent demander une authentification chez le provider. PhishCase ne visite pas la page suspecte.

Guide technique dans le dépôt ↗

Modes de connectivité

Offline bloque les enrichissements externes et les vérifications DNS facultatives. Restricted permet uniquement les recherches autorisées ; connected permet aussi les types de soumission activés. Une clé ne vaut jamais consentement d’envoi. Les résultats déjà enregistrés restent consultables hors ligne. Pour une frontière réseau indépendante de la politique logicielle, configurez aussi le pare-feu/les réseaux Docker. Les services Cloud d’authentification email et de facturation ont leurs propres connexions d’exploitation.

Confidentialité technique

Les emails peuvent contenir des données personnelles et des secrets. Limitez les accès, évitez les soumissions inutiles et exportez uniquement les preuves nécessaires. Le site public n’intègre ni analytics ni ressources tierces ; il conserve seulement le choix de langue dans le navigateur. L’application conserve les sessions nécessaires à l’authentification. Consultez la page Confidentialité pour le stockage, les destinataires, les durées et les documents à valider avant commercialisation.

Lire la page dédiée ↗

Rétention et suppression

Cloud propose 90/180/365 jours selon l’offre, avec réduction par l’administrateur. La version actuelle demande une prévisualisation puis une confirmation de purge ; aucun ordonnanceur n’efface automatiquement les preuves à échéance. Les analyses en cours sont exclues. Relisez les éléments sélectionnés et reprenez les nettoyages marqués en attente. Campagnes, notes, audit, facturation et sauvegardes ont un cycle distinct ; une purge locale ne retire pas une soumission déjà envoyée à un provider.

Les réponses liées à une analyse apparaissent dans le périmètre de rétention. Une transmission active bloque la purge de l’analyse concernée ; rapprochez son résultat avant de reprendre une opération de suppression.

Sécurité et limites

Les originaux sont vérifiés par SHA-256 ; téléchargements authentifiés en pièce jointe, sans cache et sans détection MIME automatique. Les limites CPU/mémoire/temps et MIME réduisent les risques du parsing, sans constituer une sandbox de détonation. Les fichiers ne sont pas chiffrés individuellement au repos : protégez le disque hôte. La page Sécurité détaille les frontières et le signalement privé. Ne publiez aucun email confidentiel, secret ou détail exploitable dans une issue publique.

Guide technique dans le dépôt ↗

Lire la page dédiée ↗

Démarrage rapide

Clonez la branche candidate, sélectionnez la révision indiquée, copiez la configuration puis démarrez Docker. Aucun compte par défaut n’existe. La commande de création d’administrateur demande les informations dans le terminal. Ouvrez ensuite http://127.0.0.1:8088, connectez-vous et importez un petit EML de test. Conservez le volume après chaque redémarrage.

git clone --branch codex/pastel-identity-20261025 https://github.com/CybersecSpirit/phishcase.git
cd phishcase
git checkout 2d0d1c550dbf088391b1cf349e091c3ef1a61568
cp .env.example .env
docker compose up -d --build
docker compose ps
docker compose exec phishcase python -m backend.investigation.store

Installation Community

Prérequis : Git, Docker Engine et Docker Compose, un stockage persistant et des ressources suffisantes pour les limites du conteneur (2 Gio). Community fonctionne sans clé provider. Gardez CONNECTIVITY_MODE=offline pour le premier essai. Tous les membres actifs lisent les preuves de l’équipe : une affectation de campagne ne crée pas une séparation des droits. Utilisez des instances séparées ou Cloud pour des organisations distinctes.

Guide technique dans le dépôt ↗

Docker et persistance

Le fichier Compose principal lance API, worker et SpamAssassin local. Le service écoute seulement sur la boucle locale ; /data contient SQLite, les preuves et la clé MFA générée si elle n’est pas fournie. Vérifiez docker compose ps puis /ready. docker compose down conserve les volumes ; l’option -v les détruit et ne fait jamais partie d’une mise à jour normale. Conservez l’image précédente pour le retour arrière.

Guide technique dans le dépôt ↗

Déploiement en production

Placez l’application derrière un proxy HTTPS, activez COOKIE_SECURE=true et limitez les requêtes à 21 Mio pour une limite de fichier de 20 Mio. Protégez volumes et fichiers de secrets. /health indique que le serveur répond ; /ready vérifie aussi base, stockage et présence récente du worker. En Cloud, PostgreSQL reste sur le réseau Docker interne. Avant l’ouverture : livraison des emails, restauration, supervision et conditions du service doivent être vérifiées.

Déploiement Plesk

Plesk conserve les ports 80/443 et les certificats. Créez les sous-domaines site, docs et app, pointez leurs DNS vers le VPS et émettez les certificats avant de forcer HTTPS. Routez leurs emplacements / vers les ports locaux 8086, 8087 et 8088. Préservez les règles ACME, remplacez les en-têtes forwarded clients et utilisez un délai de 60 secondes. Ne modifiez pas les vhosts générés ni les sites existants. Le guide privé PLESK.md donne les directives exactes et les contrôles de retour arrière.

Sauvegarde chiffrée

Arrêtez les écritures pendant une sauvegarde opérationnelle cohérente. Community sauvegarde SQLite et les preuves ; Cloud utilise pg_dump avec les preuves référencées. L’archive authentifiée inclut configuration explicite et clé MFA/applicative. La clé d’archive reste séparée. Programmez une fenêtre et une rétention adaptées ; le logiciel ne configure pas automatiquement cette planification. Gardez une copie indépendante du serveur lorsque cette destination est autorisée. Une sauvegarde sur le même VPS ne couvre pas sa perte totale.

Guide technique dans le dépôt ↗

Restaurer et vérifier

Restaurez uniquement dans une base et un répertoire vides, sur une pile isolée. Vérifiez la version de l’image, les clés et les destinations externes avant de lancer le worker : une restauration remet aussi les files et sessions à leur état sauvegardé. Contrôlez connexion MFA, hash d’un original, pièce jointe, quota et séparation des organisations. Exigez /ready avant de basculer le proxy. N’écrasez jamais la production pour tester la restauration.

Guide technique dans le dépôt ↗

Mettre à jour

Choisissez une révision examinée, sauvegardez puis conservez les références des images et migrations. Construisez la nouvelle image. Community applique ses migrations additives au démarrage ; Cloud demande explicitement alembic upgrade head avant l’API/worker. Un échec de migration interdit la remise en ligne. Un retour à l’ancienne image n’est sûr que si elle comprend le schéma courant ; sinon restaurez le snapshot précédent dans une autre pile puis basculez après vérification.

La simplification Emails/Campagnes utilise SQLite 2026101002, Cloud Alembic 20261010_0005 et tenant 20261010_tenant_0003. Les dossiers automatiques sans contexte deviennent des emails indépendants. Le contexte utile devient une campagne, avec conservation des responsables, notes, actions, réponses, relations et historiques. Les anciens liens sont archivés et redirigés. Arrêtez les écritures, sauvegardez et vérifiez une restauration et la migration sur une copie avant la production. Un retour à une ancienne image nécessite une sauvegarde compatible.

Dépannage

503 sur /ready : vérifiez PostgreSQL/SQLite, permissions du volume et worker récent. Analyse bloquée : contrôlez l’état du job, attendez l’expiration du bail après un arrêt puis utilisez la relance explicite si failed. 413 : vérifiez taille de fichier et proxy. 403 provider : relisez mode, rôle et permission de l’opération ; n’activez pas une soumission pour résoudre un échec de recherche. Email de compte absent : vérifiez SMTP et l’outbox sans imprimer les jetons. Après modification des secrets, recréez le service concerné.

409 pendant une modification : rechargez l’élément indiqué. Clôture refusée : terminez les actions, qualifiez les analyses et vérifiez les transmissions restantes. Transport non configuré : conservez le brouillon puis demandez la configuration SMTP ou Mailgun. Envoi incertain : utilisez le rapprochement avec une preuve, sans relance automatique.

API et ingestion

Créez un jeton depuis un compte autorisé et conservez-le dans un gestionnaire de secrets. Community expose /api/v1 ; Cloud expose les investigations sous /api/workspace et les comptes sous /api/cloud. Envoyez un multipart file à /analyses ; la réponse 202 fournit un ID à suivre jusqu’à completed ou failed. Un Idempotency-Key stable sécurise une même tentative répétée. Paginer avec page/page_size évite les réponses incomplètes. Consultez le contrat API Community pour les codes 401/403/409/413/422/429.

POST /analyses conserve un email indépendant. POST /campaigns peut recevoir analysis_ids ; POST /campaigns/{id}/emails et DELETE /campaigns/{id}/emails/{analysis_id}?revision=… gèrent les relations. GET /analyses/{id}/campaigns expose ses campagnes. Renvoyez la révision pour les campagnes, relations, actions, brouillons et rapprochements. La décision utilise l’identifiant de dernière décision lue. Un 409 demande de recharger. Les tables cases et campaign_cases servent uniquement à la compatibilité et à la traçabilité historiques.

Guide technique dans le dépôt ↗

Webhooks sortants

Les administrateurs Team/Business configurent jusqu’à cinq destinations HTTPS publiques. Les événements d’analyse, de verdict et de campagne contiennent des identifiants et états, sans corps d’email ni pièce jointe. Enregistrez le secret affiché une seule fois. Vérifiez HMAC-SHA256 sur timestamp + "." + corps HTTP brut, la fraîcheur du timestamp et l’unicité de l’ID. Le destinataire doit dédupliquer : une livraison peut être répétée. La rotation remplace immédiatement le secret, y compris pour les tentatives en attente.

Architecture

Le cœur associe API, file persistante, worker, parseur borné et stockage de preuves immuables. Community utilise SQLite. Cloud ajoute un plan de contrôle PostgreSQL et des schémas d’enquête par organisation, sélectionnés côté serveur à partir de l’identité authentifiée. L’isolation est applicative avec un rôle PostgreSQL partagé ; elle ne constitue pas une séparation par OS ou compte DB. Redis, haute disponibilité et stockage objet distribué ne sont pas requis pour cette V1 monohôte.

Guide technique dans le dépôt ↗

Architecture open-core

Community est publique sous MIT et fonctionne seule. Le dépôt privé Enterprise référence une révision précise du cœur par sous-module, puis construit son adaptateur et ses interfaces. Les corrections génériques restent publiques ; provisioning, abonnement et exploitation SaaS restent privés. L’historique et la notice MIT de eml_analyzer/Manabu Niseki sont préservés. Détacher le dépôt du réseau de forks ne supprime ni l’ascendance ni les obligations d’attribution.

Guide technique dans le dépôt ↗

Enterprise et prestations

Enterprise On-Premise est proposé sur demande, selon le périmètre validé. Installation, migration, configuration, accompagnement, formation, intégration SIEM/SOAR et maintenance renforcée sont des prestations à cadrer avec l’éditeur. SSO/LDAP, connecteurs premium et MSSP restent des développements prévus, pas des fonctions actives de cette candidate. Définissez le périmètre, la licence commerciale et le support avant engagement.

Développement et tests

Le cœur demande Python 3.14, Node 24, uv et libmagic. Installez les dépendances verrouillées, construisez le frontend puis lancez API et worker avec les mêmes chemins de données. Utilisez des fixtures synthétiques et une base séparée. Les tests historiques demandent SpamAssassin ; les tests Cloud demandent PostgreSQL 17. Stripe reste simulé sans compte, ou en mode test avec votre propre compte. Dev, tests, staging et production ne doivent partager ni base, volumes, clés ni destinations de notification.

Guide technique dans le dépôt ↗

Contribuer

Ouvrez une branche et une pull request ciblée dans Community pour une amélioration générique. Décrivez le problème, le comportement et les vérifications ; préservez les notices MIT et n’ajoutez aucun secret ni véritable email client aux fixtures. Suivez CONTRIBUTING.md et SECURITY.md. Les extensions commerciales évoluent dans le dépôt privé.

Guide technique dans le dépôt ↗

Périmètre et suite

Le périmètre comprend dépôt EML/MSG et API, qualification humaine, corrélations, travail d’équipe, actions persistantes, réponse au signalant avec rapprochement de transport et hypothèses sourcées, ainsi que comptes/organisations et exploitation Docker. Collecte email entrante, add-ins, SSO, MSSP, connecteurs premium et architecture distribuée restent des évolutions prévues. Les vérifications locales ne remplacent pas la validation de livraison SMTP, d’un compte Stripe de test ou des droits contractuels provider avant commercialisation.