Giter VIP home page Giter VIP logo

veeamloganonymizer's Introduction

Veeam Log Anonymizer

Twitter: JMousqueton

A tool to anonimyze your Veeam logs

VeeamLogAnonymizeris is a python script designed for anonymizing log files generated by Veeam Backup & Replication v12, which may contain sensitive information like server names, IP addresses, email addresses, and more. Anonymizing log files helps protect privacy and confidentiality when sharing or analyzing these logs.

I want to clarify that I'm not a developer by profession, but rather a member of the Veeam community who saw the need for a tool like this. The script has been created out of a passion for data privacy and a desire to contribute to our community.

πŸ†• Important information

With Eric, another Veeam Vanguard, we're developping a new version in C# to improuve drasticly the performance.

You can find the early stage project here.

⚠️ Disclamer

This script is still as an early stage of development.

⚠️ UNDER CONSTRUCTION ⚠️

I want to make it clear that I am not employed by or associated with Veeam Software in any official capacity. This script, its development, and its distribution are entirely independent efforts. It is not endorsed or supported by Veeam Software.

The script has been created by a member of the Veeam community out of a genuine interest in data privacy and the needs of fellow users. While it is designed to work with Veeam Backup & Replication logs, it is not an official Veeam product, and any issues or concerns related to its use should be directed to me rather than Veeam Software.

Please use this script responsibly and in accordance with your organization's policies and any relevant data privacy regulations. Always ensure that you have proper backups and safeguards in place when making changes to log files.

Thank you for understanding the independent nature of this project.

βš™οΈ Features

Veeam Log Anonymizer, anonymizes :

  • Veeam Server name
  • Usernames
  • IPs address
  • SMTP Servers
  • vCenter Username
  • Domains
  • vCenter Servers
  • Email
  • vCenter Location

πŸ’Ώ Installation

coming soon

πŸš€ Usage

You need to files :

  • patterns.json
  • VeeamLogAnonymizer.py

Run the Script: Execute the script by providing the necessary command-line arguments.

-i or --input: Specify the input log file or directory containing log files. -o or --output: Specify the output directory where processed log files will be saved. -f or --force: Optional. Use this flag to force overwrite if output files exist or force the creation of the output directory if it doesn't exist. -m or --mapping: Optional. Use this flag to display the mapping table of anonymized data. -v or --verbose: Optional. Use this flag to display processing information and progress. -D or --dictionary: Optional. Use this flag to output a JSON file with the dictionary of anonymized data.

The script will process the log files, anonymizing specific values such as IP addresses, email addresses, server names, and more. If the -m flag is used, the script will display the mapping between original and anonymized values. If the -D flag is used, a JSON file with the anonymized data dictionary will be generated.

The processed log files will be saved in the output directory specified using the -o flag.

πŸ“ Examples

python3 VeeamLogAnonymizer.py -h

.-.   .-.,---.  ,---.    .--.                   ,-.    .---.    ,--,              .--.  .-. .-. .---.  .-. .-..-.   .-.        ,-. _____  ,---.  ,---.    
\ \ / / | .-'  | .-'   / /\ \ |\    /|         | |   / .-. ) .' .'              / /\ \ |  \| |/ .-. ) |  \| | \ \_/ )/|\    /||(|/___  / | .-'  | .-.\   
 \ V /  | `-.  | `-.  / /__\ \|(\  / |         | |   | | |(_)|  |  __          / /__\ \|   | || | |(_)|   | |  \   (_)|(\  / |(_)   / /) | `-.  | `-'/   
  ) /   | .-'  | .-'  |  __  |(_)\/  |         | |   | | | | \  \ ( _)         |  __  || |\  || | | | | |\  |   ) (   (_)\/  || |  / /(_)| .-'  |   (    
  (_)   |  `--.|  `--.| |  |)|| \  / |         | `--.\ `-' /  \  `-) )         | |  |)|| | |)|\ `-' / | | |)|   | |   | \  / || | / /___ |  `--.| |\ \   
        /( __.'/( __.'|_|  (_)| |\/| |         |( __.')---'   )\____/          |_|  (_)/(  (_) )---'  /(  (_)  /(_|   | |\/| |`-'(_____/ /( __.'|_| \)\  
       (__)   (__)            '-'  '-'         (_)   (_)     (__)                     (__)    (_)    (__)     (__)    '-'  '-'          (__) v 1.0  (__) 
   by Julien Mousqueton (@JMousqueton)
    
usage: VeeamLogAnonymizer.py [-h] [-i INPUT_FILE] [-d INPUT_DIRECTORY] -o OUTPUT_DIRECTORY [-f] [-m] [-v] [-D]

Anonymize your Veeam Backup & Replication logs.

options:
  -h, --help            show this help message and exit
  -i INPUT_FILE, --input INPUT_FILE
                        Input log file
  -d INPUT_DIRECTORY, --directory INPUT_DIRECTORY
                        Input directory containing log files
  -o OUTPUT_DIRECTORY, --output OUTPUT_DIRECTORY
                        Output directory for processed log files
  -f, --force           Force overwrite if output files exist or force the creation of output directory if not exists
  -m, --mapping         Display the mapping table of anonymized data
  -v, --verbose         Display processing files and other information
  -D, --dictionary      output a JSON file with the dictionary of anonymized data

