Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO...

21
PUBLIC iQ-WEBX WADO ADMINISTRATION GUIDE Version 3.1.1 PUB INT EN – 001R Copyright ® 2003-2016 IMAGE Information Systems Ltd. Release date: 2016-02-12

Transcript of Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO...

Page 1: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

PUBLIC

iQ-WEBX WADO

ADMINISTRATION GUIDE

Version 3.1.1 PUB INT EN – 001R

Copyright ® 2003-2016 IMAGE Information Systems Ltd.

Release date: 2016-02-12

Page 2: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

2

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D2

2. i

2

1. i

Q

-

TABLE OF CONTENTS

1 Introduction ......................................................................................................... 3

1.1 Scope of the document ......................................................................................... 3

1.2 Purpose of the software ........................................................................................ 3

2 System requirements ........................................................................................... 4

3 Installing the software ......................................................................................... 5

3.1 Installation after download ................................................................................... 5

3.2 Launching the application ..................................................................................... 5

4 Uninstalling the software ..................................................................................... 6

5 Licensing .............................................................................................................. 7

5.1 Licensing system ................................................................................................. 7

5.2 Activating the software ......................................................................................... 7

6 License migration and renewal ............................................................................. 8

6.1 Migrating an existing license ................................................................................. 8

6.2 Changing an existing license ................................................................................. 8

7 Maintenance ......................................................................................................... 9

8 Software administration ..................................................................................... 10

8.1 General configuration ......................................................................................... 10

8.2 Link creator ...................................................................................................... 11

8.3 Integration with a HIS/RIS ................................................................................. 13

8.3.1 Interface configuration .................................................................................... 14

8.3.2 URL design .................................................................................................... 14

8.3.3 Interface usage .............................................................................................. 14

8.3.3.1 Interface root file ...................................................................................... 14

8.3.3.2 Interface mode ......................................................................................... 15

8.3.3.3 ID ........................................................................................................... 15

8.3.3.4 Viewer mode ............................................................................................ 15

8.3.3.5 Display iQ-WEBX header ............................................................................ 16

8.3.3.6 Username ................................................................................................ 16

8.3.3.7 Password ................................................................................................. 16

8.3.3.8 Limited life time token ............................................................................... 16

8.3.3.9 AES-128 .................................................................................................. 17

8.3.3.10 Unix time ................................................................................................. 17

8.3.4 BDT/GDT tool ................................................................................................ 17

8.3.4.1 Configuration ............................................................................................ 17

8.3.5 iQ-WEBX WADO HL7 ....................................................................................... 19

9 Abbreviations and acronyms .............................................................................. 20

Page 3: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

3

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D3

2. i

3

1. i

Q

-

1 Introduction

1.1 Scope of the document

This document represents the iQ-WEBX WADO Administration Guide for software version 3.1.1

provided by IMAGE Information Systems Ltd.

Disclosure level of this document is PUBLIC (PUB), which means that this document is freely

available to anyone interested, such as resellers, current end users as well as potential

customers. Primary color is orange.

NOTICE The provided data was researched with the utmost care. Nevertheless, the author does not

accept any liability for the correctness, completeness and up-to-date nature of the information

contained in this document. It is the responsibility of the user or the local administrator to

verify the details by considering suitable sources. The author expressly disclaims liability for

any provided information.

1.2 Purpose of the software

iQ-WEBX WADO represents the official Web Access to DICOM Persistent Objects implementation

for iQ-WEB. Users of medical information systems require rapid and reliable access to reports

and images. Within computerized environments, such access is increasingly based on web

technologies. Access to relevant DICOM Persistent Objects is required without the need for

duplication of such data objects.

This interface, based on the jointly developed standard by ISO TC215 (Medical Informatics)/WG2

(Messages and Communications) and DICOM/WG10 (Strategy Advisory), relates exclusively to

DICOM Persistent Objects (e. g. images, series, studies, reports) and not to workflow messages.

This document describes the interface of iQ-WEBX WADO for iQ-WEB by IMAGE Information

