# Kirona

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FrpwMM9wSAislqVnvdpjs%2Fkirona.png?alt=media&#x26;token=8add0d69-313d-45a6-bd9b-4b377f91253d" alt=""><figcaption></figcaption></figure>

### Launching Keyfax

These are the launch and test Keyfax steps with Kirona Job Manager integrated with Keyfax Repairs Diagnostics.

1. Launch Job Manager:  Username: KEYFAX01, Password: password1

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2Fq8xLsQQOFCAsAaILpvDi%2Fimage.png?alt=media&#x26;token=da417eef-d6c2-4d37-a1b0-084a71765778" alt=""><figcaption></figcaption></figure>

2. Choose to create a Job (from the Create menu on the Left Hand side)

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FQdQYnaulEZEivU7d6rd4%2Fimage.png?alt=media&#x26;token=89a6d68d-1c84-4bd6-9072-2e80df205d07" alt=""><figcaption></figcaption></figure>

3. When prompted for what type of job choose Works Management Case (WM Case):

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FN1N6ktJMEy2I3JUciQ56%2Fimage.png?alt=media&#x26;token=db32ae9f-71d6-42e4-8cfa-9f7b0a599157" alt=""><figcaption></figcaption></figure>

4. Confirm WM case is the integration by looking at the “About” drop down. You can also check that the URL is correct for launching Keyfax:&#x20;

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FYlGpiiuxwTPcLGd8tcAr%2Fimage.png?alt=media&#x26;token=bd973722-63bd-4cfc-8374-74e3f0e15987" alt=""><figcaption></figcaption></figure>

5. To Launch Keyfax, an asset (property) that YHN actually maintains must be chosen from the list of all properties. So a postcode search can be made (e.g. for NE6 3…) and then select a “Managed Property” (maintained by YHN), and click on “Add Selected Item”, which adds it to the WM Case.

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FNnKEgk7cgGTfxdPl0IgN%2Fimage.png?alt=media&#x26;token=b9d6c41d-4566-4109-a219-60f1fdcd65f2" alt=""><figcaption></figcaption></figure>

6. At this point the Keyfax button becomes fully blue and clickable:

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FlV2xaUlU1FbIWBBR78qW%2Fimage.png?alt=media&#x26;token=a9f24845-2947-40d1-8a94-846d4ada2375" alt=""><figcaption></figcaption></figure>

### Known Errors

When initially set up as intended as above Kirona JM gave an error:

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2F2v0JqLTKQ1CymSjnLvTE%2Fimage.png?alt=media&#x26;token=7bd5c685-26da-4364-a25c-5e8cced01b29" alt=""><figcaption></figcaption></figure>

This was due to being logged into JM as a user “ADMIN” not known in Keyfax. Once set up (KEYFAX01) this worked fine (Jake actually logged in as another user). However, as part of the integration Kirona have decided to hardcode the user as “operator” with an incremented number to set up a unique OrderID. From the database orders:

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2F3U4bPMUUuXy9N920wrV4%2Fimage.png?alt=media&#x26;token=c4a1e8af-faf9-4684-8b45-76a5b3ae9088" alt=""><figcaption></figcaption></figure>

Previous to this, Keyfax wouldn’t launch under https with a wildcard certificate if (as was set by default) TLS1.3 Client was switched on in the Win 2019 registry. Once switched off Keyfax worked fine. So on this KEYDCB002 server we have restricted TLS to be 1.2 only.
