This specification is subject to these terms of use. Diese Spezifikation unterliegt diesen Nutzungsbedingungen.
Documentation is available for the following files: Org-eticore-et Org-eticore-payment Org-eticore-cvCertificates Org-eticore-tariff Org-eticore-moticsCopyProtection Org-eticore-ste Org-eticore-um Org-eticore-sam Org-eticore-common

Org-eticore-common

Schema file name: common.asn

Version: 3.0.0-rc.6

Index:

# ActionCounter

Data type for a sequence number that is increased by one every time a SAM authorises an action to be executed with a user medium.

Tag: 0x4A

Type: RESTRICTION

Base type: INTEGER

# Aid

Registered application identifier.

Tag: 0x40

Type: RESTRICTION

Base type: OCTET STRING

Constraint type: SIZE

Constraint range: [5, 16]

# AppInstanceId

ID of an application instance. Structured similar to Subject.

Tag: 0x64

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x4D registrationAuthorityId OrganisationId no Contains the organisation identifier assigned to the registration authority.
0x80 subjectRole OCTET STRING no Contains an octet string assigned by the registration authority.
0x82 subjectNumber OCTET STRING no Contains an octet string assigned by the registration authority.

# AppVersion

Version of the application.

Tag: 0x61

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x4D appProviderId OrganisationId no Identification of the application provider.
0x81 appProviderVersion UTF8String no Version information specific to the provider.
0x82 specVersion SpecVersion no Version of the underlying specification.
0x83 capabilityProfileVersion UTF8String no Version of the capability profile.

# AttestationSignature

A signature value as calculated by a SAM, user medium or motics app.

Tag: 0x9E

Type: RESTRICTION

Base type: OCTET STRING

# CommandApdu

Contains a CommandAPDU.

Tag: 0x52

Type: RESTRICTION

Base type: OCTET STRING

# ConfigurationVersion

This value represents the version of the configuration used by the application.

Tag: 0x5F2E

Type: RESTRICTION

Base type: INTEGER

# DeviceTypeCode

Classifies terminals. See also EN 1545-1:2015: DeviceTypeCode.

Tag: 0x81

Type: RESTRICTION

Base type: EnumMarker

Constraint type: VALUE

Constraint range: [0, 127]

# DeviceTypeEnum

Classifies terminals. See also EN 1545-1:2015: DeviceTypeCode.

Tag: 0x0A

Type: ENUMERATED

Value Identifier Documentation
0 otherwise-specified Otherwise specified
1 registrationTerminal Registration terminal (used for cico/bibo etc.)
2 ticketVendingMachine Ticket vending machine
3 inspectionTerminal Inspection terminal (mobile, operated by staff)
4 customerMediaIssuingTerminal Customer media issuing terminal
5 customerMediaReturnTerminal Customer media return terminal
6 validator Validator / ticket stamper / puncher
7 multiFunctionTerminal Multi function terminal (operated by customer)
8 informationTerminal Information terminal
9 loadingTerminal Loading terminal
13 massPersonaliser Terminal at mass personaliser
14 serviceTerminal Terminal in sales or service center (operated by staff)
15 driverTerminal Driver terminal (sales and inspection)
16 mobileTicketServer Mobile ticket server
17 onlineTicketServer Online ticket server
18 mobileSalesTerminal Mobile sales terminal (operated by customer)
19 mobileSalesAndInspectionTerminal Mobile sales and inspection terminal (operated by staff)

# EntitlementId

Data type for the unique identifier of an entitlement.

Tag: 0x6E

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x4D ccpOrgId OrganisationId no Contains the identifier of the organisation responsible for the entitlement.
0x64 samId AppInstanceId no ID of the issuing SAM.
0x4B entitlementIssuanceCounter EntitlementIssuanceCounter no Contains the value of the EntitlementIssuanceCounter of the issuing SAM at the issuance of the entitlement in question.

# EntitlementIssuanceCounter