Systems Ltd. iQ-WEBX WADO has been developed as a module for an easy access to iQ-WEB

content directly out of a medical information system and show them in the iQ-X module. Usage

of the new interface results in registering all available patient-related images/studies in the

user’s web browser. For reasons of time saving, it is possible to skip the main iQ-WEB

authentication.

Page 4: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

4

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D4

2. i

4

1. i

Q

-

2 System requirements

Please refer to the iQ-WEB 6.4.5 “Administration Guide” document if you plan to use this version

of iQ-WEBX WADO.

Page 5: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

5

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D5

2. i

5

1. i

Q

-

3 Installing the software

3.1 Installation after download

Since iQ-WEBX WADO comes with the installation of iQ-WEBX 6.4.5 as a built in module, there

is no need of a manual installation.

3.2 Launching the application

After the Installation has been completed successfully, you can access the main configuration

page by logging into the iQ-WEBX web interface as an administrator, opening the “SETTINGS”

tab and selecting the menu item “WADO”.

Page 6: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

6

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D6

2. i

6

1. i

Q

-

4 Uninstalling the software

Not applicable.

Page 7: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

7

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D7

2. i

7

1. i

Q

-

5 Licensing

5.1 Licensing system

iQ-WEBX WADO does not come with a build-in trial license. You will have to apply for a trial

respectively full license.

Basically, there are the following licenses available for iQ-WEBX WADO:

A full license allows you to use iQ-WEBX WADO without any limitations regarding features

or time.

A trial license allows you to use iQ-WEBX WADO without any limitations to its features.

However, there are limitations in time. Usually, a trial license is valid for up to two weeks.

Longer periods as well as trial extensions can be applied by contacting our license team.

Trial and full licenses always depend on the system which means that a license issued for one

designated system cannot be used on another one.

5.2 Activating the software

For obtaining and activating a license via the web interface, please refer to the corresponding

section in the iQ-WEB 6.4.5 “Administration Guide” document.

For obtaining a software license manually, please send our license team your current IP

configuration together with your iQ-WEBX WADO version and the license type you apply for. In

return, the license team will send you a file which will be named “wado.lic”. Please copy this file

into the “php” folder of your iQ-WEBX installation folder, e.g.:

“C:\Program Files\iQ-WEBX\PACS\php”

NOTICE: If you are replacing an existing license, ensure to back up the old license file.

For checking the license status, you can log into the iQ-WEBX web interface open the “SETTINGS”

tab and click the menu item “WADO”. On the left hand side you will see if the license file has

been recognized or not.

License status

Page 8: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

8

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D8

2. i

8

1. i

Q

-

6 License migration and renewal

6.1 Migrating an existing license

For a migration of the license a complete new installation is necessary. Before planning migration

of iQ-WEBX WADO please contact your local distributor or [email protected] for

generating a new license and further instructions.

NOTICE: Generating a new license is NOT free of charge.

6.2 Changing an existing license

The procedure for changing an existing license is equal to the initial activation of the software

(see 5.2).

Page 9: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

9

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D9

2. i

9

1. i

Q

-

7 Maintenance

Once iQ-WEBX WADO is running, there is no need for maintenance. However, there is a log file

which logs all relevant events concerning the activities of WADO. The log file is named “wado.log”

and can be found under “[iQ-WEB installation folder]\PACS\log”. In addition the log entries can

be viewed on the WADO configuration page in the web interface.

Page 10: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

10

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

0

10

1. i

Q

-

8 Software administration

8.1 General configuration

The WADO configuration can be accessed by selecting the menu item “WADO” located in the

“SETTINGS” tab of the iQ-WEBX web interface. On the left hand side of the screen, you find all

settings that can be altered by the user. You will have to setup WADO before you can access the

PACS with the interface.

General Configuration

HOSTNAME

This value represents the hostname of the computer on which iQ-WEBX is installed on.

DATABASE NAME

This value represents the name of the database that iQ-WEBX uses.

