The eHealth integration toolkits are a collection of integration tools and sample code resources available in both .NET and Java. The sample code and integration tools are used within the eHealth reference platform, forming part of the code library for tools and simulators.
Access to sample code and the eHealth reference platform’s online simulator services is supported by suitable right-to-use licenses and terms and conditions regarding the eHealth reference platform.
The secure messaging integration toolkit contains libraries for business-to-business connectivity to Secure Message Delivery (SMD) and Endpoint Location Services (ELS), providing sample code for all operations as well as a Medical Document Management (MDM) library to create the payload for SMD. It also includes secure messaging conformance test tools, which support the Australian Technical Specification for Secure Message Delivery (ATS 5822-2010).
Secure messaging integration toolkit in the Australian context
The sample code and integration tools provided here should only be used in conjunction with the Australian Digital Health Agency’s detailed specifications for clinical documents and messaging infrastructure.
The Australian secure messaging standards provide a general-purpose secure web service protocol for the delivery of business service messages from one healthcare provider organisation to another.
The secure messaging standards are:
- AS 5552-2013 E-health Secure Message Delivery (SMD)
- AS 5551-2013 E-health XML Secured Payload Profiles (XSP)
- AS 5550-2013 E-health Web Services Profiles (WSP)
The SMD standard makes use of the XSP and WSP standards. These standards supersede the previous Australian secure messaging specifications, including:
- ATS 5822-2010 E-health Secure Message Delivery (SMD)
- ATS 5821-2010 E-health XML Secured Payload Profiles (XSP)
- ATS 5820-2010 E-health Web Services Profiles (WSP)
The secure messaging integration toolkit libraries, sample code and test tools all support the Australian Technical Specification for SMD (ATS 5822-2010). All existing SMD implementations are based on the older ATS 5822-2010 and its related XSP and WSP specifications. The Agency has published a conformance assessment scheme and conformance test tools for ATS 5822 and conformance to ATS 5822 is required for the Department of Health's Practice Incentive Program (PIP) eHealth incentive. Subject to industry agreement and budget approvals the Agency will update the conformance assessment scheme and the secure messaging integration toolkit to support AS 5552-2013 and its related XSP and WSP specifications in the future.
Related specifications and foundations
Secure messaging relies on the use of X.509 public key infrastructure certificates. Secure messaging implementations may utilise a combination of NASH PKI certificates and certificates issued by commercial secure messaging providers. Existing SMD implementations make use of the Endpoint Location Service (ELS)v1.3 specification and the healthcare provider directory that is provided as part of the Healthcare Identifiers Service. Over time these will be superseded by the HL7™ FHIR® standard provider directory interface.
The Secure Messaging Integration Toolkit contains libraries for B2B connectivity to Secure Message Delivery (SMD) and Endpoint Location Services (ELS), providing sample code for all operations, as well as a Medical Document Management (MDM) library to create the payload for SMD.