decalage2/oletoolsBoîte à outils Python pour analyser les documents MS OLE2 et Office, extraire les macros VBA, détecter les exploits et effectuer une analyse forensique des fichiers de stockage structuré.
oletools est un ensemble d'outils python pour analyser les fichiers Microsoft OLE2 (également appelés Structured Storage, Compound File Binary Format ou Compound Document File Format), tels que les documents Microsoft Office 97-2003, les fichiers MSI ou les messages Outlook, principalement pour l'analyse de malwares, la criminalistique numérique et le débogage. Il est basé sur l'analyseur olefile.
Il fournit également des outils pour analyser les fichiers RTF et les fichiers basés sur le format OpenXML (alias OOXML) tels que les documents MS Office 2007+, les fichiers XPS ou MSIX.
Par exemple, oletools peut détecter, extraire et analyser les macros VBA, les objets OLE, les macros Excel 4 (XLM) et les liens DDE.
Voir http://www.decalage.info/python/oletools pour plus d'informations.
Liens rapides : Page d'accueil - Téléchargement/Installation - - - - -
Remarque : python-oletools n'est pas lié à OLETools publié par BeCubed Software.
Voir le journal des modifications complet pour plus d'informations.
oletools est utilisé par un certain nombre de projets et de services d'analyse de malwares en ligne, notamment ACE, ADAPT, Anlyz.io, AssemblyLine, Binary Refinery, CAPE, CinCan, Cortex XSOAR (Palo Alto), Cuckoo Sandbox, DARKSURGEON, Deepviz, DIARIO, dridex.malwareconfig.com, EML Analyzer, EXPMON, FAME, FLARE-VM, GLIMPS Malware, Hybrid-analysis.com, InQuest Labs, IntelOwl, Joe Sandbox, Laika BOSS, MacroMilter, mailcow, malshare.io, malware-repo, Malware Repository Framework (MRF), MalwareBazaar, olefy, Pandora, PeekabooAV, pcodedmp, PyCIRCLean, QFlow, Qu1cksc0pe, Tylabs QuickSand, REMnux, Snake, SNDBOX, Splunk add-on for MS O365 Email, SpuriousEmu, Strelka, stoQ, Sublime Platform/MQL, Subparse, TheHive/Cortex, ThreatBoook, TSUGURI Linux, Vba2Graph, Viper, ViperMonkey, YOMI, et probablement VirusTotal, FileScan.IO. Et pas mal d'autres projets sur GitHub. (Veuillez me contacter si vous avez ou connaissez un projet utilisant oletools)
La méthode recommandée pour télécharger et installer/mettre à jour la dernière version stable d'oletools est d'utiliser pip :
sudo -H pip install -U oletools[full]pip install -U oletools[full]Cela devrait créer automatiquement des scripts en ligne de commande pour exécuter chaque outil depuis
n'importe quel répertoire : olevba, mraptor, rtfobj, etc.
Le mot-clé [full] signifie que toutes les dépendances optionnelles seront installées, comme XLMMacroDeobfuscator.
Si vous préférez une version plus légère sans dépendances optionnelles, supprimez simplement [full] de la ligne de commande.
Pour obtenir la dernière version de développement à la place :
sudo -H pip install -U https://github.com/decalage2/oletools/archive/master.zippip install -U https://github.com/decalage2/oletools/archive/master.zipVoir la documentation pour d'autres options d'installation.
La dernière version de la documentation est disponible en ligne, sinon une copie est fournie dans le sous-dossier doc du paquet.
Ceci est un projet open-source personnel, développé sur mon temps libre. Toute contribution, suggestion, retour d'expérience ou rapport de bug est le bienvenu.
Pour suggérer des améliorations, signaler un bug ou tout problème, veuillez utiliser la page de signalement des problèmes, en fournissant toutes les informations et fichiers nécessaires pour reproduire le problème.
Vous pouvez également contacter l'auteur directement pour faire part de vos commentaires.
Le code est disponible dans un dépôt GitHub. Vous pouvez l'utiliser pour soumettre des améliorations via des forks et des pull requests.
This license applies to the python-oletools package, apart from the thirdparty folder which contains third-party files published with their own license.
The python-oletools package is copyright (c) 2012-2024 Philippe Lagadec (http://www.decalage.info)
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
olevba contient du code source modifié du projet officeparser, publié sous la licence MIT (MIT) suivante :
officeparser est copyright (c) 2014 John William Davison
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.