FHIR Chat · HL7 May Connectathon! · smart/health-cards

Stream: smart/health-cards

Topic: HL7 May Connectathon!


view this post on Zulip Neelima Karipineni (Apr 19 2021 at 17:01):

Friendly reminder for those who are interested in participating in the SHC track at the May 17-19 HL7 FHIR Connectathon, early bird deadline is April 23rd and regular deadline is the 30th. Registration link http://www.hl7.org/events/fhir/connectathon/2021/05/, track page at https://confluence.hl7.org/display/FHIR/2021-05+SMART+Health+Cards+for+Vaccination+and+Testing.

view this post on Zulip Isaac Vetter (May 05 2021 at 21:32):

The track kick off mtng is in whova! https://whova.com/portal/webapp/hlsfh_202105/Agenda/1646128

view this post on Zulip Isaac Vetter (May 14 2021 at 18:18):

Are you planning on bringing a SMART Health card consumers/verifier that would be interested in testing a QR code or .smart-health-card? Alternatively, are you an issuer? Let's use this thread to connect!

view this post on Zulip Oliver Pang (May 14 2021 at 18:27):

Thanks Isaac!
Kevin Durand and I are here with an issuer implementation from Epic. We'll be available and would love to test against other holders & verifiers while we're here.

view this post on Zulip Paul Denning (May 14 2021 at 19:36):

For reference, the CARIN SHC connectathon is documented at https://confluence.hl7.org/display/CAR/Track+Page+for+the+SMART+Health+Card and https://confluence.hl7.org/display/CAR/Track+Registration+SMART+Health+Card

view this post on Zulip Richard Braman (FLY.HEALTH) (May 17 2021 at 13:25):

Hi All, I missed Friday nights intro and I am listening to the recording as I type this. Where are we hanging out today?

view this post on Zulip Neelima Karipineni (May 17 2021 at 13:55):

Hi Richard, welcome! We're hanging out on this stream today and the Zoom meeting is available for breakouts if anyone needs it.

view this post on Zulip Richard Braman (FLY.HEALTH) (May 17 2021 at 14:11):

I have a question on the qrcode. In the sample, it seems to use numeric encoding like shc://23123798273. My api currently produces a qr code of the crednetial itself. Is the numeric encoding required?

view this post on Zulip Christian Paquin (May 17 2021 at 14:14):

Richard Braman (FLY.HEALTH) said:

I have a question on the qrcode. In the sample, it seems to use numeric encoding like shc://23123798273. My api currently produces a qr code of the crednetial itself. Is the numeric encoding required?

This section of the spec details the creation of the QR code, in which the JSON Web Signature (JWS) value is indeed numerically-encoded before creating the QR image.

view this post on Zulip Richard Braman (FLY.HEALTH) (May 17 2021 at 15:13):

Thanks Christian, Do you have a reference library in node js that produces the correct output? The library I am using complains that the jws cannot be encoded with numeric... it insists on byte.

view this post on Zulip Reece Adamson (May 17 2021 at 15:22):

qrcode supports manual mode that allows specifying a different encoding for each segment

view this post on Zulip Reece Adamson (May 17 2021 at 15:24):

The "QR Code Generation" of this Jupyter notebook illustrates a basic example using that library (adapted from the source code for generating the examples in the spec, which is another good resource to look at)

view this post on Zulip Richard Braman (FLY.HEALTH) (May 17 2021 at 15:29):

Reece, that's the library I am using. I guess I need to convert the JWS to numeric before I put it in there as the library will only accept numeric characters in the segment when you specify "numeric" mode. My question is has anyone implemented the conversion of JWS to numeric encoding via the spec. To be clear:

 var segs = [
                    { data: 'shc:/', mode: 'Byte' },
                    { data: JSON.parse(verifiableCredential).verifiableCredential[0], mode: 'numeric' }
                ]
''
throws an error

view this post on Zulip Richard Braman (FLY.HEALTH) (May 17 2021 at 15:36):

I think it see it in the Jupyter notebook
toNumericQr
and splitJwsIntoChunks

view this post on Zulip Reece Adamson (May 17 2021 at 15:49):

Yes you'll need to do the numeric encoding conversion, which you can find in the Jupyter notebook or the spec source code.

Here's a link to the JWS chunking in the example generation code

view this post on Zulip Richard Braman (FLY.HEALTH) (May 17 2021 at 16:55):

got it done. Thanks Reece and Christian!

view this post on Zulip Michael O'Hanlon (May 18 2021 at 10:48):

The MITRE team will be looking to test our reference implementation this week. We've hosted https://connectathon.vci.org (GitHub source: https://github.com/dvci/health_cards) that:

  • can act as an issuer app that can generate QR codes and allows file downloads
  • allows QR codes and file downloads to be scanned or uploaded and verified

We're looking to test verifiers with health cards we generate, and test issuers with our verifier tools (file upload and QR code scan).

We also have some tests in development on inferno-dev.healthit.gov (GitHub source: https://github.com/inferno-community/inferno-core) for issuers that we'd love to try.

view this post on Zulip Neelima Karipineni (May 18 2021 at 13:23):

Also please check out the ConMan page, where the Cerner team has added details on their health-cards-issue endpoints (secure and unsecured) for testing. Go to http://conman.clinfhir.com/connectathon.html?event=con27 -> Track details and testing -> SMART Health Cards for Vaccination and Testing -> Servers tab.

view this post on Zulip Christian Paquin (May 18 2021 at 13:23):

Re-posting validation tools' links for those implementing support for SMART Health Cards (SHC). The validation SDK is a tool to validate SHC artifacts. Can be run locally, or in docker. The new developer portals expose this capability on a friendly web interface:

  • The developer portal allows you to generate SHC from scratch, or by copy-pasting your data.
  • The verifier portal allows you, you've guessed it, to validate them, getting feedback on their adherence to the spec.

view this post on Zulip Zameer Sura (May 18 2021 at 13:25):

Cerner implementations for the Issuer FHIR API are:

Implementation notes and details on how you can integrate with our implementation can be found here.
We are looking to connect with holder applications that can test against our APIs.

view this post on Zulip Isaac Vetter (May 18 2021 at 13:35):

Hey @Michael O'Hanlon , I uploaded a few .smart-health-card files into connectathon.vci.org, that appeared to work successfully. Do the inferno-dev tests only test the FHIR API or do they also support QR codes and files?

view this post on Zulip Reece Adamson (May 18 2021 at 13:39):

@Isaac Vetter The inferno tests (https://inferno-dev.healthit.gov/) were just updated to support $health-cards-issue in addition to the file download

view this post on Zulip Neelima Karipineni (May 18 2021 at 13:51):

Another resource - Jupyter notebook demonstrating the creation of a SMART Health Card.
SMART Health Cards Walkthrough - https://github.com/dvci/health-cards-walkthrough/blob/main/SMART%20Health%20Cards.ipynb

view this post on Zulip Max Masnick (May 18 2021 at 14:10):

Here's a page that lists all the specs, tools, and endpoints I could find for the Connectathon:

https://confluence.hl7.org/display/FHIR/SMART+Health+Cards+links+and+tools

Anyone should feel free to add to this if something's missing.

view this post on Zulip Reece Adamson (May 18 2021 at 14:17):

The Inferno SMART Health Cards $health-cards-issue tests (https://inferno-dev.healthit.gov/) are now updated to allow an optional bearer token to be provided


Last updated: Apr 12 2022 at 19:14 UTC