https://github.com/de4a-eu/ial-service
DE4A WP5 IDK/IAL Service
https://github.com/de4a-eu/ial-service
de4a dsd ial idk oots
Last synced: about 1 year ago
JSON representation
DE4A WP5 IDK/IAL Service
- Host: GitHub
- URL: https://github.com/de4a-eu/ial-service
- Owner: de4a-eu
- License: apache-2.0
- Created: 2022-02-23T09:05:53.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-04-04T13:26:14.000Z (about 3 years ago)
- Last Synced: 2025-02-09T19:40:39.579Z (over 1 year ago)
- Topics: de4a, dsd, ial, idk, oots
- Language: Java
- Homepage:
- Size: 743 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ial-service
DE4A IAL Service
The application in this repository represents the central DE4A IAL.
It uses the DE4A Directory as the backing data storage.
This project is licensed under the Apache 2.0 license.
## Submodules
This project consists of the following submodules:
* `ial-api` - the API level with the technical interfaces. To be used by the Connector
* `ial-webapp` - the web application of the IAL that takes requests, queries the Directory and enriches the data. To be called by the Connector or by Data Evaluators directly.
## Maven Coordinates
The Maven BOM can be used like this (replacing `x.y.z` with the real version number):
```xml
...
eu.de4a.ial
ial-parent-pom
x.y.z
pom
import
...
```
## WebApp REST APIs
### `/api/provision/{canonicalObjectTypeIDs}`
Get a list of all participants, that matches any of the Canonical Object Types (Canonical Evidences and Canonical Events)
in the provided list. Multiple Canonical Object Types can be provided, separated by comma.
Example calls:
* `/api/provision/urn:de4a-eu:CanonicalEvidenceType::CompanyRegistration:1.0`
* Search for all EPs that support the "Company Registration" evidence type, independent of the country
* `/api/provision/urn:de4a-eu:CanonicalEvidenceType::MarriageRegistration:1.0,urn:de4a-eu:CanonicalEvidenceType::BirthCertificate:1.0`
* Search for all EPs that support the "Marriage Registration" or the "Birth Certificate" evidence type, independent of the country
### `/api/provision/{canonicalObjectTypeIDs}/{atuCode}`
Get a list of all participants, that matches any of the Canonical Object Types (Canonical Evidences and Canonical Events)
in the provided list, filtering it by a target ATU code. Multiple Canonical Object Types can be provided, separated by comma.
Example calls:
* `/api/provision/urn:de4a-eu:CanonicalEvidenceType::CompanyRegistration:1.0/AT`
* Search for all EPs that support the "Company Registration" evidence type, limit to the matches in Austria
* `/api/provision/urn:de4a-eu:CanonicalEvidenceType::CompanyRegistration:1.0/AT130`
* Search for all EPs that support the "Company Registration" evidence type, limit to the matches in Vienna, Austria (NUTS 3)
* `/api/provision/urn:de4a-eu:CanonicalEvidenceType::MarriageRegistration:1.0,urn:de4a-eu:CanonicalEvidenceType::BirthCertificate:1.0/SE`
* Search for all EPs that support the "Marriage Registration" or the "Birth Certificate" evidence type, limit to the matches in Sweden
## `/mor/xx.json`
Get the MOR data for the provided country code `xx`.
Available country codes (case sensitive):
* `en` - English
* `es` - Spanish
* `fr` - French
* `pt` - Portuguese
* `ro` - Romanian
* `sl` - Slovenian
## WebApp Configuration parameters
* **`global.debug`** (boolean) - enable or disable global debug checks in the application. Should only be enabled during development.
* **`global.production`** (boolean) - enable or disable global functionality only meant to be used in production. Should only be enabled on production systems.
* **`ial.directory.url`** (string) - the full URL of the Directory to be queried. E.g. `https://de4a.simplegob.com/directory/`
* **`ial.directory.tls.trustall`** (boolean) (v0.1.4) - pass true to trust all SSL/TLS certificates for the Directory (unsecure setting)
* **`ial.rest.payload-on-error`** (boolean) - true to log payload in case of an error
* **`ial.rest.log-exceptions`** (boolean) - true to print exception stack traces in case of error
* **`ial.webapp.status.enabled`** (boolean) - true to enable the `/status` servlet to show data
* **`ial.webapp.data.path`** (string) - the file system path where runtime data should be stored
## News and Noteworthy
* v0.1.12 - 2023-04-04
* Updated the license information to the final version
* v0.1.11 - 2023-02-25
* Fixed the result match making of `/api/provision` calls - corrected and more efficient
* v0.1.10 - 2022-12-15
* Fixed an issue with search results if CanonicalEvidenceType and ATU code were provided together
* Improved internal error resilience
* Added new internal API `/internal/clear-smpclient-cache` to clear the IAL SMP client lookup cache
* v0.1.9 - 2022-10-19
* Made the SMP truststore configurable via the properties `ial.smp.truststore.path` and `ial.smp.truststore.password`
* v0.1.8 - 2022-10-18
* The IAL filters out all participant identifiers that does not support the process ID "urn:de4a-eu:MessageType::Request" with the idea that only DOs are left
* v0.1.7 - 2022-10-05
* Updated to Apache Http Client v5.x
* Added response header `Access-Control-Allow-Origin: *` to all queries
* Fixed character encoding problem when querying IAL
* v0.1.6 - 2022-08-09
* Removed name prefix `idk` from `IALMarshaller` method
* Added the public folder `/mor` to provide the MOR JSON files
* v0.1.5 - 2022-05-05
* Fixed an internal error if no search result was found
* Added the missing `country` parameter when searching the Directory
* v0.1.4 - 2022-05-05
* Added a new configuration item `ial.directory.tls.trustall`
* v0.1.3 - 2022-04-26
* First version of the IAL service
* v0.1.2 - 2022-04-13
* Updated to the latest IAL.xsd matching the Technical Design v1.1
* v0.1.1 - 2022-03-21
* Updated IAL.xsd to the latest version
* v0.1.0 - 2022-03-11
* Initial release