[core] Chair's review of draft-ietf-core-resource-directory-19

Jaime Jiménez <jaime.jimenez@ericsson.com> Fri, 22 February 2019 12:34 UTC

Return-Path: <jaime.jimenez@ericsson.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 B996512EB11 for <core@ietfa.amsl.com>; Fri, 22 Feb 2019 04:34:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.322
X-Spam-Level:
X-Spam-Status: No, score=-3.322 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FROM_EXCESS_BASE64=0.979, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=ericsson.com header.b=C+jg9IYC; dkim=pass (1024-bit key) header.d=ericsson.com header.b=am9v2T9C
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 5yOFAS7EH_H4 for <core@ietfa.amsl.com>; Fri, 22 Feb 2019 04:34:34 -0800 (PST)
Received: from sesbmg23.ericsson.net (sesbmg23.ericsson.net [193.180.251.37]) (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 6B37E12E04D for <core@ietf.org>; Fri, 22 Feb 2019 04:34:32 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; d=ericsson.com; s=mailgw201801; c=relaxed/relaxed; q=dns/txt; i=@ericsson.com; t=1550838866; x=1553430866; h=From:Sender:Reply-To:Subject:Date:Message-ID:To:CC:MIME-Version:Content-Type: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=cmIGPa/uKHletvWyToiTAOrBrSPakW/m4qvcT0KK9cQ=; b=C+jg9IYC0hASORqA43NeFAew1kLW18SjhDHWdko9nGtutHcFexfqgmmiD/KBO/uX FMQcdwbs1zOTig/mXF3N7R/bJ+4rBcRllFK99NO4hPb6e/yqVSsgRrOTqgzDOua9 X8dSpI4J3ejLNAA0zI65rpy06K4HzYOme850aQnyL68=;
X-AuditID: c1b4fb25-da1ff70000005ff7-f3-5c6fec521ad9
Received: from ESESSMB502.ericsson.se (Unknown_Domain [153.88.183.120]) by sesbmg23.ericsson.net (Symantec Mail Security) with SMTP id FF.76.24567.25CEF6C5; Fri, 22 Feb 2019 13:34:26 +0100 (CET)
Received: from ESESSMB501.ericsson.se (153.88.183.162) by ESESSMB502.ericsson.se (153.88.183.163) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1466.3; Fri, 22 Feb 2019 13:34:26 +0100
Received: from EUR02-HE1-obe.outbound.protection.outlook.com (153.88.183.157) by ESESSMB501.ericsson.se (153.88.183.162) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1466.3 via Frontend Transport; Fri, 22 Feb 2019 13:34:26 +0100
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=cmIGPa/uKHletvWyToiTAOrBrSPakW/m4qvcT0KK9cQ=; b=am9v2T9CV29YumCBkeQjSbH4XiVL5FTS2fpGS27x3z6J6aIW6K3CebpS+A/S5vS/R/mTnd729WsMPx9laXRCRZ8x3CLtAkJQfeR96JJYgKRZVa/seJzG4LhgjaO11jGz+Bl59sKjBXUqi/92ShxygU0mAhBLZyxl02jaoN5AqE8=
Received: from AM5PR0701MB2307.eurprd07.prod.outlook.com (10.169.152.18) by AM5SPR00MB2540.eurprd07.prod.outlook.com (10.169.247.151) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1665.5; Fri, 22 Feb 2019 12:34:24 +0000
Received: from AM5PR0701MB2307.eurprd07.prod.outlook.com ([fe80::60c7:8b7:f1b1:b641]) by AM5PR0701MB2307.eurprd07.prod.outlook.com ([fe80::60c7:8b7:f1b1:b641%11]) with mapi id 15.20.1665.006; Fri, 22 Feb 2019 12:34:24 +0000
From: =?utf-8?B?SmFpbWUgSmltw6luZXo=?= <jaime.jimenez@ericsson.com>
To: core <core@ietf.org>
CC: Carsten Bormann <cabo@tzi.org>, "draft-ietf-core-resource-directory@ietf.org" <draft-ietf-core-resource-directory@ietf.org>
Thread-Topic: [core] Chair's review of draft-ietf-core-resource-directory-19
Thread-Index: AdTKqThILqREaxH5RIWEnORALxAYaQ==
Date: Fri, 22 Feb 2019 12:34:24 +0000
Message-ID: <AM5PR0701MB2307AF330344860328775506977F0@AM5PR0701MB2307.eurprd07.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=jaime.jimenez@ericsson.com;
x-originating-ip: [192.176.1.75]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: e371b15d-c42c-4a38-bd73-08d698c213fa
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600110)(711020)(4605104)(2017052603328)(7153060)(7193020); SRVR:AM5SPR00MB2540;
x-ms-traffictypediagnostic: AM5SPR00MB2540:
x-ms-exchange-purlcount: 4
x-microsoft-exchange-diagnostics: =?utf-8?B?MTtBTTVTUFIwME1CMjU0MDsyMzpyY0dFVWIzYkNiYlQrWThJZUVrMVJ6TExj?= =?utf-8?B?QXEwdjRmYUdLZFYvbC9ZWkpjOHdRZS9RMEdJS2EwcWtUVCtrbGE0M0ZJeHo5?= =?utf-8?B?TGZSRmNDRXRzbW5FWjJBN3hsc29YckpNem56enllMEIzeE1INUlzMW1BdkdO?= =?utf-8?B?bDNCZkMwQmNXS3kzTm92eUttdVFsaXpwTDZLNE9LTXFtRUJQVklld0xCZXk4?= =?utf-8?B?MVh1MytQbG9Nc0tiR3N1Njl3YUs3VVJTbEpjYWN2TS94aDhlQzdoaTlxWDg4?= =?utf-8?B?TS8vcnhYMEhOVEhxeEtIREUyQzZsRG5hK0svTWRmcGovd3luM0tJYy93VVEw?= =?utf-8?B?VU1oODdZOFhEWVJRL2dYd3BSaUpsbDJCOVQvSDVIeFYvOUpQUUt2Vnk2Q1dx?= =?utf-8?B?Y0l5a3kzRnJJaU5GT2FwWUxrQW9neFEvemk5U2NHdVZCdlhTZEdUNnB4M2hV?= =?utf-8?B?VjY1Q0VvZnlvbklUMjVhb3lSR0ZmMFcyemtnYjBVTUUrS3RQRHYwbElaZi9P?= =?utf-8?B?V1BOaUU0T3l0cWRRRzZtU0RNandUTWNJMFNMYkRjbU5Xb21sNE15Zk40T2RP?= =?utf-8?B?TkIrZGxvRjBXb2w2c1pxVzVCMXNLVjg5cmdwMmZNTDZYbTVEVjhhNVFJR1lJ?= =?utf-8?B?Uko4cFhTUDRXUWhsMzNRZUVpK1dUVHhXVGw0YnhDOStpSGtwNHc1VVlnc01J?= =?utf-8?B?eDR3NzJ4V3lBbVlpcVhhSE1RZldINWNWK21NcHgzaGNGOUVZR2ZSdWQ2REY3?= =?utf-8?B?cDJDWGIrVHJnU0xTQjkwK3dvV2tQUkdrN0xZMExtTjJlMUQrRUlsQ2U1NHlT?= =?utf-8?B?emp4TVFFZkFQb0VnYVVuVmprRTFBd0JsN1lBVEtrcndmUFdJY2s4cHkwaHBC?= =?utf-8?B?b3RIbGlqczVWcjFGa3FodG9LUER4Yk95c05oMStaZW0vbWh3N215U3VUcU5Q?= =?utf-8?B?TjFQRlJVOWRCVC9HSkZFam9xVVh5QlpkNWxBU3BZRkdodmxhMThGc3c3aE05?= =?utf-8?B?aURMUDRpUnlCZEc3T0FiL3BsT1dGRlE0ZHN5ajJtMkpKR1dtdEd1MHFXalUw?= =?utf-8?B?VXU2M3hJeHZKbWg3RWNUam4rR0dpVDdyMUp5NnlvTDVQbklRRTI0ZDUxclJH?= =?utf-8?B?anRUYkk1dUU3bmRQQkdrNTVxNWM4eWFUOU5aeUpBY25RNHlZL3h4b2hNQ2lU?= =?utf-8?B?cVR1M0lLME5YNUdJQnB4eEVqOEMvckpXT2hqdzZhaURrNWc4OTE0RW9sMGlI?= =?utf-8?B?NzdpTW1FVXVNQkl4MStZcVo1VnhoT1hzbVpiZUNPV1dKd2NRMTVwUzFOSGpO?= =?utf-8?B?aGJJcFBWSUI3L3hLUXBXcCtMc1NDQ2lsV29JT2d5K1lsZTg1TFJuSVhycmgv?= =?utf-8?B?Zzk0MU9MQ0lhcjBpNkQ3ZE1Rc0h2UWhXenptMnFuYXBRL3RHMTRMa05ZNlNj?= =?utf-8?B?SytrOCtqY3hEdjRlTzNGbWhBcW82Tkp6WXlRU0lQUlFXaTVEM05tNU9JVlVD?= =?utf-8?B?RWVNNjRxd0ExNXJYWjl6b21ldk05ZHhLOUEwR2V1RkF5R2MvWEdtTjNOOG54?= =?utf-8?B?Wkc4VjlNaG4rUFhqVmwrVXVlTVI4U2tjNnpXMjUvS0NWNHpvWmRSa3gxUjA4?= =?utf-8?B?djMwMnRqMTRQWGtxSHZ0elhFWG8zUmFjRjJFZUFxZ1EvUVNtWVhuNnVwTkRm?= =?utf-8?B?UnRFZFFBMlNGWmlWUEhicWo1N25qMHhUWDFMMTVjNmt6bkpHOTFva0RqelFt?= =?utf-8?B?UDZWQjhUSXZsRFFYZVZ4dUE9PQ==?=
x-microsoft-antispam-prvs: <AM5SPR00MB2540E4DD82A85FB6195BDBEC977F0@AM5SPR00MB2540.eurprd07.prod.outlook.com>
x-forefront-prvs: 09565527D6
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(396003)(366004)(346002)(376002)(136003)(39860400002)(199004)(189003)(6436002)(6916009)(81156014)(8936002)(81166006)(54906003)(54896002)(486006)(7736002)(74316002)(3846002)(106356001)(14444005)(256004)(606006)(8676002)(790700001)(6116002)(6506007)(66574012)(102836004)(236005)(9686003)(186003)(6306002)(66066001)(53936002)(105586002)(26005)(86362001)(476003)(316002)(5660300002)(55016002)(2906002)(14454004)(478600001)(97736004)(99286004)(71200400001)(71190400001)(413944005)(966005)(7696005)(85202003)(4326008)(68736007)(33656002)(85182001)(25786009); DIR:OUT; SFP:1101; SCL:1; SRVR:AM5SPR00MB2540; H:AM5PR0701MB2307.eurprd07.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam-message-info: rdUaqRMVwSm9BIU3oppFpfv5/j8pyd133Jtb4Cuf1SIxsFMNlnpUHoV8VBMYDJkRohzfOvEfEYGbZmMWmvOPKbU6Q3BLYuM4G2fXVS99Jcyy9Em6GZARe08fD7o0IeI7EN/uT8Y8ePp72pNUyEJ0dhGZal90r/leuVq7ykegSYaE5xuOHYT8YWs7OnlsW/fZHjcuc+w7V7K07rl1p6gs4pN346eijqckjbBBhiaP1YphomoLWPb14b9oJZyMgc00UjqcKf/r27pdL1zXpvOUgOWSPLh6dzArvzq2VHpH8X5Syzg6lFHqHa+B7vlQNRa85V+Wl8XGAl/lSTlCLNELB3vJh3LHrtm4qORS9EAr5iAmaXTxev3QFKcyZyfEl1pLAKP9ziY6qeISh+oSu8u/uTXyAcMXzz3glLKuCsJRRlg=
Content-Type: multipart/alternative; boundary="_000_AM5PR0701MB2307AF330344860328775506977F0AM5PR0701MB2307_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: e371b15d-c42c-4a38-bd73-08d698c213fa
X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Feb 2019 12:34:24.5270 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 92e84ceb-fbfd-47ab-be52-080c6b87953f
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5SPR00MB2540
X-OriginatorOrg: ericsson.com
X-Brightmail-Tracker: H4sIAAAAAAAAA02Se0hTYRjG+845c8fV4nM5fbELutI0Se0CDrKwQhLKC4IgorWVJ125TXZU 1H/aFJU0Q8mEiZbWKhLNtNIs8ZaVGmS6DBmWiLfyUlSW16KdnQX+97zv+3ve73s+PpqU1Anc aJUmldFplMkyBxFljGnO2Bs1p40LaL+xS95d+lEgb5uvJ+Udi4HBZKjJtEyElt1SRRKxoqAE JlmVzuj8jyhESebZ21TKkhllmPPySD2qfYsKkCMN+CBc/5RPFiARLcHdCK7VG+zFbwRzgzwl wSYCxr+LuAGFi0lYyp1BPFVGwGrNJMEXkwjM91cpzuKAj8OPKYOQ084Y4PKvdiEHkTgHwXLO tG3vFnwC8szTBA+dgvymR9bDaav2g/afPlybwp7wZ2DOtlOMFdA5NCTgNMIusNhXa7OS2BUs EzcJPhAGU2s/yWspfBn/K+BWIhwPfdUMJwG7Q3tDFE9sh8GbhfanCIPXLWu2XIAtCBoHvtnX +ELbSgnFazf4OvyA4qFeJ1gwzNvdaqhuyLFD26As+40DD00I4OFMHcG/IwP36nLthh1QUzRG FSPf8nUZeK2F0bVBstyW2Ql6jRNUufXiJPaB+mf+POIBpYVjQl57Q25FpXB9vwoJa5CUZdiz 6sT9B/wYneocy2o1fhomtRFZP1Hn41XPp8g8d7QLYRrJNoljh7VxEoEync1UdyGgSZmzeMO0 tSVOUGZmMTrtGV1aMsN2oa00JXMVr0mc4iQ4UZnKXGSYFEb3f0rQjm56JK8Mj2hIGbV4sa4L +cYLFeMuIyrHlxqdY3JwNJl0skiJo8mRQxtbpgxZekVEZ8Gl5zsDe2rfPUloqjosVRg7PqdD CHK/Kowpycrt8t4d5FUkDUgbuLO59W6YdnnF5diLVyJ1ZGrglfcG02B2p2UxfjYkHPQfgs/3 9zQTltMeMopNUu7bQ+pY5T+yd9XvQAMAAA==
Archived-At: <https://mailarchive.ietf.org/arch/msg/core/vt7JiBeAI6XrkpKI1UWMbnMc9B8>
Subject: [core] Chair's review of draft-ietf-core-resource-directory-19
X-BeenThere: core@ietf.org
X-Mailman-Version: 2.1.29
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: Fri, 22 Feb 2019 12:34:36 -0000

