Malaffi
Clinicians open Malaffi, the Abu Dhabi health information exchange, from wawa without signing in again: Open in Malaffi on a patient opens that patient, and Malaffi portal in the user menu opens the Malaffi portal and its JAWDA forms, once Malaffi has issued a portal launch URL.
How it works
- wawa signs the clinician in to Malaffi with SAML 2.0 single sign-on, using the IdP-initiated POST flow that Malaffi supports. The clinician's browser sends the signed sign-in to Malaffi; wawa's servers never connect to Malaffi.
- Each staff member opens Malaffi as themselves, with the access level an administrator assigns. wawa's own administrator accounts can't open Malaffi, even while signed in as one of your users.
- Every launch is recorded in wawa's activity log.
- Signing out of wawa, or being timed out, closes the Malaffi window, so on a shared computer the next person isn't left in Malaffi as the last one. Only the wawa tab that opened Malaffi can close it, and closing that tab or the browser leaves Malaffi open, so ask staff to sign out of wawa rather than just closing the browser.
- Patients are matched by the patient ID shown in wawa, which Malaffi calls the MRN, so your Malaffi data feed must
send the same value as the MRN. API v2 returns it as
patient_identity_management_id, not the record'sid.
What we need from you
| Input | What to give us |
|---|---|
| Malaffi's SSO values | The issuer, recipient, audience, patient launch URL, patient identifier OID and organisation code Malaffi issues for UAT and for production, and the portal launch URL if Malaffi gives you one |
| Accounts | Each wawa account connects to one Malaffi environment, so test against UAT from a test account and use production on your live account |
| Network access | Malaffi's sign-in address is reached over your SD-WAN connection to Malaffi, so clinic computers, including any used to test against UAT, must be on it |
| Staff details | Each person's Malaffi access level, DoH profession, category and major, gender and work phone, and their DoH licence number if they have one. Every visit wawa sends to Malaffi names a consulting clinician by their DoH licence, so book at least one clinician with a DoH licence on each Abu Dhabi appointment; the appointment's Details tab warns when none is booked |
| Facility licence | The DoH facility licence on each Abu Dhabi location |
Certificates
wawa generates the signing certificate; you send it to Malaffi during onboarding, and start using it once Malaffi
confirms they have registered it. Sign-on can't be switched on before then. It downloads as .pem or .cer.
- When you generate it, choose a self-signed certificate, valid for a year, or one from a certificate authority if
Malaffi needs that. For an authority, download the signing request (
.csr), send it to them and upload the certificate they issue; only then can you download it for Malaffi. The private key stays in wawa either way. - While sign-on is on, administrators get an email 60, 30, 14, 7 and 1 days before it expires, and again once it has expired.
- To renew, prepare a new certificate and send it to Malaffi. The current one keeps working until you switch, which you do once Malaffi confirms they have registered the new one.
- If a certificate may be compromised, revoke it. Sign-on switches off at once; tell Malaffi so they disable it too.
Checking it works
The Malaffi settings page opens on a setup check that links each item to the tab where you fix it. Its Launches tab shows the most recent launches, and its Troubleshooting tab runs from a blocked pop-up or an unreachable network to each of Malaffi's own error messages. Malaffi shows its errors in its own window, where wawa can't see them, so start with what the person saw there.
Authorised users
The DoH HIE Policy asks facilities to send Malaffi a list of authorised users and to report changes within 48 hours. The Malaffi settings page's Authorised users tab lists everyone with a Malaffi access level, what each still needs, and the last 14 days of changes, and downloads as CSV.
A new or corrected DoH licence replaces the person's Federation ID, the ID Malaffi knows them by. The change shows in the tab's recent changes, and the CSV's Previous Federation ID column gives the ID it replaced, so you can tell Malaffi within the same 48 hours.