Module ibm.crypto.hdwrcca

Package com.ibm.crypto.hdwrCCA.provider

Class RACF

java.lang.Object

com.ibm.crypto.hdwrCCA.provider.RACF

public class RACF
extends java.lang.Object

This class represents a RACF object which contains the contents of a keyring. This class is an interface to the JNI code for performing the key ring reading and storing the records.

Field Summary

Fields

Modifier and Type	Field	Description
boolean	debug
static boolean	IsAvailable
static int	RACF_CERTAUTH
static int	RACF_DH_KEY
static int	RACF_DSA_KEY
static int	RACF_ICSF_KEY
static int	RACF_PCICC_KEY
static int	RACF_PERSONAL
static int	RACF_PKDS_ECC_KEY
static int	RACF_SOFTWARE_ECC_KEY
static int	RACF_SOFTWARE_KEY
static int	RACF_TKDS_DSA_KEY
static int	RACF_TKDS_ECC_KEY
static int	RACF_TKDS_RSA_KEY

Constructor Summary

Constructors

Constructor	Description
RACF()	Constructor

Method Summary

Modifier and Type	Method	Description
java.util.Hashtable<java.lang.String,RACFObject>	getRACFHashtable()	Return the hash table which contains the key ring records.
int	getRecords(java.lang.String userid, java.lang.String alias, java.lang.String ringid)	Get the records from the key ring.
boolean	isTrusted(java.lang.String userid, java.lang.String ringid, byte[] cert)	Check if the certificate is trusted.
int	putRecords(RACFResults results, byte[] useridbytes, byte[] ringidbytes, int numDeleteRecords, int numPutRecords, byte[] recordsbytes)	Put the records into the key ring.
void	setDebug(boolean dbg)	Turn tracing on or off for the native methods.
void	TestLibrary()	Test if the DLL for reading the keyring is available.

Methods inherited from class java.lang.Object

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

Field Detail

RACF_SOFTWARE_KEY

public static final int RACF_SOFTWARE_KEY

See Also:

Constant Field Values

RACF_ICSF_KEY

public static final int RACF_ICSF_KEY

See Also:

Constant Field Values

RACF_PCICC_KEY

public static final int RACF_PCICC_KEY

See Also:

Constant Field Values

RACF_DSA_KEY

public static final int RACF_DSA_KEY

See Also:

Constant Field Values

RACF_DH_KEY

public static final int RACF_DH_KEY

See Also:

Constant Field Values

RACF_SOFTWARE_ECC_KEY

public static final int RACF_SOFTWARE_ECC_KEY

See Also:

Constant Field Values

RACF_PKDS_ECC_KEY

public static final int RACF_PKDS_ECC_KEY

See Also:

Constant Field Values

RACF_TKDS_RSA_KEY

public static final int RACF_TKDS_RSA_KEY

See Also:

Constant Field Values

RACF_TKDS_ECC_KEY

public static final int RACF_TKDS_ECC_KEY

See Also:

Constant Field Values

RACF_TKDS_DSA_KEY

public static final int RACF_TKDS_DSA_KEY

See Also:

Constant Field Values

RACF_CERTAUTH

public static final int RACF_CERTAUTH

See Also:

Constant Field Values

RACF_PERSONAL

public static final int RACF_PERSONAL

See Also:

Constant Field Values

IsAvailable

public static boolean IsAvailable

debug

public boolean debug

Constructor Detail

RACF

public RACF()

Constructor

Method Detail

TestLibrary

public void TestLibrary()

Test if the DLL for reading the keyring is available.

getRecords

public int getRecords(java.lang.String userid,
                      java.lang.String alias,
                      java.lang.String ringid)

Get the records from the key ring.

Parameters:

userid - the userid of the key ring owner

alias - the name of the certificate to be retrieved

ringid - the key ring to read

putRecords

public int putRecords(RACFResults results,
                      byte[] useridbytes,
                      byte[] ringidbytes,
                      int numDeleteRecords,
                      int numPutRecords,
                      byte[] recordsbytes)

Put the records into the key ring.

Parameters:

results - the results are written back to this object

useridbytes - the userid of the key ring owner

ringidbytes - the key ring to write

numDeleteRecords - number of delete records

numPutRecords - number of put records

recordsbytes - containing certificates and keys to write to RACF

isTrusted

public boolean isTrusted(java.lang.String userid,
                         java.lang.String ringid,
                         byte[] cert)

Check if the certificate is trusted.

Parameters:

userid - the userid of the key ring owner

ringid - the key ring which contains the certificate

cert - the certificate to be checked for trust status

getRACFHashtable

public java.util.Hashtable<java.lang.String,RACFObject> getRACFHashtable()

Return the hash table which contains the key ring records.

Returns:

the key ring entries

setDebug

public void setDebug(boolean dbg)

Turn tracing on or off for the native methods.

Parameters:

dbg - true to turn tracing on and false to turn it off