org.openhealthtools.ihe.atna.nodeauth.handlers

Class TLSEnabledSocketHandler

java.lang.Object

org.openhealthtools.ihe.atna.nodeauth.handlers.AbstractSecureSocketHandler

org.openhealthtools.ihe.atna.nodeauth.handlers.TLSEnabledSocketHandler

All Implemented Interfaces:

SocketHandler

public class TLSEnabledSocketHandler
extends AbstractSecureSocketHandler

Implementation of the Node Authentication's SocketHandler to create of sockets secured using Transport Layer Security version 1. The TLS-enabled Socket Handler constructs sockets using a specified keystore, truststore, and cipher suite via a SecurityDomain. These settings are used to mututally-authenticate and negotiate the parties involved in the transaction. This handler implements the IHE ITI-19 Node Authentication transaction. To access this handler, use NodeAuthModule.getContext().getSocketHandler().

Author:

Glenn Deen, Rick Stevens, Sondra Renly, Matthew Davis

See Also:

SocketHandler

Field Summary

Fields inherited from class org.openhealthtools.ihe.atna.nodeauth.handlers.AbstractSecureSocketHandler

CONTEXT

Constructor Summary

Constructors

Constructor and Description
TLSEnabledSocketHandler(NodeAuthModuleContext context) Default constructor for the TLS-enabled Socket Handler

Method Summary

Modifier and Type	Method and Description
protected SSLSocket	createSecureSocket(String host, int port, SecurityDomain securityDomain, Socket nestedSocket) Creates a TLS-enabled secure socket for a given URI and SecurityDomain configuration
InputStream	getInputStream(URI uri) Negotiates and creates a socket for a given URI and returns the InputStream associated with the socket.
InputStream	getInputStream(URI uri, SecurityDomain securityDomain) TODO: To be removed in the 2009 post-Connectathon Branch

Methods inherited from class org.openhealthtools.ihe.atna.nodeauth.handlers.AbstractSecureSocketHandler

createSocket, createSocketFromFactory, getSocket, getSocket, getSocket, getSocket, getSocket

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TLSEnabledSocketHandler

public TLSEnabledSocketHandler(NodeAuthModuleContext context)

Default constructor for the TLS-enabled Socket Handler

Parameters:

context - The NodeAuth Module Context to use

Method Detail

createSecureSocket

protected SSLSocket createSecureSocket(String host,
                                       int port,
                                       SecurityDomain securityDomain,
                                       Socket nestedSocket)
                                throws NoSecurityDomainException,
                                       NoSuchAlgorithmException,
                                       KeyManagementException,
                                       UnknownHostException,
                                       IOException

Description copied from class: AbstractSecureSocketHandler

Creates a TLS-enabled secure socket for a given URI and SecurityDomain configuration

Specified by:

createSecureSocket in class AbstractSecureSocketHandler

Parameters:

host - Host to connect to

port - Port to connect to

securityDomain - Configuration options to use when securing the socket

Returns:

A socket secured using TLS for a given URI and SecurityDomain

Throws:

NoSecurityDomainException

NoSuchAlgorithmException

KeyManagementException

UnknownHostException

IOException

getInputStream

public InputStream getInputStream(URI uri,
                                  SecurityDomain securityDomain)
                           throws NoSecurityDomainException,
                                  MalformedURLException,
                                  IOException,
                                  NoSuchAlgorithmException

TODO: To be removed in the 2009 post-Connectathon Branch

Parameters:

uri - The URI for which to open the socket

securityDomain - Security Domain config to use in securing the socket

Returns:

An InputStream for reading from the socket

Throws:

NoSecurityDomainException

MalformedURLException

IOException

NoSuchAlgorithmException

getInputStream

public InputStream getInputStream(URI uri)
                           throws Exception

Description copied from interface: SocketHandler

Negotiates and creates a socket for a given URI and returns the InputStream associated with the socket. If a "secure" URI is given (e.g. HTTPS), then a secure socket is created using the implementation's security mechanism.

Parameters:

uri - The URI for which to open the socket

Returns:

An InputStream for reading from the socket

Throws:

Exception