<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>

<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [


<!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">
<!ENTITY RFC4493 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4493.xml">
<!ENTITY RFC4543 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4543.xml">
<!ENTITY RFC5116 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5116.xml">
<!ENTITY RFC5297 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5297.xml">
<!ENTITY RFC7301 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.7301.xml">
<!ENTITY RFC7525 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.7525.xml">
<!ENTITY RFC8174 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.8174.xml">
<!ENTITY RFC8446 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.8446.xml">
<!ENTITY RFC8915 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.8915.xml">
]>



<?rfc toc="yes"?>        <!-- generate a ToC -->
<?rfc tocindent="yes"?>
<?rfc tocdepth="4"?>     <!-- the number of levels of subsections in ToC. default: 3 -->
<?rfc sortrefs="yes"?>   <!-- sort the reference entries alphabetically -->
<?rfc symrefs="yes"?>    <!-- use symbolic references tags, i.e, [RFC2119] instead of [1] -->
<?rfc strict="yes"?>     <!-- give errors regarding ID-nits and DTD validation -->
<?rfc compact="yes"?>    <!-- do not start each main section on a new page -->
<?rfc subcompact="yes"?>  <!-- keep one blank line between list items -->
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc version="3"?>      <!-- xml2rfc v2v3 conversion 2.38.1 -->

<rfc category="std" docName="draft-langer-ntp-nts-for-ptp-03" ipr="trust200902">
  <front>
    <title abbrev="NTS4PTP">NTS4PTP - Key Management System for the Precision Time Protocol 
	                        Based on the Network Time Security Protocol </title>

    <author initials="M." surname="Langer" fullname="Martin Langer">
      <organization abbrev="Ostfalia University" >Ostfalia University of Applied Sciences</organization>
      <address>
	  <postal>
          <street>Salzdahlumer Straße 46/48</street>
          <city>Wolfenbüttel</city>
          <region></region>
          <code>38302</code>
          <country>Germany</country>
        </postal>
        <email>mart.langer@ostfalia.de</email>
      </address>
    </author>

	<author initials="R." surname="Bermbach" fullname="Rainer Bermbach">
      <organization abbrev="Ostfalia University" >Ostfalia University of Applied Sciences</organization>
      <address>
	  	  <postal>
          <street>Salzdahlumer Straße 46/48</street>
          <city>Wolfenbüttel</city>
          <region></region>
          <code>38302</code>
          <country>Germany</country>
        </postal>
        <email>r.bermbach@ostfalia.de</email>
      </address>
    </author>


    <date day="20" month="February" year="2022"/>

    <area>Internet</area>
    <workgroup>Network Time Protocol</workgroup>
    <keyword>Internet-Draft</keyword>

    <abstract>

<t>This document defines a key management service for automatic key management 
for the integrated security mechanism (prong A) of IEEE Std 1588™-2019 (PTPv2.1) described there 
in Annex P. It implements a key management for the immediate security processing approach and 
offers a security solution for all relevant PTP modes. The key management service for PTP is 
based on and extends the NTS Key Establishment protocol defined in IETF RFC 8915 for securing NTP, 
but works completely independent from NTP.</t>

    </abstract>

  </front>
 

  <middle>

<section anchor="notational-conventions" title="Notational Conventions">

<t>The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,
“SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this
document are to be interpreted as described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/>
when, and only when, they appear in all capitals, as shown here.</t>

</section>



<section anchor="introduction" title="Key Management Using Network Time Security">

<t>In its annex P the IEEE Std 1588-2019 (<xref target="IEEE1588-2019"/>, Precision 
Time Protocol version 2.1, PTPv2.1) defines a comprehensive PTP security concept based 
on four prongs (A to D). Prong A incorporates an immediate security processing approach 
and specifies in section 16.14 an extension to secure PTP messages by means of an 
AUTHENTICATION TLV (AuthTLV) containing an Integrity Check Value (ICV). For PTP 
instances to use the securing mechanism, a respective key needs to be securely distributed 
among them. Annex P gives requirements for such a key management system and mentions 
potential candidates without further specification, but allows other solutions as long 
as they fulfill those requirements.
</t>

<t>This document defines such a key management service for automatic key management for 
the immediate security processing in prong A. The solution <xref target="Langer_et_al._2020"/>
is based on and expands the NTS Key Establishment protocol defined in IETF RFC 8915 
<xref target="RFC8915"/> for securing NTP, but works completely independent from NTP.</t>

<t>Many networks include both, PTP and NTP at the same time. Furthermore, many time server 
appliances that are capable of acting as the Grandmaster of a PTP network are also capable 
of acting as an NTP server. For these reasons, it is likely to be easier both, for the time 
server manufacturer and the network operator, if PTP and NTP use a key management system 
based on the same technology. The Network Time Security (NTS) protocol was specified by the 
Internet Engineering Task Force (IETF) to protect the integrity of NTP messages 
<xref target="RFC8915"/>. Its NTS Key Establishment sub-protocol is secured by the Transport 
Layer Security (TLS 1.3, IETF RFC 8446 <xref target="RFC8446"/>) mechanism. TLS is used 
to protect numerous popular network protocols, so it is present in many networks. For example, 
HTTPS, the predominant secure web protocol uses TLS for security. Since many PTP capable 
network appliances have management interfaces based on HTTPS, the manufacturers are already 
implementing TLS. </t>

<!--This document outlines how 
the NTS Key Establishment protocol of IETF RFC 8915 can be expanded for use as a PTP key 
management mechanism <xref target="Langer_et_al._2020"/> for immediate security processing complementing the exemplary 
GDOI proposal in the IEEE Std 1588-2019 <xref target="IEEE1588-2019"/>. As a key establishment server for NTP should be 
implemented stateless which is not necessary for PTP systems, suitable new NTS messages 
are to be defined in this document.</t> -->

<t>Though the key management for PTP is based on the NTS Key Establishment (NTS-KE) protocol 
for NTP, it works completely independent of NTP. The key management system uses the procedures 
described in IETF RFC 8915 for the NTS-KE and expands it with new NTS messages for PTP. It 
may be applied in a Key Establishment server (NTS-KE server) that already manages NTP but 
can also be operated only handling KE for PTP. Even when the PTP network is isolated from 
the Internet, a Key Establishment server can be installed in that network providing the PTP 
instances with necessary key and security parameters.</t>

<t>The NTS-KE server may often be implemented as a separate unit. It also may be collocated 
with a PTP instance, e.g., the Grandmaster. In the latter case communication between the NTS-KE 
server program and the PTP instance program needs to be implemented in a secure way if TLS 
communication (e.g., via local host) is not or cannot be used.</t> 

<t>Using the expanded NTS Key Establishment protocol for the NTS key management for PTP, 
NTS4PTP provides two principle approaches specified in this document.</t>




<t>1. Group-based approach (GrBA, multicast)</t>
            <t><list style="symbols">
			  <t>definition of one or more security groups in the PTP network,</t>
              <t>very suitable for PTP multicast mode and mixed multicast/unicast mode,</t>
              <t>suitable for unicast mode in small subgroups of very few participants 
			  (Group-of-2, Go2) but poor scaling and more administration work,</t>
            </list>
            </t>
<t>2. Ticket-based approach (TiBA, unicast)</t>
            <t><list style="symbols">
			  <t>secured (end-to-end) PTP unicast communication between a PTP requester and grantor,</t>
              <t>no group binding necessary,</t>
              <t>very suitable for native PTP unicast mode, because of good scaling,</t>
              <t>a bit more complex NTS message handling.</t>
            </list>
            </t>


<t>For these modes, the NTS key management for PTP defines six new NTS messages which will 
   be introduced in the sections to come:</t>

<t> </t>
            <t><list style="symbols">
			  <t>PTP Key Request message (see <xref target="key-request"/>)</t>			  
			  <t>PTP Key Response message (see <xref target="key-response"/>)</t>
              <t>PTP Registration Request message (see <xref target="registration-request"/>)</t>
              <t>PTP Registration Response message (see <xref target="registration-response"/>)</t>
              <t>PTP Registration Revoke message (see <xref target="registration-revoke"/>)</t>
			  <t>Heartbeat message (see <xref target="heartbeat"/>)</t>
            </list>
          </t>

<t>This document describes the structure and usage of the two approaches GrBA and TiBA in their application 
as a key management system for the integrated security mechanism (prong A) of IEEE Std 1588-2019. 
<xref target="key-distribution"/> starts with a description of the principle key distribution 
mechanism, continues with details of the various group-based options (<xref target="exchange-group-based"/>) 
and the ticket-based unicast mode (<xref target="exchange-ticket-based"/>) before it ends with 
more general topics in <xref target="general-topics"/> for example the key update process and 
finally an overview of the newly defined NTS messages in <xref target="overview-nts-messages"/>. 
<xref target="nts-messages-4-ptp"/> gives all the details necessary to construct all records forming 
the particular NTS messages. <xref target="new-ticket-tlv"/> depicts details of a TICKET TLV needed 
to transport encrypted security information in PTP unicast requests. The following 
<xref target="auth-tlv-parameters"/> mentions specific parameters used in the PTP AUTHENTICATION TLV 
when working with the NTS4PTP key management system. <xref target="iana-considerations"/> and 
<xref target="security-considerations"/> discuss IANA 
respectively security considerations.</t>



<section anchor="key-distribution" title="Principle Key Distribution Mechanism">

<t>A PTP instance requests a key from the server referred to as the Key Establishment server, 
or NTS-KE server using the NTS-KE protocol defined in <xref target="RFC8915"/>, see Section 1.3. 
<xref target="fig-key-distribution-sequence"/> describes the principle 
sequence which can be used for PTP multicast as well as PTP unicast operation.</t>


      <figure anchor="fig-key-distribution-sequence" title="NTS key distribution sequence">
        <artwork><![CDATA[
PTP Instance                      NTS-KE Server

 |                                    |
 |<======== Open TLS Channel ========>|
 |                                    |
 |                                    |
 |========= PTP Key Request =========>| ) NTS messages
 |                                    | ) for PTP
 |<======== PTP Key Response =========| ) key exchange
 |                                    |
 |                                    |
 |<======== Close TLS Channel =======>|
 |                                    |
 |                                    o
 |                                        
 |                              PTP Instance 2/
 |                              PTP Network         
 |                                        
 |                                    |
 |<---- Secured PTP Communication --->|
 |           using shared key         |
 |                                    |
 V                                    V
 ]]>
        </artwork>
      </figure>



<t>The PTP instance client connects to the NTS-KE server on the NTS TCP port (port number 4460). Then both parties 
perform a TLS handshake to establish a TLS 1.3 communication channel. No earlier TLS versions 
are allowed. The details of the TLS handshake are specified in IETF RFC 8446 <xref target="RFC8446"/>. </t>

<t>Implementations must conform to the rules stated in Section 3 “TLS Profile for Network Time 
Security” of IETF RFC 8915 <xref target="RFC8915"/>:</t>



<t><list>
	 <t> <spanx style="emph">&quot;Network Time Security makes use of TLS for NTS key 
	     establishment.</spanx><vspace blankLines="1" /></t>
	 <t> <spanx style="emph">Since the NTS protocol is new as of this publication, no 
	     backward-compatibility concerns exist to justify using obsolete, insecure, or 
		 otherwise broken TLS features or versions.</spanx><vspace blankLines="1" /></t> 
	 <t> <spanx style="emph">Implementations MUST conform with RFC 7525 </spanx>
	     <xref target="RFC7525"/><spanx style="emph"> or with a later revision of BCP 195.
		 </spanx><vspace blankLines="1" /></t>
	 <t> <spanx style="emph">Implementations MUST NOT negotiate TLS versions earlier than 
	     1.3 </spanx><xref target="RFC8446"/><spanx style="emph"> and MAY refuse to negotiate 
		 any TLS version that has been superseded by a later supported version.</spanx>
		 <vspace blankLines="1" /></t>
	 <t> <spanx style="emph">Use of the Application-Layer Protocol Negotiation Extension 
	     </spanx><xref target="RFC7301"/><spanx style="emph"> is integral to NTS, and support 
		 for it is REQUIRED for interoperability ... &quot;</spanx></t>
</list></t>

<t>The client starts the TLS handshake with a ‘Client Hello’ message that must contain two 
TLS extensions. The first extension is the Application Layer Protocol Negotiation <xref target="RFC7301"/> 
(ALPN with "ntske/1", which refers to the NTS Key Establishment as the subsequent protocol.) 
The second extension is the Post-Handshake Client Authentication, which the client uses to signal the 
TLS server that the client certificate can be requested after the TLS handshake.  Afterwards, 
the client authenticates the NTS-KE server using the root CA certificate or by means of the 
Online Certificate Status Protocol (OCSP). Both, client and server agree on the cipher suite 
and then establish a secured channel that ensures authenticity, integrity and confidentiality 
for subsequent messages. In the process, the NTS-KE server acknowledges the ALPN and expects 
a message from the NTS-KE protocol.</t>

            <t>Thus, the TLS handshake accomplishes the following:

            <list style="symbols">
			  <t>Negotiation of TLS version (only TLS 1.3 allowed), and</t>
              <t>negotiation of the cipher suite for the TLS session, and </t>
              <t>authentication of the TLS server (equivalent to the NTS-KE server) using a digital 
			     X.509 certificate,</t>
              
              <t>and the encryption of the subsequent information exchange between the TLS communication 
			     partners.</t>
            </list>
          </t>


<t>TLS is a layer five protocol that runs on TCP over IP. Therefore, PTP implementations that 
support NTS-based key management need to support TCP and IP (at least on a separate management port).</t>

<t>Once the TLS session is established, the PTP instance will ask for a PTP key as well as the 
associated security parameters using the new NTS message PTP Key Request (see <xref target="key-request"/>). 
Then the server requests the client's X.509 certificate (via TLS Certificate Request) and verifies it upon receipt.
In NTS for NTP this was unnecessary, in NTS4PTP the clients MUST be authenticated, too.
The NTS application of the NTS-KE server will respond with a PTP Key 
Response message (see <xref target="key-response"/>). If no delivery of security data is possible 
for whatever reason, the PTP Key Response message contains a respective error code. All messages 
are constructed from specific records as described in <xref target="nts-records"/>.</t>

<t>When the PTP Key Request message was responded with a PTP Key Response, the TLS 
session will be closed with a 'close notify' TLS alert from both parties, the PTP instance 
and the key server.</t>

<t>With the key and other information received, the PTP instance can take part in the secured 
PTP communication in the different modes of operation.</t>

<t>After the reception of the first set of security parameters the PTP instance may resume the 
TLS session according to IETF RFC 8446 <xref target="RFC8446"/>, 
Section 4.6.1, allowing the PTP instance to skip the TLS version and algorithm negotiations. 
If TLS Session Resumption (<xref target="RFC8446"/>, Section 2.2) is used and supported by the 
NTS-KE server, a suitable lifetime (max. 24 hrs) for the TLS session key must be defined to 
not open the TLS connection for security threats. If the NTS-KE server does not support TLS 
resumption, a full TLS handshake must be performed.</t>

<t>As the TLS session provides authentication, but not authorization additional means have 
to be used for the latter (see <xref target="upfront-authorization"/>). </t>

<t>As mentioned above, the NTS key management for PTP supports two principle methods, the 
group-based approach (GrBA) and the ticket-based approach (TiBA) which are described in the following 
sections below.</t>


<section anchor="exchange-group-based" title="NTS Message Exchange for Group-based Approach">

<t>As described in <xref target="key-distribution"/>, a PTP instance wanting to join a secured 
PTP communication in the group-based modes contacts the NTS-KE server starting the establishment 
of a secured TLS connection using the NTS-KE protocol (ALPN: ntske/1). Then, the client continues 
with a PTP Key Request message, asking for a specific group (see <xref target="key-request"/>) as shown in 
<xref target="fig-group-based"/>. After receiving the message, the NTS-KE server requests the 
client's certificate and performs an authorization check. The NTS-KE server then replies with a 
PTP Key Response message (see <xref target="key-response"/>) with all the necessary data to 
join the group communication. Else, it contains a respective error code if the PTP instance 
is not allowed to join the group. This procedure is necessary for all parties, which are or 
will be members of that PTP group including the Grandmaster and other special participants, 
e.g., Transparent Clocks. As mentioned above, this not only applies to multicast mode but also 
to mixed multicast/unicast mode (former hybrid mode) where the explicit unicast communication 
uses the multicast group key received from the NTS-KE server. The group number for both modes 
is primarily generated by a concatenation  of the PTP domain number and the PTP profile identifier 
(sdoId), as described in <xref target="association-mode"/>.</t>
 



<t>Additionally, besides multicast and mixed multicast/unicast mode, a group of two (or few 
more) PTP instances can be configured, practically implementing a special group-based unicast 
communication mode, the group-of-2 (Go2) mode. </t>


      <figure anchor="fig-group-based" title="Message exchange for the group-based approach">
        <artwork><![CDATA[
Secured
PTP Network       PTP Instance          NTS-KE Server

 |                      |         TLS:        |
 |                  TLS |== PTP Key Request =>| Response contains:
 |              secured |                     | GroupID, security
 |        communication |         TLS:        | parameters, group
 |                      |<= PTP Key Response =| key, validity 
 |                      |                     | period etc.
 |    Secured PTP:      |                     |
 |--- Announce -------->|  )                  |
 |                      |  )                  |
 |    Secured PTP:      |  )                  |
 |-- Sync & Follow_Up ->|  )                  |
 |                      |  ) Secured          |
 |                      |  ) PTP messages     |
 |    Secured PTP:      |  ) using            |
 |<-- Delay_Req --------|  ) group key        |
 |                      |  )                  |
 |    Secured PTP:      |  )                  |
 |--- Delay_Resp ------>|  )                  |
 |                      |  )                  |
 V                      V                     V

Legend:        TLS:       Authenticated & encrypted
          =============>  TLS communication

           Secured PTP:   Group key-authenticated
          ------------->  PTP communication


 ]]>
        </artwork>
      </figure>

