pyAirlock 0.9.0

Python library for Airlock product REST APIs

GitHub	PyPI

pyAirlock

Airlock, a subsidiary of Ergon Informatik, provides security products to protect web applications and APIs against all sorts of attacks.

• Airlock Gateway Airlock Gateway is a web application firewall (WAF) and protects mission-critical, web-based applications and APIs from attacks and undesired visitors. As a central security instance, it examines every HTTP(S) request for attacks and thus blocks any attempt at data theft and manipulation.
• Airlock Microgateway Airlock Microgateway protects APIs and microservices from attacks and unauthorized access while they are running. Being specifically designed for use in Kubernetes environments, it is placed close to the protected services.
• Airlock IAM Airlock IAM is a customer identity and access management (cIAM) solution guaranteeing absolutely secure and efficient access procedures for web applications. offers centralised identity management and organisation of access permissions, for applications and APIs, alike. Integrated applications can be bundled as a single sign-on (SSO) group.

Airlock Gateway and Airlock IAM, being stand-alone, centrally installed services, both provide REST APIs to integrate third-party or customer-specific tools. These APIs are all documented here.

pyAirlock is a Python library wrapping these REST APIs and allowing system administrators easier access.

• Gateway
  • configuration REST API, providing access to configuration objects, virtual hosts, mappings etc.
• IAM (not implemented yet)
  • Loginapp flows for authentication, registration and self-services
  • Transaction approval flows
  • Adminapp for user and token management
• Common
  • Shared library functions such as reading config files, logging etc.

Airlock Microgateway, by the way, is tightly integrated with Kubernetes. Configuration, for example, is specified through custom resource definitions, expressed as YAML manifests. They are created and maintained using the standard Kubernetes APIs.

Getting started

Installation

pip install pyAirlock

Create API documentation

pip install pdoc3
pdoc --html src/pyAirlock

Read documentation by opening html/index.html in your browser of choice.

Usage

from pyAirlock.gateway.config_api import gateway
from pyAirlock.common import config

cfg = config.Config( "src/samples/config.yaml" )
cfg.load()
server = cfg.get( 'servers.test' )[0]
gw = gateway.GW( "test", cfg.get( 'hostname', base=server ), cfg.get( 'apikey', base=server ))
gw.setTLSVerify( False )
gw.connect()
gw.get( "/configuration/configurations" ).json()

Getting support

This library is not part of the official Airlock product delivery. Airlock support will be unable to accept or answer tickets.

If you encounter an error, the author welcomes pull requests with fixes. Alternatively, an issue may be created on the GitHub issue tracker. Please note that there is no guaranteed response time and any support is best effort.