Scalable Consent Management, published by HL7 International / Community Based Collaborative Care. This guide is not an authorized publication; it is the continuous build for version 1.0.0-preview built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-consent-management/ and changes regularly. See the Directory of published versions
| Page standards status: Informative |
The need for this guide emerged from an initial FAST discovery project to evaluate and identify gaps in the existing consent-related specifications and guidelines, as outlined in the Consent at Scale Report. This report defines the impetus and scope of the current implementation guide.
This guide is built on several underlying specifications. Implementers should be familiar with the key aspects of each before reading this guide.
This implementation guide is based on the HL7 FHIR R4 standard. Implementers need to understand the basics of FHIR, including terminology, notations, and design principles. Readers who are unfamiliar with FHIR are encouraged to read (or at least skim) the following prior to reading the rest of this implementation guide.
This implementation guide builds on the US Core Implementation Guide. Implementers need to be familiar with the US Core profiles for Patient, Practitioner, Organization, RelatedPerson, PractitionerRole, and QuestionnaireResponse, as these are referenced directly by the FAST Consent profile.
This implementation guide uses subscriptions to notify systems of consent changes. Subscriptions are based on the Subscriptions R5 Backport framework. Implementers should understand how to register a subscription, how topic-based subscriptions work, and how to receive and process subscription notifications.
This guide aligns with the IHE Privacy Consent on FHIR (PCF) guide. The FAST Consent profiles are designed to be a US-Core-flavoured subset of IHE-PCF — a Consent instance that is valid against the FAST Consent profile will generally also satisfy IHE-PCF constraints. Implementers should consult IHE-PCF for additional context on consent actors, transactions, and enforcement patterns. IHE-PCF also includes Appendix P, which provides foundational background on the concepts underlying privacy consent management.
IHE-PCF defines four actors: Consent Recorder, Consent Registry, Consent Authorization Server, and Consent Enforcement Point. This guide defines two system roles — Consent Client System and Consent Server System — that correspond to a subset of these actors:
IHE-PCF defines transactions using IHE's ITI transaction model. This guide uses custom FHIR operations and RESTful FHIR interactions rather than IHE-style transactions. The functional correspondence is:
$fileConsent operation (this guide) corresponds to IHE-PCF's [ITI-108] Access Consent (create).$revokeConsent operation (this guide) corresponds to IHE-PCF's [ITI-109] Revoke Consent.Implementers conforming to this guide do not need to implement IHE-PCF transactions, but systems that already implement IHE-PCF transactions may find that their implementations are largely compatible with the operations defined here.
IHE-PCF relies on IHE's own authorization model (IUA — Internet User Authorization). This guide recommends SMART App Launch as the OAuth-based authorization mechanism for securing the operations and interactions defined here. Systems that have already implemented IHE IUA for IHE-PCF compliance may adapt their existing authorization infrastructure to satisfy the SMART-based access control expectations of this guide; the underlying OAuth 2.0 token model is compatible. See the Privacy, Safety, and Security section for additional guidance.
This guide relies on IHE Basic Audit Log Patterns (BALP) for representing audit events related to consent access and health information disclosure. Implementers should be familiar with the BALP Consent Authorized Decision Audit Message and the Privacy Disclosure Audit Message profiles.
Prior to the widespread adoption of FHIR, patient consent decisions were commonly represented using HL7 Clinical Document Architecture (CDA) documents, including the HL7 CDA R2 Implementation Guide: Privacy Consent Directives. These CDA-based consent directives capture the same fundamental patient decisions — authorizing or restricting the use and disclosure of health information — that this guide represents as FHIR Consent resources.
This guide does not define a migration path or transformation profile for converting CDA Privacy Consent Directives to FHIR Consent resources. Organizations operating in environments where consent is currently captured in CDA format will need to develop their own transformation processes to produce FHIR Consent instances conformant with the FAST Consent profile defined here. The IHE-PCF guide includes guidance on representing consent in FHIR that may be useful as a reference for such transformations.
Note that the IHE-PCF guide itself references and aligns with both the CDA Privacy Consent Directive tradition and the FHIR Consent resource model. Because the FAST Consent profile is a US-Core-flavoured subset of IHE-PCF, implementers familiar with IHE-PCF's handling of CDA-to-FHIR consent representations will find that guidance applicable here as well.
Implementers should also familiarize themselves with the FHIR resources used within the guide:
| Resource | Relevance |
|---|---|
| CapabilityStatement | Used to define conformance expectations for this guide |
| Consent | The main resource that contains the information |
| CodeSystem | Used to define custom codes specific to this guide |
| OperationDefinition | Used to define the operations used in this IG |
| Organization | Used when identifying providers in Consents |
| Parameters | Used to provide the information for the operations |
| Patient | Demographic information relevant to all requests |
| Practitioner | Used when identifying providers in Consents |
| PractitionerRole | Used when identifying providers in Consents |
| StructureDefinition | Used when profiling resources and defining extensions |
| Subscription | Used when subscribing for authorization decisions for an organization |
| ValueSet | Used to define collections of codes used in FAST Consent profiles |