sitmun / sitmun-proxy-middleware

The proxy "middleware" component of the SITMUN platform.
European Union Public License 1.2
1 stars 2 forks source link

Quality Gate

SITMUN proxy middleware

The SITMUN Proxy Middleware is a reverse proxy and middleware that facilitates the access of the SITMUN Map Viewer to protected services and databases.

These protected services or databases can have various restrictions or requirements, such as:

Prerequisites

Before you begin, ensure you have met the following requirements:

Installing SITMUN Proxy Middleware

To install the SITMUN Proxy Middleware, follow these steps:

  1. Clone the repository:

    git clone https://github.com/sitmun/sitmun-proxy-middleware.git
  2. Change to the directory of the repository:

    cd sitmun-proxy-middleware
  3. Create a new file named .env inside the directory. Open the .env file in a text editor and add in the following format:

    SITMUN_BACKEND_CONFIG_URL=the_location_of_the_sitmun_backend_configuration_endpoint
    SITMUN_BACKEND_CONFIG_SECRET=the_shared_secret
  4. Start the SITMUN Middleware proxy:

    docker compose up

    This command will build and start all the services defined in the docker-compose.yml file.

  5. Access the SITMUN Middleware Proxy at http://localhost:9002/actuator/health and expect:

    {"status":"UP"}

See SITMUN Application Stack as an example of how to deploy and run the proxy as parte of the SITMUN stack.

Configuration

The following environment variables are required:

Additional information is available at https://sitmun.github.io/architecture/.

Uninstalling SITMUN Proxy middleware

To stop and remove all services, volumes, and networks defined in the docker-compose.yml file, use:

docker compose down -v

Contributing to SITMUN Application Stack

To contribute to SITMUN Application Stack, follow these steps:

  1. Fork this repository on GitHub.
  2. Clone your forked repository to your local machine.
  3. Create a new branch for your changes.
  4. Make your changes and commit them.
  5. Push your changes to your forked repository.
  6. Create the pull request from your branch on GitHub.

Alternatively, see the GitHub documentation on creating a pull request.

License

This project uses the following license: European Union Public Licence V. 1.2.