5 really basic Orthanc startup Questions

Google Groups archive
1

I am a radiologist trying to use Orthanc plus the Osimis plugin to make teaching files for my students.
I apologise if these questions are basic. I’ve read through documentation but am unable to find my answers.

Installed Orthanc on my Mac with the webviewer plugin form the Osimis website. I can push exams to Orthanc server and view on localhost using the web interface and viewer via.

http://localhost:8042/osimis-viewer/app/index.html?study=68694bfa-99b9e069-3a48b335-8b714b6b-66141d69

. . . So not a complete idiot!

(1) how does a user log out of the web interface? The first time I went to localhost:8042 I was prompted for a login but never subsequently. I’ve even restarted Orthanc. Do I need to clear browser cache?

(2) How can I determine the study ID for the case, for example “68694bfa-99b9e069-3a48b335-8b714b6b-66141d69” Are there other tags I can use like studyUID?

(3) In the config file for the WebViewer one can change image presets. I don’t know where to find this file to change it. Do I need to download the source code, change the config file and then rebuild the plugin?

(4) Ultimately I want to embed the viewer as an iFrame on a simple web page like the demo on the Osimis web page: https://www.osimis.io/en/products/orthanc-plugins/orthanc-viewer-basic.html. They use a link within an iframe:

https://viewer-basic.osimis.io/osimis-viewer/app/index.html?study=1b4c72ad-5aba2557-9fc396b3-323e190c-07d36585

How do you set things up so that a user can go to

http://localhost:8042/osimis-viewer/app/index.html?study=68694bfa-99b9e069-3a48b335-8b714b6b-66141d69

and see a study in the viewer; but when they go to

http://localhost:8042 they DO NOT access the web interface. Turning remoteaccessallowed to false also disabled the viewer too.

(5) If I try IP:8042/osimis-viewer/app/index.html?study=68694bfa-99b9e069-3a48b335-8b714b6b-66141d69 from another computer in my network and not local host am I going to get CORS issues?

Apologies for the long post. Hopefully each question is a simple answer.

Kind regards,
Dan

2

Hello,

(1) There is no login/logout feature in Orthanc Explorer, as explained in this FAQ:
https://book.orthanc-server.com/faq/improving-interface.html

The username/password corresponds to the so-called “HTTP Basic Authentication” mechanism that is implemented by any Web browser. As explained on Wikipedia, “the web browser needs to cache credentials for a reasonable period of time to avoid constantly prompting the user for their username and password. Caching policy differs between browsers”:
https://en.wikipedia.org/wiki/Basic_access_authentication

If you plan to make your Orthanc server available on an Intranet/Extranet, you must carefully read the following FAQ:
https://book.orthanc-server.com/faq/security.html

(2) This is explained in the Orthanc Book:
https://book.orthanc-server.com/faq/orthanc-ids.html

(3) The Orthanc Web viewer does not allow to change the windowing presets without recompiling from source:
https://book.orthanc-server.com/plugins/webviewer.html

The Osimis Web viewer has a configuration file, where you can adapt the option “WindowingPresets”:
https://book.orthanc-server.com/plugins/osimis-webviewer.html

https://bitbucket.org/osimis/osimis-webviewer-plugin/src/master/doc/default-configuration.json

(4) You’ll have to implement access rules by yourself. This can be done either in Lua, or using the “advanced authorization plugin”:
https://book.orthanc-server.com/users/lua.html#filtering-incoming-rest-requests

https://book.orthanc-server.com/plugins/authorization.html

This can also be done at a higher level in some Web application (for instance in PHP), or in your reverse proxy. I will personally not provide any support about this topic, as this highly dependent on your workflow.

(5) CORS is not a built-in feature of Orthanc (as Orthanc is designed as a micro-service). CORS must be implemented through reverse proxying, or by a higher-level application (e.g. in PHP):
https://book.orthanc-server.com/faq/nginx.html#enabling-cors

HTH,
Sébastien-