Dear authors,

below are some of the comments to the draft, they are mostly editorials with few ones that may warrant further discussion.

p1 - "Web interfaces" is often used interchangeably with "REST interfaces" it'd be better to use one only, maybe the latter.

p3 - "with limited RAM and ROM" Adding a reference to the expected RAM and ROM would be good. https://ieeexplore.ieee.org/document/6970748/ provides an estimation of <2kB of minimum RAM and <30kB of minimum ROM for common IoT OSs.

p3 p12 - I think we could move on and update the term "machine-to-machine" to "Internet of Things" throughout the document, unless there is a specific need to keep M2M still there.

p6 - RDAO is under-defined in the terminology section, expanding the acronym is too short for a definition.
p6 - the last paragraph of Section 2 "For several operations.... circumstances" could probably go before the enumeration of the terminology.
p6 - "Only information SHOULD be stored in the resource directory that can be obtained by querying ..." could be "Information SHOULD be stored in the resource directory only if it can that can be obtained by querying ..."

p8 - The Commissioning Tool (CT) should be added to the architecture on the Registration Interface.

p10 – change content-type (ct)/content-format (ct)

p15 - I wonder why there is no DHCP/DHCP6 option to discover RD defined, is there no interest by those deploying RD? If the authors find it relevant, it could be added as a new draft or as part of this one in a similar way as the RDAO option on a new section 4.2

