Token Generation

Generate A Token

To launch MedDream, a token must be generated and signed with an AdvaPACS API Key so AdvaPACS can verify it.

As a prerequisite, an AdvaPACS API key must be generated with the Generate MedDream Token permission. This will be used for signing the JWT.

The token shall be created according to the V3 Token Specification that can be found in the MedDream Integration Manual.

note

Only the items property is mandatory. The storage property shall be omitted.

note

The storageConfiguration part of the token will be ignored.

note

Permissions may be passed. Any of PATIENT_HISTORY, EXPORT_ISO, EXPORT_ARCH and ANONYMOUS_VIEW are supported.

This token shall then be used as the body of a JWT.

In the header of the JWT a claim aki shall be added. This shall be set to the value of the AdvaPACS API Key Access Key ID.

The token expiry shall be set to 300 seconds or less.

The token shall be signed using one of HS256, HS384 or HS512 using the SHA-256 hash of the AdvaPACS API Key Access Key Secret.

Sample Token

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImFraSI6IjczZGU2MGIyODhhMDQwOWNiNWYxN2M5YWM2OGVlODJkIn0.eyJleHAiOjE2NTI5MjEzNDEsIml0ZW1zIjpbeyJzdHVkaWVzIjp7ImFjY251bSI6IjYxNDQ4NS1VUyJ9fV0sInBlcm1pc3Npb25zIjpbIlBBVElFTlRfSElTVE9SWSJdfQ.FuUkXdnm5mGSbVxLOx_5R5s6tSHYoBle_FKK0lmU5nQ

Launch MedDream

To display the studies in MedDream, the generated token shall be passed to MedDream with the following format.

<region> shall be set to the region code associated with your AdvaPACS tenant. For example aus for Australia.

<token> shall be set to the token generated previously.

https://<region>.meddream.advapacs.com/?token=<token>

The optional parameter add=true should be used if opening the studies from different URLs in one MedDream viewer window is required. The optional parameter replace=true should be used if the studies, that are opened in MedDream viewer window, should be replaced with the studies from new URL in the same MedDream viewer window. Otherwise, a different URL will result in a new independent viewer window with a different set of studies.

Sample Launch URLs

https://aus.meddream.advapacs.com/?token=eyJhbGciOiJIU..._FKK0lmU5nQ

https://aus.meddream.advapacs.com/?token=eyJhbGciOiJIU..._FKK0lmU5nQ&add=true

https://aus.meddream.advapacs.com/?token=eyJhbGciOiJIU..._FKK0lmU5nQ&replace=true