Data type for a sequence number that is increased by one every time a SAM authorises the issuance of a (static) entitlement.

Tag: 0x4B

Type: RESTRICTION

Base type: INTEGER

# EnumMarker

Base type for all integer-based enums (marker type).

Tag: 0x02

Type: RESTRICTION

Base type: INTEGER

Constraint type: VALUE

Constraint range: [0, *]

# IndividualisationTime

This element contains the time at which the individualisation data was written.

Tag: 0x5F2D

Type: RESTRICTION

Base type: UnixTime

# KeyReference

Used to identify a key.

Tag: 0x53

Type: RESTRICTION

Base type: OCTET STRING

Constraint type: SIZE

Constraint range: [1, 1]

# LocationId

Unique ID for a location.

Tag: 0x7F69

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x81 locationSchemaType LocationSchemaTypeCode no Identifies the location schema underlying the id string.
0x82 locationIdString UTF8String no Actual identifier for the location using the schema given in location schema type.

# LocationSchemaTypeCode

Identifies the location schema underlying the id string.

Tag: 0x81

Type: RESTRICTION

Base type: EnumMarker

# LocationSchemaTypeEnum

Identifies the location schema underlying the id string.

Tag: 0x0A

Type: ENUMERATED

Value Identifier Documentation
1 eticore Indicates that locationIdString consists of the location type, the location number and the responsible organisation ID, in this order, coded as decimals without leading zeroes, separated by colons (':'). Example: location of type ticketserver (215) with number 234 of organisation 123 is coded as 215:234:123
2 ifopt Indicates that locationIdString comprises a IFOPT compatible location identifier, e.g., a DHID.

# LocationTypeCode

Classifies locations. See also EN 1545-1:2015: LocationTypeCode.

Tag: 0x02

Type: RESTRICTION

Base type: EnumMarker

Constraint type: VALUE

Constraint range: [0, 255]

# LocationTypeEnum

Classifies locations. See also EN 1545-1:2015: LocationTypeCode.

Tag: 0x0A

Type: ENUMERATED

Value Identifier Documentation
0 busStopStation Bus stop station
1 metroStation Metro station
2 railwayStation Railway station
3 tramStopStation Tram stop station
11 retailAgent Retail agent
16 areaId Area ID
17 corridor Corridor
200 generalStop General stop, independent of mode of transport
201 massPersonaliser Mass personaliser
202 areaListId Spatial area
203 inVehicle In vehicle / train
204 touchPoint Touch point
205 inVehicleOfLine In vehicle of line
206 inVehicleOfNumber In vehicle of number
207 partialZone Partial zone
208 neutralZone Neutral zone
209 fareZone Fare zone
210 largeFareZone Large fare zone
211 tariffPoint Tariff point
212 backOffice Back office
213 inVehicleAtStop In vehicle at stop
214 eventLocation Event location
215 ticketServer Ticket server
216 postalCode Postal code
217 globalIdInDE Global ID in DE = DHID
218 globalIdInNL Global ID in NL
219 globalIdInBE Global ID in BE
220 globalIdInLU Global ID in LU
221 globalIdInFR Global ID in FR
222 globalIdInCH Global ID in CH
223 globalIdInAT Global ID in AT
224 globalIdInCZ Global ID in CZ
225 globalIdInPL Global ID in PL
226 globalIdInDK Global ID in DK
251 suburb Suburb / local quarter
252 municipality Municipality
253 county County / rural district
254 state State. may be used to identify a country or a state.
255 unspecified Unspecified

# OrganisationId

Unique identifier of an organisation.

Tag: 0x4D

Type: RESTRICTION

Base type: INTEGER

# OwnerId

Contains the identifier of the organisation (OrgID) currently responsible for the SAM/UM.

Tag: 0x4D

Type: RESTRICTION

Base type: OrganisationId

# PrivateKeyParameters

Contains the parameters of a private key. Only used in the GlobalPlatform command STORE_DATA (with secure messaging) in order to initialise the private keys during individualisation.

