[core] New Version Notification for draft-amsuess-core-pd-body-error-position-00.txt

Christian Amsüss <christian@amsuess.com> Sat, 04 February 2023 22:40 UTC

Return-Path: <christian@amsuess.com>
X-Original-To: core@ietfa.amsl.com
Delivered-To: core@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8A138C14F748 for <core@ietfa.amsl.com>; Sat, 4 Feb 2023 14:40:52 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.895
X-Spam-Level:
X-Spam-Status: No, score=-1.895 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
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 oeJ9ZYFQZWLg for <core@ietfa.amsl.com>; Sat, 4 Feb 2023 14:40:48 -0800 (PST)
Received: from smtp.akis.at (smtp.akis.at [IPv6:2a02:b18:500:a515::f455]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8A6EEC14F693 for <core@ietf.org>; Sat, 4 Feb 2023 14:40:46 -0800 (PST)
Received: from poseidon-mailhub.amsuess.com ([IPv6:2a02:b18:c13b:8010:a800:ff:fede:b1bd]) by smtp.akis.at (8.17.1/8.17.1) with ESMTPS id 314MehW6031007 (version=TLSv1.2 cipher=ECDHE-ECDSA-AES256-GCM-SHA384 bits=256 verify=NOT) for <core@ietf.org>; Sat, 4 Feb 2023 23:40:43 +0100 (CET) (envelope-from christian@amsuess.com)
X-Authentication-Warning: smtp.akis.at: Host [IPv6:2a02:b18:c13b:8010:a800:ff:fede:b1bd] claimed to be poseidon-mailhub.amsuess.com
Received: from poseidon-mailbox.amsuess.com (hermes.amsuess.com [10.13.13.254]) by poseidon-mailhub.amsuess.com (Postfix) with ESMTP id 84B281A441 for <core@ietf.org>; Sat, 4 Feb 2023 23:40:42 +0100 (CET)
Received: from hephaistos.amsuess.com (hephaistos.amsuess.com [IPv6:2a02:b18:c13b:8010::907]) by poseidon-mailbox.amsuess.com (Postfix) with ESMTPSA id 50D471CD69 for <core@ietf.org>; Sat, 4 Feb 2023 23:40:42 +0100 (CET)
Received: (nullmailer pid 30704 invoked by uid 1000); Sat, 04 Feb 2023 22:40:42 -0000
Date: Sat, 04 Feb 2023 23:40:41 +0100
From: Christian Amsüss <christian@amsuess.com>
To: core@ietf.org
Message-ID: <Y97e6dWnME7brk7r@hephaistos.amsuess.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="Yi6u6CFT5rYWQ/GN"
Content-Disposition: inline
Archived-At: <https://mailarchive.ietf.org/arch/msg/core/6aOu1imii5Tme2ExU4gnuMqhr10>
Subject: [core] New Version Notification for draft-amsuess-core-pd-body-error-position-00.txt
X-BeenThere: core@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "Constrained RESTful Environments \(CoRE\) Working Group list" <core.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/core>, <mailto:core-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/core/>
List-Post: <mailto:core@ietf.org>
List-Help: <mailto:core-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/core>, <mailto:core-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 04 Feb 2023 22:40:52 -0000

Hi Standard Problem Detail Keys experts, hello group,

implementing RFC9290 for the Rust coap-handler-implementations, I found
that many error paths are due to parsing errors (which, the way things
are set up, are not distinguished between CBOR format errors or just
unexpected elements). The problem detail might lend itself to
generalization, which I've written up with the intention to apply for a
standard problem detail number.

While no WG or even IETF action is required for this, I'd appreciate a
few eyes and/or comments before sending this to IANA and eventually the
experts, Thomas and Carsten.

Below the "new document" template, I've copied down the two most
relevant sections for your convenience.

Name:		draft-amsuess-core-pd-body-error-position
Revision:	00
Title:		Concise Problem Details: Body Error Position
Document date:	2023-02-04
Group:		Individual Submission
Pages:		5
Status:         https://datatracker.ietf.org/doc/draft-amsuess-core-pd-body-error-position/
Html:           https://www.ietf.org/archive/id/draft-amsuess-core-pd-body-error-position-00.html
Htmlized:       https://datatracker.ietf.org/doc/html/draft-amsuess-core-pd-body-error-position

Abstract:
   This defines a single standard problem detail for use with the
   Concise Problem Details format: Request Body Error Position.  Using
   this detail, the server can point at the position inside the client's
   request body that induced the error.


1.2.  Document lifecycle

   Registering a standard problem detail merely requires a
   specification, not an RFC (let alone of a particular track).

   It is the author's opinion that an Interned Draft can provide
   sufficient specification, and is more suitable than an informal note
   published at some arbitrary website due to its archival through the
   draft submission process.

   It is not expected that this draft will proceed all the way to an
   RFC; instead, once sufficiently mature, it will be used as a
   reference in a request to IANA, and updated with the assigned number.

   This document will eventually expire as an Internet Draft, but
   nonetheless be usable as the permanent reference for the assigned
   problem detail.

2.  Request Body Error Position

   The Request Body Error Position problem detail indicates that the
   error described by the Concise Problem Details response resulted from
   processing the request body.  The numeric value indicates a byte
   position inside that body that corresponds to the error.  The precise
   error position for invalid data may vary by implementation -- for
   example, if a numeric value inside a CBOR ([STD94]) item exceeds the
   expected range, it may indicate the number's initial byte (typically
   if the implementation doesn't even implement the indicated argument
   size) or the argument (if it implements it).

   When the request's content format indicated a non-identity content
   coding, the offset points into the uncompressed body.  Consequently,
   this error detail is not suitable for pointing out errors that occur
   during uncompressing.

   The main envisioned use of this option is for the client to highlight
   or back-annotate (eg. to counteract minification, or to display it on
   some diagnostic notation) the erroneous item in the request body for
   a human author.

BR
c

-- 
To use raw power is to make yourself infinitely vulnerable to greater powers.
  -- Bene Gesserit axiom