xShare Project Yellow Button
0.3.0-ci - ci-build 150

xShare Project Yellow Button, published by xShare Project. This guide is not an authorized publication; it is the continuous build for version 0.3.0-ci built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/xshare-yb/ and changes regularly. See the Directory of published versions

## Yellow Button Technical view

The technology domain describes the technology stack and the infrastructure required to support the xShare Yellow Button.

This includes:

- technical standards, specifications, and security considerations.
- tools that can be used for realizing the Primary logical application components of the xShare reference implementation. (See xShare Yellow Button Toolbox)

### Overview

Technical standards, specifications, and security considerations are documented in this version of the guide by starting from a sequence diagram (diagram below) representing how the application view sequence is implemented.

The diagram highlights (in yellow) the roles (i.e. the participants) that Yellow Button implementers can claim conformance to:

- The xShare Yellow Button Provider. It implements the xShare Yellow Button application role.
- The xShare Yellow Button Consumer. It implements the Authorised Data Recipient application role.

More details about these roles (actors in the IHE world) are documented in the xShare Yellow Button Participants page.

Messages supported by these roles (transactions in the IHE world) are reported in the xShare Yellow Button Messages section.

By clicking on the message in the diagrams readers can directly access the details of that message, including conformance rules.

The messages for which technical validation is supposed to be performed are higlighted in blue.

### xShare Yellow Button realization

### xShare Yellow Button Participants

Yellow Button implementers can claim conformance to the yellow button by implementing one of both of these participants:

- The xShare Yellow Button Provider
- The xShare Yellow Button Consumer

The xShare Yellow Button Provider shall be able to act as:

- xShare Yellow Button Content Creator, always
- xShare Yellow Button Link Provider, if the One-time Share option is supported

The xShare Yellow Button Consumer shall be able to act as:

- xShare Yellow Button Content Consumer, always
- xShare Yellow Button Link Consumer, if the One-time Share option is supported

More details about these roles is provided in the xShare Yellow Button participants page.

### xShare Yellow Button Messages

This section describes the messages used by the sequence diagrams above.

#### Natural person authentication

For this version of the guide the natural person identification, authentication and authorization is a Yellow Button pre-requisite.

See Yellow Button Business View and Yellow Button Applicaiton View.

##### Conformance

There are not technical specifications to claim conformance with.

Yellow button adopters have however to:

- Demonstrate that only authenticated Natural Persons can access the xShare Yellow Button features.
- Claim that user autentication is realized in conformance with the European Regulations.

#### Search and Select

For this version of the guide the search and selection of personal health data is an internal activity.

##### Conformance

There are not technical specifications to claim conformance with.

Yellow button adopters have however to:

- Demonstrate that (only) authenticated Natural Persons can search for and select the documents or data they wish to download or share.

#### Retrieve and Format

For this version of the guide the Retrieve and Format Natural personal health data is an internal activity.

##### Conformance

There are not technical specifications to claim conformance with.

#### Select Options

For this version of the guide the Select Options is an internal activity.

##### Conformance

There are not technical specifications to claim conformance with.

#### Download

This version of the guide does not specify how downloaded data are stored into the Natural person's storage.

##### Conformance

- Yellow button adopters claiming support to the Yellow Button Download option shall act as xShare Yellow Button Content Creator

#### Generate SHL URI

The xShare Yellow Button Provider generates a SMART Health Link Manifets URL and Payload.

A SMART Health Link may be configured either as a short-lived sharing mechanism or, by using the L flag, as a long-term link whose manifest content may evolve over time. The L flag does not by itself define the expiry period; expiration can be indicated using exp, while actual link validity is enforced by the SHL Sharing Application / Resource Server.

##### Conformance

- Yellow button adopters implementing Generate SHL URI shall act as xShare Yellow Button Link Provider

- The SMART Health Link URI is generated in conformance with the SMART Health Links Sharing Application Generates a SMART Health Link URI specifications.

#### Process SHL URI

The xShare Yellow Button Provider process a SMART Health Link URI.

##### Conformance

- Yellow button adopters implementing Process SHL URI shall act as xShare Yellow Button Link Consumer

- The SMART Health Link URI is processed in conformance with the SMART Health Links Receiving Application processes a SMART Health Link specifications.

#### Request SHL Manifest

The xShare Yellow Button Link Consumer retrieves a SMART Health Links's manifest from the xShare Yellow Button Link Provider

##### Conformance

###### xShare Yellow Button Provider

- Yellow button adopters implementing Request SHL Manifest as Consumer shall act as xShare Yellow Button Link Consumer

- The SMART Health Links's manifest is retrieved in conformance with SMART Health Link Manifest Request

- The SMART Health Links's manifest shall conform with at least one of the content specifications listed in the Yellow Button Information view page.

###### xShare Yellow Button Consumer

- Yellow button adopters implementing Request SHL Manifest as Creator shall act as xShare Yellow Button Link Provider

- The SMART Health Links's manifest is provided in conformance with SMART Health Link Manifest Request

- The SMART Health Links's manifest shall conform with at least one of the content specifications listed in the Yellow Button Information view page.