AUTOSAR Classic Crypto Services

Notifies the CRYIF about the completion of the request with the result of the cryptographic operation.

This interface dispatches the job cancellation function to the configured crypto driver object.

Returns the version information of this module.

Initializes the CRYIF module. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_CryptoInterface

This function shall co py all key elements from the source key to a target key.

This function shall dispatch th e key derive function to the configured crypto driver object.

Service CryIf_KeyElementCopy.

Service CryIf_KeyElementCopyPartial.

This function shall dispatch the get key ele ment function to the configured crypto driver object.

This function shall dispatch the set key element function to the configured crypto driver object.

This function shall dispatch the key exchange public value calculation function to the configured crypto driver object. Available

This function shall dispatch the key exchange common shared secret calculation function to the configured crypto driver object.

This function shall dispatch the key generate function to the configured crypto driver object.

Returns the key state of the key identified by cry If Key Id.

Sets invalid for the status of the key identifi ed by cry If Key Id.

This function shall dispatch the set key valid function to the configured crypto driver object.

Service CryIf_ProcessJob.

This function shall dispatch the random seed function to the configured crypto driver object.

Configuration data structure of Cry If module

This interface removes the provided job from the queue and cancels the processing of the job if possible.

Returns the version information of this module.

Initializes the Crypto Driver.

Copies a key with all its elements to another key in the same crypto driver. Note: If the actual key element is directly mapped to flash memory, there could be a bigger delay when calling this function (synchronous operation)

Derives a new key by using the key elements in the given key identified by the crypto Key Id. The given key contains the key elements for the password, salt. The derived key is stored in the key element with the id 1 of the key identified by target Crypto Key Id. The number of iterations is given in the key element CRYPTO_ KE_ KEYDERIVATION_ ITERATIONS.

Service Crypto_KeyElementCopy.

Service Crypto_KeyElementCopyPartial.

This interface shall be used to get a key element of the key identified by the crypto

Used to retrieve information which key elements are available in a given key.

Sets the given key element bytes to the key identified by crypto Key Id.

Calculates the public value for the key exchange a nd stores the public key in the memory location pointed by the public value pointer.

Calculates the shared secret key for the key exchange with the key material of the key identified by the crypto Key Id and the partner public key. The shared secret key is stored as a key element in the same key.

Generates new key material store it in the key identified by crypto Key Id.

Returns the key state of the key identified by crypto Key Id.

Sets invalid for the status of the key identifi ed by crypto Key Id.

Sets the key state of the key identified by crypto Key Id to valid.

If asynchronous job processing is configured and there are job queues, the function is called cyclically to process queued jobs. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_CryptoDriver

Service Crypto_ProcessJob.

This function generates the internal seed state using the pro vided entropy source. Furthermore, this function can be used to update the seed state with new entropy

Configuration data structure of Cry If module

CSM notifies the application that a job has finished. The function name is configurable. The function name itself is derived from "{CSM Job/ CSM Job Primitive Callback Ref}/CSM Callback Func".

Service Csm_AEADDecryptManager.

Service Csm_AEADEncrypt.

Notifies the CSM that a job has finished. This function is used by the underlying layer (CRYIF).

Cancels the job processing from asynchronous or streaming jobs .

Service Csm_Decrypt.

Service Csm_Encrypt.

Returns the version information of this module.

Uses the given data to perform the hash calculation and stores the hash.

Initializes the CSM module. In configurations, in which CSM is assigned to more than one partition (i.e. Csm_ Main Functions are mapped to partitions), CSM may provide one init function per partition.

Derives a new key by using the key elements in the given key identified by the key Id. The given key contains the key elements for the password and salt. The derived key is stored in the key element with the id 1 of the key identified by target Crypto

Calculates the public value of the current user for the key exchange and stores the

Calculates the shared secret key for the key exchange with the key material of the key identified by the key Id and the partner public key. The shared secret key is stored as a key element in the same key.

Generates new key material and stores it in the key identified by key Id.

Sets the key status to invalid. The key cannot be used any longer for cryptographic operations until it has been set to valid state again.

Stores the key if necessary and sets the key state of the key identified by key Id to valid.

Provides a new seed for the specified key that is used for an associated random number generator.

This function shall copy all key elements from the source key to a target key. Ava ilable via Csm.h