Tag: 0x7F6F

Type: SEQUENCE

Tag Element name Type name Optional Documentation
... ... yes

# PrivateKeyWithReference

Contains a key reference to a key pair establishment key and the parameters of the corresponding private key. Only used in the GlobalPlatform command STORE_DATA (with secure messaging) in order to initialise the private keys during individualisation.

Tag: 0x7F6E

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x53 keyReference KeyReference no Contains the value 0x01 for the private key corresponding to PublicKeyUM and 0x02 for the private key corresponding to AlternatePublicKeyUM.
0x7F6F privateKeyParameters PrivateKeyParameters no Contains the parameters of the private key.

# ProductId

Data type for a unique product ID. Consists of the number of the product and the organisation ID of the product owner (PO). Both parts together make the product ID unique across the electronic fare management scheme.

Tag: 0x6C

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x4D orgId OrganisationId no Organisation ID of the product owner.
0x80 productType ProductTypeCode no Product type assigned to the product by the product owner.
0x81 productNumber ProductNumber no Product number assigned to the product by the product owner.

# ProductNumber

Product owner's internal product number. Must be unique together with the organisation ID of the product owner.

Tag: 0x81

Type: RESTRICTION

Base type: INTEGER

# ProductTypeCode

Classifies products.

Tag: 0x80

Type: RESTRICTION

Base type: EnumMarker

# ProductTypeEnum

Classifies products. In the context of EXECUTE_ACTION ProductType may also take the value 0 for "application". In order to map the right to perform an ApplicationUnblockedAttestation to the structure ProductIssuanceRights in the SAM, the data object ProductID will also be used with productOwnerID = ownerID (for the user medium) and productType = 0.

Tag: 0x0A

Type: ENUMERATED

