corona-warn-app / cwa-documentation

Project overview, general documentation, and white papers. The CWA development ends on May 31, 2023. You still can warn other users until April 30, 2023. More information:
https://coronawarn.app/en/faq/#ramp_down
Apache License 2.0
3.28k stars 344 forks source link

App not clear which format vaccination certificate acceptable #643

Closed MikeMcC399 closed 3 years ago

MikeMcC399 commented 3 years ago

Avoid duplicates

Technical details

Describe the bug

The introduction to scanning certificates does not clearly describe that only EU compatible vaccination certificates can be successfully scanned. Instead users are scanning QR codes that they received after being vaccinated, before the new format was introduced, and they receive the app error 'This QR code is not a valid vaccination certificate. (VC_PREFIX_INVALID)'.

Steps to reproduce the issue

  1. On Start Screen, tap "Certificates"
  2. Read text on screen "Add Certificates"
  3. Tap "CONTINUE"
  4. Read tile "Add Digital Proof of Vaccination"

Add Certificates

Certificates

Expected behavior

The app should be clear about what type of digital proof of vaccination it can accept.

Possible Fix

Add text to the screens leading up to the QR-Code Scan so that the user is able to recognize if the QR-Code they plan to scan is likely to be accepted by the app. If the app is only able to scan in an "EU Digital Covid Vaccination Certificate", then this term should explicitly appear in the text.

Additional context

The document https://ec.europa.eu/health/sites/default/files/ehealth/docs/covid-certificate_paper_guidelines_en.pdf shows an EU example of a typical EU Digital Covid Vaccination Certificate in paper and digital form.


Internal Tracking ID: EXPOSUREAPP-8029

dsarkar commented 3 years ago

@MikeMcC399 Thanks! Internally tracked.


Internal Tracking ID: EXPOSUREAPP-8029 Corona-Warn-App Open Source Team

MikeMcC399 commented 3 years ago

The certificate specification https://ec.europa.eu/health/sites/default/files/ehealth/docs/digital-green-certificates_v1_en.pdf describes in "4.2.2 QR 2D Barcode" that "..the base45 encoded data (as per this specification) SHALL be prefixed by the Context Identifier string "HC1:"."

To check if you are scanning a compatible code, use a regular QR reader to see if the QR code starts with "HC1:".

There is an example on https://github.com/Digitaler-Impfnachweis/certification-apis/blob/master/examples/README.md.

MikeMcC399 commented 3 years ago

In CWA Android 2.5.0-RC3 (not yet released) I see the improved text.

Certificates > three-dot symbol > Information

"Add your EU digital COVID certificates in the app. This will enable you to prove your vaccination protection, a negative test result, or your recovery from an infection with the app."

"You can add EU digital COVID vaccination certificates, COVID test certificates, and COVID certificates of recovery in the app."

When 2.5.x is released, the texts above will solve the issue reported here. 👍🏻

MikeMcC399 commented 3 years ago

This issue is resolved with the release of CWA 2.5.1, since the texts now clearly refer to EU digital COVID certificates.

Closing as resolved.

dsarkar commented 3 years ago

Thanks @MikeMcC399.