p19 - https://github.com/core-wg/resource-directory/issues/191
"The entries for "Failure" are quite repetitive for 4.00 and 5.03. Can we factor these out a bit?
The entry "HTTP support" is surprising; maybe this item should be explained beforehand. (It seems all it is saying is that HTTP does not do multicast or /.well-known/core?)"

p20 p28 p31 p38 and others - There does not seem to be a common way to present REST interactions in the examples of the document. Please use always the same form. For example similar to:

<Interaction>: <Origin EP> -> <Destination EP>
<Request>:  <Method> <URI/PATH>
            <PAYLOAD>
<Response>: <Code>
            <PAYLOAD>

Which in markdown would look like:
~~~~
  Int: EP -> IPv6 Multicast Address (FF0X::FE) or [MCD1]
  Req: GET coap://[MCD1]/.well-known/core?rt=core.rd*
  Res: 2.05 Content
       </rd>;rt="core.rd";ct=40,
       </rd-lookup/ep>;rt="core.rd-lookup-ep";ct=40,
       </rd-lookup/res>;rt="core.rd-lookup-res";ct=40,
~~~~

p22 - Endpoint Name "mostly mandatory" is ambiguous. If the ep name is not needed to register to an RD then it is optional. If, on the other hand the RD needs an ep name and assigns one then it is mandatory ( btw if the RD assigns the ep name, shouldn't it return that information to the ep, together with the location within the rd, once the registration is successful? )
Github Issue 190 (below) raises the need to define a bit better what the ep name is supposed to contain. To me, we could keep it mandatory and add some guidelines for its creation, in OMA for example they are defined as an URN http://www.openmobilealliance.org/release/LightweightM2M/V1_1-20180710-A/HTML-Version/OMA-TS-LightweightM2M_Core-V1_1-20180710-A.html#7-3-1-0-731-Endpoint-Client-Name
p22 - https://github.com/core-wg/resource-directory/issues/190
"All we know from the draft is that it is ≤ 63 bytes. But we need to say that it is a UTF-8 string. Not entirely sure we want 😈👄👽 as an endpoint name either. Same for sector."


p23 - Sorry for asking, but why is base URI only mandatory when filled by the Commissioning Tool? Wouldn't it be better to make it always mandatory to avoid the differentiation?

p26 - Section 5.3.1 seems like could use a bit of reordering, I can explain this in another email or call with the authors.

p30 - lt, base and extra-attrs were already explained in 5.3 you might want to keep it as it is or change it by adding a reference to 5.3 and comment on the changes that the Registration Update has over the Registration.

p33 - As per the document structure, there are two interfaces: registration and lookup. Shouldn't they be at the same level in the document? Registration is 5.3, shouldn't lookup be 5.5 instead of 6?

p41 p42 - Just to clarify, is then the tuple [endpoint,sector] the way RD identifies endpoints? Or is it derived from the device's credentials?
- "A given endpoint that registers itself, needs to proof its possession of its unique (endpoint name, sector) value pair." - "An Endpoint (name, sector) pair is unique within the et of endpoints registered by the RD.  An Endpoint MUST NOT be identified by its protocol, port or IP address as these may change over the lifetime of an Endpoint."

p44 - typo address/Address