Skip to content

eu-digital-green-certificates/dgca-app-core-android

EU Digital COVID Certificate App Core - Android

AboutDevelopmentDocumentationSupportContributeContributorsLicensing

About

This repository contains the source code of the EU Digital COVID Certificate App Core for Android.

The app core provides shared functionality for the verifier and wallet apps.

Base module that provides functionality for handling DCC certificate type. It decodes the base45-encoded QR code, extracts the COSE signature, and decodes CBOR back to JSON. It then verifies the signature with the keys provided by the verifier/wallet app’s backend. The module uses only open-source libraries.

Documentation

Module features:

  • Prefix validation: Drops a country-specific prefix from contents, e.g. "HC1:"
  • Base45 Decoding: decodes provided input according to specification: Base45
  • Decompression with ZLIB
  • Decodes input according to COSE specification RFC8152
  • Decodes input as a CBOR structure
  • Schema validation - verifies CBOR with predefined schema (JsonSchema.kt#JSON_SCHEMA_V1)
  • Verifies COSE signature

For more details check unit tests to see how it works step by step.

Support and feedback

The following channels are available for discussions, feedback, and support requests:

Type Channel
Issues
Other requests

How to contribute

Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.

Contributors

Our commitment to open source means that we are enabling -in fact encouraging- all interested parties to contribute and become part of its developer community.

Licensing

Copyright (C) 2021 T-Systems International GmbH and all other contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.