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 Detail

      • getProductType

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

      • getProductInfo

        java.lang.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

        java.lang.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

        java.util.SortedMap<java.lang.Integer,​java.lang.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

        java.lang.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

        java.util.SortedMap<java.lang.Integer,​java.lang.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