<t>This Go2 mode requires additional administration in advance defining groups-of-2 and supplying 
them with an additional attribute in addition to the group number mentioned for the other 
group-based modes – the subGroup attribute in the Association Mode record (see <xref target="association-mode"/>) of 
the PTP Key Request message. So, addressing for Go2 is achieved by use of the group number 
derived from domain number, sdoId and the additional attribute subGroup. Communication in 
that mode is performed using multicast addresses. If the latter is undesirable, unicast 
addresses can be used but the particular IP or MAC addresses of the communication partners 
need to be configured upfront, too.</t>

<t>In spite of its specific name, Go2 allows more than two participants, for example additional 
Transparent Clocks. All participants in that subgroup need to be configured respectively. 
(To enable the NTS-KE server to supply the subgroup members with the particular security data 
the respective certificates may reflect permission to take part in the subgroup. Else another 
authorization method is to be used.)</t>

<t>Having predefined the Go2s the key management for this mode of operation follows the same 
procedure (see <xref target="fig-group-based"/>) and uses the same NTS messages as the other 
group-based modes. Both participants, the Group-of-2 requester and the respective grantor need 
to have received their security parameters including key etc. before secure PTP communication 
can take place.</t>

<t>After the NTS key establishment messages for these group-based modes have been exchanged, 
the secured PTP communication can take place using the security association(s) communicated.
The participants of the PTP network are now able to use the group key to verify secured PTP 
messages of the corresponding group or to generate secured PTP messages itself. In order to 
do this, the PTP node applies the group key together with the MAC algorithm to the PTP packet 
to generate the ICV transported in the AUTHENTICATION TLV of the PTP message.</t>

<!-- <t>The key management for these modes works relatively simple and needs only the above mentioned 
three NTS messages: PTP Key Request, PTP Key Response or PTP Refusal. The group number used for 
addressing is automatically derived from the configured attributes domain number and sdoID.</t> 

<t>Additionally, besides multicast and hybrid mode, a (multicast) group of two PTP instances can 
be configured, practically implementing a special unicast communication.</t> -->

<t>The key management for these modes works relatively simple and needs only the above mentioned 
two NTS messages: PTP Key Request and PTP Key Response.</t>



</section>

<section  anchor="exchange-ticket-based" title="NTS Message Exchange for the Ticket-based Approach">

<t>The scaling problems of the group-based approach are solved by the ticket-based approach (TiBA) 
for unicast connections. TiBA ensures end-to-end security between the two PTP communication partners, 
requester and grantor, and is therefore only suitable for PTP unicast where no group binding exists. 
Therefore, this model scales excellently with the number of connections. TiBA also allows free MAC 
algorithm and server negotiation, eliminating the need for the administrator to manually prepare the 
table of acceptable unicast masters at each individual PTP node. In addition, this allows optional 
load control by the NTS-KE server.</t>

<t>In (native) PTP unicast mode using unicast message negotiation (<xref target="IEEE1588-2019"/>, 
Section 16.1) any potential instance (the grantor) which can be contacted by other PTP instances 
(the requesters) needs to register upfront with the NTS-KE server as depicted in <xref target="fig-ticket-based"/>.</t>


      <figure anchor="fig-ticket-based" title="Message exchange for ticket-based unicast mode">
        <artwork><![CDATA[
     PTP Requester         NTS-KE Server            PTP Grantor
           
             |                 |         TLS:        |Grantor
             |    KE generates |<= PTP Registration =|registers
             |      ticket key |       Request       |upfront
             |                 |                     |
             |                 |        TLS:         |gets
             |        KE sends |== PTP Registration >|ticket
             |      ticket key |       Response      |key to
             |                 |                     |decrypt
             |                 |                     |tickets
             :                 :                     :
 PTP instance|     TLS:        |                     |
wants unicast|== PTP Key =====>| KE generates        |
communication|   Request       | and sends           |
             |                 | unicast key         |
             |     TLS:        | & encrypted         |
             |<= PTP Key ======| ticket              |
             |   Response      |                     |
             |                 |                     |decrypts
      Unicast|                 |                     |ticket,
      request|   Secured PTP:  |                     |extracts
     contains|-- Unicast  -------------------------->|containing
       ticket|   Request       |                     |unicast key
             |                 |                     |
             |   Secured PTP:  |                     |Grantor uses
             |<- Grant ------------------------------|unicast key
             |                 |                     |
             V                 V                     V

Legend:        TLS:       Authenticated & encrypted
          =============>  TLS communication

           Secured PTP:   Unicast key-authenticated
          ------------->  PTP communication

 ]]>
        </artwork>
      </figure>



<t>(Note: As any PTP instance may request unicast messages from any other instance the terms 
requester and grantor as used in the standard suit better than talking about slave respectively 
master. In unicast PTP, the grantor is typically a PTP Port in the MASTER state, and the requester 
is typically a PTP Port in the SLAVE state. However all PTP Ports are allowed to grant and request 
unicast PTP message contracts regardless of which state they are in. A PTP port in MASTER state 
may be requester, a port in SLAVE state may be a grantor.)</t>

<t>Since the registration of unicast grantors is not provided for in the NTS-KE protocol, a new 
sub-protocol is needed, the NTS Time Server Registration (NTS-TSR) protocol. NTS-TSR does not 
conflict with NTS for NTP, and the original procedure for NTS-secured NTP remains unchanged. 
All NTS requests still arrive at the NTS-KE server on port 4460/TCP, whether a simple client 
or a time server connects. The authentication of the NTS-KE server by the querying partner 
already takes place when the TLS connection is established. In doing so, it chooses the NTS 
protocol to be used by selecting the ALPN  <xref target="RFC7301"/>. If the ALPN contains the string "ntske/1", 
the NTS Key Establishment protocol is executed after the TLS handshake (see group-based approach). 
If it contains "ntstsr/1" instead, the NTS Time Server Registration protocol is executed.
(Unlike the NTS-KE protocol, requesting grantors are already authenticated during the TLS handshake.) </t>


<t> The registration of a PTP grantor is performed via a PTP Registration Request message 
(see <xref target="registration-request"/>). The NTS-KE server answers with a PTP Registration 
Response message (see <xref target="registration-response"/>).  If no delivery of security data 
is possible for whatever reason, the PTP Registration Response message contains a respective 
error code.</t>


<t>With the reception of the PTP Registration Response message, the grantor holds a ticket key known 
only to the NTS-KE server and the registered grantor. With this ticket key it can decrypt  
cryptographic information contained in a so-called ticket which enables secure unicast 
communication.</t>

<t>After the end of the registration process (phase 1), phase 2 begins with the key request 
of the client (now called requester). Similar to the group-based approach, a PTP instance 
(the requester) wanting to start a secured PTP unicast communication with a specific grantor 
contacts the NTS-KE server sending a PTP Key Request message (see <xref target="key-request"/>) 
as shown in <xref target="fig-key-request"/>, again using the TLS-secured NTS Key Establishment 
protocol. The NTS-KE server performs the authentication check of the client and then answers 
with a PTP Key Response message (see <xref target="key-response"/>) with all the necessary 
data to begin the unicast communication with the desired partner or with a respective error 
code if unicast communication with that instance is unavailable. Though the message types 
are the same as in GrBA the content differs.</t>

<t>The PTP Key Response message includes a unicast key to secure the PTP message exchange with 
the desired grantor. In addition, it contains the above mentioned (partially) encrypted ticket which the 
requester later (phase 3) transmits in a special Ticket TLV (see <xref target="new-ticket-tlv"/>) 
with the secured PTP message to the grantor.</t>

<t>After the NTS key establishment messages for the PTP unicast mode have been exchanged, finally, 
the secured PTP communication (phase 3) can take place using the security association(s) 
communicated. A requester may send a (unicast key) secured PTP signaling message containing 
the received encrypted ticket, asking for a grant of a so-called unicast contract which contains 
a request for a specific PTP message type, as well as the desired frame rate.</t>

<t>The grantor receiving the PTP message decrypts the received ticket with its 
ticket key and extracts the containing security parameters, for example the unicast key used 
by the requester to secure the PTP message and the requester’s identity. In that way the 
grantor can check the received message, identify the requester and can use the unicast key 
for further secure PTP communication with the requester until the unicast key expires.</t>

<t>A grantor that supports unicast and provides sufficient capacity will acknowledge the request 
for a unicast contract with a PTP unicast grant.</t>

<t>If a grantor is no longer at disposal for unicast mode during the lifetime of registration 
and ticket key, it sends a TLS-secured PTP Registration Revoke message (see <xref target="registration-revoke"/>, 
not shown in <xref target="fig-ticket-based"/>) to the NTS-KE server, so requesters no longer 
receive PTP Key Response messages for this grantor.</t>

<t>The Heartbeat message (see <xref target="heartbeat"/>, not shown in <xref target="fig-ticket-based"/>) 
allows grantors to send messages to the NTS-KE server at regular intervals during the validity 
of the current security data and signal their own functionality. Optionally, these messages 
can contain status reports, for example, to enable load balancing between the registered 
time servers or to provide additional monitoring.</t>

<t>With its use of two protocols, the NTS-KE and the NTS-TSR protocol, this unicast mode is a 
bit more complex than the Group-of-2 approach and eventually uses all six new NTS messages. 
However, no subgroups have to be defined upfront. Addressing a grantor, the requesting instance 
simply may use the grantor's IP, MAC address or PortIdentity attribute.</t>

</section>
</section>



<section anchor="general-topics" title="General Topics">

<t>This section describes more general topics like key update and key generation as well as discussion 
of the time information on the NTS-KE server, the use of certificates and topics concerning upfront 
configuration.</t>


<section anchor="key-update"  title="Key Update Process">

<t>The security parameters update process is an important part of NTS4PTP. It keeps the keys up to date, 
allows for both, runtime security policy changes and easy group control. The rotation operation allows 
uninterrupted PTP operation in multicast as well as unicast mode.</t>

<t>The update mechanism is based on the Validity Period record in the NTS response messages, which 
includes the three values lifetime, update period (UP) and grace period (GP), see 
<xref target="fig-update-group-based"/>. The lifetime 
parameter specifies the validity period of the security parameters (e.g., security association (SA) and 
ticket) in seconds, which is counted down. This value can range from a few minutes to a few days. 
(Due to the design of the replay protection, a maximum lifetime of up to 388 days is possible, but 
should not be exploited). After the validity period has expired, the security parameters may no longer 
be used to secure PTP messages and must be deleted soon after.</t>

<t>New security parameters are available on the NTS-KE server during the update period, a time span 
before the expiry of the lifetime. The length of the update period is therefore always shorter 
than the full lifetime and is typically in the range of a few minutes. To ensure uninterrupted 
rotation for unicast connections, it is also necessary to ensure that the update period is 
greater than the minimum unicast contract time.</t>

<t>The grace period also helps to ensure uninterrupted key rotation. This value defines a period 
of time after the lifetime expiry during which the expired security parameters continue to be 
accepted. The grace period covers a few seconds at most and is only intended to compensate for 
runtime delays in the network during the update process. The respective values of the three 
parameters are defined by the administrator and can also be specified by a corresponding PTP 
profile.</t>


      <figure anchor="fig-update-group-based" title="Example of the parameter rotation using lifetime, update period and
                                                      grace period in group-based mode">
        <artwork><![CDATA[
|12,389s (@time of key request)  0s|14,400s                   0s|
+----------------------------------+------------------...-------+
| Lifetime (current parameters)    |  Lifetime (next parameters)|
+-------------------------+--------+------------------...-------+
                          |  300s  |  10s |
                          |<------>|<---->|
                          | update |grace |
                          | period |period| 
                          |________|______|
                               |       |
                               V       V
 Request and receive new parameters   Still accepting
          at a random point in time   old parameters

Example:
--------
lifetime (full): 14,400s = 4h
update period:   300s = 5 min
grace period     10s

 ]]>
        </artwork>
      </figure>


<t>As the value for lifetime is specified in seconds which denote the remaining time and is decremented down 
to zero, hard adjustments of the clock used have to be avoided. Therefore, the use of a monotonic 
clock is recommended. Requests during the currently running validity period will receive respectively 
adapted count values.</t> 

<t>The Validity Period record (see <xref target="validity-period"/>) with its parameters lifetime, update time and grace period is contained 
in a so-called Current Parameters container record. Together 
with other security parameters this container record is always present in a PTP Key respectively Registration 
Response message. During the update period the response message additionally comprises the Next Parameters 
container record, which holds the new lifetime etc. starting at the end of the current lifetime as well 
as the other security parameters of the upcoming lifetime cycle.</t> 

<t>Any PTP client sending a PTP Key Request to the NTS-KE server, be it in GrBA to receive the group 
SA or be it in TiBA asking for the unicast SA (unicast key etc. and encrypted ticket), will receive 
the Current Parameters container record where lifetime includes the remaining time to run rather 
than the full. Requesting during the update period the response includes also the new lifetime value 
in the Next Parameters container record. The new lifetime is the full value of the validity starting 
at the end of the current lifetime and update period. After the old lifetime has expired, only the 
new parameters (including lifetime, update period and grace period) have to be used. Merely during the 
grace period, the old SA will be accepted to cope with smaller delays in the PTP communication.</t> 

<t>All PTP clients are obliged to connect to the NTS-KE server during the update period to allow for 
uninterrupted secured PTP operation. To avoid peak load on the NTS-KE server all clients SHOULD choose 
a random starting time during the update period.</t> 

<t>In TiBA the unicast grantors execute the NTS-TSR protocol to register with the NTS-KE server. The 
rotation sequence (see <xref target="fig-update-ticket-based"/>) and the behavior of the PTP 
Registration Response message is almost identical to the NTS-KE protocol. The main difference here 
is that the update period has to start earlier so that a grantor has re-registered before requesters 
ask for new security parameters at the NTS-KE server.</t> 

<t>As the difference between the start of the requester’s update period and the beginning of the 
update period of the grantor is not communicated, the grantor should contact the NTS-KE server directly 
after the start of its update period. However, since the rotation periods occur at different times 
for multiple grantors, no load peaks occur here either.</t> 

<t>If a grantor does not re-register in time, requesters asking for a key etc. may not receive a 
Next Parameters container record, as no new SA is available at that point. So, requesters need to 
try again later in their update period.</t> 

<t>As unicast contracts in TiBA run independently of the update cycle, a special situation may occur. 
If the remaining lifetime is short, it may be necessary to select a shorter time for the unicast 
contract validity period because the unicast contract cannot run longer than the lifetime. If a 
unicast contract is to be extended within the update period and the requester already owns the new 
ticket, it can already apply the upcoming security parameters here. This corresponds to some kind 
of negative grace period (pre-validity use of upcoming security parameters) and allows the requester 
to negotiate the full time for the unicast contract with the grantor.</t> 

<t>If a grantor has revoked his registration with a PTP Registration Revoke message, requesters 
will receive a PTP Key Response message with an error code when trying to update for a new unicast 
key. No immediate key revoke mechanism exists. The grantor SHOULD not grant respective unicast 
requests during the remaining lifetime of the revoked key.</t> 


      <figure anchor="fig-update-ticket-based" title="Example of the parameter rotation using lifetime and
                                                      update period in ticket-based mode">

        <artwork><![CDATA[
Update process grantor:
-----------------------

(@time of registration response)
  |   
|14,400s                          0s |14,400s                 0s|
+---------------------------------------------------...---------+
|Lifetime (current ticket key)       |Lifetime (next ticket key)|
+----------------------+------+------+--------------...---------+
                       | 180s |      :
                       |<---->|      :
                       |update|      :
                       |period|      :
                       |______|      :
                           |  :      :
                           V  :      :
              Re-registration :      :
                              :      :
                              :      : 
Update process requester:     :      :
-------------------------     :      :
                              :      :
    |12,389s (@time of key request)0s|14,400s                 0s|
    +--------------------------------+----------------...-------+
    | Lifetime (current parameters)  |Lifetime (next parameters)|
    +-------------------------+------+------+---------...-------+
                              | 300s |  10s |
                              |<---->|<---->|
                              |update|grace |
                              |period|period| 
                              |______|______|
                                 |       |
                                 V       V
 Request and receive new parameters    Still accepting
          at a random point in time    old parameters

Example:
--------
lifetime (full):        14,400s = 4h
update period grantor:     180s = 3 min
update period requester:   300s = 5 min
grace period:               10s

 ]]>
        </artwork>
      </figure>


</section>


<section anchor="key-generation" title="Key Generation">

<t>In all cases keys obtained by a secure random number generator SHALL be used. The length of 
the keys depends on the MAC algorithm (see also last subsection in <xref target="sa-sp-management"/>) 
respectively the AEAD algorithm utilized.</t>

</section>


<section anchor="time-ke-server" title="Time Information of the NTS-KE server">

<t>As the NTS-KE server embeds time duration information in the respective messages, its local time 
should be accurate to within a few seconds compared to the controlled PTP network(s). To 
avoid any dependencies, it should synchronize to a secure external time source, for example an 
NTS-secured NTP server. The time information is also necessary to check the lifetime of certificates used.</t>

</section>


<section anchor="certificates" title="Certificates">

<t>The authentication of the TLS communication parties is based on certificates issued by a trusted 
Certificate Authority (CA) that are utilized during the TLS handshake. In classical TLS applications 
only servers are required to have them. For the key management system described here,  the PTP nodes 
also need certificates to allow only authorized and trusted devices to get the group key and join 
a secure PTP network. (As TLS only authenticates the communication partners, authorization has to 
be managed by external means, see the topic “Authorization” in <xref target="upfront-authorization"/>.) 
The verification of a certificate always requires a loose time synchronicity, 
because they have a validity period. This, however, reveals the well-known start-up problem, since 
secure time transfer itself requires valid certificates. (See the discussion and proposals on this 
topic in IETF RFC 8915 <xref target="RFC8915"/>, Section 8.5 “Initial Verification of Server certificates” 
which applies to client and server certificates in the PTP key management system, too.) </t>

