Class HybridRACFInputStream

java.lang.Object

java.io.InputStream

com.ibm.crypto.ibmjcehybrid.provider.HybridRACFInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class HybridRACFInputStream
extends InputStream

This class extends the InputStream class and is for use by the JCEHYBRIDRACFKS keystore to read certificates and private keys from RACF.

Constructor Summary

Constructors

Constructor	Description
HybridRACFInputStream(String userID, String ringID, char[] passwd)	Constructs an instance of a HybridRACFInputStream.

Method Summary

Modifier and Type	Method	Description
char[]	getPassword()	Obtains the password associated with this HybridRACFInputStream.
String	getRingid()	Obtains the keyring name associated with this HybridRACFInputStream.
String	getUserid()	Obtains the userid associated with the instance of this HybridRACFInputStream class.
int	read()	This method always returns 0 since no data is actually being read.

Methods inherited from class InputStream

available, close, mark, markSupported, nullInputStream, read, read, readAllBytes, readNBytes, readNBytes, reset, skip, skipNBytes, transferTo

Methods inherited from class Object

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

Constructor Details

HybridRACFInputStream

public HybridRACFInputStream(String userID,
 String ringID,
 char[] passwd)
                      throws IOException

Constructs an instance of a HybridRACFInputStream. A HybridRACFInputStream is used to access certificates and keys from a RACF Key Ring for use with the JCEHYBRIDRACFKS keystore type. If null is specified for the userID value the method defaults to use the userid associated with the callers address space.

Parameters:

userID - a string containing the ID of the user that owns the keyring. If null is specified for the userID value the method defaults to use the userid associated with the callers address space.

ringID - a string containing the name of the RACF key ring.

passwd - a character array containing the password for the keystore. This parameter will also be the password associated with each key entry within the keystore. If null is specified for this parameter the password will default to the value "password".

Throws:

IOException

Method Details

getPassword

public char[] getPassword()

Obtains the password associated with this HybridRACFInputStream.

Returns:

char[] representing the password associated with this HybridRACFInputStream.

getUserid

public String getUserid()

Obtains the userid associated with the instance of this HybridRACFInputStream class. Specifically the userid returned represents the userid specified on the constructor to this class.

If null was passed as the userid to the constructor of this class then the userid of the calling address space is by default used by RACF services to fetch keys and certificates. This method will still return null in this case.

Returns:

String representing the userid associated with this HybridRACFInputStream.

getRingid

public String getRingid()

Obtains the keyring name associated with this HybridRACFInputStream.

Returns:

String representing the keyring name associated with this HybridRACFInputStream.

read

public int read()

This method always returns 0 since no data is actually being read.

Specified by:

read in class InputStream

Returns:

int which is always 0.