4 |
5 | 
6 |
7 |
10 | nebula-dfl.com | 11 | nebula-dfl.eu | 12 | federatedlearning.inf.um.es 13 |
14 | 15 | 16 | ## NEBULA Analysis 17 | 18 | This folder contains different analyses of the NEBULA platform. The analysis is divided into two parts: 19 | 20 | - **Data analysis**: This folder contains the analysis of the data included in the platform. The analysis is done using Jupyter Notebooks and Python. 21 | 22 | - **Network analysis**: This folder contains the analysis of the network of the platform. The analysis is done using WireShark and Python. 23 | 24 | _*NOTE:* Some data is not included in this repository due to privacy reasons. If you want to access the data, please contact us._ 25 | -------------------------------------------------------------------------------- /analysis/data-analysis/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/analysis/data-analysis/__init__.py -------------------------------------------------------------------------------- /analysis/network-analysis/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/analysis/network-analysis/__init__.py -------------------------------------------------------------------------------- /app/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/app/__init__.py -------------------------------------------------------------------------------- /app/certs/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/app/certs/__init__.py -------------------------------------------------------------------------------- /app/config/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/app/config/__init__.py -------------------------------------------------------------------------------- /app/logs/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/app/logs/__init__.py -------------------------------------------------------------------------------- /docs/_prebuilt/changelog.md: -------------------------------------------------------------------------------- 1 | --- 2 | hide: 3 | -toc 4 | --- 5 | --8<-- "CHANGELOG.md" 6 | -------------------------------------------------------------------------------- /docs/_prebuilt/contributing.md: -------------------------------------------------------------------------------- 1 | --- 2 | hide: 3 | -toc 4 | --- 5 | --8<-- "CONTRIBUTING.md" 6 | -------------------------------------------------------------------------------- /docs/_prebuilt/css/toc.css: -------------------------------------------------------------------------------- 1 | .md-sidebar--secondary { 2 | order: 0; 3 | } 4 | 5 | .md-sidebar--primary { 6 | display: none; 7 | } 8 | -------------------------------------------------------------------------------- /docs/_prebuilt/index.md: -------------------------------------------------------------------------------- 1 | --- 2 | hide: 3 | -toc 4 | --- 5 | --8<-- "README.md" 6 | -------------------------------------------------------------------------------- /docs/_prebuilt/js/toc.js: -------------------------------------------------------------------------------- 1 | document.addEventListener('DOMContentLoaded', function() { 2 | if (window.location.pathname.includes("api")) { 3 | document.querySelector('.md-sidebar--primary').style.display = 'block'; 4 | } 5 | }); 6 | -------------------------------------------------------------------------------- /docs/_prebuilt/static/armasuisse.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/armasuisse.jpg -------------------------------------------------------------------------------- /docs/_prebuilt/static/custom.css: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/custom.css -------------------------------------------------------------------------------- /docs/_prebuilt/static/developerguide/structure.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/developerguide/structure.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/docker-required-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/docker-required-options.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/nebula-logo.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/nebula-logo.jpg -------------------------------------------------------------------------------- /docs/_prebuilt/static/nebula-logo.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/nebula-logo.pdf -------------------------------------------------------------------------------- /docs/_prebuilt/static/nebula-mockup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/nebula-mockup.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/umu.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/umu.jpg -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/deployment.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/deployment.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/frontend.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/frontend.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/monitor.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/monitor.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/nebula-dashboard.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/nebula-dashboard.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/realtime-images.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/realtime-images.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/realtime-scalars.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/realtime-scalars.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/realtime-time-series.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/realtime-time-series.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/userguide/running_nebula.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/userguide/running_nebula.png -------------------------------------------------------------------------------- /docs/_prebuilt/static/uzh.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/docs/_prebuilt/static/uzh.jpg -------------------------------------------------------------------------------- /docs/scripts/gen_ref_pages.py: -------------------------------------------------------------------------------- 1 | """Generate the code reference pages and navigation.""" 2 | 3 | from pathlib import Path 4 | 5 | import mkdocs_gen_files 6 | 7 | nav = mkdocs_gen_files.Nav() 8 | 9 | root = Path(__file__).parent.parent.parent 10 | src = root / "nebula" 11 | 12 | print(f"Generating API pages from {src}") 13 | 14 | excluded_dirs = ["tests", "utils", "config"] 15 | 16 | for path in sorted(src.rglob("*.py")): 17 | if any(excluded in path.parts for excluded in excluded_dirs): 18 | print(f"Skipping excluded directory: {path}") 19 | continue 20 | print(f"Generating API page for {path}") 21 | module_path = path.relative_to(src).with_suffix("") 22 | print(f"Module path: {module_path}") 23 | doc_path = path.relative_to(src).with_suffix(".md") 24 | print(f"Doc path: {doc_path}") 25 | full_doc_path = Path("api", doc_path) 26 | print(f"Full doc path: {full_doc_path}") 27 | 28 | parts = tuple(module_path.parts) 29 | if not parts: 30 | continue 31 | 32 | # Prepend 'nebula' to the parts to include the root module 33 | parts = ("nebula",) + parts 34 | 35 | if parts[-1] == "__init__": 36 | parts = parts[:-1] 37 | print(f"Parts: {parts}") 38 | doc_path = doc_path.with_name("index.md") 39 | full_doc_path = full_doc_path.with_name("index.md") 40 | elif parts[-1] == "__main__": 41 | continue 42 | 43 | nav[parts] = doc_path.as_posix() 44 | 45 | with mkdocs_gen_files.open(full_doc_path, "w") as fd: 46 | ident = ".".join(parts) 47 | 48 | custom_title = f"Documentation for {parts[-1].capitalize()} Module" 49 | fd.write("---\n") 50 | fd.write("hide:\n - toc\n") 51 | fd.write("---\n") 52 | fd.write(f"# {custom_title}\n\n") 53 | if parts[-1].capitalize() == "Nebula": 54 | fd.write( 55 | "This API Reference is designed to help developers understand every part of the code, providing detailed information about functions, parameters, data structures, and interactions within the platform.\n\n On the left, you'll find the directory tree of the platform, including folders, functions, code, and documentation.\n\n" 56 | ) 57 | fd.write(f"::: {ident}") 58 | 59 | mkdocs_gen_files.set_edit_path(full_doc_path, path.relative_to(root)) 60 | 61 | with mkdocs_gen_files.open("api/SUMMARY.md", "w") as nav_file: 62 | nav_file.writelines(nav.build_literate_nav()) 63 | -------------------------------------------------------------------------------- /nebula/__init__.py: -------------------------------------------------------------------------------- 1 | __version__ = "1.0.0" 2 | __description__ = "NEBULA: A Platform for Decentralized Federated Learning" 3 | __long_description__ = "NEBULA: A Platform for Decentralized Federated Learning" 4 | __author__ = "Enrique Tomás Martínez Beltrán, Alberto Huertas Celdrán, Alejandro Avilés Serrano, Fernando Torres Vega" 5 | __long_description_content_type__ = "text/markdown" 6 | __keywords__ = "federated learning, decentralized federated learning, machine learning, deep learning, neural networks, collaborative learning" 7 | -------------------------------------------------------------------------------- /nebula/addons/__init__.py: -------------------------------------------------------------------------------- 1 | """ 2 | This package consists of several modules that handle different aspects of the network simulation: 3 | 4 | 1. `env.py`: 5 | - Manages the environment configuration and settings. 6 | - It initializes the system environment, loads configuration parameters, and ensures correct operation of other components based on the simulation's settings. 7 | 8 | 2. `functions.py`: 9 | - Contains utility functions that are used across different parts of the simulation. 10 | - It provides helper methods for common operations like data processing, mathematical calculations, and other reusable functionalities. 11 | 12 | 3. `mobility.py`: 13 | - Models and simulates the mobility of nodes within the network. 14 | - It handles dynamic aspects of the simulation, such as node movement and position updates, based on mobility models and the simulation's configuration. 15 | 16 | 4. `reporter.py`: 17 | - Responsible for collecting and reporting data during the simulation. 18 | - It tracks various system metrics, including node status and network performance, and periodically sends updates to a controller or dashboard for analysis and monitoring. 19 | 20 | 5. `topologymanager.py`: 21 | - Manages the topology of the network. 22 | - It handles the creation and maintenance of the network's structure (e.g., nodes and their connections), including generating different types of topologies like ring, random, or fully connected based on simulation parameters. 23 | 24 | Each of these modules plays a critical role in simulating a network environment, enabling real-time tracking, topology management, mobility simulation, and efficient reporting of results. 25 | """ 26 | -------------------------------------------------------------------------------- /nebula/addons/attacks/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/attacks/__init__.py -------------------------------------------------------------------------------- /nebula/addons/attacks/communications/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/attacks/communications/__init__.py -------------------------------------------------------------------------------- /nebula/addons/attacks/communications/delayerattack.py: -------------------------------------------------------------------------------- 1 | import asyncio 2 | import logging 3 | from functools import wraps 4 | 5 | from nebula.addons.attacks.communications.communicationattack import CommunicationAttack 6 | from nebula.core.network.communications import CommunicationsManager 7 | 8 | 9 | class DelayerAttack(CommunicationAttack): 10 | """ 11 | Implements an attack that delays the execution of a target method by a specified amount of time. 12 | """ 13 | 14 | def __init__(self, engine, attack_params: dict): 15 | """ 16 | Initializes the DelayerAttack with the engine and attack parameters. 17 | 18 | Args: 19 | engine: The engine managing the attack context. 20 | attack_params (dict): Parameters for the attack, including the delay duration. 21 | """ 22 | try: 23 | self.delay = int(attack_params["delay"]) 24 | round_start = int(attack_params["round_start_attack"]) 25 | round_stop = int(attack_params["round_stop_attack"]) 26 | attack_interval = int(attack_params["attack_interval"]) 27 | self.target_percentage = int(attack_params["target_percentage"]) 28 | self.selection_interval = int(attack_params["selection_interval"]) 29 | except KeyError as e: 30 | raise ValueError(f"Missing required attack parameter: {e}") 31 | except ValueError: 32 | raise ValueError("Invalid value in attack_params. Ensure all values are integers.") 33 | 34 | super().__init__( 35 | engine, 36 | CommunicationsManager.get_instance(), 37 | "send_message", 38 | round_start, 39 | round_stop, 40 | attack_interval, 41 | self.delay, 42 | self.target_percentage, 43 | self.selection_interval, 44 | ) 45 | 46 | def decorator(self, delay: int): 47 | """ 48 | Decorator that adds a delay to the execution of the original method. 49 | 50 | Args: 51 | delay (int): The time in seconds to delay the method execution. 52 | 53 | Returns: 54 | function: A decorator function that wraps the target method with the delay logic. 55 | """ 56 | 57 | def decorator(func): 58 | @wraps(func) 59 | async def wrapper(*args, **kwargs): 60 | if len(args) == 4 and args[3] == "model": 61 | dest_addr = args[1] 62 | if dest_addr in self.targets: 63 | logging.info(f"[DelayerAttack] Delaying model propagation to {dest_addr} by {delay} seconds") 64 | await asyncio.sleep(delay) 65 | _, *new_args = args # Exclude self argument 66 | return await func(*new_args) 67 | 68 | return wrapper 69 | 70 | return decorator 71 | -------------------------------------------------------------------------------- /nebula/addons/attacks/communications/floodingattack.py: -------------------------------------------------------------------------------- 1 | import logging 2 | from functools import wraps 3 | 4 | from nebula.addons.attacks.communications.communicationattack import CommunicationAttack 5 | from nebula.core.network.communications import CommunicationsManager 6 | 7 | 8 | class FloodingAttack(CommunicationAttack): 9 | """ 10 | Implements an attack that delays the execution of a target method by a specified amount of time. 11 | """ 12 | 13 | def __init__(self, engine, attack_params: dict): 14 | """ 15 | Initializes the DelayerAttack with the engine and attack parameters. 16 | 17 | Args: 18 | engine: The engine managing the attack context. 19 | attack_params (dict): Parameters for the attack, including the delay duration. 20 | """ 21 | try: 22 | round_start = int(attack_params["round_start_attack"]) 23 | round_stop = int(attack_params["round_stop_attack"]) 24 | attack_interval = int(attack_params["attack_interval"]) 25 | self.flooding_factor = int(attack_params["flooding_factor"]) 26 | self.target_percentage = int(attack_params["target_percentage"]) 27 | self.selection_interval = int(attack_params["selection_interval"]) 28 | except KeyError as e: 29 | raise ValueError(f"Missing required attack parameter: {e}") 30 | except ValueError: 31 | raise ValueError("Invalid value in attack_params. Ensure all values are integers.") 32 | 33 | self.verbose = False 34 | 35 | super().__init__( 36 | engine, 37 | CommunicationsManager.get_instance(), 38 | "send_message", 39 | round_start, 40 | round_stop, 41 | attack_interval, 42 | self.flooding_factor, 43 | self.target_percentage, 44 | self.selection_interval, 45 | ) 46 | 47 | def decorator(self, flooding_factor: int): 48 | """ 49 | Decorator that adds a delay to the execution of the original method. 50 | 51 | Args: 52 | flooding_factor (int): The number of times to repeat the function execution. 53 | 54 | Returns: 55 | function: A decorator function that wraps the target method with the delay logic. 56 | """ 57 | 58 | def decorator(func): 59 | @wraps(func) 60 | async def wrapper(*args, **kwargs): 61 | if len(args) == 4 and args[3] == "model": 62 | dest_addr = args[1] 63 | if dest_addr in self.targets: 64 | logging.info(f"[FloodingAttack] Flooding message to {dest_addr} by {flooding_factor} times") 65 | for i in range(flooding_factor): 66 | if self.verbose: 67 | logging.info( 68 | f"[FloodingAttack] Sending duplicate {i + 1}/{flooding_factor} to {dest_addr}" 69 | ) 70 | _, *new_args = args # Exclude self argument 71 | await func(*new_args, **kwargs) 72 | _, *new_args = args 73 | return await func(*new_args) 74 | 75 | return wrapper 76 | 77 | return decorator 78 | -------------------------------------------------------------------------------- /nebula/addons/attacks/dataset/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/attacks/dataset/__init__.py -------------------------------------------------------------------------------- /nebula/addons/attacks/dataset/datasetattack.py: -------------------------------------------------------------------------------- 1 | import logging 2 | from abc import abstractmethod 3 | 4 | from nebula.addons.attacks.attacks import Attack 5 | 6 | 7 | class DatasetAttack(Attack): 8 | """ 9 | Implements an attack that replaces the training dataset with a malicious version 10 | during specific rounds of the engine's execution. 11 | 12 | This attack modifies the dataset used by the engine's trainer to introduce malicious 13 | data, potentially impacting the model's training process. 14 | """ 15 | 16 | def __init__(self, engine, round_start_attack, round_stop_attack, attack_interval): 17 | """ 18 | Initializes the DatasetAttack with the given engine. 19 | 20 | Args: 21 | engine: The engine managing the attack context. 22 | """ 23 | self.engine = engine 24 | self.round_start_attack = round_start_attack 25 | self.round_stop_attack = round_stop_attack 26 | self.attack_interval = attack_interval 27 | 28 | async def attack(self): 29 | """ 30 | Performs the attack by replacing the training dataset with a malicious version. 31 | 32 | During the specified rounds of the attack, the engine's trainer is provided 33 | with a malicious dataset. The attack is stopped when the engine reaches the 34 | designated stop round. 35 | """ 36 | if self.engine.round not in range(self.round_start_attack, self.round_stop_attack + 1): 37 | pass 38 | elif self.engine.round == self.round_stop_attack: 39 | logging.info(f"[{self.__class__.__name__}] Stopping attack") 40 | elif self.engine.round >= self.round_start_attack and ( 41 | (self.engine.round - self.round_start_attack) % self.attack_interval == 0 42 | ): 43 | logging.info(f"[{self.__class__.__name__}] Performing attack") 44 | self.engine.trainer.datamodule.train_set = self.get_malicious_dataset() 45 | 46 | async def _inject_malicious_behaviour(self, target_function, *args, **kwargs): 47 | """ 48 | Abstract method for injecting malicious behavior into a target function. 49 | 50 | This method is not implemented in this class and must be overridden by subclasses 51 | if additional malicious behavior is required. 52 | 53 | Args: 54 | target_function (callable): The function to inject the malicious behavior into. 55 | *args: Positional arguments for the malicious behavior. 56 | **kwargs: Keyword arguments for the malicious behavior. 57 | 58 | Raises: 59 | NotImplementedError: This method is not implemented in this class. 60 | """ 61 | pass 62 | 63 | @abstractmethod 64 | def get_malicious_dataset(self): 65 | """ 66 | Abstract method to retrieve the malicious dataset. 67 | 68 | Subclasses must implement this method to define how the malicious dataset 69 | is created or retrieved. 70 | 71 | Raises: 72 | NotImplementedError: If the method is not implemented in a subclass. 73 | """ 74 | raise NotImplementedError 75 | -------------------------------------------------------------------------------- /nebula/addons/attacks/model/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/attacks/model/__init__.py -------------------------------------------------------------------------------- /nebula/addons/attacks/model/gllneuroninversion.py: -------------------------------------------------------------------------------- 1 | import logging 2 | 3 | import torch 4 | 5 | from nebula.addons.attacks.model.modelattack import ModelAttack 6 | 7 | 8 | class GLLNeuronInversionAttack(ModelAttack): 9 | """ 10 | Implements a neuron inversion attack on the received model weights. 11 | 12 | This attack aims to invert the values of neurons in specific layers 13 | by replacing their values with random noise, potentially disrupting the model's 14 | functionality during aggregation. 15 | 16 | Args: 17 | engine (object): The training engine object that manages the aggregator. 18 | _ (any): A placeholder argument (not used in this class). 19 | """ 20 | 21 | def __init__(self, engine, attack_params): 22 | """ 23 | Initializes the GLLNeuronInversionAttack with the specified engine. 24 | 25 | Args: 26 | engine (object): The training engine object. 27 | _ (any): A placeholder argument (not used in this class). 28 | """ 29 | try: 30 | round_start = int(attack_params["round_start_attack"]) 31 | round_stop = int(attack_params["round_stop_attack"]) 32 | attack_interval = int(attack_params["attack_interval"]) 33 | except KeyError as e: 34 | raise ValueError(f"Missing required attack parameter: {e}") 35 | except ValueError: 36 | raise ValueError("Invalid value in attack_params. Ensure all values are integers.") 37 | 38 | super().__init__(engine, round_start, round_stop, attack_interval) 39 | 40 | def model_attack(self, received_weights): 41 | """ 42 | Performs the neuron inversion attack by modifying the weights of a specific 43 | layer with random noise. 44 | 45 | This attack replaces the weights of a chosen layer with random values, 46 | which may disrupt the functionality of the model. 47 | 48 | Args: 49 | received_weights (dict): The aggregated model weights to be modified. 50 | 51 | Returns: 52 | dict: The modified model weights after applying the neuron inversion attack. 53 | """ 54 | logging.info("[GLLNeuronInversionAttack] Performing neuron inversion attack") 55 | lkeys = list(received_weights.keys()) 56 | logging.info(f"Layer inverted: {lkeys[-2]}") 57 | received_weights[lkeys[-2]].data = torch.rand(received_weights[lkeys[-2]].shape) * 10000 58 | return received_weights 59 | -------------------------------------------------------------------------------- /nebula/addons/functions.py: -------------------------------------------------------------------------------- 1 | import logging 2 | 3 | 4 | def print_msg_box(msg, indent=1, width=None, title=None, logger_name=None): 5 | """ 6 | Prints a formatted message box to the logger with an optional title. 7 | 8 | This function creates a visually appealing message box format for logging messages. 9 | It allows for indentation, custom width, and inclusion of a title. If the message is 10 | multiline, each line will be included in the box. 11 | 12 | Args: 13 | msg (str): The message to be displayed inside the box. Must be a string. 14 | indent (int, optional): The number of spaces to indent the message box. Default is 1. 15 | width (int, optional): The width of the message box. If not provided, it will be calculated 16 | based on the longest line of the message and the title (if provided). 17 | title (str, optional): An optional title for the message box. Must be a string if provided. 18 | logger_name (str, optional): The name of the logger to use. If not provided, the root logger 19 | will be used. 20 | 21 | Raises: 22 | TypeError: If `msg` or `title` is not a string. 23 | 24 | Returns: 25 | None 26 | 27 | Notes: 28 | - The message box is bordered with decorative characters to enhance visibility in the logs. 29 | - If the `width` is not provided, it will automatically adjust to fit the content. 30 | """ 31 | logger = logging.getLogger(logger_name) if logger_name else logging.getLogger() 32 | 33 | if not isinstance(msg, str): 34 | raise TypeError("msg parameter must be a string") # noqa: TRY003 35 | 36 | lines = msg.split("\n") 37 | space = " " * indent 38 | if not width: 39 | width = max(map(len, lines)) 40 | if title: 41 | width = max(width, len(title)) 42 | box = f"\n╔{'═' * (width + indent * 2)}╗\n" # upper_border 43 | if title: 44 | if not isinstance(title, str): 45 | raise TypeError("title parameter must be a string") # noqa: TRY003 46 | box += f"║{space}{title:<{width}}{space}║\n" # title 47 | box += f"║{space}{'-' * len(title):<{width}}{space}║\n" # underscore 48 | box += "".join([f"║{space}{line:<{width}}{space}║\n" for line in lines]) 49 | box += f"╚{'═' * (width + indent * 2)}╝" # lower_border 50 | logger.info(box) 51 | -------------------------------------------------------------------------------- /nebula/addons/gps/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/gps/__init__.py -------------------------------------------------------------------------------- /nebula/addons/gps/gpsmodule.py: -------------------------------------------------------------------------------- 1 | from abc import ABC, abstractmethod 2 | 3 | 4 | class GPSModule(ABC): 5 | """ 6 | Abstract base class representing a GPS module interface. 7 | 8 | This class defines the required asynchronous methods that any concrete GPS module implementation must provide. 9 | These methods allow for lifecycle control (start/stop), status checking, and distance calculation between coordinates. 10 | 11 | Any subclass must implement all the following asynchronous methods: 12 | - `start()`: Begins GPS tracking or data acquisition. 13 | - `stop()`: Halts the GPS module's operation. 14 | - `is_running()`: Checks whether the GPS module is currently active. 15 | - `calculate_distance()`: Computes the distance between two geographic coordinates (latitude and longitude). 16 | 17 | All implementations should ensure that methods are non-blocking and integrate smoothly with async event loops. 18 | """ 19 | 20 | @abstractmethod 21 | async def start(self): 22 | """ 23 | Starts the GPS module operation. 24 | 25 | This may involve initiating hardware tracking, establishing connections, or beginning periodic updates. 26 | """ 27 | pass 28 | 29 | @abstractmethod 30 | async def stop(self): 31 | """ 32 | Stops the GPS module operation. 33 | 34 | Ensures that any background tasks or hardware interactions are properly terminated. 35 | """ 36 | pass 37 | 38 | @abstractmethod 39 | async def is_running(self): 40 | """ 41 | Checks whether the GPS module is currently active. 42 | 43 | Returns: 44 | bool: True if the module is running, False otherwise. 45 | """ 46 | pass 47 | 48 | @abstractmethod 49 | async def calculate_distance(self, self_lat, self_long, other_lat, other_long): 50 | """ 51 | Calculates the distance between two geographic points. 52 | 53 | Args: 54 | self_lat (float): Latitude of the source point. 55 | self_long (float): Longitude of the source point. 56 | other_lat (float): Latitude of the target point. 57 | other_long (float): Longitude of the target point. 58 | 59 | Returns: 60 | float: Distance in meters (or implementation-defined units) between the two coordinates. 61 | """ 62 | pass 63 | 64 | 65 | class GPSModuleException(Exception): 66 | pass 67 | 68 | 69 | def factory_gpsmodule(gps_module, config, addr, update_interval: float = 5.0, verbose=False) -> GPSModule: 70 | from nebula.addons.gps.nebulagps import NebulaGPS 71 | 72 | GPS_SERVICES = { 73 | "nebula": NebulaGPS, 74 | } 75 | 76 | gps_module = GPS_SERVICES.get(gps_module, NebulaGPS) 77 | 78 | if gps_module: 79 | return gps_module(config, addr, update_interval, verbose) 80 | else: 81 | raise GPSModuleException(f"GPS Module {gps_module} not found") 82 | -------------------------------------------------------------------------------- /nebula/addons/networksimulation/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/networksimulation/__init__.py -------------------------------------------------------------------------------- /nebula/addons/reputation/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/reputation/__init__.py -------------------------------------------------------------------------------- /nebula/addons/trustworthiness/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/trustworthiness/__init__.py -------------------------------------------------------------------------------- /nebula/addons/trustworthiness/configs/factsheet_template.json: -------------------------------------------------------------------------------- 1 | { 2 | "project": { 3 | "overview": "", 4 | "purpose": "", 5 | "background": "" 6 | }, 7 | "data": { 8 | "provenance": "", 9 | "preprocessing": "", 10 | "avg_entropy": "" 11 | }, 12 | "participants": { 13 | "client_num": "", 14 | "sample_client_rate": "", 15 | "client_selector": "", 16 | "avg_dataset_size": "" 17 | }, 18 | "configuration": { 19 | "aggregation_algorithm": "", 20 | "training_model": "", 21 | "personalization": "", 22 | "visualization": "", 23 | "differential_privacy": "", 24 | "dp_epsilon": "", 25 | "trainable_param_num": "", 26 | "total_round_num": "", 27 | "learning_rate": "", 28 | "local_update_steps": "" 29 | }, 30 | "performance": { 31 | "test_loss_avg": "", 32 | "test_acc_avg": "", 33 | "test_feature_importance_cv": "", 34 | "test_clever": "" 35 | }, 36 | "fairness": { 37 | "test_acc_cv": "", 38 | "selection_cv": "", 39 | "class_imbalance": "" 40 | }, 41 | "system": { 42 | "avg_time_minutes": "", 43 | "avg_model_size": "", 44 | "total_upload_bytes": "", 45 | "total_download_bytes":"", 46 | "avg_upload_bytes": "", 47 | "avg_download_bytes": "" 48 | }, 49 | "sustainability": { 50 | "avg_carbon_intensity_server": "", 51 | "avg_carbon_intensity_clients": "", 52 | "avg_power_performance_clients": "", 53 | "avg_power_performance_server": "", 54 | "emissions_training": "", 55 | "emissions_aggregation": "", 56 | "emissions_communication_uplink": "", 57 | "emissions_communication_downlink": "" 58 | } 59 | } 60 | -------------------------------------------------------------------------------- /nebula/addons/trustworthiness/metric.py: -------------------------------------------------------------------------------- 1 | import json 2 | import logging 3 | import os 4 | 5 | from nebula.addons.trustworthiness.graphics import Graphics 6 | from nebula.addons.trustworthiness.pillar import TrustPillar 7 | from nebula.addons.trustworthiness.utils import write_results_json 8 | 9 | dirname = os.path.dirname(__file__) 10 | 11 | logger = logging.getLogger(__name__) 12 | 13 | 14 | class TrustMetricManager: 15 | """ 16 | Manager class to help store the output directory and handle calls from the FL framework. 17 | """ 18 | 19 | def __init__(self, scenario_start_time): 20 | self.factsheet_file_nm = "factsheet.json" 21 | self.eval_metrics_file_nm = "eval_metrics.json" 22 | self.nebula_trust_results_nm = "nebula_trust_results.json" 23 | self.scenario_start_time = scenario_start_time 24 | 25 | def evaluate(self, experiment_name, weights, use_weights=False): 26 | """ 27 | Evaluates the trustworthiness score. 28 | 29 | Args: 30 | scenario (object): The scenario in whith the trustworthiness will be calculated. 31 | weights (dict): The desired weghts of the pillars. 32 | use_weights (bool): True to turn on the weights in the metric config file, default to False. 33 | """ 34 | # Get scenario name 35 | scenario_name = experiment_name 36 | factsheet_file = os.path.join(os.environ.get('NEBULA_LOGS_DIR'), scenario_name, "trustworthiness", self.factsheet_file_nm) 37 | metrics_cfg_file = os.path.join(dirname, "configs", self.eval_metrics_file_nm) 38 | results_file = os.path.join(os.environ.get('NEBULA_LOGS_DIR'), scenario_name, "trustworthiness", self.nebula_trust_results_nm) 39 | 40 | if not os.path.exists(factsheet_file): 41 | logger.error(f"{factsheet_file} is missing! Please check documentation.") 42 | return 43 | 44 | if not os.path.exists(metrics_cfg_file): 45 | logger.error(f"{metrics_cfg_file} is missing! Please check documentation.") 46 | return 47 | 48 | with open(factsheet_file, "r") as f, open(metrics_cfg_file, "r") as m: 49 | factsheet = json.load(f) 50 | metrics_cfg = json.load(m) 51 | metrics = metrics_cfg.items() 52 | input_docs = {"factsheet": factsheet} 53 | 54 | result_json = {"trust_score": 0, "pillars": []} 55 | final_score = 0 56 | result_print = [] 57 | for key, value in metrics: 58 | pillar = TrustPillar(key, value, input_docs, use_weights) 59 | score, result = pillar.evaluate() 60 | weight = weights.get(key) / 100 61 | final_score += weight * score 62 | result_print.append([key, score]) 63 | result_json["pillars"].append(result) 64 | final_score = round(final_score, 2) 65 | result_json["trust_score"] = final_score 66 | write_results_json(results_file, result_json) 67 | 68 | graphics = Graphics(self.scenario_start_time, scenario_name) 69 | graphics.graphics() 70 | -------------------------------------------------------------------------------- /nebula/addons/waf/Dockerfile-grafana: -------------------------------------------------------------------------------- 1 | FROM grafana/grafana:latest 2 | 3 | ARG USER 4 | ENV USER=${USER} 5 | 6 | COPY ./grafana/dashboard_config.yml /etc/grafana/provisioning/dashboards/local.yml 7 | COPY ./grafana/automatic.yml /etc/grafana/provisioning/datasources/automatic.yml 8 | COPY ./grafana/dashboard.json /var/lib/grafana/dashboards/dashboard.json 9 | 10 | RUN sed -i "s|http://nebula|http://$USER|g" /etc/grafana/provisioning/datasources/automatic.yml 11 | -------------------------------------------------------------------------------- /nebula/addons/waf/Dockerfile-loki: -------------------------------------------------------------------------------- 1 | FROM grafana/loki:latest 2 | 3 | COPY loki-config.yml /mnt/config/loki-config.yml 4 | -------------------------------------------------------------------------------- /nebula/addons/waf/Dockerfile-promtail: -------------------------------------------------------------------------------- 1 | FROM grafana/promtail:latest 2 | 3 | ARG USER 4 | ENV USER=${USER} 5 | 6 | COPY promtail-config.yml /etc/promtail/config.yml 7 | 8 | RUN sed -i "s|http://nebula|http://$USER|g" /etc/promtail/config.yml 9 | -------------------------------------------------------------------------------- /nebula/addons/waf/Dockerfile-waf: -------------------------------------------------------------------------------- 1 | # First Stage: Build NGINX and modules 2 | FROM owasp/modsecurity-crs:3.3.5-nginx-202310170110 3 | 4 | ARG NGINX_VERSION=1.24.0 5 | 6 | ARG USER 7 | ENV USER=${USER} 8 | 9 | # Installed necessary packages 10 | RUN apt-get update && apt-get install -y libmaxminddb0 libmaxminddb-dev mmdb-bin git wget 11 | RUN apt install -y build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev 12 | RUN wget http://nginx.org/download/nginx-$NGINX_VERSION.tar.gz -P nginx-modules 13 | RUN git clone https://github.com/leev/ngx_http_geoip2_module.git nginx-modules/ngx_http_geoip2_module 14 | RUN tar zxvf nginx-modules/nginx-$NGINX_VERSION.tar.gz -C nginx-modules 15 | 16 | # nginx with geoip2 compiled 17 | RUN cd nginx-modules/nginx-1.24.0 && ./configure --add-dynamic-module=../ngx_http_geoip2_module --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx \ 18 | --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log \ 19 | --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock \ 20 | --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp \ 21 | --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp \ 22 | --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-compat --with-file-aio --with-threads \ 23 | --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module \ 24 | --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module \ 25 | --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail \ 26 | --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module \ 27 | --with-cc-opt='-g -O2 -ffile-prefix-map=/data/builder/debuild/nginx-1.24.0/debian/debuild-base/nginx-1.24.0=. -fstack-protector-strong \ 28 | -Wformat -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -fPIC' --with-ld-opt='-Wl,-z,relro -Wl,-z,now -Wl,--as-needed -pie' 29 | 30 | # nginx geoip2 installed 31 | RUN cd nginx-modules/nginx-$NGINX_VERSION && make 32 | RUN cd nginx-modules/nginx-$NGINX_VERSION && make install 33 | 34 | # copy modules to default modules path 35 | RUN cp nginx-modules/nginx-1.24.0/objs/ngx_http_geoip2_module.so /usr/lib/nginx/modules 36 | RUN cp nginx-modules/nginx-1.24.0/objs/ngx_stream_geoip2_module.so /usr/lib/nginx/modules 37 | 38 | # geoip2 database downloaded 39 | RUN wget https://github.com/P3TERX/GeoLite.mmdb/raw/download/GeoLite2-Country.mmdb -P /usr/share/GeoIP/ 40 | 41 | # nginx configuration files 42 | COPY default.conf /etc/nginx/templates/conf.d/default.conf.template 43 | 44 | RUN sed -i "s|http://nebula|http://${USER}|g" /etc/nginx/templates/conf.d/default.conf.template 45 | 46 | COPY nginx.conf /etc/nginx/templates/nginx.conf.template 47 | 48 | # owasp crs 49 | COPY crs-setup.conf /etc/modsecurity.d/owasp-crs/crs-setup.conf 50 | -------------------------------------------------------------------------------- /nebula/addons/waf/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/CyberDataLab/nebula/b85d196cd9927503ed3514ad80684882d17fb018/nebula/addons/waf/__init__.py -------------------------------------------------------------------------------- /nebula/addons/waf/default.conf: -------------------------------------------------------------------------------- 1 | # Nginx configuration for both HTTP and SSL 2 | map $http_upgrade $connection_upgrade { 3 | default upgrade; 4 | '' close; 5 | } 6 | 7 | set_real_ip_from 192.0.0.0/8; 8 | real_ip_header X-Forwarded-For; 9 | real_ip_recursive on; 10 | 11 | server { 12 | listen 80 default_server; 13 | 14 | server_name localhost; 15 | set $upstream http://nebula_nebula-frontend; # Change this 16 | set $always_redirect off; 17 | modsecurity on; 18 | location /platform { 19 | client_max_body_size 0; 20 | 21 | if ($always_redirect = on) { 22 | return 301 https://$host$request_uri; 23 | } 24 | 25 | modsecurity_rules ' 26 | SecRule REQUEST_URI "@beginsWith /platform/socket.io/" "id:4200000,phase:1,allow,nolog" 27 | '; 28 | 29 | modsecurity_rules ' 30 | SecRule REQUEST_URI "@beginsWith /platform/ws/" "id:4200001,phase:1,allow,nolog" 31 | '; 32 | 33 | modsecurity_rules ' 34 | SecRule REQUEST_URI "@beginsWith /platform/dashboard/deployment/run" "id:4200005,phase:1,nolog,pass,ctl:ruleRemoveById=200007" 35 | '; 36 | 37 | modsecurity_rules ' 38 | SecRule REQUEST_URI "@beginsWith /platform/dashboard/deployment/run" "id:4200006,phase:2,nolog,pass,ctl:ruleRemoveById=200002" 39 | '; 40 | 41 | # modsecurity_rules " 42 | # SecRule REMOTE_ADDR \"@geoLookup\" \\ 43 | # \"id:100, phase:1, t:none, pass, \\ 44 | # setvar:tx.geoip_country_code=%{geoip.country_code3}, \\ 45 | # log, auditlog, msg:'GeoIP Country Code: %{tx.geoip_country_code}'\" 46 | # "; 47 | 48 | include includes/proxy_backend.conf; 49 | 50 | index index.html index.htm; 51 | root /usr/share/nginx/html; 52 | } 53 | 54 | access_log /var/log/nginx/analytics.log json_analytics; 55 | 56 | include includes/location_common.conf; 57 | #include includes/custom_locations.conf; 58 | 59 | } 60 | 61 | server { 62 | listen 443 ssl; 63 | 64 | server_name localhost; 65 | set $upstream http://localhost:80; 66 | 67 | ssl_certificate /etc/nginx/conf/server.crt; 68 | ssl_certificate_key /etc/nginx/conf/server.key; 69 | ssl_session_timeout 1d; 70 | ssl_session_cache shared:MozSSL:10m; 71 | ssl_session_tickets off; 72 | 73 | ssl_dhparam /etc/ssl/certs/dhparam-2048.pem; 74 | 75 | ssl_protocols TLSv1.2 TLSv1.3; 76 | ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384; 77 | ssl_prefer_server_ciphers off; 78 | 79 | ssl_stapling off; 80 | ssl_stapling_verify off; 81 | 82 | ssl_verify_client off; 83 | 84 | location / { 85 | client_max_body_size 0; 86 | 87 | include includes/proxy_backend.conf; 88 | 89 | index index.html index.htm; 90 | root /usr/share/nginx/html; 91 | } 92 | include includes/location_common.conf; 93 | #include includes/custom_locations.conf; 94 | } 95 | -------------------------------------------------------------------------------- /nebula/addons/waf/geoip/GeoIP.conf: -------------------------------------------------------------------------------- 1 | # GeoIP.conf file for `geoipupdate` program, for versions >= 3.1.1. 2 | # Used to update GeoIP databases from https://www.maxmind.com. 3 | # For more information about this config file, visit the docs at 4 | # https://dev.maxmind.com/geoip/updating-databases. 5 | 6 | # `AccountID` is from your MaxMind account. 7 | AccountID your_AccountID 8 | 9 | # `LicenseKey` is from your MaxMind account 10 | LicenseKey your_LicenseKey 11 | 12 | # `EditionIDs` is from your MaxMind account. 13 | EditionIDs GeoLite2-ASN GeoLite2-City GeoLite2-Country 14 | 15 | # The remaining settings are OPTIONAL. 16 | 17 | # The directory to store the database files. Defaults to /usr/share/GeoIP 18 | DatabaseDirectory /usr/share/GeoIP/ 19 | 20 | # The server to use. Defaults to "updates.maxmind.com". 21 | # Host updates.maxmind.com 22 | 23 | # The proxy host name or IP address. You may optionally specify a 24 | # port number, e.g., 127.0.0.1:8888. If no port number is specified, 1080 25 | # will be used. 26 | # Proxy 127.0.0.1:8888 27 | 28 | # The user name and password to use with your proxy server. 29 | # ProxyUserPassword username:password 30 | 31 | # Whether to preserve modification times of files downloaded from the server. 32 | # Defaults to "0". 33 | # PreserveFileTimes 0 34 | 35 | # The lock file to use. This ensures only one geoipupdate process can run at a 36 | # time. 37 | # Note: Once created, this lockfile is not removed from the filesystem. 38 | # Defaults to ".geoipupdate.lock" under the DatabaseDirectory. 39 | # LockFile /usr/share/GeoIP/.geoipupdate.lock 40 | 41 | # The amount of time to retry for when errors during HTTP transactions are 42 | # encountered. It can be specified as a (possibly fractional) decimal number 43 | # followed by a unit suffix. Valid time units are "ns", "us" (or "µs"), "ms", 44 | # "s", "m", "h". 45 | # Defaults to "5m" (5 minutes). 46 | # RetryFor 5m 47 | 48 | # The number of parallel database downloads. 49 | # Defaults to "1". 50 | # Parallelism 1 51 | -------------------------------------------------------------------------------- /nebula/addons/waf/grafana/automatic.yml: -------------------------------------------------------------------------------- 1 | datasources: 2 | - name: Loki 3 | type: loki 4 | url: http://nebula_nebula-waf-loki:3100 5 | isDefault: true 6 | editable: true 7 | -------------------------------------------------------------------------------- /nebula/addons/waf/grafana/dashboard_config.yml: -------------------------------------------------------------------------------- 1 | apiVersion: 1 2 | 3 | providers: 4 | #© ${year} NEBULA. All rights reserved.
Documentation | Source code
Warning: you will remove the scenario from the database
` 33 | ); 34 | 35 | $('#confirm-modal #yes-button').off('click').on('click', () => { 36 | this.executeRemove(scenarioName); 37 | }); 38 | }, 39 | 40 | async executeRelaunch(scenarioName) { 41 | try { 42 | const response = await fetch(`/platform/dashboard/${scenarioName}/relaunch`, { 43 | method: 'GET' 44 | }); 45 | 46 | if (response.redirected) { 47 | window.location.href = response.url; 48 | } else { 49 | $('#confirm-modal').modal('hide'); 50 | $('#confirm-modal').on('hidden.bs.modal', () => { 51 | $('#info-modal-body').html('You are not allowed to relaunch a scenario with demo role.'); 52 | $('#info-modal').modal('show'); 53 | }); 54 | } 55 | } catch (error) { 56 | console.error('Error:', error); 57 | } 58 | }, 59 | 60 | async executeRemove(scenarioName) { 61 | try { 62 | const response = await fetch(`/platform/dashboard/${scenarioName}/remove`, { 63 | method: 'GET' 64 | }); 65 | 66 | if (response.redirected) { 67 | window.location.href = response.url; 68 | } else { 69 | $('#confirm-modal').modal('hide'); 70 | $('#confirm-modal').on('hidden.bs.modal', () => { 71 | $('#info-modal-body').html('You are not allowed to remove a scenario with demo role.'); 72 | $('#info-modal').modal('show'); 73 | }); 74 | } 75 | } catch (error) { 76 | console.error('Error:', error); 77 | } 78 | } 79 | }; 80 | 81 | export default ScenarioActions; 82 | -------------------------------------------------------------------------------- /nebula/frontend/static/js/deployment/graph-settings.js: -------------------------------------------------------------------------------- 1 | // Graph Settings Module 2 | const GraphSettings = (function() { 3 | const Settings = { 4 | solidDistance: 50, 5 | Distance: 50 6 | }; 7 | 8 | function initializeDistanceControls() { 9 | const distanceInput = document.getElementById('distanceInput'); 10 | const distanceValue = document.getElementById('distanceValue'); 11 | 12 | distanceInput.addEventListener('input', function() { 13 | distanceValue.value = distanceInput.value; 14 | Settings.Distance = distanceInput.value; 15 | updateLinkDistance(); 16 | }); 17 | 18 | distanceValue.addEventListener('input', function() { 19 | distanceInput.value = distanceValue.value; 20 | Settings.Distance = distanceValue.value; 21 | updateLinkDistance(); 22 | }); 23 | } 24 | 25 | function updateLinkDistance() { 26 | const Graph = window.TopologyManager.getGraph(); 27 | if (Graph) { 28 | Graph.d3Force('link') 29 | .distance(link => link.color ? Settings.solidDistance : Settings.Distance); 30 | Graph.numDimensions(3); // Re-heat simulation 31 | } 32 | } 33 | 34 | return { 35 | initializeDistanceControls, 36 | updateLinkDistance, 37 | getSettings: () => Settings 38 | }; 39 | })(); 40 | 41 | export default GraphSettings; 42 | -------------------------------------------------------------------------------- /nebula/frontend/static/js/deployment/utils.js: -------------------------------------------------------------------------------- 1 | // Utility Functions Module 2 | const Utils = (function() { 3 | function greaterThan0(input) { 4 | const value = parseInt(input.value); 5 | if(value < 1 && !isNaN(value)) { 6 | input.value = 1; 7 | } 8 | } 9 | 10 | function isInRange(input, min, max) { 11 | const value = parseFloat(input.value); 12 | if(isNaN(value)) { 13 | input.value = min; 14 | } else { 15 | input.value = Math.min(Math.max(value, min), max); 16 | } 17 | } 18 | 19 | function handleProbabilityChange(input) { 20 | let value = parseFloat(input.value); 21 | if (isNaN(value)) { 22 | value = 0.5; 23 | } else { 24 | value = Math.min(Math.max(value, 0), 1); 25 | } 26 | input.value = value.toFixed(1); 27 | 28 | // Trigger topology update if Random is selected 29 | const topologySelect = document.getElementById('predefined-topology-select'); 30 | if (topologySelect && topologySelect.value === 'Random') { 31 | window.TopologyManager.generatePredefinedTopology(); 32 | } 33 | } 34 | 35 | function atLeastOneChecked(checkboxIds) { 36 | return checkboxIds.some(function(id) { 37 | const checkbox = document.getElementById(id); 38 | return checkbox && checkbox.checked; 39 | }); 40 | } 41 | 42 | function selectALL(checkboxIds, checked) { 43 | for (let i = 0; i < checkboxIds.length; i++) { 44 | document.getElementById(checkboxIds[i]).checked = checked; 45 | } 46 | } 47 | 48 | return { 49 | showAlert, 50 | greaterThan0, 51 | isInRange, 52 | atLeastOneChecked, 53 | selectALL, 54 | handleProbabilityChange 55 | }; 56 | })(); 57 | 58 | export default Utils; 59 | -------------------------------------------------------------------------------- /nebula/frontend/static/js/particles.json: -------------------------------------------------------------------------------- 1 | { 2 | "particles": { 3 | "number": { 4 | "value": 40, 5 | "density": { 6 | "enable": true, 7 | "value_area": 800 8 | } 9 | }, 10 | "color": { 11 | "value": "#1d2253" 12 | }, 13 | "shape": { 14 | "type": "circle", 15 | "stroke": { 16 | "width": 0, 17 | "color": "#000000" 18 | }, 19 | "polygon": { 20 | "nb_sides": 5 21 | }, 22 | "image": { 23 | "src": "img/github.svg", 24 | "width": 100, 25 | "height": 100 26 | } 27 | }, 28 | "opacity": { 29 | "value": 0.5, 30 | "random": false, 31 | "anim": { 32 | "enable": false, 33 | "speed": 1, 34 | "opacity_min": 0.1, 35 | "sync": false 36 | } 37 | }, 38 | "size": { 39 | "value": 5, 40 | "random": true, 41 | "anim": { 42 | "enable": false, 43 | "speed": 40, 44 | "size_min": 0.1, 45 | "sync": false 46 | } 47 | }, 48 | "line_linked": { 49 | "enable": true, 50 | "distance": 150, 51 | "color": "#1d2253", 52 | "opacity": 0.4, 53 | "width": 1 54 | }, 55 | "move": { 56 | "enable": true, 57 | "speed": 2, 58 | "direction": "none", 59 | "random": false, 60 | "straight": false, 61 | "out_mode": "out", 62 | "attract": { 63 | "enable": false, 64 | "rotateX": 600, 65 | "rotateY": 1200 66 | } 67 | } 68 | }, 69 | "interactivity": { 70 | "detect_on": "window", 71 | "events": { 72 | "onhover": { 73 | "enable": true, 74 | "mode": "repulse" 75 | }, 76 | "onclick": { 77 | "enable": true, 78 | "mode": "push" 79 | }, 80 | "resize": true 81 | }, 82 | "modes": { 83 | "grab": { 84 | "distance": 400, 85 | "line_linked": { 86 | "opacity": 1 87 | } 88 | }, 89 | "bubble": { 90 | "distance": 400, 91 | "size": 40, 92 | "duration": 2, 93 | "opacity": 8, 94 | "speed": 3 95 | }, 96 | "repulse": { 97 | "distance": 100 98 | }, 99 | "push": { 100 | "particles_nb": 4 101 | }, 102 | "remove": { 103 | "particles_nb": 2 104 | } 105 | } 106 | }, 107 | "retina_detect": true, 108 | "config_demo": { 109 | "hide_card": false, 110 | "background_color": "#1d2253", 111 | "background_image": "", 112 | "background_position": "50% 50%", 113 | "background_repeat": "no-repeat", 114 | "background_size": "cover" 115 | } 116 | } 117 | -------------------------------------------------------------------------------- /nebula/frontend/static/maintenance.html: -------------------------------------------------------------------------------- 1 | 2 |Sorry for the inconvenience. We’re performing some maintenance at the moment. If you need to you can always contact me on Email for updates, otherwise we’ll be back up shortly!
21 |— NEBULA team
22 |You're not allowed to access.
8 |This operation is forbidden.
8 |The resource can not be found.
8 |The method of your request is not allowed.
8 |Please check the file size you're uploading.
8 |This is the private area of the scenario {{ scenario_name }}.
9 |