PACS USERNAME

This value represents the user name which is used to access the PACS via the WADO interface.

The user you type in here has to be a valid iQ-WEBX user.

PACS PASSWORD

This value represents the user password which is used to access the PACS via the WADO

interface.

NOTICE: Please note that the password may expire during the time, caused by the iQ-WEB security

feature “automatic password expiration” and has to be updated manually here.

SECRET KEY

This value represents the key used for the encryption of the limited life time token (LLTT), the

individual username and password. iQ-WEBX WADO secures sensitive data with AES-128 in a

Page 11: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

11

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

1

11

1. i

Q

-

cipher block chaining (CBC) mode. AES is a symmetric encryption which uses the same key for

encryption and decryption.

The key has a length of 128 bit respectively 16 alpha-numeric characters.

By clicking the button “Create random key”, a random secret key is created and entered in the

field next to the button. This feature creates a key with a 128 bit length.

INITIALIZATION VECTOR

This value represents the initialization vector (IV) used during the AES encryption in a CBC mode.

In cryptography, an initialization vector is a fixed-size input to a cryptographic primitive that is

typically required to be random or pseudorandom. This value has to have a length of 128 bit

displayed as 32 hexadecimal characters.

ENABLE LLTT

This option activates or deactivates the check of the limited life time token. The limited life time

token is a parameter which decides whether the created WADO link is still valid or not. The

timeframe can be chosen during the link creation and might be anything from 0 to any desired

number of minutes.

USE CENTRAL CREDENTIALS

This option defines, whether iQ-WEBX WADO is forced to use the central credentials each time

somebody requests data via the interface. In case it is checked, iQ-WEBX WADO will use the

credentials entered as PACS username and PACS password above. If it is not checked, it is

possible to use individual user credentials transmitted in the URL. If it is not checked and no

credentials are transmitted in the URL, the interface will fall back and will use the central ones.

LOG LEVEL

This option defines, how detailed the log will be written. All messages will be saved in the

wado.log located under “[iQ-WEBX installation folder]\PACS\log”. The file will be created if it

does not exist.

LICENSE STATUS

This option shows whether your license file has been recognized or not. Once it has been

recognized, you can click the ”Info” link to display additional license information, such as status,

date of creation and date of expiration.

WADO VERSION

This shows which WADO version you are currently running on.

SAVE

By clicking this button, you will save the altered configuration.

8.2 Link creator

The WADO link creator is an easy way to create valid WADO URLs by using all supported

parameters of the interface. This is an easy method to create URLs for test purposes. Once all

Page 12: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

12

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

2

12

1. i

Q

-

parameters have been entered, you can click “Create” and the link will appear in the WADO

status box beneath the link creator and the configuration.

Link creator

HOSTNAME/IP

The name or the IP address of the computer iQ-WEBX WADO is running on will be entered here.

Dynamic DNS names such as the ones provided by dyndns.com or other providers are accepted,

as well.

USE SSL

Determines whether the HTTP or HTTPS protocol is used in the URL. If checked, HTTPS is used.

PORT

This specifies the port of the web server iQ-WEBX is running on. If you use port 80, you can

leave this field empty.

MODE

This specifies the kind of ID you want to search for. Supported are request based on

1 = patient ID

2 = study instance UID

3 = series instance UID

4 = accession number

5 = patient name.

ID

Specifies the ID you want to search for. The *, as a wildcard, is supported at the end or the

beginning of the string.

DIRECT VIEWER REQUEST

Specifies the viewer used to open the requested image(s).

Page 13: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

13

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

3

13

1. i

Q

-

TURN OFF MENU

This deactivates the main iQ-WEBX menu during a request.

USERNAME

This specifies an individual username you can use for the automatic login procedure. It will only

be used if “Use central credentials” is turned off. The user, you type in here, has to be a valid

iQ-WEBX user.

PASSWORD

This specifies the password for the above mentioned user.

START OF URL VALIDITY

