2.2.2.17 MS-Version Attribute

The MS-Version attribute is used to convey the TURN protocol version. This attribute SHOULD be included in the Allocate request message from the protocol client.  This attribute SHOULD be included in the Allocate response message from the TURN server<15>. The format of this attribute is as follows.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Attribute Type

Attribute Length

Version

Attribute Type (2 bytes): The TURN attributes are specified in [IETFDRAFT-STUN-02] section 10.2 and [IETFDRAFT-TURN-08] section 9.2. Set to "0x8008".

Attribute Length (2 bytes): The length of bytes of the Version field. Set to "0x0004" (4).

Version (4 bytes): This field contains the version of the TURN protocol in use.

The following versions are currently defined:

  • "0x00000001" – Used by a protocol client implementing the Interactive Connectivity Establishment (ICE) protocol described in [MS-ICE].

  • "0x00000002" – Used by a protocol client implementing the ICE protocol described in [MS-ICE2].<16>

  • "0x00000003" – Used by a protocol client implementing the ICE protocol described in [MS-ICE2] along with support for HMAC SHA-256 algorithm in the Message Integrity attribute.  Used by a TURN server implementing support for the HMAC SHA-256 algorithm in the Message Integrity attribute.<17>

  • "0x00000004" – Used by a protocol client implementing the ICE protocol described in [MS-ICE2] along with support for HMAC SHA-256 algorithm in the Message Integrity attribute and support for IPv6 addresses.  Used by a TURN server implementing support for the HMAC SHA-256 algorithm in the Message Integrity attribute along with support for IPv6 addresses.<18>

  • "0x00000005" – Used by a protocol client and a TURN server implementing the Multiplexed TURN message format for UDP connections.

  • "0x00000006" – Used by a protocol client and a TURN server implementing the Multiplexed TURN message format for both UDP and TCP connections.