Commit 914d58be authored by ASN.1 Checker's avatar ASN.1 Checker
Browse files

Documentation update

parent 86ffbfe7

docs/EtsiTs103759Core.md

+66 −16
Original line number Diff line number Diff line 
# <a name="EtsiTs103759Core"></a>ASN.1 module EtsiTs103759Core

OID: _{itu-t(0) identified-organization(4) etsi(0) itsDomain(5) wg5(5) ts(103759) general(1) core(1) major-version-1(1) minor-version-1(1)}_

OID: _{itu-t(0) identified-organization(4) etsi(0) itsDomain(5) wg5(5) ts(103759) general(1) core(1) major-version-2(2) minor-version-1(1)}_



## Imports:

* **[EtsiTs103097Module](EtsiTs103097Module.md)** *{itu-t(0) identified-organization(4) etsi(0) itsDomain(5) wg5(5) secHeaders(103097) core(1) major-version-3(3) minor-version-1(1)} WITH SUCCESSORS*<br/>
@@ -10,8 +10,52 @@ OID: _{itu-t(0) identified-organization(4) etsi(0) itsDomain(5) wg5(5) ts(103759 
* **[SaeJ3287AsrBsm](SaeJ3287AsrBsm.md)** *{joint-iso-itu-t(2) country(16) us(840) organization(1) sae(114566) v2x-communications(1) technical-committees(1) v2x-security(4) technical-reports(1) misbehavior-reporting(1) asn1-module(1) aid-specific(2) bsm(32) major-version-1(1) minor-version-0(0)} WITH SUCCESSORS*<br/>

## Data Elements:

### <a name="EtsiTs103759Data"></a>EtsiTs103759Data

This data type is the general PDU for a misbehaviour report from an 

 ITS-S to the MA responsible for reports of that type.

This data type is the top level PDU for a misbehaviour report from an ITS

 station to the Misbehaviour Authority (MA) responsible for reports of that

 type.



Fields:

* _version_ of type [**Uint8**](Ieee1609Dot2BaseTypes.md#Uint8) (3)<br>

  contains the version number of this PDU definition. 



* _content_ of type [**EtsiTs103759MbrSec**](#EtsiTs103759MbrSec) <br>

  contains the security encapsulated misbehaviour report.

   



```asn1

EtsiTs103759Data ::= SEQUENCE {

  version Uint8(3),

  content EtsiTs103759MbrSec

}

```



### <a name="EtsiTs103759MbrSec"></a>EtsiTs103759MbrSec

This data type is the security encapsulation for [**EtsiTs103759Mbr**](#EtsiTs103759Mbr).



Fields:

* _plaintext_ of type [**EtsiTs103759Mbr**](#EtsiTs103759Mbr) <br>

  contains the report in the plaintext form, i.e., without

   any security encapsulation.



* _signed_ of type [**EtsiTs103759Mbr-Signed**](#EtsiTs103759Mbr-Signed) <br>

  contains the report in the signed form.



* _sTE_ of type [**EtsiTs103759Mbr-STE**](#EtsiTs103759Mbr-STE) <br>

  contains the report in the signed-then-encrypted form.

   



```asn1

EtsiTs103759MbrSec ::= CHOICE {

  plaintext EtsiTs103759Mbr,

  signed    EtsiTs103759Mbr-Signed,

  sTE       EtsiTs103759Mbr-STE,

  ...

}

```



### <a name="EtsiTs103759Mbr"></a>EtsiTs103759Mbr

This data type is the container for the generation time, observation

 location and the AID-specific misbehaviour report. 



 AID-specific modules (EtsiTs103759AsrAppAgnostic, EtsiTs103759AsrCam, 

 EtsiTs103759AsrDenm, SaeJ3287AsrBsm) have been imported using `WITH SUCCESSORS`
@@ -20,10 +64,6 @@ This data type is the general PDU for a misbehaviour report from an 
 these AID-specific modules shall have minor-version greater than `0`.



Fields:

* _version_ of type [**Uint8**](Ieee1609Dot2BaseTypes.md#Uint8) <br>

  contains the version number of this PDU definition. For this

   version of this data type it shall be equal to `2`.



* _generationTime_ of type [**Time64**](Ieee1609Dot2BaseTypes.md#Time64) <br>

  contains information on when this PDU was generated.
@@ -36,27 +76,37 @@ Fields: 
   



```asn1

EtsiTs103759Data ::= SEQUENCE {

  version              Uint8,

EtsiTs103759Mbr ::= SEQUENCE {

  generationTime       Time64, 

  observationLocation  ThreeDLocation, 

  report               AidSpecificReport 

}

```



### <a name="EtsiTs103759Data-SignedAndEncrypted-Unicast"></a>EtsiTs103759Data-SignedAndEncrypted-Unicast

This structure is the SPDU used to send a signed and encrypted 

 [**EtsiTs103759Data**](#EtsiTs103759Data) to the MA.

### <a name="EtsiTs103759Mbr-Signed"></a>EtsiTs103759Mbr-Signed

This data type is used for the option signed of security encapsulation of

 the report.



 For the signature to be valid the signing certificate shall conform to the

 authorization ticket profile given in clause 7.2.1 of ETSI TS 103 097 v2.1.1,

 where the appPermissions field in the authorization ticket allows signing of 

 misbehaviour reports.

```asn1

EtsiTs103759Mbr-Signed ::= EtsiTs103097Data-Signed {EtsiTs103759Mbr}

```



### <a name="EtsiTs103759Mbr-STE"></a>EtsiTs103759Mbr-STE

This data type is used for the option sTE (signed-then-encrypted) of security

 encapsulation of the report. 



 For the signature to be valid the signing certificate shall conform to the

 authorization ticket profile given in clause 7.2.1 of ETSI TS 103 097 v2.1.1,

 where the appPermissions field in the authorization ticket allows signing of 

 misbehaviour reports. The signed [**EtsiTs103759Data**](#EtsiTs103759Data) shall be encrypted 

 misbehaviour reports. The signed [**EtsiTs103759Mbr**](#EtsiTs103759Mbr) shall be encrypted 

 to the MA using the encryption key in the MA's certificate.

```asn1

EtsiTs103759Data-SignedAndEncrypted-Unicast ::= 

  EtsiTs103097Data-SignedAndEncrypted-Unicast {

  EtsiTs103759Data

EtsiTs103759Mbr-STE ::= EtsiTs103097Data-SignedAndEncrypted-Unicast {

  EtsiTs103759Mbr

}

```