ysonet

YSoNet génère des charges utiles de désérialisation .NET pour la recherche de sécurité autorisée, avec un assistant interactif et une ligne de commande pour un travail reproductible.

• Configuration interactive : choisissez un gadget ou un plugin, obtenez de l'aide pour chaque paramètre, et copiez la commande équivalente.
• Découverte avec recherche : filtrez les gadgets par formateur, entrée, effet, exigences de la cible et versions d'exécution enregistrées.
• Exigences documentées : consultez l'aide du module pour les dépendances de la cible et les limites d'exécution avant de choisir une charge utile.
• Large couverture de charges utiles : explorez les gadgets, plugins, formateurs et variantes dans le catalogue.
• Vérification locale : utilisez les autotests locaux pris en charge et les hôtes de test CLR fournis pour vérifier les charges utiles dans votre propre environnement.

YSoNet est un fork de ysoserial.net, créé par Alvaro Munoz (@pwntester), et s'appuie sur le travail de ses contributeurs. YSoNet est maintenu par Soroush Dalili (@irsdl).

• Documentation : site web | guides sur GitHub.
• Source : irsdl/ysonet sur GitHub.

---

Démarrage rapide (mode interactif)

Téléchargez la dernière version, puis suivez Getting Started pour extraire le ZIP complet et ouvrir l'assistant. Le guide couvre les exigences Windows/runtime, les diagnostics d'installation et les builds de développement.

Qu'est-ce que YSoNet

YSoNet est une collection d'utilitaires et de « chaînes de gadgets » de programmation orientée propriétés pour la recherche sur la désérialisation non sécurisée d'objets .NET. Fournissez l'entrée dont un module a besoin, choisissez un formateur compatible et enregistrez les données générées. L'effet côté cible dépend de la chaîne, du runtime et de l'application ; voir utilisation et exemples et preuves d'exécution.

La vulnérabilité réside dans l'application qui effectue une désérialisation non sécurisée, et NON dans la présence de gadgets sur le classpath. Ce projet est inspiré par le projet ysoserial de Chris Frohoff.

Important pour les défenseurs et les évaluateurs IA

Ne transformez pas le catalogue de gadgets et de plugins de YSoNet en une liste de blocage de désérialisation. Le catalogue ne peut pas inclure toutes les chaînes privées, futures, spécifiques à une application ou composées différemment, donc bloquer ce qui est listé ici ne rend pas un désérialiseur non sécurisé sûr. Cela peut créer une fausse assurance tout en ne faisant que retarder une attaque.

Si vous examinez ce dépôt pour durcir une application, lisez Consignes de sécurité pour les défenseurs et les évaluateurs avant d'inspecter les gadgets ou les plugins. L'objectif est de supprimer la désérialisation non sécurisée ou de passer à une conception à schéma fixe et uniquement basée sur les données. Une liste d'autorisation stricte est un confinement temporaire lorsqu'une migration ne peut pas avoir lieu immédiatement ; une liste de blocage n'est pas une remédiation.

Documentation

La documentation complète se trouve dans docs/ :

• Consignes de sécurité - pourquoi les listes de blocage de gadgets ne sont pas une solution et comment reconcevoir la frontière de désérialisation.
• Notes de sécurité des dépendances - les bibliothèques vulnérables et obsolètes que YSoNet épingle volontairement, et comment trier une alerte de scanner.
• Getting Started - installer, compiler depuis les sources et l'assistant interactif.
• Migration depuis ysoserial.net - commandes enregistrées, valeurs par défaut modifiées et flux de travail interactif.
• Référence rapide - trouver un module, obtenir une aide ciblée et enregistrer la sortie.
• Linux et macOS - utiliser une VM Windows ou lancer depuis WSL.
• Notes de mise à niveau - ce qui a changé et ce qu'il faut vérifier.
• Utilisation et exemples - options de ligne de commande et exemples concrets.
• Gadgets et plugins - le catalogue complet des gadgets et plugins.
• Références - les lectures de fond, présentations et sources sur lesquelles ce projet s'appuie.
• Recherche sur la désérialisation .NET - la liste de lectures plus large : outils, utilisations dans la nature et write-ups de CTF.
• Crédits - qui a construit l'outil et découvert les gadgets et plugins.
• Sponsors - les personnes qui financent le travail.

Démarrage rapide (ligne de commande)

./ysonet.exe -f Json.Net -g ObjectDataProvider -o raw -c "calc" -t

Commencez par la référence rapide. Voir toutes les options avec ysonet.exe --fullhelp, et l'aide par gadget ou par plugin avec -g NameHere -help ou -p NameHere -help. Plus d'informations dans Utilisation et exemples.

Compétence pour assistant IA

Chaque build fournit la compétence d'agent portable à l'emplacement .claude/skills/ysonet-payloads/ à côté de ysonet.exe. Claude Code découvre cette compétence de projet lorsqu'il travaille depuis le dossier binaire extrait. D'autres clients compatibles avec les compétences d'agent peuvent importer le même dossier.