This specifies the start date and validity time of the created URL. You can create the current

timestamp by clicking the button “Create current time”. The timestamp is given in the UNIX

timestamp format.

END OF URL VALIDITY

This specifies the end date and validity time of the created URL. You can easily add minutes by

using the “Add” button and by choosing the requested amount of minutes. The timestamp is

given in the UNIX timestamp format.

8.3 Integration with a HIS/RIS

The interface is controlled with URLs that have to be opened in a web browser. All parameters

have to be written in lower cases. The manufacture of the MIS has to implement a function that

creates the URL according to the specification above. Below, you will find some example URLs:

http://localhost/pacs/wado.php?mode=1&id_1=123456

This URL searches for the patient ID “123456”.

http://localhost/pacs/wado.php?mode=1&id_1=*123456*

This URL searches for all patients containing the string “123456” in its patient ID.

http://localhost/pacs/wado.php?mode=4&id_1=AB12G

This URL searches for all studies containing the accession number “AB12G”.

http://localhost/pacs/wado.php?mode=1&id_1=123456&viewer=2&header_off=1

This URL searches for all patients with the ID “123456” and presents the results directly in iQ-

4VIEW, while the main iQ-WEBX menu is deactivated.

http://test.com:8080/pacs/wado.php?mode=1&id_1=123456&viewer=2&header_off=1&user

name=27046f519d22049f2a89d221c4575382c23e97cc3cdb73751dae3e0209d37dd2&password=e

36c7652a4700b369617a3399da9c47da5d78112f7262bf43a21405e2d500b3a&lltt=71976cfb306

153ccab8ea1e160eebb9da6c05f8f49e2da966729326c68e412f4

This URL does the following:

Page 14: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

14

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

4

14

1. i

Q

-

Searches for the patient ID “123456”

Displays the result directly in the iQ-4VIEW viewer

Turns off the iQ-WEBX menu

Uses an individual username and password for the automatic login procedure

Uses the limited life time token to limit the validity of the URL

8.3.1 Interface configuration

To allow the interface accessing iQ-WEBX, you will have to setup a user account that will be

used. Any user account (even “root”) that has been created by iQ-WEBX is usable for the

interface. Using the “root” account is not recommended due to security reasons, because it has

full access/change rights.

8.3.2 URL design

Working with WADO requires a functioning URL with a couple of parameters delimited by a “&”.

The most important thing is that all necessary parameters have to be passed in their correct

form.

NOTICE: The order of these parameters is irrelevant so they can be interchanged in their sequence.

In general, a valid URL has to contain the hostname, port (if it differs from 80), a mode and one

or more IDs (if all additional options are disabled). For example:

http://localhost/pacs/wado.php?mode=1&id_1=123456

In case all features are enabled, the URL includes all parameters. Such an URL looks like the

following:

http://test.com:8080/pacs/wado.php?mode=1&id_1=123456&viewer=2&header_off=1&user

name=27046f519d22049f2a89d221c4575382c23e97cc3cdb73751dae3e0209d37dd2&password=e

36c7652a4700b369617a3399da9c47da5d78112f7262bf43a21405e2d500b3a&lltt=71976cfb306

153ccab8ea1e160eebb9da6c05f8f49e2da966729326c68e412f4

8.3.3 Interface usage

The interface is controlled with URLs that have to be opened in a web browser. The following

chapters describes the different parts of the URL and how they can be combined.

8.3.3.1 Interface root file

wado.php

Page 15: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

15

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

5

15

1. i

Q

-

Part one of a generated URL always consists of the main interface file. So each URL starts with

http://localhost/pacs/wado.php

It is possible to replace “localhost” with any other DNS name or IP Address from a computer

where iQ-WEBX is installed on. If you have changed the alias directive for your PACS installation,

you have to adapt the part “/pacs” as well.

8.3.3.2 Interface mode

mode = [1-5]

This parameter indicates how the “id” parameter should be interpreted.

The following modes are possible:

1 – search for patient ID

2 – search for study instance UID

