Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 3.14 KB

README.md

File metadata and controls

56 lines (35 loc) · 3.14 KB
Raw

hl7-fhir-udap-client

Getting Started

For a general overview of UDAP as well as a getting starting guide of the full four-repository collection see UDAP Documentation

Overview

This nodejs library is part of a four-repository collection for a full UDAP implementation. The implementation adheres to published Version 1.0 of the HL7 UDAP Security Implementation Guide. This library implements a udapClient class. The constructor takes in the following attributes:

  • communityKeystoreFilename: The PCKS#12 file (.p12). Contains public and private keys for trust community.
  • communityKeystorePassword: The password to the PCKS#12 file.
  • trustAnchorFilename: Trust community trust anchor in PEM format.
  • clientId: Client id for the associated UDAP server this instance is connecting to. Optional if client has not registered with server yet pass in "".
  • serverBaseUrl: Base FHIR url for the server this client instance is connecting to.

The following are defined in Defined in B2B Authorizaion Extension Object:

  • organizationId: Unique identifier for the ogranization represented by this udap client instance
  • organizationName: String representation of the organization represented by this udap client instance
  • purposeOfUse: The purpose for which the data requested will be used

The client class has methods to handle UDAP Trusted Dynamic Client Registration, UDAP Authorization Code Flow, and UDAP Client Credentials Flow, as well as caching and validating UDAP metadata.

Links to the other repositories in the collection:

Usage

To see example code, you can browse the hl7-fhir-udap-client-ui and hl7-fhir-udap-server repositories.

Installation

The repositories are currently set up for local installation. Placing all four repositories under the same parent folder will allow the package.json local file references to be resolved accurately. This repository will eventually be an npm package.

Known Issues

  • Currently assumes server side support for Tiered OAuth. Check will be added in the future.

Getting Help

If you have questions, concerns, bug reports, etc., file an issue in this repository's Issue Tracker.

Getting Involved

See the CONTRIBUTING file for info on how to get involved.

License

The hl7-fhir-udap-client is Open Source Software released under the Apache 2.0 license.

Original Contributors

We would like to recognize the following people for their initial contributions to the project:

  • Tom Loomis, Evernorth
  • Dan Cinnamon, OKTA