IOWA Web Service Setup Version 1.2 10022017
1 of 20
zehn
Iowa Immunization Registry Information System (IRIS)
Web Services Data Exchange Setup
Version 1.2
Last Updated: October 2017
IOWA Web Service Setup Version 1.2 10022017
2 of 20
Table of Contents
SSL Certificate Creation ..................................................................................................................................................... 3
Option 1: Complete the “Provider Info” column and DXC will send to you the keystore and
certificate ............................................................................................................................................................................... 3
Step 1: Please complete the “Provider Info” column: ................................................................................................... 3
Step 2: Email info and request for Username and Password to the Iowa Department of Public .............. 4
Health................................................................................................................................................................................................. 4
Step 3: Receiving Your Keystore including the Signed Certificate .......................................................................... 4
Step 4: Install Your Keystore including the Signed Certificate .................................................................................. 4
Option 2: Generating a Key and Certificate Signing Request (CSR) ................................................................. 4
Generating a Private Key and CSR using OpenSSL ............................................................................................................... 4
Step 1: Generate Private Key .................................................................................................................................................. 4
Step 2: Generate the CSR .......................................................................................................................................................... 4
Step 3: Send CSR and request for Username and Password to the Iowa Department of Public ................ 6
Health................................................................................................................................................................................................. 6
Step 4: Backup the private key ............................................................................................................................................... 6
Step 5: Receiving Your Signed Certificate .......................................................................................................................... 6
Generating a Private Key and CSR using Microsoft Windows ............................................................................. 8
Step 1: Creating the Private Key and CSR ................................................................................................................................ 8
SSL Trust Stores in a Web Services Context ............................................................................................................... 9
Keystores .............................................................................................................................................................................................. 9
Truststores ........................................................................................................................................................................................... 9
IRIS Web Services Client Operations ......................................................................................................................................... 9
Get information about Secure Sockets Layer (SSL) certificates ...................................................................... 10
Introduction to SOAP Web Services in IRIS ............................................................................................................ 12
Getting the WSDL ............................................................................................................................................................................. 13
Obtaining the WSDL: Extract the version from this document ................................................................................... 13
Getting the URL................................................................................................................................................................................. 14
Appendix A: WSDL File Contents ............................................................................................................................... 15
Appendix B: URL for OpenSSL ..................................................................................................................................... 20
2 of 20
IOWA Web Service Setup Version 1.2 10022017
3 of 20
SSL Certificate Creation
The Secure Sockets Layer (SSL) is a commonly-used protocol for managing the security of a message
transmission on the Internet. SSL client and server certificates are used as an added security feature for
transmitting data for IRIS Web services transactions. IRIS requires both the client and server install
certificates generated by the IRIS vendor, DXC, personnel.
To accomplish this, you have two options:
1. Provide the info needed for IDPH and DXC to build your keystore and certificate, or
2. Create a private key for each machine that will be accessing the IRIS Web services machine. This private key
is then used to create a Certificate Signing Request (CSR) which will be sent to IDPH. IDPH/DXC will create
the SSL certificate which will be returned to you for installation on your client machine (“client” in this
instance will most likely be the server that communicates with the IRIS Web services servers).
Option 1: Complete the “Provider Info” column and IDPH/DXC will send to you
the keystore and certificate
Step 1: Please complete the “Provider Info” column:
Field
Provider Info
Description
State or Province
Spell out the state completely; do not abbreviate the
state or province name. Example: Iowa
Locality or City
The Locality field is the city or town name; do not
abbreviate. Example: Mount Pleasant , not Mt. Pleasant
Company
If the company or department has an &, @, or any other
symbol using the shift key in its name, the symbol must
be spelled out or omitted.
Example: XY & Z Corporation would be XYZ Corporation
or XY and Z Corporation.
Organizational
Unit
Can be used to help identify certificates registered to an
organization. The Organizational Unit (OU) field is the
name of the department or organization unit making the
request.
Common Name
The Common Name is the Host + Domain Name. It looks
like "my.server.com". Example: For Smith Health Center,
the Common Name could be “smithhealthcenter.org”.
Email Address
The e-mail address of a long-term technical /
administrative contact. It is used identify the owner of a
certificate in case there are issues.
IOWA Web Service Setup Version 1.2 10022017
4 of 20
Step 2: Email info and request for Username and Password to the Iowa Department of Public
Health
Email the info to Joey Zehner at joseph.zehn[email protected].gov and copy Kim Tichy at
Kimberly.tic[email protected]wa.gov.
Step 3: Receiving Your Keystore including the Signed Certificate
Once your CSR has been processed, you will receive the keystore including the signed certificates as an email
attachment.
The instructions for this will vary depending on your environment. Two common trusted stores are
PublicKey Cryptography Standards #12 (PKCS#12 or PFX) and Java Key Store (JKS). A good source of
reference for this information is Google (search for: importing trusted root certificates).
Step 4: Install Your Keystore including the Signed Certificate
Configuration of SSL/TLS mutual authentication varies widely depending upon software platform and
product. It is advisable to consult the vendor-provided documentation for your particular product. This will
be the most authoritative source for acceptable formats and configuration locations.
Option 2: Generating a Key and Certificate Signing Request (CSR)
To generate a CSR, a key pair must be created for the server. These two items are a digital certificate key
pair and cannot be separated. If the public/private key file is lost or changed before the SSL certificate is
installed, the SSL certificate will need to be re-issued. The private key, CSR, and certificate must all match in
order for the installation to be successful. The following sequence of commands will generate a 2048 bit key
using the OpenSSL software. Below are instructions for creating the CSR in a Windows environment. It is
recommended to use the domain name or IP address that will be used for the certificate as the prefix of the
filenames. Also make sure that any existing keys and CSRs are NOT overwritten.
Generating a Private Key and CSR using OpenSSL
Step 1: Generate Private Key
Type the following command at the prompt: openssl
genrsa –out my.server.com.key 2048
This command generates a 2048 bit RSA private key and stores it in the file,
my.server.com.key
Note: For all SSL certificates, the CSR key bit length must be 2048. The text in italic bold (i.e. my.server.com) is
only an example. Replace it with a name that is meaningful to you. It does not have to be a website but MUST have
the “.key” extension.
Step 2: Generate the CSR
Type the following command at the prompt:
Openssl.exe req –new –key my.server.com.key –out my.server.com.csr
This command will prompt for the following attributes of the certificate:
IOWA Web Service Setup Version 1.2 10022017
5 of 20
Field
Required /
Optional
Description
Country Name
R
Use the two-letter code without punctuation for country.
Example: US or CA
State or Province
R
Spell out the state completely; do not abbreviate the state or
province name. Example: Iowa
Locality or City
R
The Locality field is the city or town name; do not abbreviate.
Example: Mount Pleasant , not Mt. Pleasant
Company
R
If the company or department has an &, @, or any other symbol
using the shift key in its name, the symbol must be spelled out
or omitted.
Example: XY & Z Corporation would be XYZ Corporation or XY
and Z Corporation.
Organizational
Unit
O
Can be used to help identify certificates registered to an
organization. The Organizational Unit (OU) field is the name of
the department or organization unit making the request.
To skip the OU field, press Enter on the keyboard.
Common Name
R
The Common Name is the Host + Domain Name. It looks like
"my.server.com".
Email Address
NA
Do
not
enter anything in this field.
Challenge Password
NA
Do
not
enter anything in this field.
Optional Company
Name
NA
Do
not
enter anything in this field.
The certificate is used to secure the transaction between provider EHR and IRIS. Each certificate is required to have a
unique common name. Combining your host and domain names will ensure your common name is unique.
A public/private key pair has now been created.
Private Key:
• File Name example: my.server.com.key
• Stored locally on the server machine
• Used for decryption (IMPORTANT – Maintain in a safe place).
Public Key
• File Name example: my.server.com.csr
• In the form of a Certificate Signing Request (CSR)
• Used for certificate enrollment
Screenshot of the screen showing the attributes of the certificate:
IOWA Web Service Setup Version 1.2 10022017
6 of 20
Step 3: Send CSR and request for Username and Password to the Iowa Department of Public
Health
The CSR is an ASCII text file that can be attached to an email and should be sent to Joey Zehner at
joseph.zehner@idph.iowa.gov and copy Kim Tichy at Kimberly.tichy@idph.iowa.gov
.
NOTE: Only send the CSR file. Do not send your private key as it should be kept confidential.
The username and password will be used later when setting up the WSDL (Web Services Description Language)
and SOAP (Simple Object Access Protocol) protocols.
Step 4: Backup the private key
It is recommended to back-up the .key file. An acceptable option is to create a copy of this file onto a flash
drive or other removable media. While backing up the private key is not required, having one will be
helpful in the instance of server failure.
Step 5: Receiving Your Signed Certificate
Once your CSR has been processed, you will receive the signed certificates as an email attachment. They
must be unzipped and placed in the same folder as your request. These files must be installed in the Trusted
Store of the computer for which it was generated. The files are:
1. The CA certificate, ca.crt. This is common to all Immunization Information System (IIS) users and
establishes DXC’s server as a valid Certificate Authority, which tells your server to trust Certificates
issued by DXC.
2. The specific server certificate, such as csr-site-request.crt. This is unique to the server from which it
was generated.
The instructions for this will vary depending on your environment. Two common trusted stores are
PublicKey Cryptography Standards #12 (PKCS#12 or PFX) and Java Key Store (JKS). A good source of
reference for this information is Google (search for: importing trusted root certificates).
Join your private key with the signed certificate and certificate authority files e-mailed by DXC, so the
browser and OS can use it.
Here is an example of creating a .pfx file using openssl.
Openssl pkcs12 –export –out www.example.com.pfx –inkey www.example.com.key –
in
www.example.com.crt –certfile cacert.crt
Here are what the example file names represent:
IOWA Web Service Setup Version 1.2 10022017
7 of 20
www.example.com.pfx = this will be the output file – which you’ll install into Windows 7 so IE can use it
www.example.com.key = this is the key that was generated by step 1
www.example.com.crt = this is the signed certificate provided in response to the CSR
cacert.crt = this is the CA (Certificate Authority) file which was provided. This is needed by openssl to verify
the first file was signed.
Refer to the following steps if you are using a .pfx file. Otherwise, skip this section.
1. Go the file where the “www.example.com.pfx” file has been created.
2. Right click on the file.
3. Select Install PFX.
4. Click on Next.
5. Click on Next.
6. No password is required. Ensure that all three check boxes are selected. Click on Next.
IOWA Web Service Setup Version 1.2 10022017
8 of 20
8. Click on Next.
9. Click on Finish.
Generating a Private Key and CSR using Microsoft Windows
Step 1: Creating the Private Key and CSR
1. Open the Microsoft Management Console (MMC). On the Start menu, click Run, type MMC, and then click
OK. MMC opens with an empty console.
2. Right-click the default Web site, click New, and then click Site. Create a new site and give it a temporary
name.
IOWA Web Service Setup Version 1.2 10022017
9 of 20
3. Right-click the new site, click Properties, click the Directory Security tab, and then click Server
certificate.
4. Select Create new certificate and follow the wizard to create a new CSR. Use the information from the
OpenSSL instructions above in Step 2, when filling out the request. When prompted, select Prepare the
request now but send it later.
5. Use the CSR that you just created to request a new certificate from DXC.
6. See the OpenSSL instructions Steps 3, 4, and 5, above, to finish the process.
SSL Trust Stores in a Web Services Context
Keystores
A keystore is a database of private keys and their associated X.509 certificate chains authenticating the
corresponding public keys. A key is a piece of information that controls the operation of a cryptographic algorithm.
For example, in encryption, a key specifies the particular transformation of plain text into ciphertext, or vice versa
during decryption. Keys are used in digital signatures for authentication.
Truststores
The truststore contains the Certificate Authority (CA) certificates and the certificate(s) of the other party to which
this entity intends to send encrypted (confidential) data. This file must contain the public key certificates of the CA
as well as the client's public key certificate.
IRIS Web Services Client Operations
For all provider servers which will be accessing the IRIS Web Service, a Truststore needs to be established. The
Truststore should contain the signed certificate received from DXC plus the CA certificate(s) from the Web Services
server.
Disclaimer: The following screen shots were taken using Internet Explorer 7 and may differ depending upon the
browser you are utilizing.
The CA certificate(s) can be acquired, by pointing your web browser at the IRIS Web Services site (e.g., using a
WSDL request).
Notice: You may receive the following notification “There is a problem with this web site’s security certificate.” If you do
receive this message, please, click the “Continue to this website (not recommended).” link.
IOWA Web Service Setup Version 1.2 10022017
10 of 20
Right click on the browser’s lock icon to display the certificate. If the lock icon is not present, you many
see . Click on the Certificate Error.
Get information about Secure Sockets Layer (SSL) certificates
When you connect to a website, Internet Explorer uses a secure connection that uses Secure Sockets Layer (SSL)
technology to encrypt the transaction. The encryption is based on a certificate that provides Internet Explorer with
the information it needs to communicate securely with the website. Certificates also identify the website and owner.
You can view a certificate to validate the identity of a website before providing information.
To validate the identity of a website:
1. Open Internet Explorer
2. Go to the website you want to validate. 3. Click the Lock icon , which is located to the
right of the Address bar.
Basic certificate information (for example, the name and address of the website owner and information
about who certified the site) will be displayed. To see additional information, click View Certificates.
Note:
If a lock icon does not appear in the Address bar in step 3 above, the connection is not secure.
You should now see a notification “Untrusted Certificate”. Click on “View certificates”
IOWA Web Service Setup Version 1.2 10022017
11 of 20
You should now be presented with the Certificate dialogue box.
Depending on the browser model and version used, you will now be able to import the CA certificates into the
machine's truststore, or export them for importing into a file by openssl.
Whether you need to import the machine's truststore or create a truststore file is determined by the type of Web
Service Client you are creating and should be explained in the documentation for that system.
IOWA Web Service Setup Version 1.2 10022017
12 of 20
Introduction to SOAP Web Services in IRIS
A Web Service is a standards-based method of allowing one computer to access functions in another computer through
the Internet. The functions are accessed through the same ports used by Internet browsers, making them very likely to
be allowed through firewalls.
Security is implemented by installing public and private key pairs (known as X.509 certificates) on both the IRIS
Web Services Server and the Electronic Health Record (EHR) computer requesting the information. Using this
technique, both the client and server are identified to each other to establish trust, and the communication is
encrypted.
IRIS supports the following functions through Web Services:
1. Connectivity Test - this is used to test connection to server
2. Submit Single Message - this is used to submit HL7 formatted messages
Web services transmission is wrapped up in several layers of protocols including:
1. Internet Layer
a. IPv4 (Internet Protocol)
2. Transport Layer
a. TCP (Transmission Control Protocol)
3. Application Layer
a. TLS/SSL (Transport Layer Security/Secure Socket Layer)
i. Client Certificate Authentication.
ii. RSA-2048 iii. SHA-512
b. HTTP (Hypertext Transmission Protocol)
i. Request Type: POST
ii. Content Type: ‘application/soap+xml’
c. SOAP (Simple Object Access Protocol)
i. SOAP 1.2
d. HL7 (Health Level 7)
Web Service functions are called using Simple Object Access Protocol (SOAP) requests, which are formatted as
XML (eXtensible Markup Language) messages.
Each SOAP request is made up of the following elements:
1. The envelope, which identifies the message as a SOAP request
IOWA Web Service Setup Version 1.2 10022017
13 of 20
2. The function name
3. The parameters of the function call. In most cases, the parameters are individual pieces of data, such as First
Name, Last Name, etc. For the IRIS Web Services, there is a single parameter which contains an entire
HL7formatted message, wrapped in a CDATA section to keep it from being misinterpreted by the parser.
Here is a simple VXU message sent to the Update History Web Service function. The pieces are numbered from
the list above.
(1) SOAP
Envelope Start
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:cdc:iisb:2011">
<soap:Header/>
<soap:Body>
(2) Function and
parameter Start
<urn:submitSingleMessage>
<urn:username>USERNAME</urn:username>
<urn:password>PASSWORD</urn:password>
<urn:facilityID>ORG ID</urn:facilityID>
<urn:hl7Message
CDATA
section Start
<![CDATA[
(3) Parameter,
the HL7 message,
segments vary
depending on the
function
MSH|^~\&|Immunization Generator^1.4.1|JIM'S
CLINIC^6740^|||20120731134645||VXU^V04|64443|P^|2.4^^^^^^^^^^^^|||ER||||
PID|||3558^^^^PI^||HOST^JAMIE^^^^^L^|NAME^MAIDEN^^^^^L^|20110101|F|||665 EAST
ST^^HOMETOWN^IA^86702^^^^^^|||||||||||||||||||Y
PD1||||||||||||
NK1|1|HOST^JAMIE^^^^^L^|SEL^SELF^HL70063^^^|665 EAST
ST^^HOMETOWN^IA^86702^^^^^^|||||||||||||||||||||||||||||||||
RXA|0|999|20120731|20120731|^^^ACTHIB^^WVTN|999||||||||||||||A|20120731134645
CDATA
section End
]]>
(2) Function and
parameter End
></urn:hl7Message>
(1) SOAP
Envelope End
</urn:submitSingleMessage>
</soap:Body>
</soap:Envelope>
The definitions of the functions are specified in the WSDL (Web Services Description Language) file. Modern
development environments (such as Java and .NET) can take the WSDL and turn it into a programming interface to
simplify implementation. The WSDL can be supplied by Meaza Bikes at meaza.bikes@dxc.com
or retrieved from
the server once the certificates are installed.
For More Information http://www.w3schools.com/webservices/default.asp i
s a good source for information
about Web Services. The Summary page includes links to information about WSDL and SOAP.
Getting the WSDL
The WSDL (Web Services Description Language, pronounced whiz-dul) is a method used to describe Web
Services functions that can be accessed through the Internet from other computers.
Using the WSDL file, modern development environments (such as Java and .NET) can turn the WSDL file into a
programming interface to simplify implementation.
Obtaining the WSDL: Extract the version from this document
1. Highlight the lines in Appendix A (the WSDL section only) from
IOWA Web Service Setup Version 1.2 10022017
14 of 20
<?xml version="1.0" encoding="UTF-8" ?> to </definitions>
2. Copy the highlighted text to the clipboard with Control-C.
3. Open up Notepad and paste the contents of the clipboard into the empty Notepad file.
4. Verify the contents include all of the lines you highlighted in Step 1.
5. Save document as “cdc.wsdl” to folder of choice.
Getting the URL
The final step is to request the production URL. This will be where messages are sent and responses will be
returned.
IOWA Web Service Setup Version 1.1 04142014
15 of 20
Appendix A: WSDL File Contents
< ? x m l v e r s i o n = " 1 . 0 " e n c o d i n g = " U T F - 8 " ? >
< d e f i n i t i o n s x m l n s : w s u = " h t t p : / / d o c s . o a s i s - o p e n . o r g / w s s / 2 0 0 4 / 0 1 / o a s i s - 2 0 0 4 0 1 - w s s w s s e c u
r i t y - u t i l i t y - 1 . 0 . x s d "
x m l n s : w s p = " h t t p : / / w w w . w 3 . o r g / n s / w s - p o l i c y "
x m l n s : w s p 1 _ 2 = " h t t p : / / s c h e m a s . x m l s o a p . o r g / w s / 2 0 0 4 / 0 9 / p o l i c y "
x m l n s : w s a m = " h t t p : / / w w w . w 3 . o r g / 2 0 0 7 / 0 5 / a d d r e s s i n g / m e t a d a t a "
x m l n s : w s a w = " h t t p : / / w w w . w 3 . o r g / 2 0 0 5 / 0 8 / a d d r e s s i n g " x m l n s : s o a p 1 2 = " h t t p : / / s c h
e m a s . x m l s o a p . o r g / w s d l / s o a p 1 2 / "
x m l n s : t n s = " u r n : c d c : i i s b : 2 0 1 1 "
x m l n s : x s d = " h t t p : / / w w w . w 3 . o r g / 2 0 0 1 / X M L S c h e m a "
x m l n s = " h t t p : / / s c h e m a s . x m l s o a p . o r g / w s d l / "
t a r g e t N a m e s p a c e = " u r n : c d c : i i s b : 2 0 1 1 " n a m e = " I I S S e r v i c e N e w " >
< ! - - s c h e m a f o r t y p e s - - >
< types>
< x s d : s c h e m a e l e m e n t F o r m D e f a u l t = " q u a l i f i e d " t a r g e t N a m e s p a c e = " u r n : c d c : i i s b : 2 0 1 1 " >
< x s d : c o m p l e x T y p e n a m e = " c o n n e c t i v i t y T e s t R e q u e s t T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " e c h o B a c k " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " c o n n e c t i v i t y T e s t R e s p o n s e T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " r e t u r n " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " s u b m i t S i n g l e M e s s a g e R e q u e s t T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " u s e r n a m e " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 0 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
< x s d : e l e m e n t n a m e = " p a s s w o r d " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 0 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
IOWA Web Service Setup Version 1.1 04142014
16 of 20
< x s d : e l e m e n t n a m e = " f a c i l i t y I D " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 0 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
< x s d : e l e m e n t n a m e = " h l 7 M e s s a g e " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " s u b m i t S i n g l e M e s s a g e R e s p o n s e T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " r e t u r n " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 "
m a x O c c u r s = " 1 " n i l l a b l e = " t r u e " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " s o a p F a u l t T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " C o d e " t y p e = " x s d : i n t e g e r " m i n O c c u r s = " 1 " / >
< x s d : e l e m e n t n a m e = " R e a s o n " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 " / >
< x s d : e l e m e n t n a m e = " D e t a i l " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " U n s u p p o r t e d O p e r a t i o n F a u l t T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " C o d e " t y p e = " x s d : i n t e g e r " m i n O c c u r s = " 1 " / >
< x s d : e l e m e n t n a m e = " R e a s o n " f i x e d = " U n s u p p o r t e d O p e r a t i o n " / >
< x s d : e l e m e n t n a m e = " D e t a i l " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " S e c u r i t y F a u l t T y p e " >
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " C o d e " t y p e = " x s d : i n t e g e r " m i n O c c u r s = " 1 " / >
< x s d : e l e m e n t n a m e = " R e a s o n " f i x e d = " S e c u r i t y " / >
< x s d : e l e m e n t n a m e = " D e t a i l " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : c o m p l e x T y p e n a m e = " M e s s a g e T o o L a r g e F a u l t T y p e " >
IOWA Web Service Setup Version 1.1 04142014
17 of 20
< x s d : s e q u e n c e >
< x s d : e l e m e n t n a m e = " C o d e " t y p e = " x s d : i n t e g e r " m i n O c c u r s = " 1 " / >
< x s d : e l e m e n t n a m e = " R e a s o n " f i x e d = " M e s s a g e T o o L a r g e " / >
< x s d : e l e m e n t n a m e = " D e t a i l " t y p e = " x s d : s t r i n g " m i n O c c u r s = " 1 " / >
< / x s d : s e q u e n c e >
< / x s d : c o m p l e x T y p e >
< x s d : e l e m e n t n a m e = " c o n n e c t i v i t y T e s t " t y p e = " t n s : c o n n e c t i v i t y T e s t R e q u e s t T y p e " / >
< x s d : e l e m e n t n a m e = " c o n n e c t i v i t y T e s t R e s p o n s e "
t y p e = " t n s : c o n n e c t i v i t y T e s t R e s p o n s e T y p e " / >
< x s d : e l e m e n t n a m e = " s u b m i t S i n g l e M e s s a g e "
t y p e = " t n s : s u b m i t S i n g l e M e s s a g e R e q u e s t T y p e " / >
< x s d : e l e m e n t n a m e = " s u b m i t S i n g l e M e s s a g e R e s p o n s e "
t y p e = " t n s : s u b m i t S i n g l e M e s s a g e R e s p o n s e T y p e " / >
< x s d : e l e m e n t n a m e = " f a u l t " t y p e = " t n s : s o a p F a u l t T y p e " / >
< x s d : e l e m e n t n a m e = " U n s u p p o r t e d O p e r a t i o n F a u l t "
t y p e = " t n s : U n s u p p o r t e d O p e r a t i o n F a u l t T y p e " / >
< x s d : e l e m e n t n a m e = " S e c u r i t y F a u l t " t y p e = " t n s : S e c u r i t y F a u l t T y p e " / >
< x s d : e l e m e n t n a m e = " M e s s a g e T o o L a r g e F a u l t "
t y p e = " t n s : M e s s a g e T o o L a r g e F a u l t T y p e " / >
< / x s d : s c h e m a >
< / t y p e s >
< ! - - M e s s a g e d e f i n i t i o n s - - >
< m e s s a g e n a m e = " c o n n e c t i v i t y T e s t _ M e s s a g e " >
< d o c u m e n t a t i o n > c o n n e c t i v i t y t e s t r e q u e s t < / d o c u m e n t a t i o n >
< p a r t n a m e = " p a r a m e t e r s " e l e m e n t = " t n s : c o n n e c t i v i t y T e s t " / >
< / m e s s a g e >
< m e s s a g e n a m e = " c o n n e c t i v i t y T e s t R e s p o n s e _ M e s s a g e " >
< d o c u m e n t a t i o n > c o n n e c t i v i t y t e s t r e s p o n s e < / d o c u m e n t a t i o n >
< p a r t n a m e = " p a r a m e t e r s " e l e m e n t = " t n s : c o n n e c t i v i t y T e s t R e s p o n s e " / >
< / m e s s a g e >
< m e s s a g e n a m e = " s u b m i t S i n g l e M e s s a g e _ M e s s a g e " >
< d o c u m e n t a t i o n > s u b m i t s i n g l e m e s s a g e r e q u e s t . < / d o c u m e n t a t i o n >
< p a r t n a m e = " p a r a m e t e r s " e l e m e n t = " t n s : s u b m i t S i n g l e M e s s a g e " / >
< / m e s s a g e >
IOWA Web Service Setup Version 1.1 04142014
18 of 20
< m e s s a g e n a m e = " s u b m i t S i n g l e M e s s a g e R e s p o n s e _ M e s s a g e " >
< d o c u m e n t a t i o n > s u b m i t s i n g l e m e s s a g e r e s p o n s e < / d o c u m e n t a t i o n >
< p a r t n a m e = " p a r a m e t e r s " e l e m e n t = " t n s : s u b m i t S i n g l e M e s s a g e R e s p o n s e " / >
< / m e s s a g e >
< m e s s a g e n a m e = " U n k n o w n F a u l t _ M e s s a g e " >
< p a r t n a m e = " f a u l t " e l e m e n t = " t n s : f a u l t " / >
< / m e s s a g e >
< m e s s a g e n a m e = " U n s u p p o r t e d O p e r a t i o n F a u l t _ M e s s a g e " >
< p a r t n a m e = " f a u l t " e l e m e n t = " t n s : U n s u p p o r t e d O p e r a t i o n F a u l t " / >
< / m e s s a g e >
< m e s s a g e n a m e = " S e c u r i t y F a u l t _ M e s s a g e " >
< p a r t n a m e = " f a u l t " e l e m e n t = " t n s : S e c u r i t y F a u l t " / >
< / m e s s a g e >
< m e s s a g e n a m e = " M e s s a g e T o o L a r g e F a u l t _ M e s s a g e " >
< p a r t n a m e = " f a u l t " e l e m e n t = " t n s : M e s s a g e T o o L a r g e F a u l t " / >
< / m e s s a g e >
< ! - - O p e r a t i o n / t r a n s a c t i o n d e c l a r a t i o n s - - >
< p o r t T y p e n a m e = " I I S _ P o r t T y p e " >
< o p e r a t i o n n a m e = " c o n n e c t i v i t y T e s t " >
< d o c u m e n t a t i o n > t h e c o n n e c t i v i t y t e s t < / d o c u m e n t a t i o n >
< i n p u t m e s s a g e = " t n s : c o n n e c t i v i t y T e s t _ M e s s a g e "
w s a w : A c t i o n = " u r n : c d c : i i s b : 2 0 1 1 : c o n n e c t i v i t y T e s t " / >
< o u t p u t m e s s a g e = " t n s : c o n n e c t i v i t y T e s t R e s p o n s e _ M e s s a g e "
w s a w : A c t i o n = " u r n : c d c : i i s b : 2 0 1 1 : c o n n e c t i v i t y T e s t R e s p o n s e " / >
< f a u l t n a m e = " U n k n o w n F a u l t " m e s s a g e = " t n s : U n k n o w n F a u l t _ M e s s a g e " / > < ! - - a g e n e r a l s o a p f a u l t - - >
< f a u l t n a m e = " U n s u p p o r t e d O p e r a t i o n F a u l t "
m e s s a g e = " t n s : U n s u p p o r t e d O p e r a t i o n F a u l t _ M e s s a g e " / > < ! - - T h e U n s u p p o r t e d O p e r a t i o n s o a p f a u l t - - >
< / o p e r a t i o n >
< o p e r a t i o n n a m e = " s u b m i t S i n g l e M e s s a g e " >
< d o c u m e n t a t i o n > s u b m i t s i n g l e m e s s a g e < / d o c u m e n t a t i o n >
< i n p u t m e s s a g e = " t n s : s u b m i t S i n g l e M e s s a g e _ M e s s a g e "
w s a w : A c t i o n = " u r n : c d c : i i s b : 2 0 1 1 : s u b m i t S i n g l e M e s s a g e " / >
< o u t p u t m e s s a g e = " t n s : s u b m i t S i n g l e M e s s a g e R e s p o n s e _ M e s s a g e "
IOWA Web Service Setup Version 1.1 04142014
19 of 20
w s a w : A c t i o n = " u r n : c d c : i i s b : 2 0 1 1 : s u b m i t S i n g l e M e s s a g e R e s p o n s e " / >
< f a u l t n a m e = " U n k n o w n F a u l t " m e s s a g e = " t n s : U n k n o w n F a u l t _ M e s s a g e " / > < ! - - a g e n e r a l s o a p f a u l t - - >
< f a u l t n a m e = " S e c u r i t y F a u l t " m e s s a g e = " t n s : S e c u r i t y F a u l t _ M e s s a g e " / >
< f a u l t n a m e = " M e s s a g e T o o L a r g e F a u l t " m e s s a g e = " t n s : M e s s a g e T o o L a r g e F a u l t _ M e s s a g e " / >
< / o p e r a t i o n >
< / p o r t T y p e >
< ! - - S O A P 1 . 2 B i n d i n g - - >
< b i n d i n g n a m e = " c l i e n t _ B i n d i n g _ S o a p 1 2 " t y p e = " t n s : I I S _ P o r t T y p e " >
< s o a p 1 2 : b i n d i n g s t y l e = " d o c u m e n t " t r a n s p o r t = " h t t p : / / s c h e m a s . x m l s o a p . o r g / s o a p / h t t p " / >
< o p e r a t i o n n a m e = " c o n n e c t i v i t y T e s t " >
< s o a p 1 2 : o p e r a t i o n s o a p A c t i o n = " u r n : c d c : i i s b : 2 0 1 1 : c o n n e c t i v i t y T e s t " / >
< i n p u t > < s o a p 1 2 : b o d y u s e = " l i t e r a l " / > < / i n p u t >
< o u t p u t > < s o a p 1 2 : b o d y u s e = " l i t e r a l " / > < / o u t p u t >
< f a u l t n a m e = " U n k n o w n F a u l t " > < s o a p 1 2 : f a u l t u s e = " l i t e r a l " n a m e = " U n k n o w n F a u l t " / > < / f a u l t >
< f a u l t n a m e = " U n s u p p o r t e d O p e r a t i o n F a u l t " > < s o a p 1 2 : f a u l t u s e = " l i t e r a l "
n a m e = " U n s u p p o r t e d O p e r a t i o n F a u l t " / > < / f a u l t >
< / o p e r a t i o n >
< o p e r a t i o n n a m e = " s u b m i t S i n g l e M e s s a g e " >
< s o a p 1 2 : o p e r a t i o n s o a p A c t i o n = " u r n : c d c : i i s b : 2 0 1 1 : s u b m i t S i n g l e M e s s a g e " / >
< i n p u t > < s o a p 1 2 : b o d y u s e = " l i t e r a l " / > < / i n p u t >
< o u t p u t > < s o a p 1 2 : b o d y u s e = " l i t e r a l " / > < / o u t p u t >
< f a u l t n a m e = " U n k n o w n F a u l t " > < s o a p 1 2 : f a u l t u s e = " l i t e r a l " n a m e = " U n k n o w n F a u l t " / > < / f a u l t >
< f a u l t n a m e = " S e c u r i t y F a u l t " > < s o a p 1 2 : f a u l t u s e = " l i t e r a l " n a m e = " S e c u r i t y F a u l t " / > < / f a u l t >
< f a u l t n a m e = " M e s s a g e T o o L a r g e F a u l t " > < s o a p 1 2 : f a u l t u s e = " l i t e r a l "
n a m e = " M e s s a g e T o o L a r g e F a u l t " / > < / f a u l t >
< / o p e r a t i o n >
< / b i n d i n g >
< ! - - S e r v i c e d e f i n i t i o n - - >
< s e r v i c e n a m e = " c d c " >
< p o r t b i n d i n g = " t n s : c l i e n t _ B i n d i n g _ S o a p 1 2 " n a m e = " c l i e n t _ P o r t _ S o a p 1 2 " >
< s o a p 1 2 : a d d r e s s l o c a t i o n = " h t t p : / / l o c a l h o s t / W e b A p p / I I S S e r v i c e " / >
< / p o r t >
< / s e r v i c e >
< / d e f i n i t i o n s >
IOWA Web Service Setup Version 1.1 04142014
20 of 20
Appendix B: URL for OpenSSL
Information about the OpenSSL application is available at the following locations:
• http://www.openssl.org/docs/
• https://en.wikipedia.org/wiki/OpenSSL
• http://slproweb.com/products/Win32OpenSSL.html