# BARS

**Repository Path**: xxdxxdxxd/BARS

## Basic Information

- **Project Name**: BARS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2023-12-12
- **Last Updated**: 2024-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BARS: Local Robustness Certification for Traffic Analysis

<p align="center">
<img src="images/overview_training_stage.png" width="56.1%" float="left">
<img src="images/overview_certification_stage.png" width="35%" float="right">
</p>

> *BARS: Local Robustness Certification for Deep Learning based Traffic Analysis Systems (NDSS'23)*

---

![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg)
![Python language](https://img.shields.io/badge/language-Python-blue.svg)
![PyTorch framework](https://img.shields.io/badge/framework-PyTorch-orange.svg)

## Introduction

**BARS** is a general local robustness certification framework for Deep Learning (DL) based traffic analysis systems based on **B**oundary **A**daptive **R**andomized **S**moothing. Against adversarial perturbations, local robustness certification is used to certify whether a DL-based model is robust in the neighborhood of a sample.

**BARS** optimizes the smoothing noise of randomized smoothing and provide tighter robustness guarantee for the traffic analysis domain. The pipeline includes four steps:
- [Build Distribution Transformer.](bars/distribution_transformer.py)
- [Optimize the noise shape.](bars/optimizing_noise.py)
- [Optimize the noise scale.](bars/optimizing_noise.py)
- [Certify robustness.](bars/smoothing.py)

**BARS** supports three traffic analysis systems:
- [Zero-Positive  Network Intrusion Detection System, Kitsune (NDSS'18)](smoothed_kitsune)
- [Concept Drift Detection System, CADE (USENIX Security'21)](smoothed_cade)
- [Supervised Multi-Classification System, ACID (INFOCOM'21)](smoothed_acid)

## Quick Start

### 1. Environmental Setup

- Basic **BARS**: `pip install -r requirement_bars.txt`
- Smoothed Kitsune: `pip install -r requirement_kitsune.txt`
- Smoothed CADE: `pip install -r requirement_cade.txt`
- Smoothed ACID: `pip install -r requirement_acid.txt`

### 2. Running Program

- Please run `python main.py`.

- Program arguments are set at the beginning of `main.py`.

## Citation
TBA.