eduTAP.google_callback_handler - A Callback-Handler for Google Wallet

This eduTAP Package provides you with a reusable callback handler that conforms with the API specification from Google Wallet. see https://developers.google.com/wallet/generic/use-cases/use-callbacks-for-saves-and-deletions

This docker compose contains:

• a google pass callback handler it just puts the request as is into kafka
• kafka instance storing incoming callback requests from google
• kafka-ui for viewing what happens in kafka
• traefik ingress server that handles https and automatic letsencrypt stuff

Install Standalone Version

Attention Google expects a public https service at the location defined in the pass class therefore we use traefik with letsencrypt

provide an .env file with the contents in the root of this directory, for example like so:

DNS=192.168.8.1
DOMAIN=demo.edutap.eu
HTTPS_PORT=443

make sure that

• the domain points to your server
• your server is reachable publicly on port 80 for letsencrypt
• your HTTPS_PORT is free

then start the appliance:

docker-compose up

the appliance contains the following services:

• callback-handler reachable under /callback
• kafka reachable
• kafka-ui
• traefik

after startup, check:

• https://{DOMAIN}/{HTTPS_PORT}/docs shall show you the swagger interface
• https://{DOMAIN}/{HTTPS_PORT}/kafka-ui shows you the kafka user interface
• https://{DOMAIN}/{HTTPS_PORT}/v1/callback contains the callback url

TODO: protect the kafka user interface

troubleshooting

• kafka complains about 'permission denied'

make sure that ./kafka_data has the necessary permissions

• permission complaints concerning the ./letsencrypt dir

fiddle around with the permissions of this directory ;)