- About The Project
- Development
- Secure Credentials Storage
- Contributing
- License EUPL
- FAQ
- Support and Feedback
The Authenticators main task is to securely authenticate users for login to digital health applications. It authenticates authorized doctors or medical staff and grants them access to the respective application. This provides a secure authentication option for a variety of IT applications.
Visit our Fachportal-Page for more information.
See ReleaseNotes.md for all information regarding the (newest) releases.
You can find detailed documentation on the requirements, the installation and the preparation in our knowledge database: Documentation
Clone this repository and run npm install to install all necessary dependencies.
Then run npm run dev to start the Authenticator locally.
This repository contain the resources to set up the development environment for the authenticator app.
Clone the following repository at the same level of the authenticator repository:
git clone https://github.com/gematik/Vue-Oidcauth-Sample
Run npm run electron:build for the production build or npm run mock:build for the mock-version-build.
Within the mock-version of the Authenticator a mock mode is integrated, which can simulate the use of a connector. This allows functional tests to be carried out without a physically present connector. This feature is intended to simplify the development with the Authenticator, as it provides not only a special mock mode but also more logging options.
Visit our knowledge database for more information: Mock-Version
Run npm run test or npm run test:watch to start the unittests.
We use our own Webpack/Vue3 stack, to keep the App flexible and secure we do not use any framework like vue-cli or vue electron plugin. They have too many vulnerabilities and this is not acceptable in our case. Using the own webpack stack also brings us the real flexibility. We can change the configuration and the whole stack smoothly. This stack based on those technologies:
- Language: Typescript
- UI Framework: VueJS
- CSS Framework: TailwindCSS
- Bundler: Webpack
- JS Compiler: Babel
- Unit Testing: Jest
- Electron Compiler: Electron Builder
- Linter: ESLint
- Formatter: Prettier
For detailed documentation of usage of the Windows Credential Manager in the context of the Authenticator, see here
Copyright 2023 gematik GmbH
The Authenticator App is licensed under the European Union Public Licence (EUPL); every use of the Authenticator App Sourcecode must be in compliance with the EUPL.
You will find more details about the EUPL here: https://joinup.ec.europa.eu/collection/eupl
Unless required by applicable law or agreed to in writing, software distributed under the EUPL is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the EUPL for the specific language governing permissions and limitations under the License.ee the Licence for the specific language governing permissions and limitations under the Licence.