You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/healthcare-apis/dicom/dicom-proxy-url-support.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,28 +13,28 @@ ms.author: buchvarun
13
13
Using URL manipulation allows you to customize the URL of the image location that is in the response object.
14
14
15
15
For the following API operations the DICOM service returns the fully qualified URL of the image location in the response object under a DICOM tag (UR) in the response object.
16
-
1. Retrieve Instance
17
-
2. Retrieve WorkItems
18
-
3. Retrieve OperationStatus
19
-
4. Resolve QueryTag
20
-
5. Resolve QueryTagError
16
+
- Retrieve Instance
17
+
- Retrieve WorkItems
18
+
- Retrieve OperationStatus
19
+
- Resolve QueryTag
20
+
- Resolve QueryTagError
21
21
22
22
Here's an example of a fully qualified image location URL. The URL could be found in the standard response for a STOW operation for a DICOM service that has data partition enabled, with partition name "foo".
1. hostname -> `https://localhost:63838` (the hostname of DICOM service)
28
-
2. path -> `v2/partitions/foo` (the path that represents the version of DICOM service being used and the datapartition name, if enabled)
29
-
3. The DICOM web standard path -> `studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114`
27
+
- hostname -> `https://localhost:63838` (the hostname of DICOM service)
28
+
- path -> `v2/partitions/foo` (the path that represents the version of DICOM service being used and the datapartition name, if enabled)
29
+
- The DICOM web standard path -> `studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114`
30
30
31
31
This feature allows you to customize the path of the image URL, if directed by the client, based on the request headers provided.
32
32
33
33
## How it works
34
34
The modified URL is based on following two headers.
35
-
1. X-Forwarded-Host: The domain name of the original host (the one the client requested before the proxy or load balancer handled the request). For example: `X-Forwarded-Host: www.example.com`
35
+
- X-Forwarded-Host: The domain name of the original host (the one the client requested before the proxy or load balancer handled the request). For example: `X-Forwarded-Host: www.example.com`
36
36
37
-
2. X-Forwarded-Prefix: the original URL path or prefix that was part of the client’s request before the proxy forwarded or changed the request. For example: `X-Forwarded-Prefix: /prefix`
37
+
- X-Forwarded-Prefix: the original URL path or prefix that was part of the client’s request before the proxy forwarded or changed the request. For example: `X-Forwarded-Prefix: /prefix`
38
38
39
39
These headers are a part of .NET core standard forwarded headers.
40
40
@@ -44,11 +44,11 @@ If `x-forwarded-prefix` header is present in the request object, it replaces the
44
44
45
45
## List of services that can use forwarded headers for URL manipulation
46
46
47
-
1. Store(STOW-RS): Upload DICOM objects to the server.
48
-
2. Retrieve(WADO-RS): Download DICOM objects from the server.
49
-
3. Worklist Service (UPS Push and Pull SOPs): Manage and track medical imaging workflows.
Here are the details of a request header for a STOW operation with the forwarded headers:
54
54
* Path: ../studies/{study}
@@ -87,7 +87,7 @@ URL of image:
87
87
88
88
89
89
## Things to remember
90
-
1. Forwarded headers don't have to be used together. If there's a need to, replace hostname and not path. Only the forwarded host header can be used. Similarly, if there's a need to replace the path, only the forwarded prefix header can be used.
91
-
2. The client is responsible for mapping the hostname and path provided in forwarded headers to the correct DICOM service hostname and pathbase.
90
+
- Forwarded headers don't have to be used together. If there's a need to, replace hostname and not path. Only the forwarded host header can be used. Similarly, if there's a need to replace the path, only the forwarded prefix header can be used.
91
+
- The client is responsible for mapping the hostname and path provided in forwarded headers to the correct DICOM service hostname and pathbase.
0 commit comments