Module ibm.crypto.ibmjcehybrid
Package com.ibm.crypto.ibmjcehybrid.provider

Class HybridRACFInputStream

  • All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable
    public class HybridRACFInputStream
extends java.io.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​(java.lang.String userID, java.lang.String ringID, char[] passwd)
      Constructs an instance of a HybridRACFInputStream.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      char[] getPassword()
      Obtains the password associated with this HybridRACFInputStream.
      java.lang.String getRingid()
      Obtains the keyring name associated with this HybridRACFInputStream.
      java.lang.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 java.io.InputStream

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

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • HybridRACFInputStream

        public HybridRACFInputStream​(java.lang.String userID,
                             java.lang.String ringID,
                             char[] passwd)
                      throws java.io.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:
        java.io.IOException

    • Method Detail

      • getPassword

        public char[] getPassword()
        Obtains the password associated with this HybridRACFInputStream.
        Returns:
        char[] representing the password associated with this HybridRACFInputStream.

      • getUserid

        public java.lang.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 java.lang.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 java.io.InputStream
        Returns:
        int which is always 0.