NIST Document Sharing Test Facility

This site supports the IHE effort in Document Sharing as part of the IT Infrastructure Domain with testing, tools, and technical expertise.

Useful things


This server is operated by the National Institute of Standards and Technology (NIST) in support of Cross-Enterprise Document Sharing (XDS) and related profiles published by Integrating the Healthcare Environment (IHE). This family of profiles is now referred to as Document Sharing.

This test facility is based on the IHE IT Infrastructure Technical Framework.

All testing done against this facility is considered conformance testing: testing against a reference. The primary goal of IHE is interoperability testing where implementations are tested against other implementations. Conformance testing always preceeds interoperability testing. Interoperability testing in IHE takes place at IHE Connectathons.

Tools Overview

These tools are freely available and downloadable from this site. See the Tool descriptions that follow or News section below for links to specific versions.

Each tool section contains a link to the supporting mailing list.

Public Registry Server

A service run on the Internet that is a testing reference for the XDS.b profile, parts of the XCA profile, and part of the ATNA profile. This server offers a reference for testing clients, actors that initiate network connections with a partner.

Some useful links are:

The Public Registry is available for local use in two forms: binary downlaod and VMWare download. See the link to Downloads (above).

XDS Toolkit

A downloadable tool that contains a large number of tools within it. It is intended to operate in a developer's lab so that concerns about firewalls and Internet access do not interupt testing. It is packaged as a Web ARchive (WAR) file and can be run on any Servlet container (Tomcat, Jetty, etc.). We currently use Tomcat 7. We have heard reports that using other servlet containers may require moving some JAR files to operate correctly.

Toolkit can be downloaded from here.

We host an Internet copy of toolkit here.

Discussion of this tool is done on the XDS Implementers mailing list. Membership can be requested via here.

NwHIN Support

Most of the tools supporting NwHIN are the same as those supporting IHE Document Sharing. Where there are differences then options can be selected. An example is the FindDocuments Query. By default, IHE interfaces do not require SAML where NwHIN does. SAML selection is therefore selectable in the user interface.

Use the XDS Toolkit for NwHIN testing

There is no specific mailing list for this effort. Please use the XDS Implementers mailing list. Membership can be requested via here.

Transport Test Tool (TTT)

Transport Test Tool (TTT) is used by the Meaningful Use stage 2 effort. It incorporates tools for testing Direct (S/MIME) and several Document Sharing interfaces.

Some useful links:

Open source

The sources for this test facility are available as open source on Source Forge as project IheOs. They can be downloaded for inspection or for local installation. Although the sources are available, we only support the binary releases. See the News section for details of recent releases.


This test facility covers the testing of the following IHE Profiles and Supplements:


November 19, 2012 - Updated certificate available for NA2013 Connectathon

The original certs were generated with too short of a key. These updates change the key size to 1024. Both the toolkit (via new Environment download) and the Public Registry server are updated.
See the Downloads section (to the right of this announcement) for Toolkit and Environment (certs) downloads.

November 2, 2012 - Toolkit and certificates available for NA2013 Connectathon

The TLS port for the Public Registry is documented here
See the Downloads section (to the right of this announcement) for Toolkit and Environment (certs) downloads.

March 5, 2012 - The Public Registry has been moved to new hardware

The changes to the following port numbers are permanent:

These changes are reflected in the wiki here

Feb 27, 2012 - European 2012 Connecathon certificate installed

The certificate for European Connectathon has been installed on the Public Registry on port 9443. For the toolkit, a new Environment has been issued with the same certificate. See the Downloads section for details.

Jan 30, 2012 - XDS Toolkit moved

The XDS Toolkit has moved to its new home

This new box will become the new home of all my services. It will get the alias once the move is complete and before the old box is decommisioned. I will announce the move once everything is in place.

Jan 25, 2012 - XDS Toolkit version 144 released

This release is the version that was used at the NA2012 Connectathon a few weeks ago. It includes a few new Pre-Connectathon tests focused on XDS Document Registry support for Extra Metadata and some bug fixes for environment management. These tests are not yet registered in Gazelle. Download from here (WAR file).

Jan 24, 2012 - VMWare distribution of Public Registry released

This VMWare appliance contains the latest version of the toolkit and the Public Registry server. It can be downloaded and run locally. It is a copy of the red/green/blue servers I run at Connectathon. Download size is 2.04 GB. Installation directions are here and the VM download is available from here (zip).

Oct 5-6, 2011 - Workshop on XDS Toolkit internals

We held a two day workshop discussing the software internals of the XDS Toolkit. We had 17 attendees from the US and Europe. The slides used are available from here (zip).

Known projects using this facility


XDS Implementers mailing list

Bill Majurski
bill At nist doT gov

Created on April 1, 2008
Last Modified: July 29, 2014

SDCT Division Webmaster:
NIST is an agency of the U.S. Commerce Department