<t>Furthermore, some kind of Public Key Infrastructure (PKI) is necessary, which may be conceivable via 
the Online Certificate Status Protocol (OCSP) as well as offline via root CA certificates.</t>

<t>The TLS communication parties must be equipped with a private key and a certificate in advance. The 
certificate contains a digital signature of the CA as well as the public key of the sender. The key 
pair is required to establish an authenticated and encrypted channel for the initial TLS phase. 
Distribution and update of the certificates can be done manually or automatically. However, it is 
important that they are issued by a trusted CA instance, which can be either local (private CA) or 
external (public CA).</t>

<t>For the certificates the standard for X.509 <xref target="ITU-T_X.509"/> certificates MUST be used. 
Additional data in the certificates like domain, sdoId and/or subgroup attributes may help in authorizing. 
In that case it should be noted that using the PTP device in another network then implies to have a new 
certificate, too. Working with certificates without authorization information would not have that 
disadvantage, but more configuring at the NTS-KE server would be necessary: which domain, sdoId and/or 
subgroup attributes belong to which certificate.</t>

<t>As TLS is used to secure both sub protocols, the NTS KE and the NTS-TSR protocol, a comment on the security of TLS 
seems reasonable. A TLS 1.3 connection is considered secure today. However, note that a DoS (Denial 
of Service) attack on the key server can prevent new connections or parameter updates for secure 
PTP communication. A hijacked key management system is also critical, because it can completely 
disable the protection mechanism. A redundant implementation of the key server is therefore essential 
for a robust system. A further mitigation can be the limitation of the number of TLS requests of 
single PTP nodes to prevent flooding. But such measures are out of the scope of this document.</t>

</section>



<section anchor="upfront-configuration" title="Upfront Configuration">

<t>All PTP instances as well as the NTS-KE server need to be configured by the network administrator. 
This applies to several fields of parameters.</t>


<section anchor="upfront-security-parameters" title="Security Parameters">
<t>The cryptographic algorithm and associated parameters (the so-called security association(s) – SA) 
used for PTP keys are configured by network operators at the NTS-KE server. PTP instances that do not support the configured 
algorithms cannot operate with the security. Since most PTP networks are managed by a single organization, 
configuring the cryptographic algorithm (MAC) for ICV calculation is practical. This prevents the 
need for the NTS-KE server and PTP instances to implement an NTS algorithm negotiation protocol. </t>

<t>For the ticket-based approach the AEAD algorithms need to be specified which the PTP grantors and 
the NTS-KE server support and negotiate during the registration process. Optionally, the MAC algorithm may 
be negotiated during a unicast PTP Key Request to allow faster or stronger algorithms, but a standard 
protocol supported by every instance should be defined. Eventually, suitable algorithms may be defined 
in a respective PTP profile. </t>

</section>

<section anchor="upfront-key-lifetimes" title="Key Lifetimes">

<t>Supplementary to the above mentioned SAs the desired key rotation periods, i.e., the lifetimes of 
keys respectively all security parameters need to be configured at the NTS-KE server. This applies to the 
lifetime of a group key in the group-based approach as well as the lifetime of ticket key and unicast 
key in the ticket-based unicast approach (typically for every unicast pair in general or eventually 
specific for each requestor-grantor pair). In addition, the corresponding update periods and grace 
periods need to be defined. Any particular lifetime, update period and grace period is configured as 
time spans specified in seconds.</t>

</section>


<section anchor="upfront-certificates" title="Certificates">

<t>The network administrator has to supply each PTP instance and the NTS-KE server with their X.509 
certificates. The TLS communication parties must be equipped with a private key and a certificate 
containing the public key in advance (see <xref target="certificates"/>). </t>

</section>


<section anchor="upfront-authorization" title="Authorization">

<t>The certificates provide authentication of the communication partners. Normally, they do not 
contain authorization information. Authorization decides, which PTP instances are allowed to join 
a group (in any of the group-based modes) or may enter a unicast communication in the ticket-based 
approach and request the respective SA(s) and key. </t> 

<t>As mentioned, members of a group (multicast mode, mixed multicast/unicast mode) are identified 
by their domain and their sdoId. PTP domain and sdoId may be attributes in the certificates of 
the potential group members supplying additional authorization. If not contained in the 
certificates extra authorization means are necessary. (See also the discussion on advantages 
and disadvantages on certificates containing additional authorization data in <xref target="certificates"/>.)</t>

<t>If the special Group-of-2 mode is used, the optional subGroup parameter (i.e., the subgroup 
number) needs to be specified at all members of respective Go2s, upfront. To enable the NTS-KE 
server to supply the subgroup members with the particular security data their respective 
certificates may reflect permission to take part in the subgroup. Else another authorization 
method is to be used.</t>

<t>In native unicast mode, any authenticated grantor that is member of the group used for multicast 
may request a registration for unicast communication at the NTS-KE server. If it is intended for 
unicast, this must be configured locally. If no group authorization is available (e.g., pure 
unicast operation) another authentication scheme is necessary. </t>

<t>In the same way, any requester (if configured for it locally) may request security data for a 
unicast connection with a specific grantor. Only authentication at the NTS-KE server using its 
certificate and membership in the group used for multicast is needed. If a unicast communication 
is not desired by the grantor, it should not grant a specific unicast request. Again, if no 
group authorization is available (e.g., pure unicast operation) another authentication scheme 
is necessary.</t>

<t>Authorization can be executed at least in some manual configuration. Probably the application 
of a standard access control system like Diameter, RADIUS or similar would be more appropriate. 
Also role-based access control (RBAC), attribute-based access control (ABAC) or more flexible 
tools like Open Policy Agent (OPA) could help administering larger systems. But details of the 
authorization of PTP instances lies out of scope of this document.</t>

</section>


<section anchor="upfront-tcs" title="Transparent Clocks">

<t>Transparent Clocks (TC) need to be supplied with respective certificates, too. For group-based 
modes they must be configured for the particular PTP domain and sdoId and eventually for the 
specific subgroup(s) when using Group-of-2. They need to request for the relevant group key(s) 
at the NTS-KE server to allow secure use of the correctionfield in a PTP message and generation of 
a corrected ICV. If TCs are used in ticket-based unicast mode, they need to be authorized for 
the particular unicast path. </t>

<t>Authorization of TCs for the respective groups, subgroups and unicast connections is paramount. 
Otherwise the security can easily be broken with attackers pretending to be TCs in the path. 
Authorization of TCs is necessary too in unicast communication, even if the normal unicast 
partners need not be especially authorized.</t>

<t>Transparent clocks may notice that the communication runs secured. In the group-based 
approaches multicast mode and mixed multicast/unicast mode they construct the GroupID from domain 
and sdoId and request a group key from the NTS-KE server. Similarly, they can use the additional 
subgroup attribute in Go2 mode for a (group) key request. Afterwards they can check the ICV 
of incoming messages, fill in the correction field and generate a new ICV for outgoing messages. 
In ticket-based unicast mode a TC may notice a secured unicast request from a requester to the 
grantor and can request the unicast key from the NTS-KE server to make use of the correction field 
afterwards. As mentioned above upfront authentication and authorization of the particular TCs 
is paramount not to open the secured communication to attackers.</t>

</section>


<section anchor="upfront-start-up" title="Start-up considerations">

<t>At start-up of a single PTP instance or the complete PTP network some issues have to be considered.</t>
 
<t>At least loose time synchronization is necessary to allow for authentication using the certificates. 
See the discussion and proposals on this topic in IETF RFC 8915 <xref target="RFC8915"/>, Section 8.5 “Initial Verification 
of Server certificates” which applies to client certificates in the PTP key management system, too.</t>

<t>Similarly, to a key re-request during an update period, key requests SHOULD be started at a random 
point in time after start-up to avoid peak load on the NTS-KE server. Every grantor must register 
with the NTS-KE server before requesters can request a unicast key (and ticket).</t>

</section>

</section>
</section>



<section anchor="overview-nts-messages" title="Overview of NTS Messages and their Structure for Use with PTP">

<t><xref target="key-distribution"/> described the principle communication sequences for PTP Key Request, 
PTP Registration Request and corresponding response messages. All messages follow the “NTS Key Establishment 
Process” stated in the first part (until the description of Figure 3 starts) of Section 4 of IETF RFC 8915 
<xref target="RFC8915"/>:</t>


<t><list>

      <t>
        <spanx style="emph">&quot;The NTS key establishment protocol is conducted via TCP port 4460.
        The two endpoints carry out a TLS handshake in conformance with
        Section 3, with the client offering (via an ALPN extension </spanx><xref target="RFC7301"/>)<spanx style="emph">, 
		and the server accepting,
        an application-layer protocol of &quot;ntske/1&quot;. Immediately
        following a successful handshake, the client SHALL send a single request
        as Application Data encapsulated in the TLS-protected channel. Then, the
        server SHALL send a single response. After sending their respective
        request and response, the client and server SHALL send TLS
        &quot;close_notify&quot; alerts in accordance with Section 6.1 of RFC 8446 </spanx><xref target="RFC8446"/>.
        <vspace blankLines="1" /></t>

      <t>
        <spanx style="emph">The client's request and the server's response each SHALL consist of a
        sequence of records formatted according to</spanx>
        <xref target="fig-ntske-record"/><spanx style="emph">. The request and a non-error response each
        SHALL include exactly one NTS Next Protocol Negotiation record. The
        sequence SHALL be terminated by a &quot;End of Message&quot; record. The
        requirement that all NTS-KE messages be terminated by an End of Message
        record makes them self-delimiting.</spanx>
        <vspace blankLines="1" /></t>
      <t>
        <spanx style="emph">Clients and servers MAY enforce length limits on requests and responses,
        however, servers MUST accept requests of at least 1024 octets and
        clients SHOULD accept responses of at least 65536 octets.</spanx>
        <vspace blankLines="1" /></t>

      <t>
        <spanx style="emph">The fields of an NTS-KE record are defined as follows:</spanx>
        <list>
          <t>
            <spanx style="emph">C (Critical Bit): Determines the disposition of unrecognized Record
            Types. Implementations which receive a record with an unrecognized
            Record Type MUST ignore the record if the Critical Bit is 0 and MUST
            treat it as an error if the Critical Bit is 1 (see Section 4.1.3).</spanx>
          <vspace blankLines="1" /></t>
          <t>
            <spanx style="emph">Record Type Number: A 15-bit integer in network byte order. The
            semantics of record types 0&ndash;7 are specified in this memo.
            Additional type numbers SHALL be tracked through the IANA Network
            Time Security Key Establishment Record Types registry.</spanx>
          <vspace blankLines="1" /></t>
          <t>
            <spanx style="emph">Body Length: The length of the Record Body field, in octets, as a
            16-bit integer in network byte order. Record bodies MAY have any
            representable length and need not be aligned to a word boundary.</spanx>
          <vspace blankLines="1" /></t>
          <t>
            <spanx style="emph">Record Body: The syntax and semantics of this field SHALL be
            determined by the Record Type.</spanx>
          <vspace blankLines="1" /></t>
        </list>
      </t>
      <t>
        <spanx style="emph">For clarity regarding bit-endianness: the Critical Bit is the
        most-significant bit of the first octet. In the C programming language,
        given a network buffer
        `unsigned char b[]` containing an NTS-KE record, the critical bit is
        `b[0] &gt;&gt; 7` while the record type is
        `((b[0] &amp; 0x7f) &lt;&lt; 8) + b[1]`.&quot;</spanx>
      </t>
</list></t>

      <figure anchor="fig-ntske-record" title="NTS-KE record format">
        <artwork><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|C|         Record Type         |          Body Length          |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
:                                                               :
:                           Record Body                         :
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]>
        </artwork>
      </figure>
	

<t>Thus, all NTS messages consist of a sequence of records, each containing a Critical Bit C, 
the Record Type, the Body Length and the Record Body, see <xref target="fig-ntske-record"/>. 
More details on record structure as well as the specific records used here are given in 
<xref target="nts-messages-4-ptp"/> and respective subsections there. So-called container 
records (short: container) themselves comprise a set of records in the record body that 
serve a specific purpose, e.g., the Current Parameters container record.</t>

<t>The records contained in a message may follow in arbitrary sequence (though nothing 
speaks against using the sequence given in the record descriptions), only the End of 
Message record has to be the last one in the sequence indicating the end of the current 
message. Container records do not include an End of Message record.</t>

<t>The NTS key management for PTP is based on six new NTS messages:</t>

<t> </t>
            <t><list style="symbols">
			  <t>PTP Key Request message (see <xref target="key-request"/>)</t>			  
			  <t>PTP Key Response message (see <xref target="key-response"/>)</t>
              <t>PTP Registration Request message (see <xref target="registration-request"/>)</t>
              <t>PTP Registration Response message (see <xref target="registration-response"/>)</t>
              <t>PTP Registration Revoke message (see <xref target="registration-revoke"/>)</t>
			  <t>Heartbeat message (see <xref target="heartbeat"/>)</t>
            </list>
          </t>



<t>The following sections describe the principle structure of those new NTS messages for the PTP key 
management. More details especially on the records the messages are built of and their types, sizes, 
requirements and restrictions are given in <xref target="nts-records"/>.</t>


<section anchor="key-request" title="PTP Key Request Message">


      <figure anchor="fig-key-request" title="Structure of a PTP Key Request message">
        <artwork><![CDATA[
PTP Key Request (NTS-KE protocol)
+===================================+==========================+
| Record                            | Exemplary body contents  |
+===================================+==========================+
| NTS Next Protocol Negotiation     | PTPv2.1                  |
+-----------------------------------+--------------------------+
| Association Mode                  | {Assoc.Type||Assoc.Val.} |
+-----------------------------------+--------------------------+
| Supported MAC Algorithms (opt.)   | CMAC                     |
+-----------------------------------+--------------------------+
| Source PortIdentity (unicast only)| {binary data}            |
+-----------------------------------+--------------------------+
| End of Message                    |                          |
+===================================+==========================+
]]>
        </artwork>
      </figure>
	  

<t><xref target="fig-key-request"/> shows the record structure of a PTP Key Request message. 
In the right column typical values are shown as examples. Detailed information on types, sizes 
etc. is given in <xref target="nts-records"/>. The message starts with the NTS Next Protocol 
Negotiation record which in this application always holds PTPv2.1. The following Association 
Mode record describes the mode how the PTP instance wants to communicate: In the group-based 
approach the desired group number (plus eventually the subgroup attribute) is given. For 
ticket-based unicast communication the Association Mode contains the identification of the 
desired grantor, for example IPv4 and its IP address.</t>


<t>Only in TiBA, an optional record may follow. It offers the possibility to choose from 
additional MAC algorithms and presents the supported algorithms from which the NTS-KE server 
may choose. Again, only in ticket-based unicast mode, the Source PortIdentity record gives 
the data of the identification of the applying requester, for example IPv4 and its IP address. 
The messages always end with an End of Message record.</t>

</section>


<section anchor="key-response" title="PTP Key Response Message">

<t><xref target="fig-key-response"/> shows the record structure of a PTP Key Response message 
from the NTS-KE server (NTS-KE protocol). In the right column typical values are shown as examples. 
Detailed information on types, sizes etc. is given in <xref target="nts-records"/>. 
The message starts with the NTS Next Protocol Negotiation record which in this application always 
holds PTPv2.1.</t>



      <figure anchor="fig-key-response" title="Structure of a PTP Key Response message.">
        <artwork><![CDATA[
PTP Key Response (NTS-KE protocol) 
+==================================+===========================+
| Record                           | Exemplary body contents   |
+==================================+===========================+
| NTS Next Protocol Negotiation    | PTPv2.1                   |
+----------------------------------+---------------------------+
| Current Parameters               | set of Records {...}      |
+----------------------------------+---------------------------+
| Next Parameters                  | set of Records {...}      |
+----------------------------------+---------------------------+
| End of Message                   |                           |
+==================================+===========================+


PTP Key Response (NTS-KE protocol) - in case of an error
+==================================+===========================+
| Record                           | Exemplary body contents   |
+==================================+===========================+
| NTS Next Protocol Negotiation    | PTPv2.1                   |
+----------------------------------+---------------------------+
| Error                            | Not authorized            |
+----------------------------------+---------------------------+
| End of Message                   |                           |
+==================================+===========================+
]]>
        </artwork>
      </figure>
	  

<t>The following Current Parameters record is a container record containing in separate records 
all the security data needed to join and communicate in the secured PTP communication during the 
current validity period. <xref target="fig-current-container-key"/> gives an example of data 
contained in that record. For more details on the records contained in the Current Parameters 
container record see <xref target="current-parameters-container"/>.</t>


      <figure anchor="fig-current-container-key" title="Exemplary contents of a Current Parameters 
	                                                      container record of a PTP Key Response message">
        <artwork><![CDATA[
Current Parameters container record (PTP Key Response)
+================================+==============================+
| Record                         | Exemplary body contents      |
+================================+========+=====================+
| Security Association           | data set {...}               |
+--------------------------------+------------------------------+
| Validity Period                | {1560s || 300s || 10s}       |
+--------------------------------+------------------------------+
| PTP Time Server (unicast only) | data set {...}               |
+--------------------------------+------------------------------+
| Ticket (unicast only)          | data set {...}               |
+================================+==============================+
]]>
        </artwork>
      </figure>
	  


<t>If the request lies inside the update period, a Next Parameters container record is additionally
appended in the PTP Key Response message giving all the security data needed in the upcoming 
validity period. Its structure follows the same composition as the Current Parameters container
record. In case of an error, both parameters container records are removed and a single error record 
is inserted (see the lower part of <xref target="fig-key-response"/>). The messages always end with an End of Message record.</t>

