Skip to main content

A RESTful API for automated IPAM of a personal lab in vLab

Project description

This service replaces the existing static gateway used in vLab.

The goal of this service is to make it easier for users to access their lab by removing the need for the jumpbox. This is achieved by exposing a RESTful API on the gateway that can dynamically port-forward through the NAT firewall that runs on the gateway. Additionally, vLab clients can leverage this API to programmically connect users to a given resource. For example the vLab CLI client can potentially:

  1. Expose an interface like vlab connect windows --name <name of instance> --protocol=RDP
  2. Call the main vLab server to get the IP of the gateway
  3. Call the API on the gateway to get the port that maps to the specific component and protocol
  4. Evoke an application on the user’s machine that understands the specific protocol, and pre-populate the connection information.

Clients can also programmically create the port forwarding rules upon component creation. This would remove the need for users to manually port forwarding rules, but clients should not prevent users from inputting their own port forwarding rules.

Background Services

The IPAM service has two background processes:


Periodically pings IPs stored in the IPAM database. This allows the service to identify “bad records” and relay that information to the user.


Forwards firewall logs to a remote server. The default iptables config will log every time a package is FORWARDed. By forwarding the logs for remote processing, admins of vLab can answer business questions like, “Do they use that resource?”


Runs on a regular cycle to send Dynamic DNS updates to the vLab DNS service.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for vlab-ipam-api, version 2019.7.3
Filename, size File type Python version Upload date Hashes
Filename, size vlab_ipam_api-2019.7.3-py3-none-any.whl (40.2 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page