Instructions

How to set up the server and run the client with a default configuration

Server

Installing

• Create a conda environment (optional but recommended)

$ conda create -n Quantumacy python=3.8.10
$ conda activate Quantumacy

• install requirements

$ pip install QKDSimkit

• Download, install and run Redis

$ wget https://download.redis.io/releases/redis-6.2.6.tar.gz
$ tar xzf redis-6.2.6.tar.gz
$ cd redis-6.2.6
$ make
$ src/redis-server

Redis is a requirement for QKDSimkit server and QKDSimkit p2p

Executing

• Run the server and the channel on the same machine, it will start both the server and the channel, the default addresses are 127.0.0.1:5002 for server and 127.0.0.1:5000 for channel

$ QKDSimkit server local

• It is possible to run the channel with custom settings adding noise (-n) and simulating an eavesdropper (-e)

$ QKDSimkit server local -n 0.5 -e True

• In case you want to share an already existing channel with other servers or with a peer to peer infrastructure you can use this command to connect the server to an external channel:

$ QKDSimkit server -a [host:port] external -ca [host:port]

Additional commands

• Add a user: specify a token, it can be useful for multiple clients

$ QKDSimkit server add_user <token>

• Retrieve keys from server it is possible to specify a token (-t) to retrieve a specific set of keys

$ QKDSimkit server retrieve 

Help

For more options please check

$ QKDSimkit server -h
$ QKDSimkit server local -h
$ QKDSimkit server external -h
$ QKDSimkit server add_user -h
$ QKDSimkit server retrieve -h

Client

Installation

• Create a conda environment (optional but recommended)

$ conda create -n Quantumacy python=3.8
$ conda activate Quantumacy

• Install requirements

$ pip install QKDSimkit

Executing

• Run client

$ QKDSimkit client [server_host:port] [channel_host:port]

• It is possible to specify the number of keys (-n) and their size (-s):

$ QKDSimkit client [server_host:port] [channel_host:port] -n [num_keys] -s [size]

• To handle multiple clients it is possible to run the client with a pre shared token

$ QKDSimkit client -t [token] [server_host:port] [channel_host:port] 

• If you are using a token remember to add the same token in the server running in the server machine:

$ QKDSimkit server add_user [token]

Help

For more options please check

$ python client -h

P2P

The peer to peer mode provides two servers (Alice and Bob) to simulate a synchronous exchange, there are three components: the channel, Alice and Bob

• Use the following command to run the channel, you can use this channel also in the Server - Client architecture and similarly it is possible to use custom settings like noise (-n) and eavesdropper (-e)

$ QKDSimkit channel -a [hostname:port]

• Run Alice

$ QKDSimkit p2p alice -c [channel_address] -a [hostname:port]

• Run Bob

$ QKDSimkit p2p bob -c [channel_address] -a [hostname:port]

• You can use http requests to Alice and Bob to start the exchange and retrieve keys.
  Check http://[address]/docs to access FastAPI documentation and to know more about http request parameters

Authors

Contributor names and contact info:

Alberto Di Meglio

Gabriele Morello [email]

License

This project is licensed under the MIT License - see the LICENSE file for details

Version History

• 0.0.6
• 0.0.5
• 0.0.2
• 0.0.1
  • Initial Release

Acknowledgments