</section>

 
<section anchor="registration-request" title="PTP Registration Request Message">

      <figure anchor="fig-registration-request" title="Structure of a PTP Registration Request message">
        <artwork><![CDATA[
PTP Registration Request  (NTS-TSR protocol)
+============================+=================================+
| Record                     | Exemplary body contents         |
+============================+=================================+
| NTS Message Type           | PTP Registration Request || v1.0|
+----------------------------+---------------------------------+
| PTP Time Server            | data set {...}                  |
+----------------------------+---------------------------------+
| AEAD Algorithm Negotiation | {AEAD_512 || AEAD_256}          |
+----------------------------+---------------------------------+
| Supported MAC Algorithms   | {CMAC || HMAC}                  |
+----------------------------+---------------------------------+
| End of Message             |                                 |
+============================+=================================+
]]>
        </artwork>
      </figure>
	  
<t>The PTP Registration Request message (NTS-TSR protocol) starts with the NTS Message Type record 
containing the message type as well as the message version number, here always 1.0, see 
<xref target="fig-registration-request"/>. (As the message belongs to the NTS-TSR protocol, no 
NTS Next Protocol Negotiation record is necessary.)</t>

<t>The PTP Time Server record presents all known network addresses of this grantor that are 
supported for a unicast connection. The following AEAD Algorithm Negotiation record indicates 
which algorithms for encryption of the ticket the grantor supports.</t>

<t>Then the next record (not optional as in PTP Key Request) follows, presenting all the grantor's 
supported MAC algorithms. The Supported MAC Algorithms record contains a list and comprises the MAC 
algorithms supported by the grantor that are feasible for calculating the ICV when securing the 
PTP messages in TiBA. The message always ends with an End of Message record.</t>

</section>


<section anchor="registration-response" title="PTP Registration Response Message">

      <figure anchor="fig-registration-response" title="Structure of a PTP Registration Response message">
        <artwork><![CDATA[
PTP Registration Response (NTS-TSR protocol)
+=========================+====================================+
| Record                  | Exemplary body contents            |
+=========================+====================================+
| NTS Message Type        | PTP Registration Response || v1.0  |
+-------------------------+------------------------------------+
| Current Parameters      | set of Records {...}               |
+-------------------------+------------------------------------+
| Next Parameters         | set of Records {...}               |
+-------------------------+------------------------------------+
| Heartbeat Timeout (opt.)| 900s                               |
+-------------------------+------------------------------------+
| End of Message          |                                    |
+=========================+====================================+


PTP Registration Response (NTS-TSR protocol)- in case of an error
+=========================+====================================+
| Record                  | Exemplary body contents            |
+=========================+====================================+
| NTS Message Type        | PTP Registration Response || v1.0  |
+-------------------------+------------------------------------+
| Error                   | Not authorized                     |
+-------------------------+------------------------------------+
| End of Message          |                                    |
+=========================+====================================+

]]>
        </artwork>
      </figure>
	  

<t>The PTP Registration Response message (NTS-TSR protocol) from the NTS-KE server starts 
with the NTS Message Type record containing the message type as well as the message version 
number, here always 1.0, see <xref target="fig-registration-response"/>. (As the message 
belongs to the NTS-TSR protocol, no NTS Next Protocol Negotiation record is necessary.)</t>

<t>As in the NTS-KE protocol, the following Current Parameters record is a container record 
containing in separate records all the necessary parameters for the current validity period. 
<xref target="fig-current-container-registration"/> gives an example of data contained in 
that record. For more details on the records contained in the Current Parameters container  
record see <xref target="current-parameters-container"/>.</t>

      <figure anchor="fig-current-container-registration" title="Exemplary contents of a Current 
	                                                        Parameters container record of a 
															PTP Registration Response message
															in the NTS-TSR protocol">
        <artwork><![CDATA[
Current Parameters container record (PTP Registration Response)
+===============================+==============================+
| Record                        | Exemplary body contents      |
+===============================+==============================+
| AEAD Algorithm Negotiation    | AEAD_AES_SIV_CMAC_512        |
+-------------------------------+------------------------------+
| Validity Period               | {2460s || 400s || 10s}       |
+-------------------------------+------------------------------+
| Ticket Key ID                 | 278                          |
+-------------------------------+------------------------------+
| Ticket Key                    | {binary data}                |
+===============================+==============================+
]]>
        </artwork>
      </figure>
	  

<t>If the registration request lies inside the update period a Next Parameters container 
record is additionally appended giving all the security data needed in the upcoming validity period. Its 
structure follows the same composition as the Current Parameters container record. The 
messages always end with an End of Message record.</t>

</section>


<section anchor="registration-revoke" title="PTP Registration Revoke Message">


      <figure anchor="fig-registration-revoke" title="Structure of a PTP Registration Revoke message">
	  
        <artwork><![CDATA[
PTP Registration Revoke (NTS-TSR protocol)
+================================+=============================+
| Record                         | Exemplary body contents     |
+================================+=============================+
| NTS Message Type               | PTP Registr. Revoke || v1.0 |
+--------------------------------+-----------------------------+
| Source PortIdentity            | {binary data}               |
+--------------------------------+-----------------------------+
| End of Message                 |                             |
+================================+=============================+
]]>
        </artwork>
      </figure>


<t>The PTP Registration Revoke message (NTS-TSR protocol) from the grantor starts with 
the NTS Message Type record containing the message type as well as the message version 
number, here always 1.0, see <xref target="fig-registration-revoke"/>. (As the message 
belongs to the NTS-TSR protocol, no NTS Next Protocol Negotiation record is necessary.)</t>

<t>The second record contains the Source PortIdentity which identifies the grantor 
   wanting to stop its unicast support. This allows the NTS-KE server to uniquely identify 
   the grantor if the PTP device communicates with the NTS-KE server via a management port 
   running multiple grantors. The message always ends with an End of Message record. </t>

</section>

<section anchor="heartbeat" title="Heartbeat Message">

      <figure anchor="fig-heartbeat" title="Structure of a Heartbeat message in the NTS-TSR protocol">
	  
        <artwork><![CDATA[
Heartbeat (NTS-TSR protocol)
+================================+=============================+
| Record                         | Exemplary body contents     |
+================================+=============================+
| NTS Message Type               | Heartbeat || v1.0           |
+--------------------------------+-----------------------------+
| Status (optional)              | server load: low            |
+--------------------------------+-----------------------------+
| End of Message                 |                             |
+================================+=============================+
]]>
        </artwork>
      </figure>


<t>The Heartbeat message (NTS-TSR protocol) from the grantor to the NTS-KE server starts 
with the NTS Message Type record containing the message type as well as the message version 
number, here always 1.0, see <xref target="fig-heartbeat"/>. (As the message belongs to the 
NTS-TSR protocol, no NTS Next Protocol Negotiation record is necessary.)</t>

<t>The second record contains the optional Status record which allows the grantor to present 
various status updates to the NTS-KE server. The message always ends with an End of Message record.</t>

<t>Heartbeat messages provide grantors with the ability to send messages to the NTS-KE server 
at regular intervals to signal their own functionality. These messages can optionally also 
contain one or multiple status records (see <xref target="fig-heartbeat"/>), for example to 
improve load balancing between the registered time servers or to provide additional monitoring. 
The NTS-KE server MUST accept Heartbeat messages from a grantor if they have been previously 
requested by the NTS-KE server in the Registration Response message. However, the NTS-KE server 
MAY discard heartbeat messages if they arrive more frequently than specified by the heartbeat 
timeout (see <xref target="heartbeat"/>). If the NTS-KE server receives heartbeat messages from a 
grantor even though it is not requested, the NTS-KE server SHOULD discard these messages 
and not process them further. Processing of the status information is optional and the status 
records MAY be ignored by the NTS-KE server. If the Grantor sends heartbeat messages to the 
NTS-KE server, the frames SHOULD NOT exceed the maximum transmission unit (MTU, 1500 octets 
for Ethernet).</t>

</section>

</section>
</section>




<section anchor="nts-messages-4-ptp" title="NTS Messages for PTP">

<t>This section covers the structure of the NTS messages and the details of the respective 
payload. The individual parameters are transmitted by NTS records, which are described in 
more detail in <xref target="nts-records"/>. In addition to the NTS records defined for 
NTP in IETF RFC8915, further records are required, which are listed in 
<xref target="tbl_nts_ke_record_registry"/> below and begin with Record Type 1024 (compare IETF RFC 8915 
<xref target="RFC8915"/>, Section 7.6.  Network Time Security Key Establishment Record Types Registry).</t>


	<texttable anchor="tbl_nts_ke_record_registry" title="NTS Key Establishment and Time Server Registration record types registry">
        <!--   <preamble><spanx style="strong"></spanx></preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">NTS Record Types</ttcol>
        <ttcol align="left">Description</ttcol>
        <ttcol align="left">Record Used in Protocol</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>End of Message</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c><xref target="RFC8915"/>, Section 4.1.1; this document, <xref target="end-of-message"/> </c>
		<!-- 2nd row:  -->
          <c>1</c>
          <c>NTS Next Protocol Negotiation</c>
          <c>NTS-KE</c>
		  <c><xref target="RFC8915"/>, Section 4.1.2; this document, <xref target="nts-next-protocol-nego"/> </c>
		<!-- 3rd row:  -->
          <c>2</c>
          <c>Error</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c><xref target="RFC8915"/>, Section 4.1.3; this document, <xref target="error"/> </c>
		<!-- 4th row:  -->
          <c>3</c>
          <c>Warning</c>
          <c>NTS-KE</c>
		  <c><xref target="RFC8915"/>, Section 4.1.4; not used for PTP</c>
		<!-- 5th row:  -->
          <c>4</c>
          <c>AEAD Algorithm Negotiation</c>
          <c>NTS-TSR</c>
		  <c><xref target="RFC8915"/>, Section 4.1.5; this document, <xref target="aead-negotiation"/> </c>
		<!-- 6th row:  -->
          <c>5</c>
          <c>New Cookie for NTPv4</c>
          <c>NTS-KE</c>
		  <c><xref target="RFC8915"/>, Section 4.1.6; not used for PTP</c>
		<!-- 7th row:  -->
          <c>6</c>
          <c>NTPv4 Server Negotiation</c>
          <c>NTS-KE</c>
		  <c><xref target="RFC8915"/>, Section 4.1.7; not used for PTP</c>
		<!-- 8th row:  -->
          <c>7</c>
          <c>NTPv4 Port Negotiation</c>
          <c>NTS-KE</c>
		  <c><xref target="RFC8915"/>, Section 4.1.8; not used for PTP</c>
		<!-- 9th row:  -->
          <c>8 - 1023</c>
          <c>Reserved for NTP</c>
          <c></c>
		  <c></c>
		<!-- 10th row:  EMPTY-->
          <c></c>
          <c></c>
          <c></c>
		  <c></c>
		<!-- 11th row:  -->
          <c>1024</c>
          <c>Association Mode</c>
          <c>NTS-KE</c>
		  <c>This document, <xref target="association-mode"/> </c>
		<!-- 12th row:  -->
          <c>1025</c>
          <c>Current Parameters</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c>This document, <xref target="current-parameters-container"/> </c>
		<!-- 13th row:  XXXXXX-->
          <c>1026</c>
          <c>Heartbeat Timeout</c>
          <c>NTS-TSR</c>
		  <c>This document, <xref target="heartbeat-timeout"/> </c>
		<!-- 14th row:  -->
          <c>1027</c>
          <c>Next Parameters Container</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c>This document, <xref target="next-parameters-container"/> </c>
		<!-- 15th row:  -->
          <c>1028</c>
          <c>NTS Message Type</c>
          <c>NTS-TSR</c>
		  <c>This document, <xref target="nts-message-type"/> </c>
		<!-- 16th row:  -->
          <c>1029</c>
          <c>PTP Time Server</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c>This document, <xref target="ptp-time-server"/> </c>
		<!-- 17th row:  -->
          <c>1030</c>
          <c>Security Association</c>
          <c>NTS-KE</c>
		  <c>This document, <xref target="security-association"/> </c>
		<!-- 18th row:  -->
          <c>1031</c>
          <c>Source PortIdentity</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c>This document, <xref target="source-portidentity"/>   </c>
		<!-- 19th row:  -->
          <c>1032</c>
          <c>Status</c>
          <c>NTS-TSR</c>
		  <c>This document, <xref target="status"/> </c>
		<!-- 20th row:  -->
          <c>1033</c>
          <c>Supported MAC Algorithms</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c>This document, <xref target="supported-mac-algos"/> </c>
		<!-- 21th row:  -->
          <c>1034</c>
          <c>Ticket</c>
          <c>NTS-TSR</c>
		  <c>This document, <xref target="ticket"/> </c>
		<!-- 22th row:  -->
          <c>1035</c>
          <c>Ticket Key</c>
          <c>NTS-TSR</c>
		  <c>This document, <xref target="ticket-key"/> </c>
		<!-- 23th row:  -->
          <c>1036</c>
          <c>Ticket Key ID</c>
          <c>NTS-TSR</c>
		  <c>This document, <xref target="ticket-key-id"/> </c>
		<!-- 24th row:  -->
          <c>1037</c>
          <c>Validity Period</c>
          <c>NTS-KE/NTS-TSR</c>
		  <c>This document, <xref target="validity-period"/> </c>
		<!-- 25th row:  -->
          <c>1038 - 16383</c>
          <c>Unassigned</c>
		  <c></c>
		  <c></c>
		<!-- 26th row:  EMPTY  -->
          <c></c>
          <c></c>
		  <c></c>
		  <c></c>
		<!-- 27th row:  -->
          <c>16384 - 32767</c>
          <c>Reserved for Private or Experimental Use</c>
		  <c></c>
		  <c><xref target="RFC8915"/> </c>

        <!-- <postamble></postamble>   -->
    </texttable>




<section anchor="nts-message-types" title="NTS Message Types">

<t>This section repeats the composition of the specific NTS messages for the PTP key 
management in overview form. The specification of the respective records from which the 
messages are constructed follows in <xref target="nts-records"/>. The reference column 
in the tables refer to the specific subsections.</t>