3 – search for series instance UID

4 – search for accession number

5 – search for patient name

Example: If mode=1, the id_1 and following is interpreted as patient ID search parameters.

8.3.3.3 ID

id_[n]

This parameter specifies the ID to search for. The “n” displays the number of the ID within the

URL, so the first “id” parameter is “id_1” the second “id_2” etc.

In reference to RFC 3986, a space character has to be encoded to “%20”. This might be

necessary if you want to transmit a patient name. It is also possible to use the “^” character.

It is possible to pass multiple IDs within the URL to open multiple entities in the viewer. If

multiple IDs are passed and the viewer mode is disabled, WADO will search only for the first ID

and list it on the web page.

8.3.3.4 Viewer mode

viewer = [0-5]

This parameter determines the viewer to be opened. The following options are possible:

Page 16: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

16

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

6

16

1. i

Q

-

0 – Opens the respective web view (patient, series or study page)

1 – The viewer selected in the user’s profile is opened

2 – iQ-4VIEW is opened

3 – iQ-X is opened if the Internet Explorer is being used, otherwise iQ-4VIEW

4 – The viewer call is forwarded to the local iQ-VIEW installation

5 – Opens the JPEG version of the requested image(s) in the browser

If the parameter is “0”, it can be omitted.

NOTICE: For downward compatibility, the iq_x parameter can still be used. It behaves as described

above.

8.3.3.5 Display iQ-WEBX header

header_off = [0 | 1]

If this parameter is set to “1”, the header (navigation pane) of iQ-WEBX is invisible. Otherwise,

it is enabled. If the parameter is “0”, it can be omitted.

8.3.3.6 Username

Username = [encrypted username]

This parameter contains the encrypted username. The used algorithm is AES-128 (see chapter

8.3.3.9). If the option “Use central credentials” is enabled, this parameter can be omitted.

8.3.3.7 Password

Password = [encrypted password]

This parameter contains the encrypted password. The used algorithm is AES-128 (see chapter

4 AES-128). If the option “Use central credentials” is enabled, this parameter can be omitted.

8.3.3.8 Limited life time token

lltt = [encrypted lltt]

This parameter contains the start and end of URL validity as UNIX timestamp (see 8.3.3.10)

combined with a colon (UNIXtimestamp:UNIXtimestamp). In addition, this string is encrypted

with AES-128 (see section 8.3.3.9). If the option “Enable LLTT” is disabled, this parameter can

be omitted.

Page 17: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

17

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

7

17

1. i

Q

-

8.3.3.9 AES-128

The Advanced Encryption Standard (AES) defines a crypto system and was published by the

National Institute of Standards and Technology (NIST). The standard as well as the algorithm

are free to use and can be downloaded from the homepage of NIST.

AES-128 defines the Rijndael algorithm in a Cipher Block Chaining mode. The block and key size

as well as the initialization vector have a size of 128 bit.

In iQ-WEBX WADO, the secret key is given as an alphanumeric string with 16 characters. A

single character has a size of 8 bit, so 16 characters have 128 bit.

The initialization vector contains 32 characters interpreted as hexadecimal values. Two

characters are one hexadecimal number with a size of 8 bit, summed up this makes 16

hexadecimal numbers with a total size of 128 bit.

8.3.3.10 Unix time

The UNIX time is defined as the number of seconds that have elapsed since 1. January 1970

00:00:00 UTC winter time without counting the leap seconds. To generate a UNIX timestamp

from your local time, you have to keep in mind that your time might have a summertime offset

and is located in a different time zone than UTC.

8.3.4 BDT/GDT tool

The BDT/GDT tool observes a predefined directory. Every times, a BDT or GDT file is inserted to

this location the tool will open the internet browser and will perform a WADO request with the

settings made before. It is not possible to use the limited life time token with this tool.

NOTICE: This tool is only available on request.

8.3.4.1 Configuration

Page 18: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

18

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

8

18

1. i

Q

-

BDT GDT reader help

