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
+15-11Lines changed: 15 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,14 +12,14 @@ ms.author: buchvarun
12
12
# What is URL manipulation
13
13
Using URL manipulation allows you to customize the URL of the image location that is in the response object.
14
14
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.
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
16
1. Retrieve Instance
17
17
2. Retrieve WorkItems
18
18
3. Retrieve OperationStatus
19
19
4. Resolve QueryTag
20
20
5. Resolve QueryTagError
21
21
22
-
The following is an example of a fully qualified image location URL. This could be found in the standard response for a STOW operation for a DICOM service that has data partition enabled, with partition name "foo".
22
+
Here is 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".
@@ -30,21 +30,25 @@ The following is an example of a fully qualified image location URL. This could
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
-
# How it works
34
-
The modified URL will be based on following two headers.
33
+
## How it works
34
+
The modified URL is based on following two headers.
35
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`
36
36
37
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`
38
38
39
-
These headers are a part of [.net core standard forwarded headers](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/proxy-load-balancer?view=aspnetcore-8.0#forwarded-headers).
39
+
These headers are a part of [.net core standard forwarded headers](https://learn.microsoft.com/aspnet/core/host-and-deploy/proxy-load-balancer).
40
40
41
41
If `x-forwarded-host` header is present in the request object, it replaces the host name with the value provided.
42
42
43
43
If `x-forwarded-prefix` header is present in the request object, it replaces the path with the value provided.
44
44
45
-
#List of API's that can use forwarded headers for URL manipulation
45
+
##List of services that can use forwarded headers for URL manipulation
46
46
47
-
### STOW, WADO, worklist, operation status, querytag and querytagerror APIs
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.
1. Forwarded headers do not have to be used together. If there is a need to, simply replace hostname and not path. Only the forwarded host header can be used. Similarly, if there is a need to replace the path, only the forwarded prefix header can be used.
88
92
89
93
2. 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