macaddress.io - REST API Demo

check_mac.py is a Python program, that demos a simple REST API to talk to macaddress.io REST API services to check the name of the company holding ownership of any mac address.

Prerequisite

-- Tested on :

• CentOS 7.4
• Python 2.7
• PIP 19.2
• Request 2.20
• Docker CE 19.03 (optional) - for containerization

Installation

Use Git clone to clone this repository.

git clone https://github.com/animeshdas/macaddress_io_REST_API_Demo.git
cd macaddress_io_REST_API_Demo

Standalone Usage

Install you macaddress.io API key.

cd assets
chmod 755 install_apikey.sh
./install_apikey.sh
mv macaddress_io.apikey ../.

Run the python program

python check_mac.py

🔴 For Security reasons, delete the API key once you are done.

rm -rf macaddress_io.apikey

Docker Usage

First change to project directory

cd macaddress_io_REST_API_Demo

Build your image once with API Key

chmod 755 assets/install_apikey.sh
chmod 755 build.sh
./build.sh

Run the python program

chmod 755 run.sh
./run.sh

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. You can also drop me an email at jobs4ani at gmail dot com

Security

To secure the API-Key, gnome-keyring along with python-keyring in headless mode (without X), can be used to store the API Key. But this is out of scope for now, due to time constraint.

🔴 Till then, delete the API key once you are done, as mentioned above.

License

MIT