The BDT/GDT tool is a command line application that allows several parameters. The parameters

and its functions will be explained in the following table.

Parameter Function

-h /-? Displays all possible parameters

-fpath Sets the path of the folder that should be observed

-a Sets the authority (hostname or IP) for the WADO request

-p Sets the port for the WADO request

-un Sets an optional username for the WADO request

-up Sets an optional password for the defined username

-iqx Sets the Direct Viewer Request option to 0 or 1 for the WADO

request (can be omitted if it should be set to “0”)

-ho Activates/deactivates the “header off” option for the WADO

request (can be omitted if it should be set to “0”)

-ssl Defines whether the WADO request should use HTTPS

protocol (iQ-WEBX has to be configured to use this protocol)

-iv Sets the initialization vector for username and password

encryption (has to be the same value entered in the

configuration of the web interface, there is no automatic

generation for this parameter)

-k Sets the initialization vector for username and password

encryption (has to be the same value entered in the

configuration of the web interface, there is no automatic

generation for this parameter)

-start Starts the observation process

NOTICE:

Page 19: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

19

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D1

9

19

1. i

Q

-

During the configuration, the tool will create a “config.ini” that will be stored in the directory

where the executable is located.

8.3.5 iQ-WEBX WADO HL7

The product iQ-WEBX WADO HL7 is an interface for providing information between PACS and

EMR, RIS or HIS. The main feature of this product is the transmission of a specific WADO link to

external systems via a HL7 message. This enables user to view and work straightforward with

images stored in iQ-WEBX. iQ-WEBX WADO HL7 is a combined product composed of iQ-WEBX,

iQ-WEBX WADO and iQ-WORKLIST.

For detailed information and description of the product please refer to the iQ-WEBX WADO HL7

“Administration Guide” document.

NOTICE: iQ-WEBX WADO 3.1.1 requires at least the version 1.2.0 of iQ-WEBX WADO HL7.

Page 20: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

20

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D2

0

20

1. i

Q

-

9 Abbreviations and acronyms

Abbreviation Meaning

AE Application Entity

AES Advanced Encryption Standard

AET Application Entity Title

ANSI American National Standards Institute

ASCII American Standard Code for Information

Interchange

BDT/GDT Behandlungsdatenträger/Gerätedatenträger

Treatment medium/Device medium

CBC Cipher block chaining

DICOM Digital Imaging and Communication in

Medicine

DNS Domain Name System

GUI Graphical User Interface

HIMSS Healthcare Information and Management

Systems Society

HIS Hospital Information System

HTTP HyperText Transfer Protocol

HTTPS HyperText Transfer Protocol Secure

IP Internet Protocol

ISO International Standards Organization

IV Initialization vector

JPEG Joint Photographic Experts Group

LLTT Limited life time token

MIS Medical information system

PACS Picture Archiving and Communication System

RIS Radiology information system

SSL Secure socket layer

TCP/IP Transmission Control Protocol / Internet

Protocol

UID Unique Identifier

URL Uniform resource locator

WADO Web Access to DICOM Persistent Objects

Page 21: Document Template (internal)offsite.ninja/content/docs/iq-web/wado/iQ-WEBX WADO... · iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R 3 iQ-VIE W 2.6. 0 Gru ndl ege nde

iQ-WEBX WADO 3.1.1 Administration Guide PUB INT EN – 001R

21

iQ-

VIE

W

2.6.

0

Gru

ndl

ege

nde

Anf

ord

eru

nge

n

CO

NF

DE

-

001

D2

1

21

1. i

Q

-

IMAGE INFORMATION SYSTEMS LTD.

3RD FLOOR | 207 REGENT STREET | LONDON W1B 3HH | UNITED KINGDOM

TEL. UK: +44 20 3289 1500 | TEL. GER: +49 381 496 58 20 | TEL. US: +1 704 323 66 63

FAX GER: +49 381 496 5 82 99

WWW.IMAGE-SYSTEMS.BIZ | [email protected]