Value Identifier Documentation
1 electronicTicket Electronic ticket
2 interoperableAccountBasedPaymentMethod Interoperable account-based (((ePaymentMethod
3 nonInteroperableAccountBasedPaymentMethod Non-interoperable account-based (((ePaymentMethod for local use
4 interoperableStoredValuePaymentMethod Interoperable stored value (((ePaymentMethod
5 nonInteroperableStoredValuePaymentMethod Non-interoperable stored value (((ePaymentMethod for local use
17 staticElectronicTicket Static electronic ticket

# PuKInfo

Comprises information about a public key represented as a subset of the information contained in a certificate body.

Tag: 0x76

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x7F20 subject Subject no Contains the Subject as in the certificate.
0x7F4C subjectAuthorisation SubjectAuthorisation no Contains the SubjectAuthorisation as in the certificate.
0x5F25 certificateEffectiveTime CertificateEffectiveTime no Contains the CertificateEffectiveTime as in the certificate.
0x5F24 certificateExpirationTime CertificateExpirationTime no Contains the CertificateExpirationTime as in the certificate.
0x7F49 publicKeyParameters PublicKeyParameters no Contains the PublicKeyParameters as in the certificate.

# RootCaKeychain

Contains one or more PuKInfo, each representing a subset of a Root-CA Certificate

Tag: 0x7F30

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[1, *] 0x76 rootCa PuKInfo Contains a subset of a Root-CA Certificate.

# SamActionData

Contains the SAM action data.

Tag: 0x7F6A

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x64 samId AppInstanceId no ID of the SAM.
0x4A samActionCounter ActionCounter no SAM action counter.

# Script

A script is a sequence of CommandAPDUs. It is used to either configure or reset a SAM or User Medium.

Tag: 0x30

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[0, *] 0x52 commandApdu CommandApdu A CommandAPDU that is part of a Script.

# SignatureAlgorithmId

The object identifier of the signature algorithm.

Tag: 0x06

Type: RESTRICTION

Base type: OBJECT IDENTIFIER

# SpecVersion

Version of the underlying specification.

Tag: 0x82

Type: RESTRICTION

Base type: UTF8String

# Subject

This data object contains a name for an entity (e.g. a component) to which the public key contained in the certificate is assigned.

Tag: 0x7F20

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x4D registrationAuthorityId OrganisationId no Contains the Organisation Identifier assigned to the registration authority performing the identification and key management for an entity (e.g. for a device or system).
0x80 subjectRole OCTET STRING no Contains an octet string assigned by the registration authority and identifying a role assigned to the key in the security concept.
0x81 subjectName UTF8String yes Contains a string assigned by the registration authority.
0x82 subjectNumber OCTET STRING yes Contains an octet string assigned by the registration authority.

# SupplementaryCaKeychain

Contains supplementary information about Sub or Root CAs.

Tag: 0x7F2B

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[1, *] 0x76 ca PuKInfo Contains a subset of a Sub or Root CA Certificate.

# SupportedCurves

List of OIDs of named elliptic curves supported for use in Diffie-Hellman key agreement procedures and the generation of ephemeral key pairs.

Tag: 0x7F2C

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[1, *] 0x06 supportedCurve OBJECT IDENTIFIER OID of a named elliptic curve supported for use in Diffie-Hellman key agreement procedures and the generation of ephemeral key pairs.

# SupportedSignatureAlgorithms

List of OIDs of signature algorithms supported for the verification of signatures generated by external entities.

Tag: 0x7F26

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[1, *] 0x06 supportedSignatureAlgorithm SignatureAlgorithmId OID of a signature algorithm supported for the verification of signatures generated by external entities.

# SymmetricKey

Contains information about a symmetric key (pair) and the actual key material.

Tag: 0x7E

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x74 symmetricKeyInfo SymmetricKeyInfo no Information about the symmetric key (pair).
0x04 symmetricKeyMaterial OCTET STRING no For master keys (SAM): the value of the master key associated with the above reference. For enc/mac key pairs (UM): contains the value of the key material. The left half of this string is encKeyData and the right half is macKeyData.

# SymmetricKeyDirectory

Contains information on the symmetric keys stored in the SAM/UM.

Tag: 0x7F2A

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[1, *] 0x74 symmetricKeyInfo SymmetricKeyInfo Contains information about a symmetric key.

# SymmetricKeyInfo

Contains information about a symmetric key.

Tag: 0x74

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x53 keyReference KeyReference no Contains a key reference which indicates the key generation. The value 0x00 may not be used.
0x06 algorithmId OBJECT IDENTIFIER no Contains the OID of the algorithm in which the key is used, e.g. for AES128 or AES256. In this way the UM/SAM can work with keys of different sizes, if needed.

# SymmetricKeys

For each value of KeyReference listed in SymmetricKeyDirectory - the UM stores a corresponding pair of symmetric keys encKey and macKey, each of type OCTET STRING with length depending on the algorithm identified in the corresponding AlgorithmID data object, confidentially in an internal structure SymmetricKeys. - the SAM stores a corresponding value masterKey of type OCTET STRING in an internal structure MasterKey.

Tag: 0x7F38

Type: SEQUENCE OF

Multiplicity Tag Element name Type name Documentation
[1, *] 0x7E symmetricKey SymmetricKey See documentation of SymmetricKeys.

# TerminalId

Data type for a unique terminal ID consisting of terminal type, terminal number and owner ID.

Tag: 0x7F1F

Type: SEQUENCE

Tag Element name Type name Optional Documentation
0x4D orgId OrganisationId no The organisation ID of the terminal owner.
0x81 deviceType DeviceTypeCode no See documentation of the referenced type.
0x82 terminalNumber TerminalNumber no The number of the terminal which, together with the terminal owner ID, forms a unique pair.

# TerminalNumber

Terminal identification number.

Tag: 0x82

Type: RESTRICTION

Base type: INTEGER

# UnixTime

Unix timestamp.

Tag: 0x02

Type: RESTRICTION

Base type: INTEGER