Basic protocol to send files using the hairgap binary ( github.com/cea-sec/hairgap ).
Project description
Hairgap
Basic protocol to send files using the hairgap binary. The goal is to send random files through a unidirectionnal data-diode using UDP connections.
By default, hairgap can only send a file, without its name nor metadata. This Python library implements a basic protocol to send complete directories with checksums.
This protocol is customizable and the sender can add some attributes (a Dict[str, str]
) to each transfer.
- We assume that the hairgap binary is installed and in the PATH environment variable.
- The MAC adress of the destination must be known from the sender machine. You can inject this information into the ARP cache of the sender machine:
DESTINATION_IP="the IP address of the destination machine"
DESTINATION_MAC="the MAC address of the destination machine"
arp -s ${DESTINATION_IP} ${DESTINATION_MAC}
First, you must start the receiver on the destination side:
python3 -m pip install hairgap
DESTINATION_IP="the IP address of the destination machine"
pyhairgap receive ${DESTINATION_IP} directory/
Then you can send directories:
python3 -m pip install hairgap
DESTINATION_IP="the IP address of the destination machine"
pyhairgap send ${DESTINATION_IP} directory/
Hairgap binaries
You need to compile hairgap binaires yourself since no official package exists.
However, a Python package (hairgap-binaries
) has been created to distribute precompiled binaries for Linux x86_64.
This package is automatically detected and used.
python3 -m pip install hairgap-binaries
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for hairgap-1.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4547ab9504fd415e47ea39e3f7e98a7ea89a514b79088f99909b5f0750e198a2 |
|
MD5 | 8269446523226d5c800f7d134c095dd5 |
|
BLAKE2b-256 | 273fef1808b9dd6decdbef07709744f9a6857e28c93b26ab2ffcb4a1ff86529d |