This part describes the ePA FdV Modul functionalities and structure.
Generated API docs are available at https://gematik.github.io/ref-FdVModul.
Licensed under the Apache License, Version 2.0.
The FdV module bundles libraries that provide the functions (service localization, authentication, authorization, session handling, key access) necessary for the use of the electronic patient record.
The authentication module provides the functionalities for authenticating the user to use the electronic patient record. All available IAuthenticator and the selected one will be returned by the AuthnService. The Authn class enforces required operations (login create challenge / login create token / renew token / logout token) according to ws-Trust to authenticate the user. The AuthenticationBindingSoap class forms the entry point for establishing the connection to the authentication web service.
The authorization module is not yet implemented
The key access module is not yet implemented
The FdV SessionHandler module provides a ServiceLocalizerLoader for available service localization services.
Interface to be implemented by service localizer as entry point to localize ePA service components. Start lookup DNS for retrieving endpoint URLs of various ePA gateway services. Once lookup has been done successfully, endpoint URLs for interfaces in ServiceInterfaceName can be retrieved.
The specific service localization needs a descriptor behind YOUR.service.localization\src\main\resources\META-INF\services with filename
de.gematik.ti.fdv.epa.service.localization.spi.IServiceLocalizer and the content of the package and class which implements the service localizer interface e.g. de.gematik.ti.fdv.epa.service.localization.ServiceLocator
Description of the service interfaces and assignments of paths to the ePA file system components
Status of service lookup in DNS - As long as the Service lookup is running, thus it might still in progress after ServiceLocatorType object has been initialized, or lookup was not successful for some reason, e.g. DNS was not accessible
The entry point for the ServiceLoader is the Authentication Service Provider Interface. This Interface returns the specific authentication provider implementation and a provider description.
The specific authentication.provider needs a descriptor behind YOUR.PROVIDER\src\main\resources\META-INF\services with filename
de.gematik.ti.fdv.authentication.service.provider.api.IAuthenticator and the content of the package and class which implements the service provider interface e.g. de.gematik.ti.epa.fdv.healthcard.authentication.Authenticator
To use ePA FdV Modul library in a project, you need just to include following dependency:
Gradle dependency settings to use ePA FdV Modul library.
dependencies {
implementation group: 'de.gematik.ti.epa', name: 'fdv.authentication', version: '1.0.2'
}
Maven dependency settings to use ePA FdV Modul library.
<dependencies>
<dependency>
<groupId>de.gematik.ti.epa</groupId>
<artifactId>fdv.authentication</artifactId>
<version>1.0.2</version>
</dependency>
</dependencies>