pyAirlock


NamepyAirlock JSON
Version 1.0.1 PyPI version JSON
download
home_pageNone
SummaryPython library for Airlock product REST APIs
upload_time2024-07-01 14:00:50
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords airlock
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            | GitHub | PyPI |
| ------ | ---- |
| [![GitHub](https://img.shields.io/badge/GitHub-pyAirlock-blue?logo=github)](https://github.com/alalazu/pyAirlock) | [![PyPI](https://img.shields.io/pypi/v/pyAirlock?logo=pypi)](https://pypi.org/project/pyAirlock/) |

# pyAirlock

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

* [Airlock Gateway](https://www.airlock.com/en/secure-access-hub/components/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](https://www.airlock.com/en/secure-access-hub/components/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](https://www.airlock.com/en/secure-access-hub/components/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](https://docs.airlock.com).

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

- [Gateway](gateway/index.html)
    - configuration REST API, providing access to configuration objects, virtual hosts, mappings etc.
- [IAM](iam/index.html) (not implemented yet)
    - Loginapp flows for authentication, registration and self-services
    - Transaction approval flows
    - Adminapp for user and token management
- [Common](common/index.html)
    - 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](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/),
expressed as YAML manifests. They are created and maintained using the standard Kubernetes APIs.

## Getting started

### Installation
```bash
pip install pyAirlock
```

### Create API documentation
```bash
pip install pdoc3
pdoc --html src/pyAirlock
```

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

### Usage
```python
from pyAirlock import gateway
from pyAirlock.common import config

cfg = config.Config( "src/samples/config.yaml" )
cfg.load()
server = cfg.get( 'servers.test' )[0]
gw = gateway.Session( 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](https://github.com/alalazu/pyAirlock/issues).
Please note that there is no guaranteed response time and any support is best effort.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pyAirlock",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "airlock",
    "author": null,
    "author_email": "Urs Zurbuchen <info@airlock.com>",
    "download_url": "https://files.pythonhosted.org/packages/95/b0/d8f5ed76924db1832b16098a786e22c629647d95b4a9a908bef4f169910f/pyairlock-1.0.1.tar.gz",
    "platform": null,
    "description": "| GitHub | PyPI |\r\n| ------ | ---- |\r\n| [![GitHub](https://img.shields.io/badge/GitHub-pyAirlock-blue?logo=github)](https://github.com/alalazu/pyAirlock) | [![PyPI](https://img.shields.io/pypi/v/pyAirlock?logo=pypi)](https://pypi.org/project/pyAirlock/) |\r\n\r\n# pyAirlock\r\n\r\nAirlock, a subsidiary of Ergon Informatik, provides security products\r\nto protect web applications and APIs against all sorts of attacks.\r\n\r\n* [Airlock Gateway](https://www.airlock.com/en/secure-access-hub/components/gateway)\r\n  Airlock Gateway is a web application firewall (WAF) and protects mission-critical,\r\n  web-based applications and APIs from attacks and undesired visitors.\r\n  As a central security instance, it examines every HTTP(S) request for attacks and\r\n  thus blocks any attempt at data theft and manipulation.\r\n* [Airlock Microgateway](https://www.airlock.com/en/secure-access-hub/components/microgateway)\r\n  Airlock Microgateway protects APIs and microservices from attacks and unauthorized\r\n  access while they are running. Being specifically designed for use in Kubernetes\r\n  environments, it is placed close to the protected services.\r\n* [Airlock IAM](https://www.airlock.com/en/secure-access-hub/components/iam)\r\n  Airlock IAM is a customer identity and access management (cIAM) solution guaranteeing\r\n  absolutely secure and efficient access procedures for web applications.\r\n  offers centralised identity management and organisation of access permissions,\r\n  for applications and APIs, alike.\r\n  Integrated applications can be bundled as a single sign-on (SSO) group.\r\n\r\nAirlock Gateway and Airlock IAM, being stand-alone, centrally installed services, both\r\nprovide REST APIs to integrate third-party or customer-specific tools.\r\nThese APIs are all documented [here](https://docs.airlock.com).\r\n\r\npyAirlock is a Python library wrapping these REST APIs and allowing system administrators\r\neasier access.\r\n\r\n- [Gateway](gateway/index.html)\r\n    - configuration REST API, providing access to configuration objects, virtual hosts, mappings etc.\r\n- [IAM](iam/index.html) (not implemented yet)\r\n    - Loginapp flows for authentication, registration and self-services\r\n    - Transaction approval flows\r\n    - Adminapp for user and token management\r\n- [Common](common/index.html)\r\n    - Shared library functions such as reading config files, logging etc.\r\n\r\n\r\nAirlock Microgateway, by the way, is tightly integrated with Kubernetes.\r\nConfiguration, for example, is specified through [custom resource definitions](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/),\r\nexpressed as YAML manifests. They are created and maintained using the standard Kubernetes APIs.\r\n\r\n## Getting started\r\n\r\n### Installation\r\n```bash\r\npip install pyAirlock\r\n```\r\n\r\n### Create API documentation\r\n```bash\r\npip install pdoc3\r\npdoc --html src/pyAirlock\r\n```\r\n\r\nRead documentation by opening html/index.html in your browser of choice.\r\n\r\n### Usage\r\n```python\r\nfrom pyAirlock import gateway\r\nfrom pyAirlock.common import config\r\n\r\ncfg = config.Config( \"src/samples/config.yaml\" )\r\ncfg.load()\r\nserver = cfg.get( 'servers.test' )[0]\r\ngw = gateway.Session( cfg.get( 'hostname', base=server ), cfg.get( 'apikey', base=server ))\r\ngw.setTLSVerify( False )\r\ngw.connect()\r\ngw.get( \"/configuration/configurations\" ).json()\r\n```\r\n\r\n## Getting support\r\n\r\nThis library is not part of the official Airlock product delivery. Airlock support will be unable\r\nto accept or answer tickets.\r\n\r\nIf you encounter an error, the author welcomes pull requests with fixes. Alternatively, an issue may be created\r\non the [GitHub issue tracker](https://github.com/alalazu/pyAirlock/issues).\r\nPlease note that there is no guaranteed response time and any support is best effort.\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python library for Airlock product REST APIs",
    "version": "1.0.1",
    "project_urls": {
        "Homepage": "https://github.com/alalazu/pyAirlock",
        "Official Website": "https://www.airlock.com"
    },
    "split_keywords": [
        "airlock"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5db5fb246e85d2bfd218c7d3f529f5e1c6ce3c611a8944eb0c8a50080a977f86",
                "md5": "bc0fc34f79f88a7a851ad7cde896447d",
                "sha256": "cff53abf9553c2999e04fce034a6ca8e8190b60160826bf6ed5bf48721ab8b8c"
            },
            "downloads": -1,
            "filename": "pyAirlock-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bc0fc34f79f88a7a851ad7cde896447d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 65040,
            "upload_time": "2024-07-01T14:00:48",
            "upload_time_iso_8601": "2024-07-01T14:00:48.784305Z",
            "url": "https://files.pythonhosted.org/packages/5d/b5/fb246e85d2bfd218c7d3f529f5e1c6ce3c611a8944eb0c8a50080a977f86/pyAirlock-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "95b0d8f5ed76924db1832b16098a786e22c629647d95b4a9a908bef4f169910f",
                "md5": "6d681260e62bf14ea0b837bc23116aa2",
                "sha256": "112972c0edeb080572a092e8903d8c7df66471cc68a04a123b59323bf16f4905"
            },
            "downloads": -1,
            "filename": "pyairlock-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "6d681260e62bf14ea0b837bc23116aa2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 27830,
            "upload_time": "2024-07-01T14:00:50",
            "upload_time_iso_8601": "2024-07-01T14:00:50.710871Z",
            "url": "https://files.pythonhosted.org/packages/95/b0/d8f5ed76924db1832b16098a786e22c629647d95b4a9a908bef4f169910f/pyairlock-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-01 14:00:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "alalazu",
    "github_project": "pyAirlock",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "pyairlock"
}
        
Elapsed time: 0.26382s