๐Ÿ•ต๏ธ request-psn

January 26, 2026 ยท View on GitHub

MegaLinter build docker codecov

request-psn

This service provides pseudonymization of a single value and fixed target domain with gPAS. The target domain is configured with the user's authorization data.

API endpoints

The (REST) service is comprised of two endpoints: One endpoint to pseudonymize a value with a pre-configured domain and a status endpoint to check the services health.

GET /request-psn/{original} (get pseudonym for {original})

Responses

http codecontent-typeresponse
200 Oktext/plain; charset=utf-8The pseudonymized value
401 Unauthorized
500 Internal Server Errortext/plain;charset=UTF-8Error message

GET /status (get service status information)

Responses

http codecontent-typeresponse
200 Okapplication/json{"healthy": [true|false] }
401 Unauthorized

Authorization

Currently, only Basic authentication is supported. The credentials and the configured domain to be used with requests are stored with the service.

Configuration properties

Application properties are read from a properties file (app.yaml) with default values.

NameDefaultDescriptionRequired
log_levelinfoLog level (error,warn,info,debug,trace)
ttp.gpas.base_urlgPAS base urlโœ“
ttp.timeout120Retry timeout

Environment variables

Override configuration properties by providing environment variables with their respective property names. Replace . with double underscore (__).

Example deployment

Docker compose:

request-psn:
  image: ghcr.io/diz-unimr/request-psn:latest
  environment:
    LOG_LEVEL: debug
    TTP__GPAS__BASE_URL: http://localhost:8081
    TTP__TIMEOUT: 60

License

AGPL-3.0