Examples

python3 VeeamLogAnonymizer.py -d ./log -o ./anonymized -f

pyhton3 VeeamLogAnonymizer.py -i ./log/VeeamBackupManager.log -o ./anonymized

and full options :)

python3 VeeamLogAnonymizer.py -d ./log -o ./anonymized -f -m -v -D

Author

πŸ‘€ Julien Mousqueton

🀝 Contributing

Contributions, issues and feature requests are welcome!

Feel free to check issues page.

πŸ™πŸ» Acknowledgements

For the original idea, the support and the ideas of improvement :

  • Bertrand (Veeam Legend)
  • Eric (Veeam Vanguard)

Show your support

Give a ⭐️ if this project helped you!

πŸ“ License

This project is under GNU GENERAL PUBLIC LICENSE version 3.

veeamloganonymizer's People

Contributors

jmousqueton avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

veeamloganonymizer's Issues

Cannot access local variable 'full_output_directory' where it is not associated with a value

Bonjour,

Merci pour votre projet.

Je ne connais pas du tout python, quand j'essaie de lancer le script avec la commande :

python3 VeeamLogAnonymizer.py -i ./log/VeeamBackupManager.log -o ./anonymized

J'obtiens l'erreur :

File "/home/prod/log_veeam/VeeamLogAnonymizer-main/VeeamLogAnonymizer.py", line 546, in main
if not os.path.exists(full_output_directory) and args.force:
^^^^^^^^^^^^^^^^^^^^^
UnboundLocalError: cannot access local variable 'full_output_directory' where it is not associated with a value

Mon Environnement :

Almalinux 8.8

platform-python.x86_64 3.6.8-51.el8_8.1.alma @BasEOS
platform-python-pip.noarch 9.0.3-22.el8 @anaconda
platform-python-setuptools.noarch 39.2.0-7.el8 @BasEOS
python3-dateutil.noarch 1:2.6.1-6.el8 @anaconda
python3-dbus.x86_64 1.2.4-15.el8 @anaconda
python3-decorator.noarch 4.2.1-2.el8 @anaconda
python3-dnf.noarch 4.7.0-16.el8_8.alma @BasEOS
python3-dnf-plugins-core.noarch 4.0.21-19.el8_8 @BasEOS
python3-firewall.noarch 0.9.3-13.el8 @anaconda
python3-gobject-base.x86_64 3.28.3-2.el8 @anaconda
python3-gpg.x86_64 1.13.1-11.el8 @anaconda
python3-hawkey.x86_64 0.63.0-14.el8_8.alma @BasEOS
python3-jmespath.noarch 0.9.0-11.el8 @appstream
python3-libcomps.x86_64 0.1.18-1.el8 @anaconda
python3-libdnf.x86_64 0.63.0-14.el8_8.alma @BasEOS
python3-libs.x86_64 3.6.8-51.el8_8.1.alma @BasEOS
python3-libselinux.x86_64 2.9-8.el8 @BasEOS
python3-linux-procfs.noarch 0.7.1-1.el8 @BasEOS
python3-nftables.x86_64 1:0.9.3-26.el8 @anaconda
python3-perf.x86_64 4.18.0-477.13.1.el8_8 @BasEOS
python3-pip-wheel.noarch 9.0.3-22.el8 @anaconda
python3-pyudev.noarch 0.21.0-7.el8 @anaconda
python3-rpm.x86_64 4.14.3-26.el8 @BasEOS
python3-setuptools-wheel.noarch 39.2.0-7.el8 @BasEOS
python3-six.noarch 1.11.0-8.el8 @anaconda
python3-slip.noarch 0.6.4-13.el8 @anaconda
python3-slip-dbus.noarch 0.6.4-13.el8 @anaconda
python3-syspurpose.x86_64 1.28.36-2.el8.alma @BasEOS
python3-systemd.x86_64 234-8.el8 @BasEOS
python3-unbound.x86_64 1.16.2-5.el8 @appstream
python3.11.x86_64 3.11.2-2.el8_8.1 @appstream
python3.11-cffi.x86_64 1.15.1-1.el8 @appstream
python3.11-cryptography.x86_64 37.0.2-5.el8 @appstream
python3.11-libs.x86_64 3.11.2-2.el8_8.1 @appstream
python3.11-pip-wheel.noarch 22.3.1-2.el8 @appstream
python3.11-ply.noarch 3.11-1.el8 @appstream
python3.11-pycparser.noarch 2.20-1.el8 @appstream
python3.11-pyyaml.x86_64 6.0-1.el8 @appstream
python3.11-setuptools-wheel.noarch 65.5.1-2.el8 @appstream
python3.11-six.noarch 1.16.0-1.el8 @appstream

Petite prΓ©cision : J'utilise Veeam v11 (mais j'ai pas l'impression que le script Γ©choue Γ  cause de Γ§a)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.