[regext] Posting of Versioning in the Registration Data Access Protocol (RDAP) - draft-gould-regext-rdap-versioning

"Gould, James" <jgould@verisign.com> Tue, 29 November 2022 20:32 UTC

Return-Path: <jgould@verisign.com>
X-Original-To: regext@ietfa.amsl.com
Delivered-To: regext@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5C6C3C152597 for <regext@ietfa.amsl.com>; Tue, 29 Nov 2022 12:32:10 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.096
X-Spam-Level:
X-Spam-Status: No, score=-2.096 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=verisign.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id KnXsPe24-_8A for <regext@ietfa.amsl.com>; Tue, 29 Nov 2022 12:32:05 -0800 (PST)
Received: from mail6.verisign.com (mail6.verisign.com [69.58.187.32]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A3A89C152599 for <regext@ietf.org>; Tue, 29 Nov 2022 12:32:05 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=verisign.com; l=26888; q=dns/txt; s=VRSN; t=1669753927; h=from:to:subject:date:message-id:mime-version; bh=/mc6VwCpFjGY3voEUBYevT9017nJy2pBJ/vO0cI+ZxY=; b=clplxZ5xpLBGElp7X6S6HBs4pZLa9kZn/vFl4/gvP53Zbw0aD3t9xXIB UZ4CCpVzzRgfZ42e1gJ3pjV7MvLhPLIg9H1GXagl5WCRLmmtfuHZeB5IA ZGBaqcJWW9wH0LFSHJgNSOuOQWoZeuXr9K/GhdbYmbXs3UhwwMli11Jef baUYJ/6Lm0rocPUx7CcnwVGEn6z4yBTtCjFxH882bI1gfrMRtoQ7nh0/1 uQLEpjJzqP/AEEPAYhbikv2DOve/a+PXVqHKFQmV1zISqeVbsEi5uFGTI opq+yi2StyrsEbNwkk5KVGCuYoZc9cKtwCsLAheJVvJ6If6zc0g4cSdOQ g==;
IronPort-Data: A9a23:F7uCGanc5aJkp+Kaq5x3dhXo5gxFJ0RdPkR7XQ2eYbSJt16W5oE+e lBvADTXbaqKYmPrO4chWDmFhUNV7JaGndRiTgtv/ixnRnhG+ZCaCdqVdkqrMXrCfpySERM5v sgXM4eecp8/RCTW9kfzP7LqpiUmjPjZTbGsVb6s1kydJONBYH5JZUVLx7dg3uaE+OSEPj5hm e8eguXSaAWoh2N6aztJu/nY9kxjsKv452hGs1JgPPka4gGDnCVMXMMUKJ/qIiqjSOG4PAIYq 8Xrl+jlozyDr3/BLvv/z94Xp2VTGua60TCm0yYQAe766vR7jnRa+r4hM/YBYltghTyMntRgo P1ArpXYpT0BZ8Ugo8xAFUgGe81CFfceouWeeCLu6ZL7I3DuKBMA/d0/VCnaAqVFoo6bMUkWn dQEJTYEaAy0hu7e6NpXncE126zPhOGyVG8ukikIIQPxVJ7KcriaK0n+3uK06R9r7ix4Na2HO 5dGM2oHgCPoOHWjMn9PYH43tLnw2imnK1W0onrNzUY8yzC7IACcTNEBmTcaEzCHbZw9o6qWm o7J10KlKDoVNY2+8DC+/2mcvtCVuyPrV51HQdVU9tYy6LGS7kYpLkQpc3aL+aP/lEW5QcoZI kBS5DA1q+4580nDotvVBkX++SHf+EdBAJwMQoXW6ynUokbQywSWAXUAQhZfZcYnr845Q3oh0 Vrhc9bBXGw27OfLEC71GrG8tGqQIDoNCX05SiY9FDJe8v7JjJMwp0eaJjpkOOvv5jHvIhnqz j+HvDQWhrgPg4gMzarTwLzcqzi2oMHWSAMlvl+SRXy/qAZ4f8uvYMqi816Cq+haN4DfRV6E1 JQZp/WjACk1JcnlvESwrC8lRtlFO97t3OXgvGNS
IronPort-HdrOrdr: A9a23:Rh7NIahCtHDwnsUF1bQEpfAykHBQXgcji2hC6mlwRA09TyX+rb HKoB17726XtN9/YhEdcLy7VpVoIkmyyXcd2+B4AV7IZniEhILHFuBfxLqn7THmFzb36+JRkY xxGpITNPTASXx3l9zz7gX9MdoxqePszImYwcPT1W1kQw0vUbxn9AsRMGumO1d7XxZLHqA0E5 eg5s5KzgDKRUgq
X-IronPort-AV: E=Sophos;i="5.96,204,1665460800"; d="png'150?scan'150,208,217,150";a="18142614"
Received: from BRN1WNEX01.vcorp.ad.vrsn.com (10.173.153.48) by BRN1WNEX02.vcorp.ad.vrsn.com (10.173.153.49) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.16; Tue, 29 Nov 2022 15:32:02 -0500
Received: from BRN1WNEX01.vcorp.ad.vrsn.com ([10.173.153.48]) by BRN1WNEX01.vcorp.ad.vrsn.com ([10.173.153.48]) with mapi id 15.01.2507.016; Tue, 29 Nov 2022 15:32:02 -0500
From: "Gould, James" <jgould@verisign.com>
To: "regext@ietf.org" <regext@ietf.org>
Thread-Topic: Posting of Versioning in the Registration Data Access Protocol (RDAP) - draft-gould-regext-rdap-versioning
Thread-Index: AQHZBDGj2uZ3oRoufU2N/qb154cK0w==
Date: Tue, 29 Nov 2022 20:32:02 +0000
Message-ID: <78AA6CA5-E8DE-4783-8791-631BF198E3FB@verisign.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: yes
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/16.66.22101101
x-originating-ip: [10.170.148.18]
Content-Type: multipart/related; boundary="_004_78AA6CA5E8DE47838791631BF198E3FBverisigncom_"; type="multipart/alternative"
MIME-Version: 1.0
Archived-At: <https://mailarchive.ietf.org/arch/msg/regext/zU5ioRxii-fVj0XxWmyKTO2UNDA>
Subject: [regext] Posting of Versioning in the Registration Data Access Protocol (RDAP) - draft-gould-regext-rdap-versioning
X-BeenThere: regext@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Registration Protocols Extensions <regext.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/regext>, <mailto:regext-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/regext/>
List-Post: <mailto:regext@ietf.org>
List-Help: <mailto:regext-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/regext>, <mailto:regext-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 29 Nov 2022 20:32:10 -0000

Based on the discussion that occurred on the mailing list on RDAP extension versioning, Mario Loffredo, Dan Keathley, and I collaborated on the Versioning in the Registration Data Access Protocol (RDAP), which has been posted as draft-gould-regext-rdap-versioning<https://datatracker.ietf.org/doc/html/draft-gould-regext-rdap-versioning>.  The extension supports the following features:


  1.  High-level
     *   Versioning based on a subset of Semantic Versioning since the use of PATCH is not applicable for protocol / interface versioning.
     *   The definition and use of an Extension Version Identifier that leverages the RDAP extension identifier.  For example, the RDAP extension identifier “versioning” has the “versioning-0.1” Extension Version Identifier for draft-gould-regext-rdap-versioning-00.
  2.  Use of an extension to the RDAP help response to identify the extension versions supported by the server with the “versioning-help” member.  The intent is to enable the client to discover what extension versions are available and to choose to override the default versions if desired.
     *   The extensions are referenced by the RDAP extensions identifier.  For example, “versioning” for the versioning extension.
     *   A list of extension versions with attributes:

                                                              i.      The Extension Version Identifier (e.g., “versioning-0.1”)

                                                            ii.      Optional default version indicator

                                                          iii.      Optional start and end of support of an extension version

                                                          iv.      Optional links to extension version documentation

  1.  Use of an RDAP Query Parameter (e.g., “versioning”) to enable a client to specify the extension versions desired in the response.  This will override the default versions defined by the server.
  2.  Use of a “versioning” member in the RDAP response to identify extension versions included in the response.
     *   The extensions are referenced by the RDAP extension identifier to map with the rdapConformance value with the inclusion of the Extension Version Identifier (e.g., “versioning-0.1”).

Please review and provide any feedback.

Thanks,

--

JG

[cid:image001.png@01D90407.BA47F360]

James Gould
Fellow Engineer
jgould@Verisign.com<applewebdata://13890C55-AAE8-4BF3-A6CE-B4BA42740803/jgould@Verisign.com>

703-948-3271
12061 Bluemont Way
Reston, VA 20190

Verisign.com<http://verisigninc.com/>