docs

Appearance

Configuring Pacsbin integration ​

DICOMweb ​

If your image archive fully supports DICOMweb, integrating with Pacsbin is very straightforward. The following data is needed:

  • A list of email addresses for approved user accounts to use the integration. These should be associated with the users' Pacsbin account.
  • A name for the DICOMweb server.
  • URL endpoints for QIDO and WADO requests, such as:

Endpoint example

QIDO: http://example.edu/pacs/dicomweb/qido
WADO: http://example.edu/pacs/dicomweb/wado

Note that these two urls may be the same, depending on your archive's configuration.

After your DICOMweb link has been established, allow your users to launch the Pacsbin uploader by launching a web browser with a link specific to your organization, such as:

https://pacsbin.com/c/upload?org=[your_org_id_here]

Most PACS systems allow configuration to launch a browser to a specific URL using a button or hotkey.

If your PACS launcher configuration allows entry of contextual information into the URL, you can pre-fill the study Accession Number in the uploader search by adding a query parameter to the URL:

https://pacsbin.com/c/upload?org=[your_org_id_here]&accession=[study_accession_number]

Common issues ​

CORS ​

The uploader application is by necessity making cross-domain requests, from the application domain (pacsbin.com) to the institution's domain (e.g. university.edu/qido). Modern browsers impose security restrictions (the same-origin policy) on these types of requests, and as such most likely the uploader application's dicomweb requests will fail unless CORS (Cross Origin Resource Sharing) has been configured. In order to comply with the same-origin policy, appropriate CORS headers must be sent by the dicomweb server with the HTTP response.

The dicomweb server must allow cross-origin requests by setting the Access-Control-Allow-Origin header, either to wildcard * to allow requests from any domain, or to allow the pacsbin.com domain specifically:

Access-Control-Allow-Origin: *

// or

Access-Control-Allow-Origin: https://pacsbin.com

If your image archive does not support this configuration, you will need to either:

  • Set up a simple reverse proxy (using something like Apache, Nginx, or Caddy) that can add these headers to all DICOMweb responses.
  • Use our proxy server configured with "proxyMode": "dicomweb"