[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/mds4ul/pprl-resolver/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","mds4ul","reponame","pprl-resolver","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2022-06-28T09:26:15.168951Z","description","","is_private","last_updated","2022-06-28T09:26:15.22136Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",63,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# PPRL Resolver Service\n\nThe PPRL pseudonym resolver service handles the client-side stuff in a PPRL workflow.\nIt connects to different data sources, converts pseudonyms into data records, encodes them and sends them off to a central linkage unit.\nMatch results are returned in a pseudonymized form.\n\n## Running with Uvicorn\n\nThe pseudonym resolver can be run with any ASGI web server.\nThis example will show the startup using [Uvicorn](https://www.uvicorn.org/).\nIt is highly recommended that you use Python 3.10 on the machine that you want to host the resolver on.\nFirst, clone this repository.\nThen, install Uvicorn on your machine by running `python -m pip install uvicorn`.\nMake sure to set necessary [environment variables](#setting-environment-variables).\nNavigate to the root directory of this repository and execute the following line.\n\n```\nuvicorn pprl_resolver.main:app --host 0.0.0.0 --port 8080\n```\n\nThis will make the web server listen on port 8080 of all interfaces and forward the requests to the pseudonym resolver.\n\n## Running with Docker\n\nThe pseudonym resolver can also be run with a preconfigured Docker image.\nAll you need to do is to download it and create a container with it.\n\n```\ndocker pull mds4ul/pprl-resolver:0.6.0\n```\n\nBy default, the container exposes the service on port 8080.\nDon't forget to bind it to your host machine, to use a different port or to put it behind a proxy, if necessary.\nMake sure to set [environment variables](#setting-environment-variables) accordingly.\n\n```\ndocker run -p 8080:8080 \\\n -e BROKER_BASE_URL=\"http://localhost:8080/broker\" \\\n -e ENCODER_BASE_URL=\"http://localhost:8080/encoder\" \\\n -e EPIX_WSDL_URL=\"http://localhost:8080/epix/epixService?wsdl\" \\\n -e GPAS_WSDL_URL=\"http://localhost:8080/gpas/gpasService?wsdl\" \\\n -e DATA_SOURCE=\"mosaic\" \\\n --name pprl-resolver \\\n -d \\\n mds4ul/pprl-resolver:0.6.0\n```\n\n## Exploring the API\n\nThe service is built using [FastAPI](https://fastapi.tiangolo.com/).\nThis means that it comes equipped with a self-documenting and interactive documentation.\nSimply navigate to the `/docs` path on the URL where you hosted the pseudonym resolver.\n\n## Setting environment variables\n\n**Name** | **Description** | **Default**\n:--|:--|:--\n`BROKER_BASE_URL` | URL at which a PPRL broker service is hosted | http://localhost:8080/broker\n`ENCODER_BASE_URL` | URL at which a PPRL encoder service is hosted | http://localhost:8080/encoder\n`EPIX_WSDL_URL` | WSDL endpoint of a hosted E-PIX service⁽¹⁾| http://localhost:8080/epix/epixService?wsdl\n`GPAS_WSDL_URL` | WSDL endpoint of a hosted gPAS service⁽¹⁾ | http://localhost:8080/gpas/gpasService?wsdl\n`DATA_SOURCE` | Data source implementation to use⁽²⁾ | mosaic\n\n⁽¹⁾ This is only necessary if `DATA_SOURCE` is set to mosaic. \n⁽²⁾ This is the list of all acceptable values: mosaic.\n\n## Running tests\n\nRun the linter in the root directory using `poetry run flake8`.\n\nNavigate to the [tests](./tests) directory on the command line and execute `docker compose up -d`.\nThis will start a number of services that are required to run the integration tests.\nOnce they're up and running (might take a couple minutes), run the following command in the root directory of this repository.\n\n```\nPYTEST_EPIX_WSDL_URL=\"http://localhost:8080/epix/epixService?wsdl\" \\\n PYTEST_GPAS_WSDL_URL=\"http://localhost:8080/gpas/gpasService?wsdl\" \\\n PYTEST_BROKER_BASE_URL=\"http://localhost:8080/broker\" \\\n PYTEST_ENCODER_BASE_URL=\"http://localhost:8080/encoder\" \\\n poetry run pytest\n```\n\n## License\n\nMIT.","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",383232767,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",15026482,"full_size",383220058,"id",243459459,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:346ac7cf10fe952dd6f0857c1505b3e792b4871712f6996bd801378d36ce423a","features","last_pulled","2026-09-08T17:34:29.926287219Z","last_pushed","2022-06-28T09:26:16Z","os","linux","os_features","os_version","size","variant","2022-06-28T09:26:15.206971Z","last_updater","last_updater_username","media_type","0.6.0","repository",17464873,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

mds4ul/pprl-resolver

Tags for mds4ul/pprl-resolver