OpenTestSystem.Otx.Extensions.ComInterface.Actions.TlsSetCertificate Class Reference

Set one or more certificate chains to the D-PDU API More...

Inheritance diagram for OpenTestSystem.Otx.Extensions.ComInterface.Actions.TlsSetCertificate:

Public Attributes
ListTerm	certificates
	Cardinality [1] A list of list of ByteField represents a Buffer holding the data formatted with DER certificate encoding of all certificate chains. More...
ComInterfaceVariable	comInterface
	Cardinality [1] Represents the handle of the communication interface on which the certificate should be set. More...
Public Attributes inherited from OpenTestSystem.Otx.Core.Actions.ActionRealisation
OtxLink	validFor
	Cardinality [0..1] Validity of ActionRealisation. More...

Detailed Description

Set one or more certificate chains to the D-PDU API

The TlsSetCertificate action can be used to set one or more certificate chains to the D-PDU API.

For the server (ECU) based TLS authentication, at least the availability of the root certificate of the CA which issued the DoIP entity certificate shall be required to check the authenticity of the DoIP entity.

Note

NOTE - The appropriate MVCI system operation is MCDInterface::execIOCtrl(PDU_IOCTL_TLS_SET_CERTIFICATE).

NOTE - In case of secured DoIP communication, the action must be invoked before the PDUConnect() for the ComLogicalLink on the related MVCI module.

NOTE - For connected ComLogicalLinks, calling this action or changing any other TLS related ComParam will have no effect on the ComLogicalLink state. Any changed security information will be applied only when the ComLogicalLink is connected with PDUConnect().

Exceptions

Exceptions.TLSException

If setting the TLS certificate failed. In the case of an MVCI System, this happens if the return value of the related IOCtrl is one of the following values: PDU_ERR_PDUAPI_NOT_CONSTRUCTED D-PDU API has not been constructed before PDU_ERR_COMM_PC_TO_VCI_FAILED Communication between host and MVCI protocol module failed PDU_ERR_INVALID_HANDLE Invalid MVCI protocol module Handle or ComLogicalLink handle PDU_ERR_MODULE_NOT_CONNECTED MVCI protocol module has not been connected PDU_ERR_FCT_FAILED Function call failed

Core.Exceptions.InvalidReferenceException

If the ComInterface variable is uninitialized, or if the interface has been freed by a CloseComInterface action.

Checker rules

CheckerRule.ComInterface_Chk001 - Correct list type for TlsSetCertificate

Syntax

ComInterface.TlsSetCertificate(ComInterfaceVariable comInterface, ListTerm certificates);

Member Data Documentation

certificates

ListTerm OpenTestSystem.Otx.Extensions.ComInterface.Actions.TlsSetCertificate.certificates

Cardinality [1]
A list of list of ByteField represents a Buffer holding the data formatted with DER certificate encoding of all certificate chains.

comInterface

ComInterfaceVariable OpenTestSystem.Otx.Extensions.ComInterface.Actions.TlsSetCertificate.comInterface

Cardinality [1]
Represents the handle of the communication interface on which the certificate should be set.