<t>The NTS messages MUST contain the records given for the particular message though not 
necessarily in the same sequence indicated. Only the End of Message record MUST be 
the final record.</t>

	<texttable anchor="tbl_ptp_key_request" title="Record structure of the PTP Key Request message">
        <preamble><spanx style="strong">PTP Key Request  (NTS-KE protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode*</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>NTS Next Protocol Negotiation</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="nts-next-protocol-nego"/> </c>
		<!-- 2nd row:  -->
          <c>Association Mode</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="association-mode"/> </c>
		<!-- 3rd row:  -->
          <c>Supported MAC Algorithms</c>
          <c>TiBA</c>
          <c>optional</c>
		  <c>This document, <xref target="supported-mac-algos"/> </c>
		<!-- 4th row:  -->
          <c>Source PortIdentity</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="source-portidentity"/> </c>
		<!-- 5th row:  -->
          <c>End of Message</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="end-of-message"/> </c>

        <postamble>* The Mode column refers to the intended use of the particular record for the respective PTP communication mode.</postamble>   
    </texttable>


	<texttable anchor="tbl_ptp_key_response" title="Record structure of the PTP Key Response message.
	                                                In case of an error, both parameters container records
													are removed and a single error record is inserted.">
        <preamble><spanx style="strong">PTP Key Response (NTS-KE protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>NTS Next Protocol Negotiation</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="nts-next-protocol-nego"/> </c>
		<!-- 2nd row:  -->
          <c>Current Parameters</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="current-parameters-container"/> </c>
		<!-- 3rd row:  -->
          <c>Next Parameters Container</c>
          <c>GrBA / TiBA</c>
          <c>mandatory (only during update period)</c>
		  <c>This document, <xref target="next-parameters-container"/> </c>
		<!-- 4th row:  -->
          <c>End of Message</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="end-of-message"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>

<t>The structure of the respective container records (Current Parameters and Next 
   Parameters) used in the PTP Key Response message is given below:</t>


	<texttable anchor="tbl_container" title="Record structure of the container records">
        <preamble><spanx style="strong">Current/Next Parameters container - PTP Key Response (NTS-KE protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Security Association</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="security-association"/> </c>
		<!-- 2nd row:  -->
          <c>Validity Period</c>
          <c>GrBA / TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="validity-period"/> </c>
		<!-- 3th row:  -->
          <c>PTP Time Server</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="ptp-time-server"/> </c>
		<!-- 4th row:  -->
          <c>Ticket</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="ticket"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>




	<texttable anchor="tbl_ptp_registration_request" title="Record structure of the PTP Registration Request message">
        <preamble><spanx style="strong">PTP Registration Request (NTS-TSR protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>NTS Message Type</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="nts-message-type"/> </c>
		<!-- 2nd row:  -->
          <c>PTP Time Server</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="ptp-time-server"/> </c>
		<!-- 3rd row:  -->
          <c>AEAD Algorithm Negotiation</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="aead-negotiation"/> </c>
		<!-- 4th row:  -->
          <c>Supported MAC Algorithms</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="supported-mac-algos"/> </c>
		<!-- 5th row:  -->
          <c>End of Message</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="end-of-message"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>



	<texttable anchor="tbl_ptp_registration_response" title="Record structure of the PTP Registration Response message.
	                                                         In case of an error, both parameters container records
													         are removed and a single error record is inserted.">
	
        <preamble><spanx style="strong">PTP Registration Response (NTS-TSR protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
       <c>NTS Message Type</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="nts-message-type"/> </c>
		<!-- 2nd row:  -->
          <c>Current Parameters</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="current-parameters-container"/> </c>
		<!-- 3rd row:  -->
          <c>Next Parameters</c>
          <c>TiBA</c>
          <c>mandatory (only during update period)</c>
		  <c>This document, <xref target="next-parameters-container"/> </c>
		<!-- 4th row:  -->
          <c>Heartbeat Timeout</c>
          <c>TiBA</c>
          <c>optional</c>
		  <c>This document, <xref target="heartbeat-timeout"/> </c>
		<!-- 6th row:  -->
          <c>End of Message</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="end-of-message"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>


<t>The structure of the respective container records (Current Parameters and Next Parameters 
   ) used in the PTP Registration Response message is given below:</t>
   

	<texttable anchor="tbl_container_in_response" title="Record structure of the container records in the PTP Registration Response message">
        <preamble><spanx style="strong">Current/Next Parameters container - PTP Registration Response (NTS-TSR protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>AEAD Algorithm Negotiation</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="aead-negotiation"/> </c>
		<!-- 2nd row:  -->
          <c>Validity Period</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="validity-period"/> </c>
		<!-- 3rd row:  -->
          <c>Ticket Key ID</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="ticket-key-id"/> </c>
		<!-- 6th row:  -->
          <c>Ticket Key</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="ticket-key"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>


	<texttable anchor="tbl_ptp_registration_revoke" title="Record structure of the PTP Registration Revoke message">
        <preamble><spanx style="strong">PTP Registration Revoke (NTS-TSR protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>NTS Message Type</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="nts-message-type"/> </c>
		<!-- 2nd row:  -->
          <c>Source PortIdentity</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="source-portidentity"/> </c>
		<!-- 3rd row:  -->
          <c>End of Message</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="end-of-message"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>


	<texttable anchor="tbl_heartbeat" title="Record structure of the Heartbeat message in the NTS-TSR protocol">
        <preamble><spanx style="strong">Heartbeat Message (NTS-TSR protocol)</spanx></preamble>

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Mode</ttcol>
        <ttcol align="center">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>NTS Message Type</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="nts-message-type"/> </c>
		<!-- 2nd row:  -->
          <c>Status</c>
          <c>TiBA</c>
          <c>optional</c>
		  <c>This document, <xref target="status"/> </c>
		<!-- 3rd row:  -->
          <c>End of Message</c>
          <c>TiBA</c>
          <c>mandatory</c>
		  <c>This document, <xref target="end-of-message"/> </c>

<!--        <postamble></postamble>   -->
    </texttable>


</section>




<section anchor="nts-records" title="NTS Records">


<t>The following subsections describe the specific NTS records used to construct the NTS 
messages for the PTP key management system in detail. They appear in alphabetic sequence 
of their individual names. See <xref target="nts-message-types"/> for the application of 
the records in the respective messages.</t>

<t>Note: For easier editing of the content, most of the descriptions in the following 
subsections are written as bullet points.</t>



<section anchor="aead-negotiation" title="AEAD Algorithm Negotiation">

	<t>Used in NTS-TSR protocol</t>


	<t>This record is required in unicast mode and enables the negotiation of the AEAD 
	algorithm needed to encrypt and decrypt the ticket. The negotiation takes place between 
	the PTP grantor and the NTS-KE server by using the NTS registration messages. The 
	structure and properties follow the record defined in IETF RFC 8915 <xref target="RFC8915"/>, Section 4.1.5.</t>

	<t>Content and conditions:</t>
	<t><list style="symbols">
	   <t>The record has a Record Type number of 4 and the Critical Bit MAY be set.</t>
	   <t>The Record Body contains a sequence of 16-bit unsigned integers in network byte order:<vspace blankLines="1" />
	      <spanx style="strong">Supported AEAD Algorithms = {AEAD 1 || AEAD 2 || …}</spanx></t>
	</list></t>

	<!-- <t>Supported AEAD Algorithms = {AEAD 1 || AEAD 2 || …}</t>   -->

	<t><list style="symbols">
		<t>Each integer represents a numeric identifier of an AEAD algorithm registered by the IANA.
		   (https://www.iana.org/assignments/aead-parameters/aead-parameters.xhtml)</t> 
		<t>Duplicate identifiers SHOULD NOT be included.</t>
		<t>Grantor and NTS-KE server MUST support at least the AEAD_AES_SIV_CMAC_256 algorithm.</t>
		<t>A list of recommended AEAD algorithms is shown in the following <xref target="tbl_aead"/>.</t> 
	    <t>Other AEAD algorithms MAY also be used.</t>
	</list></t>
	
	<texttable anchor="tbl_aead" title="AEAD algorithms">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Numeric ID</ttcol>
        <ttcol align="left">AEAD Algorithm</ttcol>
        <ttcol align="left">Use</ttcol>
        <ttcol align="center">Key Length (Octets)</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>15</c>
          <c>AEAD_AES_SIV_CMAC_256</c>
          <c>mand.</c>                      <!-- abbreviated, table to large in text mode  -->
          <c>16</c>
          <c><xref target="RFC5297"/></c>
		<!-- 2nd row:  -->
          <c>16</c>
          <c>AEAD_AES_SIV_CMAC_384</c>
          <c>opt.</c>                      <!-- abbreviated, table to large in text mode  -->
          <c>24</c>
          <c><xref target="RFC5297"/></c>
		<!-- 3rd row:  -->
          <c>17</c>
          <c>AEAD_AES_SIV_CMAC_512</c>
          <c>opt.</c>                      <!-- abbreviated, table to large in text mode  -->
          <c>32</c>
          <c><xref target="RFC5297"/></c>
		<!-- 4th row:  -->
          <c>32 - 32767</c>
          <c>Unassigned</c>
          <c></c>
          <c></c>
          <c></c>
		<!-- 5th row:  -->
          <c>32768 - 65535</c>
          <c>Reserved for Private or Experimental Use</c>
          <c></c>
          <c></c>
          <c><xref target="RFC5116"/></c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

	<t><list style="symbols">
		<t>In a PTP Registration Request message, this record MUST be contained exactly once.</t>
		<t>In that message at least the AEAD_AES_SIV_CMAC_256 algorithm MUST be included.</t>
		<t>If multiple AEAD algorithms are supported, the grantor SHOULD put the algorithm identifiers in descending priority in the Record Body.</t>
		<t>Strong algorithms with higher bit lengths SHOULD have higher priority.<vspace blankLines="1" /></t>

		<t>In a PTP Registration Response message, this record MUST be contained exactly once in the Current Parameters 
		   container record and exactly once in the Next Parameters container record.</t>
		<t>The Next Parameters container record MUST be present only during the update period.</t>
		<t>The NTS-KE server SHOULD choose the highest priority AEAD algorithm from the request message that grantor and NTS-KE server support.</t>
		<t>The NTS-KE server MAY ignore the priority and choose a different algorithm that grantor and NTS-KE server support.</t>
		<t>In a PTP Registration Response message, this record MUST contain exactly one AEAD algorithm.</t>
		<t>The selected algorithm MAY differ in the corresponding Current Parameters container record and Next Parameters container record.</t>
	</list></t>


</section>


<section anchor="association-mode" title="Association Mode">

	<t>Used in NTS-KE protocol</t>

	<t>This record enables the NTS-KE server to distinguish between a group based request 
	(multicast, mixed multicast/unicast, Group-of-2) or a unicast request. A multicast 
	request carries a group number, while a unicast request contains an identification 
	attribute of the grantor (e.g., IP address or PortIdentity).</t>

	<t>Content and conditions:</t>
	<t><list style="symbols">
	   <t>In a PTP Key Request message, this record MUST be contained exactly once.</t>
	   <t>The record has a Record Type number of 1024 and the Critical Bit MAY be set.</t>
	   <t>The Record Body SHALL consist of two data fields:</t>
	</list></t>
	
	<texttable anchor="tbl_assoc" title="Association">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Association Type</c>
          <c>2</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>Association Value</c>
          <c>A</c>
          <c>2</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

	<t><list style="symbols">
       <t>The Association Type is a 16-bit unsigned integer.</t>
       <t>The length of Association Value depends on the value of Association Type.</t>
       <t>All data in the fields are stored in network byte order.</t>
       <t>The type numbers of Association Type as well as the length and content of Association 
	      Value are shown in the following table and more details are given below.</t>
	</list></t>

	<texttable anchor="tbl_assoc_types" title="Association Types">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Description</ttcol>
        <ttcol align="center">Assoc. Type Number</ttcol>
        <ttcol align="left">Association Mode</ttcol>
        <ttcol align="left">Association Value Content</ttcol>
        <ttcol align="center">Assoc. Value Octets</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Group</c>
          <c>0</c>
          <c>Multicast / Unicast*</c>
          <c>Group Number</c>
          <c>5</c>
		<!-- 2nd row:  -->
          <c>IPv4</c>
          <c>1</c>
          <c>Unicast</c>
          <c>IPv4 address of the target port</c>
          <c>4</c>
		<!-- 3rd row:  -->
          <c>IPv6</c>
          <c>2</c>
          <c>Unicast</c>
          <c>IPv6 address of the target port</c>
          <c>16</c>
		<!-- 4th row:  -->
          <c>802.3</c>
          <c>3</c>
          <c>Unicast</c>
          <c>MAC address of the target port</c>
          <c>6</c>
		<!-- 5th row:  -->
          <c>PortIdentity</c>
          <c>4</c>
          <c>Unicast</c>
          <c>PortIdentity of the target PTP entity</c>
          <c>10</c>

    <postamble>Unicast*: predefined groups of two (Group-of-2, Go2, see Group entry below)</postamble>
    </texttable>
	
    <t>Group:</t>
	<t><list style="symbols">
      <t>This association type allows a PTP instance to join a PTP multicast group.</t>
      <t>A group is identified by the PTP domain, the PTP profile (sdoId) and a sub-group attribute (see table below).</t>
      <t>The PTP domainNumber is an 8-bit unsigned integer in the closed range 0 to 255.</t>
      <t>The sdoId of a PTP domain is a 12-bit unsigned integer in the closed range 0 to 4095:
      <list style="symbols">
         <t>The most significant 4 bits are named the majorSdoId.</t>
         <t>The least significant 8 bits are named the minorSdoId.</t>
         <t>Reference: IEEE Std 1588-2019, Section 7.1.1	<vspace blankLines="1" /> </t>
      </list><spanx style="strong">sdoId = {majorSdoId || minorSdoId}</spanx></t>
	</list></t>
	
	<!--   <t>sdoId = {majorSdoId || minorSdoId}</t>	-->

	<t><list style="symbols">
      <t>The subGroup is 16-bit unsigned integer, which allows the division of a PTP multicast network into separate groups, each with individual security parameters.</t>
      <t>This also allows manually configured unicast connections (Group-of-2), which can include transparent clocks as well.</t>
      <t>The subGroup number is defined manually by the administrator.</t> 
      <t>Access to the groups is controlled by authorization procedures of the PTP devices (see <xref target="upfront-authorization"/>).</t>
      <t>If no subgroups are required (= multicast mode), this attribute MUST contain the value zero.<vspace blankLines="1" /></t>

      <t>The group number is eventually formed by concatenation of the following values:<vspace blankLines="1" />
	     <spanx style="strong">group number = {domainNumber || 4 bit zero padding || sdoId || subGroup}</spanx></t>
	</list></t>
	
	<!-- <t><spanx style="strong">group number = {domainNumber || 4 bit zero padding || sdoId || subGroup}</spanx></t>   -->

	<texttable anchor="tbl_group" title="Group Association">
    <preamble>This is equvalent to:</preamble>

		<!-- table header:  -->
        <ttcol align="center">Bits 7 - 4</ttcol>
        <ttcol align="center">Bits 3 - 0</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>domainNumber (high)</c>
          <c>domainNumber (low)</c>
          <c>1</c>
          <c>0</c>

		<!-- 2nd row:  -->
          <c>zero padding</c>
          <c>majorSdoId</c>
          <c>1</c>
          <c>1</c>
		<!-- 3rd row:  -->
          <c>minorSdoId (high)</c>
          <c>minorSdoId (low)</c>
          <c>1</c>
          <c>2</c>
		<!-- 4th row:  -->
          <c>subgroup (high)</c>
          <c>subGroup (low)</c>
          <c>2</c>
          <c>4</c>

    <!--   <postamble></postamble>   -->
    </texttable>


<t>IPv4:</t>
	<t><list style="symbols">
      <t>This Association Type allows a requester to establish a PTP unicast connection to the desired grantor.</t>
      <t>The Association Value contains the IPv4 address of the target PTP entity.</t>
      <t>The total length is 4 octets.</t>
	</list></t>
	
<t>IPv6:</t>
	<t><list style="symbols">
      <t>This Association Type allows a requester to establish a PTP unicast connection to the desired grantor.</t>
      <t>The Association Value contains the IPv6 address of the target PTP entity.</t>
      <t>The total length is 16 octets.</t>
	</list></t>
	
<t>802.3:</t>
	<t><list style="symbols">
      <t>This Association Type allows a requester to establish a PTP unicast connection to the desired grantor.</t>
      <t>The Association Value contains the MAC address of the Ethernet port of the target PTP entity.</t>
      <t>The total length is 6 octets.</t>
      <t>This method supports the 802.3 mode in PTP, where no UDP/IP stack is used.</t>
	</list></t>
	
<t>PortIdentity:</t>
	<t><list style="symbols">
      <t>This Association Type allows a requester to establish a PTP unicast connection to the desired grantor.</t>
      <t>The Association Value contains the PortIdentity of the target PTP entity.</t>
      <t>The total length is 10 octets.<vspace blankLines="1" /></t>

      <t>The PortIdentity consists of the attributes clockIdentity and portNumber:<vspace blankLines="1" />
	     <spanx style="strong">PortIdentity = {clockIdentity || portNumber}</spanx></t>
	</list></t>
	
	<!--  <t>PortIdentity = {clockIdentity || portNumber}</t>   -->

	<t><list style="symbols">
      <t>The clockIdentity is an 8 octet array and the portNumber is a 16-bit unsigned integer.</t>
      <t>Source: IEEE Std 1588-2019, Sections 5.3.5 and 7.5</t>
	</list></t>

	
</section>


<section anchor="current-parameters-container" title="Current Parameters">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

	<t>This record is a simple container that can carry an arbitrary number of NTS 
	records. It holds all security parameters relevant for the current validity period. 
	The content as well as further conditions are defined by the respective NTS messages. 
	The order of the included records is arbitrary and the parsing rules are so far 
	identical with the NTS message. One exception: An End of Message record SHOULD NOT 
	be present and MUST be ignored. When the parser reaches the end of the Record Body 
	quantified by the Body Length, all embedded records have been processed.</t>

	<t>Content and conditions:</t>
	<t><list style="symbols">
       <t>The record has a Record Type number of 1025 and the Critical Bit MAY be set.</t>
       <t>In a PTP Key Response message, this record MUST be contained exactly once.</t>
       <t>The Record Body is defined as a set of records and MAY contain the following records:</t>
       </list></t>

	<texttable anchor="tbl_curr_param_key" title="Current Parameters container for PTP Key Response message">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Comunication Type</ttcol>
        <ttcol align="left">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Security Associations (one or more)</c>
          <c>Multicast / Unicast</c>
          <c>mandatory</c>
          <c>This document, <xref target="security-association"/></c>
		<!-- 2nd row:  -->
          <c>Validity Period</c>
          <c>Multicast / Unicast</c>
          <c>mandatory</c>
          <c>This document, <xref target="validity-period"/></c>
		<!-- 3rd row:  -->
          <c>PTP Time Server</c>
          <c>Unicast</c>
          <c>mandatory</c>
          <c>This document, <xref target="ptp-time-server"/></c>
		<!-- 4th row:  -->
          <c>Ticket</c>
          <c>Unicast</c>
          <c>mandatory</c>
          <c>This document, <xref target="ticket"/></c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>


	<t><list style="symbols">
       <t>The records Security Association and Validity Period MUST be contained exactly once.</t>
       <t>Additionally, the records PTP Time Server and Ticket MUST be included exactly once if 
	      the client wants a unicast connection and MUST NOT be included if the client wants to 
		  join a multicast group.</t>
       <t>In a PTP Registration Response message, the Current Parameters container record MUST be contained exactly once.</t>
       <t>The Record Body MUST contain the following records exactly:</t>
       </list></t>
	   
	<t><list style="symbols">
       <t>In a PTP Registration Response message, the Current Parameters Container record MUST be contained exactly once.</t>
       <t>The record body MAY contain the following records:</t>
       </list></t>

	<texttable anchor="tbl_curr_param_registration" title="Current Parameters container for PTP Registration Response Message">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">NTS Record Name</ttcol>
        <ttcol align="left">Use</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>AEAD Algorithm Negotiation</c>
          <c>mandatory</c>
          <c>This document, <xref target="aead-negotiation"/></c>
		<!-- 2nd row:  -->
          <c>Validity Period</c>
          <c>mandatory</c>
          <c>This document, <xref target="validity-period"/></c>
		<!-- 3rd row:  -->
		  <c>Ticket Key ID</c>
          <c>mandatory</c>
          <c>This document, <xref target="ticket-key-id"/></c>
		<!-- 6th row:  -->
          <c>Ticket Key</c>
          <c>mandatory</c>
          <c>This document, <xref target="ticket-key"/></c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>


</section>


<section anchor="end-of-message" title="End of Message">

	<t>Used in NTS-KE and NTS-TSR protocol</t>


<t>The End of Message record is defined in IETF RFC8915 <xref target="RFC8915"/>, Section 4:</t>

	<t><list style="empty">
       <t><spanx style="emph">&quot;The record sequence in an NTS message SHALL be terminated by an “End of 
          Message” record. The requirement that all NTS-KE messages be terminated by an End 
          of Message record makes them self-delimiting.&quot;</spanx></t>
       </list></t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 0 and a zero-length body.</t>
       <t>The Critical Bit MUST be set.</t>
       <t>This record MUST occur exactly once as the final record of every NTS request and response message.</t>
       <t>This record SHOULD NOT be included in the container records and MUST be ignored if present.</t>
       <t>See also: IETF RFC8915, Section 4.1.1</t>
       </list></t>

</section>


<section anchor="error" title="Error">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

<t>The Error record is defined in IETF RFC8915 <xref target="RFC8915"/>, Section 4.1.3. In addition to the 
Error codes 0 to 2 specified there the following Error codes 3 to 4 are defined:</t>

	<texttable anchor="tbl_error" title="Error Codes">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Error Code</ttcol>
        <ttcol align="left">Description</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>Unrecognized Critical Record</c>
		<!-- 2nd row:  -->
          <c>1</c>
          <c>Bad Request</c>
		<!-- 3rd row:  -->
          <c>2</c>
          <c>Internal Server Error</c>
		<!-- 4th row:  -->
          <c>3</c>
          <c>Not Authorized</c>
		<!-- 5th row:  -->
          <c>4</c>
          <c>Grantor not Registered</c>
		<!-- 6th row:  -->
          <c>5 - 32767</c>
          <c>Unassigned</c>
		<!-- 7th row:  -->
          <c>32768 - 65535</c>
          <c>Reserved for Private or Experimental Use</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 2 and body length of two octets consisting 
	      of an unsigned 16-bit integer in network byte order, denoting an error code.</t>
       <t>The Critical Bit MUST be set.<vspace blankLines="1" /></t>

       <t>The Error code 3 "Not Authorized" is sent by the NTS-KE server if the requester 
	      is not authorized to join the desired multicast group or if a grantor is prohibited 
		  to register with the NTS-KE server.</t>
       <t>The Error record MUST NOT be included in a PTP Registration Request message.<vspace blankLines="1" /></t>
	   
       <t>The Error code 4 "Grantor not Registered" is sent by the NTS-KE server when the requester 
	      wants to establish a unicast connection to a grantor that is not registered with the NTS-KE server.</t>
       <t>The Error record MUST NOT be included in a PTP Key Request message.</t>
       </list></t>

</section>


<section anchor="heartbeat-timeout" title="Heartbeat Timeout">

	<t>Used in NTS-TSR protocol</t>

<t>This record provides the NTS-KE server the capability to monitor the availability of the 
registered grantors. If this optional record is used, the registered grantors SHOULD send 
an NTS Heartbeat message to the NTS-KE server before the timeout expires.</t>

<t>Content and conditions:</t>
	<t><list style="symbols">
       <t>The record has a Record Type number of 1026 and the Critical Bit SHOULD NOT be set.</t>
       <t>The Record Body consists of a 16-bit unsigned integer in network byte order and denotes the heartbeat timeout in seconds..</t>
       <t>The timeout set by the NTS-KE server MUST NOT be less than 1s and MUST be less than the lifetime set in the Validity Period record.</t>
       <t>The timeout starts at the NTS-KE server with the generation of the Registration Response message.</t>

       <t>Grantors that receive an invalid value as a heartbeat timeout MUST ignore this record and MUST NOT send heartbeat messages.</t>
       <t>Grantors that receive a valid value SHOULD send a heartbeat message to the NTS-KE server before the timeout has elapsed.</t>
       <t>The grantors SHOULD keep the heartbeat intervals and MAY also send heartbeat messages more frequently.</t>
       <t>After transmitting a heartbeat from the grantor to the NTS-KE server, both sides reset the timeout to the start value and let the time count down again.</t>
       <t>If this timeout is exceeded without receiving a heartbeat message or several heartbeats are missing in a row, 
	      the NTS-KE server MAY delete the grantor from its registration list, so that a new registration of the grantor is necessary. </t>

       <t>Grantors that are not (or no longer) registered with a NTS-KE server MUST NOT send heartbeat messages and NTS-KE 
	      servers MUST discard heartbeat messages from non-registered grantors.</t>
	   <t>NTS-KE servers MAY respond in such cases with a Registration Response message containing error code 4 "Grantor not Registered".</t>
	
       </list></t>

</section>


<section anchor="next-parameters-container" title="Next Parameters">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

<t>This record is a simple container that can carry an arbitrary number of 
NTS records. It holds all security parameters relevant for the upcoming 
validity period. The content as well as further conditions are defined by 
the respective NTS messages. The order of the included records is arbitrary 
and the parsing rules are so far identical with the NTS message. One 
exception: An End of Message record SHOULD NOT be present and MUST be 
ignored. When the parser reaches the end of the Record Body quantified 
by the Body Length, all embedded records have been processed.</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1027 and the Critical Bit MAY be set.</t>
       <t>The Record Body is defined as a set of records.</t>
       <t>The structure of the record body and all conditions MUST be identical to the rules 
	      described in <xref target="current-parameters-container"/> of this document.<vspace blankLines="1" /></t>

       <t>In both the PTP Key Response and PTP Registration Response message, this record MUST 
	      be contained exactly once during the update period.</t>
       <t>Outside the update period, this record MUST NOT be included.</t>
       <t>In GrBA mode, this record MAY also be missing if the requesting client is to be 
	      explicitly excluded from a multicast group after the security parameter rotation 
		  process by the NTS-KE server.</t>
       <t>More details are described in <xref target="key-update"/>.</t>
       </list></t>

</section>


<section anchor="nts-next-protocol-nego" title="NTS Next Protocol Negotiation">

	<t>Used in NTS-KE protocol</t>

<t>The Next Protocol Negotiation record is defined in IETF RFC8915 <xref target="RFC8915"/>, Section 4.1.2:</t>

    <t><list>
		<t><spanx style="emph">&quot;The Protocol IDs listed in the client's NTS Next Protocol Negotiation record denote 
		those protocols that the client wishes to speak using the key material established 
		through this NTS-KE server session. Protocol IDs listed in the NTS-KE server's response 
		MUST comprise a subset of those listed in the request and denote those protocols that 
		the NTP server is willing and able to speak using the key material established through 
		this NTS-KE server session. The client MAY proceed with one or more of them. The request 
		MUST list at least one protocol, but the response MAY be empty.&quot;</spanx></t>
    </list></t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1 and the Critical Bit MUST be set.</t>
       <t>The Record Body consists of a sequence of 16-bit unsigned integers in network byte order.<vspace blankLines="1" />
          <spanx style="strong">Record body = {Protocol ID 1 || Protocol ID 2 || …}</spanx><vspace blankLines="1" /></t>

        <!--   Record body = {Protocol ID 1 || Protocol ID 2 || …}   -->

       <t>Each integer represents a Protocol ID from the IANA "Network Time Security Next Protocols" registry as shown in the table below.</t>
       <t>For NTS request messages for PTPv2.1 (NTS-KE protocol merely), only the Protocol ID for PTPv2.1 SHOULD be included.</t>
       <t>This prevents the mixing of records for different time protocols.</t> 
       </list></t>


	<texttable anchor="tbl_next_protocol_ids" title="NTS next protocol IDs">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Protocol ID</ttcol>
        <ttcol align="left">Protocol Name</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>Network Time Protocol version 4 (NTPv4)</c>
          <c><xref target="RFC8915"/>, Section 7.7</c>
		<!-- 2nd row:  -->
          <c>1</c>
          <c>Precision Time Protocol version 2.1 (PTPv2.1)</c>
          <c>This document</c>
		<!-- 3rd row:  -->
          <c>2 - 32767</c>
          <c>Unassigned</c>
          <c></c>
		<!-- 4th row:  -->
          <c>32768 - 65535</c>
          <c>Reserved for Private or Experimental Use</c>
          <c></c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



<t>Possible NTP/PTP conflict:</t>

	<t><list style="symbols">
       <t>The support of multiple protocols in this record may lead to the problem 
	      that records in NTS messages can no longer be assigned to a specific time protocol.</t>
       <t>For example, an NTS request could include records for both NTP and PTP.</t>
       <t>However, NTS for NTP does not use NTS message types and the End of Message record is also 
	   not defined for the case of multiple NTS requests in one TLS message.</t>
       <t>This leads to the mixing of the records in the NTS messages.<vspace blankLines="1" /></t>

       <t>A countermeasure is the use of only a single time protocol in the NTS Next Protocol 
	   Negotiation record that explicitly assigns the NTS message to a specific time protocol.</t> 
       <t>When using NTS-secured NTP and NTS-secured PTP, two separate NTS requests i.e., two 
	   separate TLS sessions MUST be made.</t>
       </list></t>

	   
</section>


<section anchor="nts-message-type" title="NTS Message Type">

	<t>Used in NTS-TSR protocol</t>

<t>This record enables the distinction between different NTS message types and message versions for
   the NTS-TSR protocol. It MUST be included exactly once in each NTS message in the NTS-TSR protocol.</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1028 and the Critical Bit MUST be set.</t>
       <t>The Record Body MUST consist of three data fields:</t>
       </list></t>

	<texttable anchor="tbl_content_message_type" title="Content of the NTS Message Type record">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Field</ttcol>
        <ttcol align="left"> </ttcol>
        <ttcol align="left">Octets</ttcol>
        <ttcol align="left">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Message Type</c>
          <c></c>
          <c>2</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>Message Version</c>
          <c>Major version</c>
          <c>1</c>
          <c>2</c>
		<!-- 3rd row:  -->
          <c>Message Version (cont.)</c>
          <c>Minor version</c>
          <c>1</c>
          <c>3</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

	   
	<t><list style="symbols">
       <t>The Message Type field is a 16-bit unsigned integer in network byte order, denoting the 
	      type of the current NTS message.</t>
       <t>The following values are defined for the Message Type:</t>
       </list></t>
	   


	<texttable anchor="tbl_message_type" title="NTS Message Types for the NTS-TSR protocol">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Message Type (value)</ttcol>
        <ttcol align="left">NTS Message (NTS-TSR protocol)</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>PTP Registration Request</c>
		<!-- 2nd row:  -->
          <c>1</c>
          <c>PTP Registration Response</c>
		<!-- 3rd row:  -->
          <c>2</c>
          <c>PTP Registration Revoke</c>
		<!-- 4th row:  -->
          <c>3</c>
          <c>Heartbeat</c>
		<!-- 5th row:  -->
          <c>4 - 32767</c>
          <c>Unassigned</c>
		<!-- 6th row:  -->
          <c>32768 - 65535</c>
          <c>Reserved for Private or Experimental Use</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

	<t><list style="symbols">
       <t>The Message Version consists of a tuple of two 8-bit unsigned integers in network byte order:<vspace blankLines="1" />
          <spanx style="strong">NTS Message Version = {major version || minor version}</spanx><vspace blankLines="1" /></t>

		<!--   NTS Message Version = {major version || minor version}   -->

       <t>The representable version is therefore in the range 0.0 to 255.255 (e.g., v1.4 = 0104h).</t>
       <t>All NTS messages for PTPv2.1 described in this document are in version number 1.0.</t>
       <t>Thus the Message Version MUST match 0100h.</t>
       </list></t>

</section>


<section anchor="ptp-time-server" title="PTP Time Server">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

<t>The PTP Time Server record is used exclusively in TiBA mode (PTP unicast connection) and signals 
   to the client (PTP requester) for which grantor the security parameters are valid. This record 
   is used both, in the NTS-KE protocol in the PTP Key Response, and in NTS-TSR protocol in the PTP 
   Registration Request message. </t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1029 and the Critical Bit MAY be set.</t>
       <t>The record body consists of a tuple of two 8-bit unsigned integers in network byte order.</t>
       <t>The structure of the record body and all conditions MUST be identical to the rules 
	      described in <xref target="association-mode"/> (Association Mode) of this document, 
		  with the following exceptions:<vspace blankLines="1" /></t>
   
       <t>In a PTP Key Response message, this record MUST be contained exactly once within 
	      a container record (e.g., Current Parameters container record).</t>
       <t>The PTP Time Server record contains a list of all available addresses of the grantor 
	      assigned by the NTS-KE server.</t>
       <t>This can be an IPv4, IPv6, MAC address, as well as the PortIdentity of the grantor.</t>
       <t>This allows the client to change the PTP transport mode (e.g., from IPv4 to 802.3) 
	      without performing a new NTS request.</t>
       <t>The list in the PTP Time Server record MUST NOT contain the Association Type number 0 
	      (multicast group) and MUST contain at least one entry.</t>
       <t>The NTS-KE server SHOULD provide the grantor addresses requested by the client in 
	      the PTP Key Request message, but MAY also assign a different grantor to the client.<vspace blankLines="1" /></t>
       </list></t>

	<t><list style="symbols">
       <t>In a PTP Registration Request message, this record MUST be included exactly once.</t>
       <t>The grantor MUST enter all network addresses that are supported for a unicast connection.</t>
       <t>This can be an IPv4, IPv6, MAC address, as well as the PortIdentity.</t>
       <t>The list in the PTP Time Server record MUST NOT contain the Association Type number 0 
	      (multicast group) and MUST contain at least the PortIdentity.</t>
       <t>The PortIdentity is especially needed by the NTS-KE server to identify the correct PTP 
	      instance (the grantor) in case of a PTP Registration Revoke message.</t>
       </list></t>


</section>


<section anchor="security-association" title="Security Association">

	<t>Used in NTS-KEprotocol</t>

<t>This record contains the information &quot;how&quot; specific PTP message types must be secured. 
It comprises all dynamic (negotiable) values necessary to construct the AUTHENTICATION 
TLV (IEEE Std 1588-2019, Section 16.14.3). Static values and flags, such as the secParamIndicator, 
are described in more detail in <xref target="auth-tlv-parameters"/>.</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1030 and the Critical Bit MAY be set.</t>
       <t>The Record Body is a sequence of various parameters in network byte order and MUST be 
	      formatted according to the following table:</t>
       </list></t>


	<texttable anchor="tbl_security_assoc" title="Security Association record">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Security Parameter Pointer</c>
          <c>1</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>Integrity Algorithm Type</c>
          <c>2</c>
          <c>1</c>
		<!-- 3rd row:  -->
          <c>Key ID</c>
          <c>4</c>
          <c>3</c>
		<!-- 4th row:  -->
          <c>Key Length</c>
          <c>2</c>
          <c>7</c>
		<!-- 5th row:  -->
          <c>Key</c>
          <c>K</c>
          <c>9</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



	<t><list style="symbols">
       <t>In a PTP Key Response message, the Security Association record MUST be included exactly once in the 
	      Current Parameters container record and the Next Parameters container record.</t>
       <t>The Next Parameters container record MUST be present only during the update period.</t>
       <t>In TiBA mode, the Security Association record MUST be included exactly once in the 
	      encrypted Ticket as well.</t>
       </list></t>
	   
	   
<t>Security Parameter Pointer</t>

	<t><list style="symbols">
       <t>The Security Parameter Pointer (SPP) is an 8-bit unsigned integer in the closed range 0 to 255.</t>
       <t>This value enables the mutual assignment of SA, SP and AUTHENTICATION TLVs.</t>
       <t>The generation and management of the SPP is controlled by the NTS-KE server (see <xref target="sa-sp-management"/>).</t>
       </list></t>
	   
	   
<t>Integrity Algorithm Type</t>

	<t><list style="symbols">
       <t>This value is a 16-bit unsigned integer in network byte order.</t>
       <t>The possible values are equivalent to the MAC algorithm types from the table in <xref target="supported-mac-algos"/>.</t>
       <t>The value used depends on the negotiated or predefined MAC algorithm.</t>
       </list></t>
	   
	   
<t>Key ID</t>

	<t><list style="symbols">
       <t>The Key ID is a 32-bit unsigned integer in network byte order.</t>
       <t>The field length is oriented towards the structure of the AUTHENTICATION TLV.</t>
       <t>The generation and management of the Key ID is controlled by the NTS-KE server.</t>
       <t>The NTS-KE server MUST ensure that every Key ID is unique.
	   <list style="symbols">
           <t>The value can be either a random number or an enumeration.</t>
           <t>Previous Key IDs SHOULD NOT be reused for a certain number of rotation periods or a defined period of 
              time (see <xref target="sa-sp-management"/>).</t>
           </list></t>
       </list></t>	   
	   
<t>Key Length</t>
	<t><list style="symbols">

       <t>This value is a 16-bit unsigned integer in network byte order, denoting the length of the key.</t>
       </list></t>
	   

<t>Key</t>

	<t><list style="symbols">
       <t>The value is a sequence of octets with a length of Key Length.</t>
       <t>This symmetric key is needed together with the MAC algorithm to calculate the ICV.</t>
       <t>It can be both a group key (GrBA mode) or a unicast key (TiBA mode).</t>
       </list></t>

</section>


<section anchor="source-portidentity" title="Source PortIdentity">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

<t>This record contains a PTP PortIdentity and serves as an identifier. In a PTP Key Request message, 
   it enables the unique assignment of the NTS request to the PTP instance of the sender, since the 
   request may have been sent to the NTS-KE server via a management port. </t>

<t>The PortIdentity is embedded in the PTP Key Response message within the ticket to bind it to the 
   PTP requester. Grantors can verify that the ticket comes from the correct sender when it is received 
   and before it is decrypted, to prevent possible crypto-performance attacks. In a PTP registration 
   Revoke message this record enables the assignment of the grantor at the NTS-KE server to revoke an 
   existing registration. This is necessary because requesting PTP devices may have multiple independent 
   PTP ports and possibly multiple registrations with the KE. </t>


<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1031 and the Critical Bit MAY be set.</t>
       <t>The record contains the PTP PortIdentity of the sender in network byte order, with a total length of 10 octets. </t>
       <t>In a PTP Key Request message, this record MUST be included exactly once if the client intends a unicast request 
	      in TiBA mode and MUST NOT be included if the client intends to join a multicast group/Go2 (= GrBA mode).</t>
       <t>In a PTP Registration Revoke message, this record MUST be included exactly once.</t>
	   <t>The PortIdentity consists of the attributes clockIdentity and portNumber:<vspace blankLines="1" />
          <spanx style="strong">PortIdentity = {clockIdentity || portNumber}</spanx><vspace blankLines="1" /></t>

		<!--   PortIdentity = {clockIdentity || portNumber}  -->

       <t>The clockIdentity is an 8-octet array and the portNumber is a 16-bit unsigned integer (source: 
	      <xref target="IEEE1588-2019"/>, Sections 5.3.5 and 7.5)</t>
       </list></t>

</section>


<section anchor="status" title="Status">

	<t>Used in NTS-TSR protocol</t>

<t>The Status record is an optional record that represents the current load of the sender. It 
   allows the NTS-KE server to improve load balancing when assigning grantors to the requesting 
   PTP clients in TiBA mode. The content of the record is designed in such a way that it can also 
   transmit other information (e.g., manufacturer-related information).</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1032 and the Critical Bit SHOULD NOT be set.</t>
       <t>The Record Body MUST consist of two data fields:</t>
       </list></t>


	<texttable anchor="tbl_status" title="Structure of the Status record">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Status Type</c>
          <c>2</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>Status Data</c>
          <c>D</c>
          <c>2</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>


	<t><list style="symbols">
       <t>The Status Type is a 16-bit unsigned integer, denoting the content of the Status Data field.</t>
       <t>The Status Data field is a sequence of octets in network byte order whose length, content 
	      and structure is determined by the Status Type field.</t>
       <t>The following values are currently set:</t>
       </list></t>


	<texttable anchor="tbl_status_data" title="Values for Status Data">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Status Type</ttcol>
        <ttcol align="center">Status Data length</ttcol>
        <ttcol align="center">Description</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>1 octet (unsigned int)</c>
          <c>grantor load</c>
		<!-- 2nd row:  -->
          <c>1 - 32767</c>
          <c>Unassigned</c>
          <c></c>
		<!-- 3rd row:  -->
          <c>32767 - 65535</c>
          <c>Reserved for Private or Experimental Use</c>
          <c></c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

	<t><list style="symbols">
       <t>The following values apply to Status Type 0:</t>
       </list></t>


	<texttable anchor="tbl_status_type_0" title="Values for Status Type 0">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Status Type</ttcol>
        <ttcol align="center">Status Data value</ttcol>
        <ttcol align="left">Description</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>0x01</c>
          <c>grantor load: 0% to 24%</c>
		<!-- 2nd row:  -->
          <c>0</c>
          <c>0x02</c>
          <c>grantor load: 25% to 49%</c>
		<!-- 3rd row:  -->
          <c>0</c>
          <c>0x03</c>
          <c>grantor load: 50% to 74%</c>
		<!-- 4th row:  -->
          <c>0</c>
          <c>0x04</c>
          <c>grantor load: 75% to 84%</c>
		<!-- 5th row:  -->
          <c>0</c>
          <c>0x05</c>
          <c>grantor load: 85% to 94%</c>
		<!-- 6th row:  -->
          <c>0</c>
          <c>0x06</c>
          <c>grantor load: 95% to 100%</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

	<t><list style="symbols">
       <t>In a Heartbeat message this record MAY be contained once or several times.</t>
       <t>If multiple status records are included, the status type MUST NOT occur twice.</t>
       <t>The NTS-KE server MAY use the status record for optimizations and MAY also ignore them.</t>
       </list></t>


</section>


<section anchor="supported-mac-algos" title="Supported MAC Algorithms">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

<t>This record allows free negotiation of the MAC algorithm needed to generate the ICV. Since 
   multicast groups are restricted to a shared algorithm, this record is used mandatorily in 
   a PTP Registration Request message and MAY be used (optionally) in a PTP Key Request message.</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1033 and the Critical Bit MAY be set.</t>
       <t>The Record Body contains a sequence of 16-bit unsigned integers in network byte order.<vspace blankLines="1" />
          <spanx style="strong">Supported MAC Algorithms = {MAC 1 || MAC 2 || …}</spanx><vspace blankLines="1" /></t>
		  
<!--   Supported MAC Algorithms = {MAC 1 || MAC 2 || …}<vspace blankLines="1" /></t>   -->

       <t>Each integer represents a MAC Algorithm Type defined in the table below.</t>
       <t>Duplicate identifiers SHOULD NOT be included.</t>
       <t>Each PTP node MUST support at least the HMAC-SHA256-128 algorithm.</t>
       </list></t>

	<texttable anchor="tbl_mac_algo" title="MAC Algorithms">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">MAC Algorithm Types</ttcol>
        <ttcol align="left">MAC Algorithm</ttcol>
        <ttcol align="center">ICV Length (octets)</ttcol>
        <ttcol align="left">Reference</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>0</c>
          <c>HMAC-SHA256-128</c>
          <c>16</c>
          <c><xref target="fiPS-PUB-198-1"/>, <xref target="IEEE1588-2019"/></c>
		<!-- 2nd row:  -->
          <c>1</c>
          <c>HMAC-SHA256</c>
          <c>32</c>
          <c><xref target="fiPS-PUB-198-1"/></c>
		<!-- 3rd row:  -->
          <c>2</c>
          <c>AES-CMAC</c>
          <c>16</c>
          <c><xref target="RFC4493"/></c>
		<!-- 4th row:  -->
          <c>3</c>
          <c>AES-GMAC-128</c>
          <c>16</c>
          <c><xref target="RFC4543"/></c>
		<!-- 5th row:  -->
          <c>4</c>
          <c>AES-GMAC-192</c>
          <c>24</c>
          <c><xref target="RFC4543"/></c>
		<!-- 6th row:  -->
          <c>5</c>
          <c>AES-GMAC-256</c>
          <c>32</c>
          <c><xref target="RFC4543"/></c>
		<!-- 7th row:  -->
          <c>6 - 32767</c>
          <c>Unassigned </c>
          <c></c>
          <c></c>
		<!-- 8th row:  -->
          <c>32768 - 65535</c>
          <c>Reserved for Private or Experimental Use</c>
          <c></c>
          <c></c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>


<t>In GrBA mode:</t>

	<t><list style="symbols"> 
       <t>This record is not necessary, since all PTP nodes in a multicast group MUST support the same MAC algorithm.</t>
       <t>Therefore, this record SHOULD NOT be included in a PTP Key Request massage and the NTS-KE server MUST ignore 
	      this record if the Association Type in the Association Mode record is 0 (= multicast group).</t>
       <t>Unless this is specified otherwise by a PTP profile, the HMAC-SHA256-128 algorithm SHALL be used by default.</t>
       </list></t>

<t>In TiBA mode:</t> 

	<t><list style="symbols">
       <t>In a PTP Key Request message, this record MAY be contained if the requester wants a unicast 
	      connection (TiBA mode, not Go2) to a specific grantor.</t>
       <t>The requester MUST NOT send more than one record of this type.</t>
       <t>If this record is present, at least the HMAC-SHA256-128 MAC algorithm MUST be included.</t>
       <t>If multiple MAC algorithms are supported, the requester SHOULD put the desired algorithm 
	      identifiers in descending priority in the record body.</t>
       <t>Strong algorithms with higher bit lengths SHOULD have higher priority.</t>
       <t>The default MAC algorithm (HMAC-SHA256-128) MAY be omitted in the record.<vspace blankLines="1" /></t>

       <t>In a PTP Registration Request message, this record MUST be present and the grantor MUST include all supported MAC algorithms in any order.</t>
       <t>The NTS-KE server selects the algorithm after receiving a PTP Key Request message in unicast mode.</t>
       <t>The NTS-KE server SHOULD choose the highest priority MAC algorithm from the request message that grantor and requester support.</t>
       <t>The NTS-KE server MAY ignore the priority and choose a different algorithm that grantor and requester support.</t>
       <t>If the MAC Algorithm Negotiation record is not within the PTP Key Request message, the NTS-KE server MUST choose the default algorithm HMAC-SHA256-128.</t>
       </list></t>

<t>Initialization Vector (IV)</t>

	<t><list style="symbols">
       <t>If GMAC is to be supported as a MAC algorithm, then an Initialization Vector (IV) must be constructed according to IETF RFC 4543 <xref target="RFC4543"/>, Section 3.1.</t>
       <t>Therefore, the IV MUST be eight octets long and MUST NOT be repeated for a specific key.</t> 
       <t>This can be achieved, for example, by using a counter.</t>
       </list></t>


</section>


<section anchor="ticket" title="Ticket">

	<t>Used in NTS-KE protocol</t>

<t>This record contains the parameters of the selected AEAD algorithm, as well as an 
encrypted security association. The record contains all the necessary 
security parameters that the grantor needs for a secured PTP unicast connection to 
the requester. The ticket is encrypted by the NTS-KE server with the 
symmetric ticket key which is also known to the grantor. The requester is not able 
to decrypt the encrypted security association within the ticket.</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1034 and the Critical Bit MAY be set.</t>
       <t>The Record Body consists of several data fields and MUST be formatted as follows.</t>
       </list></t>



	<texttable anchor="tbl_ticket" title="Structure of a Ticket record">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Ticket Key ID</c>
          <c>4</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>Source PortIdentity</c>
          <c>10</c>
          <c>4</c>
		<!-- 3rd row:  -->
          <c>Nonce Length</c>
          <c>2</c>
          <c>14</c>
		<!-- 4th row:  -->
          <c>Nonce</c>
          <c>N</c>
          <c>16</c>
		<!-- 5th row:  -->
          <c>Encrypted SA Length</c>
          <c>2</c>
          <c>N+16</c>
		<!-- 6th row:  -->
          <c>Encrypted Security Association</c>
          <c>E</c>
          <c>N+18</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



	<t><list style="symbols">
       <t>In a PTP Key Response message, this record MUST be included exactly once each in the 
	      Current Parameters container record and the Next Parameters container record if the 
		  requesting client wants a unicast communication to a specific grantor in TiBA mode.</t>
       <t>The Next Parameters container record MUST be present only during the update period.</t> 
       </list></t>

<t>Ticket Key ID</t>

	<t><list style="symbols">
       <t>This is a 32-bit unsigned integer in network byte order, denoting the Key ID of the ticket key.</t>
       <t>The value is set by the and is valid for the respective validity period.</t>
       <t>See also <xref target="ticket-key-id"/> for more details.</t>
       </list></t>

<t>Source PortIdentity</t>

	<t><list style="symbols">
       <t>This 10-octet long field contains the identical Source PortIdentity of the PTP client 
	      from the PTP Key Request message.</t>
       </list></t>

<t>Nonce Length</t>

	<t><list style="symbols">
       <t>This is a 16-bit unsigned integer in network byte order, denoting the length of 
	      the Nonce field.</t>
       </list></t>

<t>Nonce</t>

	<t><list style="symbols">
       <t>This field contains the Nonce needed for the AEAD operation.</t>
       <t>The length and conditions attached to the Nonce depend on the AEAD algorithm used.</t>
       <t>More details and conditions are described in <xref target="aead-operation"/>.</t>
       </list></t>

<t>Encrypted SA Length</t>

	<t><list style="symbols">
       <t>This is a 16-bit unsigned integer in network byte order, denoting the length of 
	      the Encrypted Security Association field.</t>
       </list></t>

<t>Encrypted Security Association</t>

	<t><list style="symbols">
       <t>This field contains the output of the AEAD operation (“Ciphertext”) after the encryption 
	      process of the respective Record Body of the respective Security Association record.</t>
       <t>The plaintext of this field is described in <xref target="security-association"/>.</t>
       <t>More details about the AEAD process and the required input data are described in 
	      <xref target="aead-operation"/>.</t>
       </list></t>

</section>


<section anchor="ticket-key" title="Ticket Key">

	<t>Used in NTS-TSR protocol</t>

<t>This record contains the ticket key, which together with an AEAD algorithm is 
used to encrypt and decrypt the ticket payload (content of the Encrypted Security 
Association field in the Ticket record).</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1035 and the Critical Bit MAY be set.</t>
       <t>The Record Body consists of a sequence of octets holding the symmetric key for the AEAD function.</t>
       <t>The generation and length of the key MUST meet the requirement of the associated AEAD 
	      algorithm.<vspace blankLines="1" /></t>

       <t>In a PTP Registration Response message, this record MUST be included exactly once each in 
	      the Current Parameters container record and the Next Parameters container record.</t>
       <t>The Next Parameters container record MUST be present only during the update period.</t>
       </list></t>

</section>


<section anchor="ticket-key-id" title="Ticket Key ID">

	<t>Used in NTS-TSR protocol</t>

<t>The Ticket Key ID record is a unique identifier that allows a grantor to identify the associated 
   ticket key. The NTS-KE server is responsible for generating this Key ID, which is also unique to 
   the PTP network and incremented at each rotation period. The associated key is known only to the 
   NTS-KE server and grantor, and is generated and exchanged during the registration phase of the 
   grantor. All tickets generated by the NTS-KE server for the corresponding grantor in this validity 
   period using the same ticket key ID.</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>The record has a Record Type number of 1036 and the Critical Bit MAY be set.</t>
       <t>The Record Body consists of a 32-bit unsigned integer in network byte order.</t>
       <t>The generation and management of the ticket key ID is controlled by the NTS-KE server.</t>
       <t>The NTS-KE server must ensure that every ticket key has a unique number.
	   <list style="symbols">
	      <t>The value is implementation dependent and MAY be either a random number, a hash value or an 
		     enumeration.</t>
	      <t>Previous IDs SHOULD NOT be reused for a certain number of rotation periods or a defined 
		     period of time.</t>
          </list><vspace blankLines="1" /></t>
       <t>In a PTP Key Response message, this record MUST be included exactly once each in the Current 
	      Parameters container record and the Next Parameters container record if a unicast connection 
		  in TiBA mode is to be established.</t>
       <t>If the requester wishes to join a multicast group, the Ticket Key ID record MUST NOT be 
	      included in the container records.</t>
       <t>In a PTP Registration Response message, this record MUST be included exactly once in the Current 
	      Parameters container record and once in the Next Parameters container record.<vspace blankLines="1" /></t>
       <t>The Next Parameters container record MUST be present only during the update period.</t>
       <t>The Ticket record MUST be present in TiBA mode and MUST NOT be present in GrBA mode.</t> 
       </list></t>

</section>


<section anchor="validity-period" title="Validity Period">

	<t>Used in NTS-KE and NTS-TSR protocol</t>

<t>This record contains the validity information of the respective security parameters see also <xref target="key-update"/>).</t>

<t>Content and conditions:</t>

	<t><list style="symbols">
       <t>In a PTP Key Response as well as the PTP Registration Response message, this record 
	      MUST be included exactly once each in the Current Parameters container record and 
		  the Next Parameters container record.</t>

       <t>The record has a Record Type number of 1037 and the Critical Bit MAY be set.</t>
       <t>The Record Body MUST consist of three data fields:</t>
       </list></t>

	<texttable anchor="tbl_validity_period" title="Structure of a Validity Period record">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">Field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>Lifetime</c>
          <c>4</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>Update Period</c>
          <c>4</c>
          <c>4</c>
		<!-- 3rd row:  -->
          <c>Grace Period</c>
          <c>4</c>
          <c>8</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>

<t>Lifetime</t>

	<t><list style="symbols">
       <t>The Lifetime is a 32-bit unsigned integer in network byte order.</t>
       <t>If this record is within a Current Parameters container record, it shows the remaining 
	      lifetime of the security parameters for the current validity period in seconds.</t>
       <t>If this record is within a Next Parameters container record, it shows the total lifetime 
	      of the security parameters for the next validity period in secondt</t>
       <t>The counting down of the Next Parameters lifetime starts as soon as the remaining 
	      lifetime of the Current Parameters reaches 0s.</t>
       <t>The maximum value is set by the NTS-KE administrator or the PTP profile.</t>
       <t>In conjunction with a PTP unicast establishment in TiBA mode, the lifetime of the unicast 
	      key (within the Security Association record), the ticket key and registration lifetime of 
		  a grantor with the NTS-KE server MUST be identical.</t>
       </list></t>

<t>Update Period</t>

	<t><list style="symbols">
       <t>The Update Period is a 32-bit unsigned integer in network byte order.</t>
       <t>It specifies how many seconds before the lifetime expires the update period starts.</t>
       <t>Unlike the lifetime, this is a fixed value that is not counted down.</t>
       <t>The Update Period value MUST NOT be greater than the full Lifetime.</t>
       <t>Recommended is an Update Period of 120s-300s if the full Lifetime is 900s or longer.</t>
       <t>If the value of the Update Period in the Current Parameters container record is greater 
	      than the Lifetime, then the key update process has started.</t>
       <t>The presence or absence of the Next Parameters container record is specified in 
	      <xref target="next-parameters-container"/>.</t>
       </list></t>

<t>Grace Period</t>

	<t><list style="symbols">
       <t>The Grace Period is a 32-bit unsigned integer in network byte order.</t>
       <t>It defines how many seconds expired security parameters MUST still be accepted.</t>
       <t>This allows the verification of incoming PTP messages that were still on the network and 
	      secured with the old parameters.</t>
       <t>The Grace Period value MUST NOT be greater than the Update Period. </t>
       <t>Recommended is a Grace Period of 5 to 10 seconds.</t>
       </list></t>

<t>Notes:</t>

	<t><list style="symbols">
       <t>Requests during the currently running lifetime will receive respectively adapted count values.</t>
       <t>The lifetime is a counter that is decremented and marks the expiration of defined parameters 
	      when the value reaches zero.</t>
       <t>The realization is implementation-dependent and can be done for example by a secondly decrementing.</t>
       <t>It MUST be ensured that jumps (e.g., by adjustment of the local clock) are avoided.</t>
       <t>The use of a monotonic clock is suitable for this.</t>
       <t>Furthermore, it is to be considered which consequences the drifting of the local clock can cause.</t>
       <t>With sufficiently small values of the lifetime (&lt;12 hours), this factor should be negligible.</t>
	   </list></t>

</section>


</section>

</section>


<!-- Marker -->





<section anchor="additional-mechanisms" title="Additional Mechanisms">

<t>This section provides information about the use of the negotiated AEAD algorithm 
as well as the generation of the security policy pointers.</t>


<section anchor="aead-operation" title="AEAD Operation">

<t>General information about AEAD:</t>

	<t><list style="symbols">
       <t>The AEAD operation enables the integrity protection and the optional encryption 
	      of the given data, depending on the input parameters.</t>
       <t>While the structure of the AEAD output after the securing operation is determined 
	      by the negotiated AEAD algorithm, it usually contains an authentication tag in 
		  addition to the actual ciphertext.</t>
       <t>The authentication tag provides the integrity protection, whereas the ciphertext 
	      represents the encrypted data.</t>
       <t>The AEAD algorithms supported in this document (see <xref target="aead-negotiation"/>) 
	      always return an authentication tag with a fixed length of 16 octets.</t> 
       <t>The size of the following ciphertext is equal to the length of the plaintext.</t> 
       <t>The concatenation of authentication tag and ciphertext always form the unit 
	      “Ciphertext”:<vspace blankLines="1" /><spanx style="strong">Ciphertext = {authentication 
		  tag || ciphertext}</spanx><vspace blankLines="1" /></t>

       <!--   Ciphertext = {authentication tag || ciphertext}   -->

       <t>Hint: The term “Ciphertext” is distinguished between upper and lower case letters.</t>
       <t>The following text always describes "Ciphertext".</t>
       <t>Separation of the information concatenated in Ciphertext is not necessary at any time.<vspace blankLines="1" /></t>

       <t>Six parameters are relevant for the execution of an AEAD operation:
	      <list style="symbols">
          <t>AEAD (...):  is the AEAD algorithm itself</t>
          <t>A:  Associated Data</t>
          <t>N:  Nonce</t>
          <t>K:  Key</t>
          <t>P:  Plaintext</t>
          <t>C:  Ciphertext</t>
          </list></t>

       <t>The protection and encryption of the data is done as follows:  C = AEAD (A, N, K, P)</t>
       <t>Therefore, the output of the AEAD function is the Ciphertext.<vspace blankLines="1" /></t>

       <t>The verification and decryption of the data is done this way:  P = AEAD (A, N, K, C)</t>
       <t>The output of the AEAD function is the Plaintext if the integrity verification is successful.</t> 
       </list></t>


<t>AEAD algorithm and input/output values for the Ticket record:</t>

	<t><list style="symbols">
       <t>AEAD (…):
	      <list style="symbols">
          <t>The AEAD algorithm that is negotiated between grantor and NTS-KE server during 
		     the registration phase.</t>
          <t>A list of the AEAD algorithms considered in this document can be found in 
		     <xref target="aead-negotiation"/>.<vspace blankLines="1" /></t>
          </list></t>

       <t>Associated Data:
	      <list style="symbols">
          <t>The Associated Data is an optional AEAD parameter and can be of any length and 
		     content, as long as the AEAD algorithm does not give any further restrictions.</t>
          <t>In addition to the Plaintext, this associated data is also included in the 
		     integrity protection.</t>
          <t>When encrypting or decrypting the Security Association record, this parameter 
		     MUST remain empty.<vspace blankLines="1" /></t>
          </list></t>

       <t>Nonce:	
	      <list style="symbols">
          <t>Corresponds to the value from the Nonce field in the Ticket (<xref target="ticket"/>).</t>
          <t>The requirements and conditions depend on the selected AEAD algorithm.</t>
          <t>For the AEAD algorithms defined in <xref target="aead-negotiation"/> (with 
		     numeric identifiers 15, 16, 17), a cryptographically secure random number MUST be used.</t> 
          <t>Due to the block length of the internal AES algorithm, the Nonce SHOULD have a length 
		     of 16 octets.<vspace blankLines="1" /></t>
          </list></t>

       <t>Key:
	      <list style="symbols">
          <t>This is the symmetric key required by the AEAD algorithm.</t>
          <t>The key length depends on the selected algorithm.</t>
          <t>When encrypting or decrypting the Security Association record, the ticket key MUST be used.<vspace blankLines="1" /></t>
          </list></t>

       <t>Plaintext:
	      <list style="symbols">
          <t>This parameter contains the data to be encrypted and secured.</t>
          <t>For AEAD encryption, this corresponds to the Record Body of the Security Association record with all parameters inside.</t>
          <t>This is also the output of the AEAD operation after the decryption process.<vspace blankLines="1" /></t>
          </list></t>

       <t>Ciphertext:
	      <list style="symbols">
          <t>Corresponds to the value from the Encrypted Security Association field in the Ticket 
		     (<xref target="ticket"/>).</t>
          <t>The Ciphertext is the output of the AEAD operation after the encryption process.</t>
          <t>This is also the input parameter for the AEAD decryption operation.</t>
          </list></t>
       </list></t>

</section>



<section anchor="sa-sp-management" title="SA/SP Management">

<t>This section describes the requirements and recommendations attached to SA/SP management, 
as well as details about the generation of identifiers.</t>

<t>Requirements for the Security Association Database management:</t>

	<t><list style="symbols">
       <t>The structure and management of the Security Association Database (SAD) are 
	      implementation-dependent both on the NTS-KE server and on the PTP devices.</t>
       <t>An example of this, as well as other recommendations, are described in Annex B.</t>
       <t>A PTP device MUST contain exactly one SAD and Security Policy Database (SPD).</t>
       <t>For multicast and Group-of-2 connections, SPPs MUST NOT occur more than once 
	      in the SAD of a PTP device.</t>
       <t>For unicast connections, SPPs MAY occur more than once in the SAD of a PTP device.</t>
       <t>The NTS-KE server MUST ensure that SPPs can be uniquely assigned to a multicast 
	      group or unicast connection.</t>
       <t>This concerns both the NTS-KE server and all PTP devices assigned to the NTS-KE server.</t>
      </list></t>

<t>SPP generation:</t>

	<t><list style="empty">
       <t>The generation of the SPP always takes place on the NTS-KE server and enables 
	      the identification of a corresponding SA. The value of the SPP can be either a 
		  random number or an enumeration. An SPP used in any multicast group MUST NOT 
		  occur in any other multicast group or unicast connection. If a multicast group 
		  or unicast connection is removed by the NTS-KE server, the released SPPs MAY be 
		  reused for new groups or unicast connections. Before reusing an SPP, the NTS-KE 
		  server MUST ensure that the SPP is no longer in use in the PTP network (e.g., 
		  within Next Parameters). In different PTP devices, an SPP used in a unicast 
		  connection MAY also occur in another unicast connection, as long as they are 
		  not used in multicast groups.</t>
      </list></t>


<t>Key/Key ID generation:</t>

	<t><list style="empty">
       <t>The generation of the keys MUST be performed by using a Cryptographically 
	      Secure Pseudo Random Number Generator (CSPRNG) on the NTS-KE server (see also 
		  <xref target="key-generation"/>). The length of the keys depends on the MAC algorithm used. The 
		  generation and management of the Key ID is also controlled by the NTS-KE server. 
		  The NTS-KE server MUST ensure that every Key ID is unique at least within an 
		  SA with multiple parameter sets. The value of the Key ID is 
		  implementation dependent and MAY be either a random number, a hash value or 
		  an enumeration. Key IDs of expired keys MAY be reused but SHOULD NOT be reused 
		  for a certain number of rotation periods or a defined period of time. Before 
		  reusing a Key ID, the NTS-KE server MUST be ensured that the Key ID is no 
		  longer in use in the PTP network (e.g., within Next Parameters).</t>
      </list></t>


</section>

</section>



<section anchor="new-ticket-tlv" title="New TICKET TLV for PTP Messages">

<t>Once a PTP port is registered as a grantor for association in unicast mode another PTP 
port (requester) can associate with it by first requesting a key from the NTS-KE server with
 Association Type in the Association Mode record set to one of the values 1 to 4 (IPv4, 
 IPv6, 802.3 or PortIdentity), and Association Values to the related address of the 
 desired grantor. After the reception of a PTP Key Response message during the NTS-KE protocol the requester obtains the unicast 
 key and the Ticket record containing the Record Body of the Security Association record (see <xref target="exchange-ticket-based"/> 
 and <xref target="ticket"/>). The ticket
 includes the identification of the requester, the Encrypted SA along with the unicast key as well 
 as the lifetime in the Validity record. </t>

<t>To provide the grantor with the security data, the requester sends a secured unicast 
request to the grantor, e.g., an Announce request (= Signaling message with a 
REQUEST_UNICAST_TRANSMISSION TLV with Announce as messageType in the TLV), which is 
secured with the unicast key.</t>

<t>To accomplish that, the requester sends a newly defined TICKET TLV with the Ticket 
embedded and the AUTHENTICATION TLV with the PTP unicast negotiation message. 
The TICKET TLV must be positioned before the AUTHENTICATION TLV to include the TICKET TLV 
in the securing by the ICV. The receiving grantor decrypts the Ticket (actually the encrypted security association) from the 
TICKET TLV getting access to the information therein. With the contained unicast key, the 
grantor checks the requester identity and the authenticity of the request message.</t>

<t>Thereafter, all secured unicast messages between grantor and requester will use the 
unicast key for generating the ICV in the AUTHENTICATION TLV for authentication of the 
message until the unicast key expires.</t>

<t>If the requester’s identity does not match with the Source PortIdentity field  
in the Ticket or the ICV in the AUTHENTICATION TLV is not identical to 
the generated ICV by the grantor, then the unicast request message MUST be denied.</t>

<t>The TICKET TLV structure is given in <xref target="tbl_ticket_tlv"/> below.</t>


	<texttable anchor="tbl_ticket_tlv" title="Structure of the TICKET TLV">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>tlvType</c>
          <c>2</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>lengthfield</c>
          <c>2</c>
          <c>2</c>
		<!-- 3rd row:  -->
          <c>Ticket record</c>
          <c>T</c>
          <c>4</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



<t>To comply with the TLV structure of IEEE Std 1588-2019 (<xref target="IEEE1588-2019"/>, Section 14.1)
   the TICKET TLV is structured as presented in <xref target="tbl_ticket_tlv"/> with a newly defined tlvType, a 
   respective length field and the Ticket record (see <xref target="ticket"/>) containing 
   the encrypted security association. Eventually the Ticket TLV may be defined externally to IEEE 1588 SA, 
   e.g., by the IETF.  Then the structure should follow IEEE Std 1588-2019 
   (<xref target="IEEE1588-2019"/>, Section 14.3) to define a new standard organization extension 
   TLV as presented in <xref target="tbl_ticket_tlv_ext"/> below.</t>


	<texttable anchor="tbl_ticket_tlv_ext" title="Structure of an organization extension TLV form for the TICKET TLV">
    <!--      <preamble>Tables use ttcol to define column headers and widths.
               Every cell then has a "c" element for its content.</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">field</ttcol>
        <ttcol align="center">Octets</ttcol>
        <ttcol align="center">Offset</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>tlvType</c>
          <c>2</c>
          <c>0</c>
		<!-- 2nd row:  -->
          <c>lengthfield</c>
          <c>2</c>
          <c>2</c>
		<!-- 3rd row:  -->
          <c>organizationId</c>
          <c>3</c>
          <c>4</c>
		<!-- 4th row:  -->
          <c>organizationSubType</c>
          <c>3</c>
          <c>7</c>
		<!-- 5th row:  -->
          <c>Ticket record</c>
          <c>T</c>
          <c>10</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



<!-- <t>To transport the TICKET TLV with the Ticket container embedded via the PTP unicast 
negotiation message two possible solutions exist:</t>

	<t><list style="letters"> -->
       <t>The TICKET TLV will be added to the PTP message preceding the AUTHENTICATION TLV as 
       shown in figure 48 of IEEE Std 1588-2019 (<xref target="IEEE1588-2019"/>, Section 16.14.1.1). </t>
	   <!-- For this solution, a completely new TICKET TLV for IEEE Std 1588-2019 needs to be defined.</t> -->




</section>

<section anchor="auth-tlv-parameters" title="AUTHENTICATION TLV Parameters">

<t>The AUTHENTICATION TLV is the heart of the integrated security mechanism (prong A) for PTP. 
It provides all necessary data for the processing of the security means. The structure is shown 
in <xref target="tbl_auth_tlv"/> below (compare to figure 49 of <xref target="IEEE1588-2019"/>).</t>


	<texttable anchor="tbl_auth_tlv" title="Structure of the AUTHENTICATION TLV ">
    <!---   <preamble>(compare to figure 49 of <xref target="IEEE1588-2019"/>)</preamble>   -->

		<!-- table header:  -->
        <ttcol align="left">field</ttcol>
        <ttcol align="left">Use</ttcol>
        <ttcol align="left">Description</ttcol>

		<!-- columns:  --> 
		<!-- 1st row:  -->
          <c>tlvType</c>
          <c>mandatory</c>
          <c>TLV Type</c>
		<!-- 2nd row:  -->
          <c>lengthfield</c>
          <c>mandatory</c>
          <c>TLV Length Information</c>
		<!-- 3rd row:  -->
          <c>SPP</c>
          <c>mandatory</c>
          <c>Security Parameter Pointer</c>
		<!-- 4th row:  -->
          <c>secParamIndicator</c>
          <c>mandatory</c>
          <c>Security Parameter Indicator</c>
		<!-- 5th row:  -->
          <c>keyID</c>
          <c>mandatory</c>
          <c>Key Identifier or Current Key Disclosure Interval, depending on verification scheme</c>
		<!-- 6th row:  -->
          <c>disclosedKey</c>
          <c>optional</c>
          <c>Disclosed key from previous interval</c>
		<!-- 7th row:  -->
          <c>sequenceNo</c>
          <c>optional</c>
          <c>Sequence number</c>
		<!-- 8th row:  -->
          <c>RES</c>
          <c>optional</c>
          <c>Reserved</c>
		<!-- 9th row:  -->
          <c>ICV</c>
          <c>mandatory</c>
          <c>ICV based on algorithm OID</c>

    <!--      <postamble>which is a very simple example.</postamble>   -->
    </texttable>



<t>The tlvType is AUTHENTICATION and lengthfield gives the length of the TLV. When using the 
AUTHENTICATION TLV with NTS key management, the SPP and keyID will be provided by the NTS-KE server 
in the PTP Key Response message</t>

<t>The optional disclosedKey, sequenceNo, and RES fields are 
omitted. So all of the flags in the SecParamIndicator MUST be FALSE.</t>

<t>ICV field contains the integrity check value of the particular PTP message calculated 
using the integrity algorithm defined by the key management.</t>


</section>




<section anchor="iana-considerations" title="IANA Considerations">

<t>Considerations should be made ...</t>
<t>... </t>

</section>


<section anchor="security-considerations" title="Security Considerations">
<t>... </t>

<t></t>

<t></t>

<t></t>



</section>


<section anchor="acknowledgements" title="Acknowledgements">
<t>The authors would like to thank ...</t>

</section>


  </middle>

  <back>

     <references title='Normative References'>

         &RFC2119;
         &RFC4493;         &RFC4543;         &RFC5116;         &RFC5297;		          &RFC7301;         &RFC7525;         &RFC8174;         &RFC8446;         &RFC8915;
		 
    <!-- References 

		IETF RFC 2119 – BCP 14 (1997), “Key words for use in RFCs to Indicate Requirement Levels,” S. Bradner, March 1997.
		IETF RFC 7525 – BCP 195 (2015), “Recommendations for Secure Use of Transport Layer Security (TLS) and Datagram Transport Layer Security (DTLS),” Y. Sheffer, R. Holz, P. Saint-Andre, May 2015.
		IETF RFC 8174 – BCP 14 (2017), “Ambiguity of Uppercase vs. Lowercase in RFC 2119 Key Words,” B. Leiba, May 2017.
		fiPS PUB 198-1
		IEEE Std 1588-2019 
ITU-T Recommendation X.509 (2008), “Information technology – Open systems interconnection – The Directory: Public-key and attribute certificate frameworks”, Nov. 2008. 

    -->

    <reference anchor="IEEE1588-2019" >
         <front>
             <title>IEEE Standard for a Precision Clock Synchronization Protocol for Networked Measurement and Control Systems</title>
             <author >
                 <organization>Institute of Electrical and Electronics Engineers - IEEE Standards Association</organization>
             </author>
             <date year="2019"/>
         </front>
         <seriesInfo name="IEEE" value="Standard 1588-2019"/>
    </reference>
	
    <reference anchor="fiPS-PUB-198-1" >
         <front>
             <title>The Keyed-Hash Message Authentication Code (HMAC)</title>
             <author >
                 <organization>National Institute of Standards and Technology (NIST)</organization>
             </author>
             <date year="2008"/>
         </front>
         <seriesInfo name="NIST" value="fiPS PUB 198-1"/>
    </reference>

    <reference anchor="ITU-T_X.509" >
         <front>
             <title>Information technology – Open systems interconnection – The Directory: Public-key and attribute certificate frameworks</title>
             <author >
                 <organization>International Telecommunication Union (ITU)</organization>
             </author>
             <date month="November" year="2008"/>
         </front>
         <seriesInfo name="ITU-T Recommendation" value="X.509 (2008)"/>
    </reference>

	
    </references>


   <references title='Informative References'>

      <reference anchor="Langer_et_al._2020"
                 target="https://ieeexplore.ieee.org/document/9314809">
        <front>
          <title>A Network Time Security Based Automatic Key Management for PTPv2.1</title>

            <author initials="M" surname="Langer" fullname="Martin Langer">
			   <organization>Mad Dominators, Inc.</organization>
			   </author>
   		    <author initials="K" surname="Heine" fullname="Kai Heine">
			   <organization>Mad Dominators, Inc.</organization>
			   </author>
   		    <author initials="D" surname="Sibold" fullname="Dieter Sibold">
			   <organization>Mad Dominators, Inc.</organization>
			   </author>
   		    <author initials="R" surname="Bermbach" fullname="Rainer Bermbach">
               <organization>Ostfalia University of Applied Sciences</organization>
            </author>

          <date month="November" year="2020"/>
        </front>
		  <seriesInfo name="2020 IEEE 45th Conference on Local Computer Networks (LCN)," value="Sydney, Australia"/>
          <seriesInfo name="DOI" value="10.1109/LCN48667.2020.9314809"/>
      </reference>       

    </references>	
 


  </back>
 
  
</rfc>