Package org.eclipse.keypop.calypso.crypto.legacysam.sam

Interface LegacySam

All Superinterfaces:
org.eclipse.keypop.reader.selection.spi.SmartCard
public interface LegacySam extends org.eclipse.keypop.reader.selection.spi.SmartCard
Extends the SmartCard interface of the "Keypop Reader API" to provide additional functionality specific to Calypso legacy SAMs.

An instance of LegacySam is obtained by casting the SmartCard object from the selection process defined by the "Keypop Reader API".

It is a dynamic view of the SAM's content, regularly updated from the selection stage to the end of the transaction.

Since:
0.1.0

  • Method Details

    • getProductType

      LegacySam.ProductType getProductType()
      Returns the SAM product type.
      Returns:
      The identified product type.
      Since:
      0.1.0

    • getProductInfo

      String getProductInfo()
      Returns a text description of the SAM.
      Returns:
      A non-null string.
      Since:
      0.1.0

    • getSerialNumber

      byte[] getSerialNumber()
      Returns the SAM serial number as a byte array.
      Returns:
      A non-null byte array.
      Since:
      0.1.0

    • getPlatform

      byte getPlatform()
      Returns the platform identifier.
      Returns:
      A byte.
      Since:
      0.1.0

    • getApplicationType

      byte getApplicationType()
      Returns the application type.
      Returns:
      A byte.
      Since:
      0.1.0

    • getApplicationSubType

      byte getApplicationSubType()
      Returns the application subtype.
      Returns:
      A byte.
      Since:
      0.1.0

    • getSoftwareIssuer

      byte getSoftwareIssuer()
      Returns the software issuer identifier.
      Returns:
      A byte.
      Since:
      0.1.0

    • getSoftwareVersion

      byte getSoftwareVersion()
      Returns the software version number.
      Returns:
      A byte.
      Since:
      0.1.0

    • getSoftwareRevision

      byte getSoftwareRevision()
      Returns the software revision number.
      Returns:
      A byte.
      Since:
      0.1.0

    • getCounter

      Integer getCounter(int counterNumber)
      Returns the value of a counter.
      Parameters:
      counterNumber - The number of the counter (in range [0..26]).
      Returns:
      Null if the counter value is not set.
      Since:
      0.1.0

    • getCounters

      SortedMap<Integer,Integer> getCounters()
      Returns the value of known counters in a sorted map where key is the counter number and value is the counter value.
      Returns:
      A non-null map.
      Since:
      0.1.0

    • getCounterIncrementAccess

      CounterIncrementAccess getCounterIncrementAccess(int counterNumber)
      Returns the counter increment access mode.
      Parameters:
      counterNumber - The number of the counter being checked.
      Returns:
      Null if the counter increment access is unknown.
      Since:
      0.2.0

    • getCounterCeiling

      Integer getCounterCeiling(int counterNumber)
      Returns the value of a counter ceiling.
      Parameters:
      counterNumber - The number of the counter ceiling (in range [0..26]).
      Returns:
      Null if the counter ceiling value is not set.
      Since:
      0.1.0

    • getCounterCeilings

      SortedMap<Integer,Integer> getCounterCeilings()
      Returns the value of known counter ceilings in a sorted map where key is the ceiling number and value is the ceiling value.
      Returns:
      A non-null map.
      Since:
      0.1.0

    • getSystemKeyParameter

      KeyParameter getSystemKeyParameter(SystemKeyType systemKeyType)
      Returns the parameters of the system key whose type is provided.
      Parameters:
      systemKeyType - The type of system key.
      Returns:
      Null if there is no parameter available for the specified key type.
      Since:
      0.2.0

    • getCaCertificate

      byte[] getCaCertificate()
      Gets the CA certificate retrieved from the SAM as a 384-byte byte array.
      Returns:
      null if the CA certificate is not available.
      Since:
      0.5.0
      See Also: