GOB StUF provides for StUF access

It serves as a proxy and transparantly forwards requests to a StUF server

* docker-compose >= 1.17
* docker ce >= 18.03
* python >= 3.6

• Both a certificate and a VPN are required to access the underlying StUF service.

• SoapUI can be used to test the StUF service.

The service definition that is exposed is:

http://localhost:<<GOB_STUF_PORT>><<ROUTE_NETLOC>>?wsdl

eg:

http://localhost:8165/SomePath/MijnService?wsdl

The StUF endpoint is reported at startup of the service.

This service also exposes REST endpoints that in the background perform StUF requests to obtain the requested data.

See REST endpoints for a more detailed explanation.

Create a virtual environment:

virtualenv env
source venv/bin/activate
pip install -r src/requirements.txt

Or activate the previously created virtual environment

source venv/bin/activate

Set the environment variables (see also next paragraph)

export $(cat .env | xargs)

Start the StUF service

cd src
python -m gobstuf

The service is default exposed at:

• http://127.0.0.1:8165/

The IP address of the server is also reported at stdout on startup the API

The StUF service needs to be configured using environment variables:

• ROUTE_SCHEME
  The scheme of the proxied path, default https
• ROUTE_NETLOC The domain of the proxied path
• ROUTE_PATH The path that is proxied by the StUF service
• PKCS12_FILENAME
  The file where the certificate is stored
• PKCS12_PASSWORD The password for the certificate file
• GOB_STUF_PORT The port at which the service listens for requests, default 8165

The environment variables should be stored in a .env file (included in .gitignore)

An example can be found in .env.example. The example connects to a public number conversion soap service

The variables can be set using:

export $(cat .env | xargs)

cd src
sh test.sh

docker-compose build
docker-compose up

The API is exposed at the same address as for the local installation.

docker-compose -f src/.jenkins/test/docker-compose.yml build
docker-compose -f src/.jenkins/test/docker-compose.yml run --rm test