Derives a new key by using the key elements in the given key identified by the key Id. The given key contains the key elements for the password and salt. The derived key is stored in the k ey element with the id 1 of the key identified by target Crypto Key Id.

Service Csm_KeyElementCopyManager.

Service Csm_KeyElementCopyPartial.

Service Csm_KeyElementGet.

Sets the given key element bytes to the key identified by key Id.

Calculates the public value of the current user for the key exchange and stores the pub lic key in the memory location pointed by the public value pointer.

Calculates the shared secret key for the key exchange with the key material of the key identified by the key Id and the partner public key. The shared secret key is stored as a key element in the same key.

Generates new key material and store it in the key identified by key Id.

Returns the key state of the key identified by key Id.

Sets the key status to invalid. The key cannot be used any longer for cryptographic operations until it has been set to valid state again.

Sets the key state of the key identified by key Id to valid.

Service Csm_MacGenerate.

Service Csm_MacVerify.

API to be called cyclically to process the requested jobs. The Csm_ Main Function shall check the queues for jobs to pass to the underlying CRYIF. Per configured CSM Main Function ins tance one Csm_ Main Function_ shall be implemented. Hereby is the short name of the CSM Main Function configuration container in the ECU configuration.

Generate a random number and stores it in the memory location pointed by th e result pointer.

Feeds the key element CRYPTO_ KE_ RANDOM_ SEED with a random seed. Manager AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_CryptoServiceManager

The Crypto Driver extracts the context data from the context Buffer and restores the internal state so that further crypto operation of this crypto service will continue at the exact point when the context was taken.

The Crypto Driver stores the internal context of the respective crypto operation to the context Buffer.

Service Csm_SignatureGenerate.

Service Csm_SignatureVerify.

Type Crypto_AlgorithmFamilyType.

Structure which determines the exact algorithm. Note, not every algorithm needs to specify all fields. AUTOSAR shall only allow valid combinations.

Type Crypto_AlgorithmModeType.

Defines which of the input/ output parameters are re - directed to a key element. The values can be combined to define a bit field.

Structure which contains further information, which depends on the job and the crypto primitive.

Type Crypto_JobPrimitiveInputOutputType.

Type Crypto_JobRedirectionInfoType.

Enumeration of the current job state.

Structure which contains further information, which depends on the job and the crypto primitive.

Enumeration for key status.

Enume ration which operation shall be performed. This enumeration is constructed from a bit mask, where the first bit indicates "Start", the second "Update" and the third "Finish".

Structure which contains basic information about the crypto primitive. Manager AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_CryptoServiceManager

Enumeration of the processing type.

Return for Std_ Return Type for Cryptostack.

Enumeration of the kind of the service.

Enumeration of the result type of verification operations.

Array long enough to store the data of the header.

Array long enough to store the ciphertext to be decrypted with AEAD.

Array long enough to store the data of the plaintext.

Array long enough to store the data of the Tag.

Array long enough to store the data of the header.

Array long enough to store the data of the cipher.

Array long enough to store the plaintext to be encrypted with AEAD.

Array long enough to store the data of the Tag.

Identification of a CSM service configuration via a numeric identifier, that is unique within a service. The name of a CSM service configuration, i.e. the name of the container Csm_Config, shall serve as a symbolic name for this parameter Avail able via Csm.h

Configuration data structure of CSM module

Array long enough to store the data to be decrypted.

Array long enough to store the data of the decrypted plaintext.

Array long enough to store the data to be encrypted.

Array long enough to store the data of the cipher.

Array long enough to store the data which shall be hashed.

Array long enough to store the data of the hash.

Array long enough to store any key element of the considered key

Implementation Data Type of category DATA_ REFERENCE with the pointer target uint32 to be able to return asynchronously the length.

Array long enough to store the data from which a MAC shall be generated.

Array long enough to store the data of the MAC.

Array long enough to store a MAC to be verified.

Array long enough to store the data for whichs MAC shall be verified.

Array long enough to store the data of the random number.

Array long enough to store the data from which the signature shall be generated.

Array long enough to store the signature and its length.

Array long enough to store a signature to be verified.

Array long enough to store the data for whichs signature shall be verified.

Implementation Data Type of category DATA_ REFERENCE with the pointer target Csm_ Verify Result Type to be able to return asynchronously the verify result.