Re: [tram] Updated IANA sections in STUNbis (RFC 8489)

Marc Petit-Huguenin <petithug@acm.org> Mon, 25 November 2019 13:48 UTC

Return-Path: <petithug@acm.org>
X-Original-To: tram@ietfa.amsl.com
Delivered-To: tram@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DC58812095D for <tram@ietfa.amsl.com>; Mon, 25 Nov 2019 05:48:26 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.442
X-Spam-Level:
X-Spam-Status: No, score=-0.442 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RDNS_NONE=0.793, SPF_SOFTFAIL=0.665] autolearn=no autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 7rzzP6zOA4xG for <tram@ietfa.amsl.com>; Mon, 25 Nov 2019 05:48:25 -0800 (PST)
Received: from implementers.org (unknown [92.243.22.217]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 1763512095B for <tram@ietf.org>; Mon, 25 Nov 2019 05:48:25 -0800 (PST)
Received: from [IPv6:2601:648:8400:8e7d:6003:2bd6:3b73:70ee] (unknown [IPv6:2601:648:8400:8e7d:6003:2bd6:3b73:70ee]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "Marc Petit-Huguenin", Issuer "implementers.org" (verified OK)) by implementers.org (Postfix) with ESMTPS id B84CBAE4A2; Mon, 25 Nov 2019 14:48:22 +0100 (CET)
To: Harald Alvestrand <harald@alvestrand.no>, "tram@ietf.org" <tram@ietf.org>
References: <ac5ba642-60a0-84c8-9e2d-b6b0c83677fb@acm.org> <cfe3cfa2-de13-a6c6-f0ed-f4f67ce25d71@alvestrand.no>
From: Marc Petit-Huguenin <petithug@acm.org>
Autocrypt: addr=petithug@acm.org; prefer-encrypt=mutual; keydata= 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
Message-ID: <6a30205b-36d5-ea0c-5105-cffdb327e915@acm.org>
Date: Mon, 25 Nov 2019 05:48:20 -0800
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.1
MIME-Version: 1.0
In-Reply-To: <cfe3cfa2-de13-a6c6-f0ed-f4f67ce25d71@alvestrand.no>
Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="PBmXOTHTkWrdXlTUvQqoAJ3reTVt9Kqwo"
Archived-At: <https://mailarchive.ietf.org/arch/msg/tram/smk2azqnsrDpwDeGWjMuxkalCOc>
Subject: Re: [tram] Updated IANA sections in STUNbis (RFC 8489)
X-BeenThere: tram@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussing the creation of a Turn Revised And Modernized \(TRAM\) WG, which goal is to consolidate the various initiatives to update TURN and STUN." <tram.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tram>, <mailto:tram-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tram/>
List-Post: <mailto:tram@ietf.org>
List-Help: <mailto:tram-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tram>, <mailto:tram-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 25 Nov 2019 13:48:27 -0000

Hi Harald,

Thanks for the review, please find the new text below.  About your question about attributes with an updated reference, these are still listed in sections 18.3.1 (updated attributes) and 18.3.2 (new attributes).  The text in section 18.3 below in just added in front of these 2 sections.


"18.2.  STUN Methods Registry

    A STUN method is a hex number in the range 0x000 - 0xFFF.  The
    encoding of STUN method into a STUN message is described in
    Section 5.

    STUN methods in the range 0x000 - 0x7FF are assigned by IETF Review
    [RFC8226].  STUN methods in the range 0x800 - 0xFFF are assigned by
    Expert Review [RFC8226].  The responsibility of the expert is to
    verify that the selected codepoint(s) are not in use and that the
    request is not for an abnormally large number of codepoints.
    Technical review of the extension itself is outside the scope of the
    designated expert responsibility.

    IANA has updated the name for method 0x002 as described below as well
    as updated the reference from RFC 5389 to RFC 8489 for the following
    STUN methods:

    0x000: Reserved
    0x001: Binding
    0x002: Reserved; was SharedSecret prior to [RFC5389]"

"18.3.  STUN Attributes Registry

    A STUN Attribute type is a hex number in the range 0x0000 - 0xFFFF.
    STUN attribute types in the range 0x0000 - 0x7FFF are considered
    comprehension-required; STUN attribute types in the range 0x8000 -
    0xFFFF are considered comprehension-optional.  A STUN agent handles
    unknown comprehension-required and comprehension-optional attributes
    differently.

    STUN Attribute types in the first half of the comprehension-required
    range (0x0000 - 0x3FFF) and in the first half of the comprehension-
    optional range (0x8000 - 0xBFFF) are assigned by IETF Review
    [RFC8226].  STUN Attribute types in the second half of the
    comprehension-required range (0x4000 - 0x7FFF) and in the second half
    of the comprehension-optional range (0xC000 - 0xFFFF) are assigned by
    Expert Review [RFC8226].  The responsibility of the expert is to
    verify that the selected codepoint(s) are not in use, and that the
    request is not for an abnormally large number of codepoints.
    Technical review of the extension itself is outside the scope of the
    designated expert responsibility."

"18.4.  STUN Error Codes Registry

    A STUN error code is a number in the range 0 - 699.  STUN error codes
    are accompanied by a textual reason phrase in UTF-8 [RFC3629] that is
    intended only for human consumption and can be anything appropriate;
    this document proposes only suggested values.

    STUN error codes are consistent in codepoint assignments and
    semantics with SIP [RFC3261] and HTTP [RFC2616].

    New STUN error codes are assigned based on IETF Review [RFC8226].
    The specification must carefully consider how clients that do not
    understand this error code will process it before granting the
    request.  See the rules in Section 6.3.4.

   IANA has updated the reference from RFC 5389 to RFC 8489 for the
   error codes defined in Section 14.8.

   IANA has changed the name of the 401 error code from "Unauthorized"
   to "Unauthenticated"."


On 11/11/19 6:12 AM, Harald Alvestrand wrote:
> Den 10.11.2019 15:56, skrev Marc Petit-Huguenin:
>> I have been asked by Magnus to send the proposed changed to the IANA section to the WG and to Harald for review.  The full new content of the 3 sections are copied below:
> 
> Great to see this!
> 
> Nits:
> - RFC 5226 is obsoleted by RFC 8226
> - The term "Designated Expert" is now deprecated; please use "Expert
> Review" (8226 section 4.5).
> 
> Those are the ones I found on reading. Also, there's one question below.
> Apart from that, I'm happy.
> 
>>
>>
>> "18.2.  STUN Methods Registry
>>
>>     A STUN method is a hex number in the range 0x000 - 0xFFF.  The
>>     encoding of STUN method into a STUN message is described in
>>     Section 5.
>>
>>     STUN methods in the range 0x000 - 0x7FF are assigned by IETF Review
>>     [RFC5226].  STUN methods in the range 0x800 - 0xFFF are assigned by
>>     Designated Expert [RFC5226].  The responsibility of the expert is to
>>     verify that the selected codepoint(s) are not in use and that the
>>     request is not for an abnormally large number of codepoints.
>>     Technical review of the extension itself is outside the scope of the
>>     designated expert responsibility.
>>
>>     IANA has updated the name for method 0x002 as described below as well
>>     as updated the reference from RFC 5389 to RFC 8489 for the following
>>     STUN methods:
>>
>>     0x000: Reserved
>>     0x001: Binding
>>     0x002: Reserved; was SharedSecret prior to [RFC5389]"
>>
>> "18.3.  STUN Attributes Registry
>>
>>     A STUN Attribute type is a hex number in the range 0x0000 - 0xFFFF.
>>     STUN attribute types in the range 0x0000 - 0x7FFF are considered
>>     comprehension-required; STUN attribute types in the range 0x8000 -
>>     0xFFFF are considered comprehension-optional.  A STUN agent handles
>>     unknown comprehension-required and comprehension-optional attributes
>>     differently.
>>
>>     STUN Attribute types in the first half of the comprehension-required
>>     range (0x0000 - 0x3FFF) and in the first half of the comprehension-
>>     optional range (0x8000 - 0xBFFF) are assigned by IETF Review
>>     [RFC5226].  STUN Attribute types in the second half of the
>>     comprehension-required range (0x4000 - 0x7FFF) and in the second half
>>     of the comprehension-optional range (0xC000 - 0xFFFF) are assigned by
>>     Designated Expert [RFC5226].  The responsibility of the expert is to
>>     verify that the selected codepoint(s) are not in use, and that the
>>     request is not for an abnormally large number of codepoints.
>>     Technical review of the extension itself is outside the scope of the
>>     designated expert responsibility."
> 
> Are there no attributes with an updated reference in this registry?
> 
>>
>> "18.4.  STUN Error Codes Registry
>>
>>     A STUN error code is a number in the range 0 - 699.  STUN error codes
>>     are accompanied by a textual reason phrase in UTF-8 [RFC3629] that is
>>     intended only for human consumption and can be anything appropriate;
>>     this document proposes only suggested values.
>>
>>     STUN error codes are consistent in codepoint assignments and
>>     semantics with SIP [RFC3261] and HTTP [RFC2616].
>>
>>     New STUN error codes are assigned based on IETF Review [RFC5226].
>>     The specification must carefully consider how clients that do not
>>     understand this error code will process it before granting the
>>     request.  See the rules in Section 6.3.4.
>>
>>    IANA has updated the reference from RFC 5389 to RFC 8489 for the
>>    error codes defined in Section 14.8.
>>
>>    IANA has changed the name of the 401 error code from "Unauthorized"
>>    to "Unauthenticated"."
>>
> 


-- 
Marc Petit-Huguenin
Email: marc@petit-huguenin.org
Blog: https://marc.petit-huguenin.org
Profile: https://www.linkedin.com/in/petithug