iaik.tc.tss.impl.java.tsp
Class TcAuthObject

java.lang.Object
  iaik.tc.tss.impl.java.tsp.TcAttributes
      iaik.tc.tss.impl.java.tsp.TcWorkingObject
          iaik.tc.tss.impl.java.tsp.TcAuthObject

All Implemented Interfaces:

TcIAttributes, TcIAuthObject, TcIWorkingObject

Direct Known Subclasses:

TcEncData, TcMonotonicCtr, TcNvRam, TcRsaKey, TcTpm

public abstract class TcAuthObject
extends TcWorkingObject
implements TcIAuthObject

This class implements common methods for all auth objects. That are all those working objects that require authorization to be used. Amon those objects are e.g. the TPM, key or EncData objects.

Method Summary

void	changeAuthAsym(TcIAuthObject parentObject, TcIRsaKey identKey, TcIPolicy newPolicy) This method changes the authorization data (secret) of an entity (object) utilizing the asymmetric change protocol and assigns the object to the newPolicy object.
TcIPolicy	getPolicyObject(long policyType) Note: Policy objects are returned by reference.
TcIPolicy	getUsagePolicyObject() Note: Policy objects are returned by reference.

Methods inherited from class iaik.tc.tss.impl.java.tsp.TcAttributes

getAttribData, getAttribUint32, setAttribData, setAttribUint32

Methods inherited from class java.lang.Object

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

Methods inherited from interface iaik.tc.tss.api.tspi.TcIAuthObject

changeAuth

Method Detail

changeAuthAsym

public void changeAuthAsym(TcIAuthObject parentObject,
                           TcIRsaKey identKey,
                           TcIPolicy newPolicy)
                    throws TcTssException

Description copied from interface: TcIAuthObject

This method changes the authorization data (secret) of an entity (object) utilizing the asymmetric change protocol and assigns the object to the newPolicy object. All classes using secrets provide this method for changing their authorization data. This method changes the authorization data of an object ensuring that the parent of the object does not get knowledge of the new secret.

Specified by:

changeAuthAsym in interface TcIAuthObject

Parameters:

parentObject - The parent object wrapping this object

identKey - The identity key object required to proof the internally created temporary key.

newPolicy - The policy object providing the new authorization data.

Throws:

TcTssException

getPolicyObject

public TcIPolicy getPolicyObject(long policyType)
                          throws TcTssException

Note: Policy objects are returned by reference. Keep that in mind when modifying a policy. For general documentation of this method refer to TcIAuthObject.getPolicyObject(long).

Specified by:

getPolicyObject in interface TcIAuthObject

Parameters:

policyType - The policy type to be returned (TSS_POLICY_*)

Returns:

Policy object currently assigned to the object.

Throws:

TcTssException

getUsagePolicyObject

public TcIPolicy getUsagePolicyObject()
                               throws TcTssException

Note: Policy objects are returned by reference. Keep that in mind when modifying a policy. For general documentation of this method refer to TcIAuthObject.getUsagePolicyObject().

Specified by:

getUsagePolicyObject in interface TcIAuthObject

Returns:

Usage policy object.

Throws:

TcTssException