Skip to main content

Proxy for easy authentication to the TecoRoute service.

Project description

TecoRoute Proxy

TecoRoute Proxy is a reverse proxy server that allows easy authentication to the TecoRoute service using a simple POST request. It also saves the credentials and automatically logs the user in when the TecoRoute session expires.

How it works

The server has one control endpoint (/TR_PROXY by default) that is used to log in and log out of the user from the proxy. All other requests are proxied to TecoRoute. The proxy session is stored only in the user's session cookies, so the server is completely stateless and no database is required.

The control endpoint accepts POST requests with application/x-www-form-urlencoded content type (HTML form).

Log the user in

The user logs in with the following data:

Name Value
action login
username TecoRoute username
password TecoRoute password
plc TecoRoute PLC

Example of a HTML form that logs the user in:

<form method="post" action="">
  <button name="action" value="login">Open PLC</button>
  <input type="hidden" name="username" value="BroukPytlik" />
  <input type="hidden" name="password" value="ferda1" />
  <input type="hidden" name="plc" value="AB_1234" />

Log the user out

The user logs out with the following data:

Name Value
action logout

Example of a HTML form that logs the user out:

<form method="post" action="">
  <button name="action" value="logout">Logout from TecoRoute</button>

Logging out will try to log the user out from TecoRoute and delete the login data from the user's cookies.

Usage options

TecoRoute Proxy can be used as a service, standalone application or as a Python library.

Use as a service

Server is deployed at The control URL is:

Feel free to use the service for testing or simple production purposes.

Install from PyPI


  • Python (version 3.8 or later)
  • pip or another package installer for Python

Installation using pip is done with:

pip install tecoroute-proxy

Start the server with:


On an unprivileged port (e.g. 8080), start the server with:

tecoroute-proxy -p 8080

For all options, run tecoroute-proxy --help.

It is possible to use the package as a Python library and run the server synchronously or asynchronously in the event loop. Example of use:

from logging import INFO, basicConfig

from tecoroute_proxy import ProxyServer

server = ProxyServer(port=8080)

See full documentation at

Run from Docker Hub

Run the image from Docker Hub:

docker run -p 80:80 czetech/tecoroute-proxy

Install to Kubernetes using Helm

Setup Helm repository:

helm repo add czetech

Install Helm chart:

helm install tecoroute-proxy czetech/tecoroute-proxy \
  --set ingress.enabled=true \
  --set ingress.hosts[0]=<ingress-host>

see the chart for more options.

Source code

The source code is available at

Project details

Download files

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

Source Distribution

tecoroute-proxy-0.3.0.tar.gz (11.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page