https://github.com/juju4/ansible-polarproxy

install Netresec PolarProxy
https://github.com/juju4/ansible-polarproxy

Last synced: 12 days ago
JSON representation

install Netresec PolarProxy

• Host: GitHub
• URL: https://github.com/juju4/ansible-polarproxy
• Owner: juju4
• License: bsd-2-clause
• Created: 2019-11-10T00:40:51.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-12-22T18:38:39.000Z (18 days ago)
• Last Synced: 2024-12-22T19:34:11.212Z (18 days ago)
• Language: Ruby
• Size: 111 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Actions Status - Master](https://github.com/juju4/ansible-polarproxy/workflows/AnsibleCI/badge.svg)](https://github.com/juju4/ansible-polarproxy/actions?query=branch%3Amaster)

[![Actions Status - Devel](https://github.com/juju4/ansible-polarproxy/workflows/AnsibleCI/badge.svg?branch=devel)](https://github.com/juju4/ansible-polarproxy/actions?query=branch%3Adevel)

# PolarProxy install

This role will install [Netresec PolarProxy](https://www.netresec.com/?page=PolarProxy)

# Requirements & Dependencies

### Ansible

It was tested on the following versions:

 * 2.8

 * 2.10

### Operating systems

Tested with molecule on Ubuntu 16.04, 18.04, 20.04 and Centos 7-8

## Example Playbook

Just include this role in your list.

For example

```

- host: all

  roles:

    - juju4.polarproxy

```

## Continuous integration

This role has a travis config leveraging molecule for testing, also kitchen with docker and vagrant

Once you ensured all necessary roles are present, You can test with:

```

$ pip install molecule docker

$ molecule test

$ molecule --debug test

$ MOLECULE_DISTRO=ubuntu:16.04 molecule test --destroy=never

```

```

$ gem install kitchen-ansible kitchen-docker kitchen-sync

$ cd /path/to/roles/juju4.polarproxy

$ kitchen verify

$ kitchen login

$ KITCHEN_YAML=".kitchen.docker.yml" kitchen verify

```

or

```

$ cd /path/to/roles/juju4.polarproxy/test/vagrant

$ vagrant up

$ vagrant ssh

```

## Troubleshooting & Known issues

* Use as explicit proxy

```

Oct 01 00:04:31 testhostname PolarProxy[49741]: [10443] n.n.n.n -> N/A System.IO.IOException : The handshake failed due to an unexpected packet format.

Oct 01 00:04:31 testhostname PolarProxy[49741]: [10443] n.n.n.n -> N/A Internal and/or external SSL session did not authenticate successfully

Oct 10 00:07:02 testcentral PolarProxy[49741]: [10443] n.n.n.n -> N/A System.IO.IOException : Authentication failed because the remote party has closed the transport stream.

Oct 10 00:07:02 testcentral PolarProxy[49741]: [10443] n.n.n.n -> N/A Internal and/or external SSL session did not authenticate successfully

```

PolarProxy works only as Transparent Proxy and requires firewall redirection. It can't be explicit through browser.

## License

BSD 2-clause