oracle.security.crypto.cryptoki

Class CkiSOSession

java.lang.Object

oracle.security.crypto.cryptoki.CkiSOSession

public class CkiSOSession
extends java.lang.Object

A CkiSOSession object represents a PKCS #11 SO Session on a token.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CkiSOSession(CkiSlot ckiSlot, java.lang.String pinSO) Creates a CkiSession on the slot using the SO pin.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the current connection.
void	finalize()
CkiSlot	getCkiSlot() Returns the slot corresponding to this session.
static CkiSOSession	getInstance(CkiSlot ckiSlot, java.lang.String pinSO) Creates a new instance of CkiSession on the specified slot.
void	initPin(java.lang.String pin) Sets the USER password.
boolean	isClosed() Says if the session is still opened (false) or closed (true).
void	login(java.lang.String pinSO) Performs a login procedure on the current token..
void	logout() Performs a logout from the current token.
void	setPin(java.lang.String oldPin, java.lang.String pin) Changes the SO pin with the new password.

Methods inherited from class java.lang.Object

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

Constructor Detail

CkiSOSession

protected CkiSOSession(CkiSlot ckiSlot,
                       java.lang.String pinSO)
                throws CryptokiException

Creates a CkiSession on the slot using the SO pin.

Parameters:

ckiSlot - The slot where the session will be opened.

pinSO - The SO pin

Throws:

CryptokiException

Method Detail

getInstance

public static CkiSOSession getInstance(CkiSlot ckiSlot,
                                       java.lang.String pinSO)
                                throws CryptokiException

Creates a new instance of CkiSession on the specified slot.

Parameters:

ckiSlot - The CkiSlot object representing the slot where the session will be opened.

Throws:

CryptokiException

close

public void close()
           throws CryptokiException

Closes the current connection.

Throws:

CryptokiException

login

public void login(java.lang.String pinSO)
           throws CryptokiException

Performs a login procedure on the current token..

Throws:

CryptokiException

logout

public void logout()
            throws CryptokiException

Performs a logout from the current token.

Throws:

CryptokiException

isClosed

public boolean isClosed()

Says if the session is still opened (false) or closed (true).

Returns:

A boolean representing the state of the connection.

getCkiSlot

public CkiSlot getCkiSlot()

Returns the slot corresponding to this session.

Returns:

The CkiSlot of this CkiSession object.

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

initPin

public void initPin(java.lang.String pin)
             throws CryptokiException

Sets the USER password.

Parameters:

pin - The new USER password.

Throws:

CryptokiException

setPin

public void setPin(java.lang.String oldPin,
                   java.lang.String pin)
            throws CryptokiException

Changes the SO pin with the new password.

Parameters:

oldPin - The old password

pin - The new password

Throws:

CryptokiException