Skip to content

Commit 6f1ef38

Browse files
nroduitnroduit
committed
Improve dicomweb config
1 parent be1103a commit 6f1ef38

File tree

1 file changed

+81
-19
lines changed

1 file changed

+81
-19
lines changed

‎content/tutorials/dicomweb-config.en.md‎

Lines changed: 81 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,45 +7,107 @@ keywords: [ "dicom import", "dicomweb", "dicom viewer", "free dicom viewer", "op
77

88
## <center>How to configure DICOMWeb node</center>
99

10-
This page explains how to configure a remote archive in DICOMWeb and then use this DICOMWeb node to [retrieve exams remotely](../dicom-import/#dicom-queryretrieve). However, it is also possible, without any prior configuration, to [launch Weasis from a web context](../../basics/customize/integration/#download-directly-with-dicomweb-restful-services) by passing it some parameters to retrieve images in DICOMWeb.
10+
This page explains how to configure DICOMWeb nodes in Weasis for [retrieving images remotely](../dicom-import/#dicom-queryretrieve). While manual configuration in Weasis is covered here, you can also [launch Weasis from a web context](../../basics/customize/integration/#download-directly-with-dicomweb-restful-services) with automatic DICOMWeb parameters derived from the URL.
1111

12-
From the main menu, open _File > Preferences (Alt + P)_ and select DICOM node list.
13-
![DICOMWeb nodes](/tuto/dicomweb-nodes.png?classes=shadow&width=750)
14-
<br>
15-
### Google Cloud Healthcare API
12+
### General Configuration Steps
13+
14+
1. Open _File > Preferences_ (Alt + P)
15+
2. Select "DICOM node list" from the left sidebar
16+
3. Click the "Add new" button to create a new node or select an existing one and click "Edit"
1617

17-
Google provides a [Cloud Healthcare API's implementation of DICOMweb](https://cloud.google.com/healthcare/docs/how-tos/dicomweb).
18+
![DICOMWeb nodes configuration](/tuto/dicomweb-nodes.png?classes=shadow&width=750)
19+
20+
<br>
1821

19-
1. Add a new DICOMWeb node and enter a description
20-
2. Select DICOMWeb service
21-
3. Enter the URL of a Google repository (must ends with /dicomWeb)
22-
4. Add an authentication by clicking on the *Manager* button and then click on *Add*
22+
Here are the steps for configuring a new DICOMWeb node:
23+
1. Create a new DICOMWeb node with a descriptive name
24+
2. Select one of the service type. The default one is `DICOMWeb (all RESTful services)` which covers all DICOMWeb services. If you want to use a specific service, select the corresponding one:
25+
- `QIDO-RS`: Query
26+
- `STOW-RS` : Store
27+
- `WADO-URI (non-RS)`: legacy retrieval for one DICOM object
28+
- `WADO-RS (Retrieve)`: Retrieve
29+
3. Enter the service URL of the DICOMWeb server.
30+
4. Configure authentication by clicking the "Manager" button and then "Add":
31+
- Either select a template from the list and click "Fill" to auto-fill some fields or fill them manually.
32+
- In the _Provider_ panel, all the fields are mandatory.
33+
- In the _Registration_ panel, the fields are optional. However, if you want to use the OAuth2 authentication, you need to fill in the Client ID, Client Secret, and the Scope. Audience is not mandatory but can be useful for some specific providers.
34+
- Click "OK" to save the authentication
35+
5. Optionally, add HTTP headers for the service URL. This can be used for authentication or other purposes.
36+
6. Click "OK" to save the authentication
37+
38+
Then open the [DICOM Import](../dicom-import/#from-weasis-menu-or-toolbar) dialog and select the node just created. You can now query the DICOMWeb server after logging in with your account into your browser when using OAuth2 authentication.
39+
40+
### Supported DICOMWeb Providers (non-exhaustive list)
41+
42+
#### Google Cloud Healthcare API
43+
44+
Google Cloud provides a comprehensive [DICOMWeb implementation](https://cloud.google.com/healthcare/docs/how-tos/dicomweb) through their Healthcare API.
45+
46+
Configuration steps:
47+
1. Create a new DICOMWeb node with a descriptive name
48+
2. Select `DICOMWeb (all RESTful services)`
49+
3. Enter the Google repository URL (must end with `/dicomWeb`)
50+
4. Configure authentication by clicking the *Manager* button and then *Add*:
51+
1. Select "Google Cloud Healthcare" template
52+
2. Click "Fill"
53+
3. Enter your Client ID and Client Secret
54+
4. Click "OK" to save the authentication
55+
5. Optionally, add HTTP headers for the Google API
56+
6. Click "OK" to save the authentication
2357

2458
![Google node](/tuto/dicomweb-google-node.png?classes=shadow&width=750)
59+
2560
<br>
26-
1. Select the Google Cloud Healthcare template
27-
2. Click on *Fill* and optionally edit the name
28-
3. Enter your *Client ID* and *Client Secret*, Click on OK and close the other windows. Then open the [DICOM Import](../dicom-import/#from-weasis-menu-or-toolbar) dialog and select the node.
2961

3062
![Google template](/tuto/dicomweb-google-auth.png?classes=shadow&width=750)
3163

64+
{{% notice note %}}
3265
Currently, the DICOMWeb service for getting thumbnails doesn't work in the Google API.
66+
{{% /notice %}}
3367

34-
### Orthanc WEB Server
68+
#### Orthanc WEB Server
3569

3670
[Orthanc](https://www.orthanc-server.com/) is a lightweight DICOM server with [DICOMWeb capabilities](https://www.orthanc-server.com/static.php?page=dicomweb).
3771

38-
Currently, the DICOMWeb service of Orthanc doesn't support the [thumbnail service](https://www.dicomstandard.org/news/supplements/view/thumbnail-service-over-dicomweb).
39-
40-
Create a new DICOMWeb node with the following URL (example with the demo server without authentication):
72+
The configuration in the image below is for the demo server without authentication. For a custom Orthanc server, you need to enter the URL of your Orthanc server and define the authentication method (see [above](#general-configuration-steps)).
4173

4274
{{< highlight text >}}
4375
https://demo.orthanc-server.com/dicom-web
4476
{{< /highlight >}}
4577

4678
![Orthanc node](/tuto/dicomweb-orthanc.png?classes=shadow&width=750)
79+
4780
<br>
48-
### dcm4chee-arc-light
4981

50-
### Kheops
82+
{{% notice note %}}
83+
Currently, the DICOMWeb service of Orthanc doesn't support the [thumbnail service](https://www.dicomstandard.org/news/supplements/view/thumbnail-service-over-dicomweb).
84+
{{% /notice %}}
85+
86+
#### dcm4chee-arc-light
87+
88+
[dcm4chee-arc-light](https://github.com/dcm4che/dcm4chee-arc-light) is a robust open-source Picture Archiving and Communication System (PACS) that supports DICOMWeb services.
89+
90+
To configure a dcm4chee-arc-light node:
91+
1. Add a new DICOMWeb node
92+
2. Enter a description (e.g., "DCM4CHEE Archive")
93+
3. Select DICOMWeb service
94+
4. Enter the URL of your dcm4chee-arc-light server. The default endpoint typically follows this pattern:
95+
{{< highlight text >}}
96+
http(s)://[server-address]:8080/dcm4chee-arc/aets/[AE_TITLE]/rs
97+
{{< /highlight >}}
98+
99+
If authentication is required:
100+
1. Click on the *Manager* button
101+
2. Click *Add* to create a new authentication
102+
3. Select "Default Keycloak" from the templates and fill in the other required fields
103+
104+
#### Amazon HealthLake
105+
106+
[Amazon HealthLake](https://aws.amazon.com/healthlake/) is a fully managed service that enables healthcare organizations to store, transform, query, and analyze health data at scale.
107+
108+
With AHI DICOMWeb Proxy you can use the DICOMWeb API to access your data in Amazon HealthLake. Simply create a DICOMWeb node in Weasis with the following URL:
109+
{{< highlight text >}}
110+
http://[EC2 instance IP or EC2/ALB DNS]:8080/aetitle
111+
{{< /highlight >}}
51112

113+
See also the Weasis configuration at the end of this [page](https://github.com/aws-samples/aws-healthimaging-samples/tree/main/dicomweb-proxy#usage).

0 commit comments

Comments
 (0)