Re: [jose] #20: Shorter names for JSON serialization

Mike Jones <Michael.Jones@microsoft.com> Wed, 08 May 2013 18:49 UTC

Return-Path: <Michael.Jones@microsoft.com>
X-Original-To: jose@ietfa.amsl.com
Delivered-To: jose@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id BCC7F21F9079 for <jose@ietfa.amsl.com>; Wed, 8 May 2013 11:49:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.431
X-Spam-Level:
X-Spam-Status: No, score=-2.431 tagged_above=-999 required=5 tests=[AWL=0.167, BAYES_00=-2.599, HTML_MESSAGE=0.001]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 8lIn1yKBE2N9 for <jose@ietfa.amsl.com>; Wed, 8 May 2013 11:49:25 -0700 (PDT)
Received: from na01-bl2-obe.outbound.protection.outlook.com (mail-bl2lp0209.outbound.protection.outlook.com [207.46.163.209]) by ietfa.amsl.com (Postfix) with ESMTP id 818AE21F9057 for <jose@ietf.org>; Wed, 8 May 2013 11:49:25 -0700 (PDT)
Received: from BL2FFO11FD028.protection.gbl (10.173.161.204) by BL2FFO11HUB019.protection.gbl (10.173.160.111) with Microsoft SMTP Server (TLS) id 15.0.687.1; Wed, 8 May 2013 18:39:58 +0000
Received: from TK5EX14HUBC102.redmond.corp.microsoft.com (131.107.125.37) by BL2FFO11FD028.mail.protection.outlook.com (10.173.161.107) with Microsoft SMTP Server (TLS) id 15.0.687.1 via Frontend Transport; Wed, 8 May 2013 18:39:57 +0000
Received: from TK5EX14MBXC283.redmond.corp.microsoft.com ([169.254.2.161]) by TK5EX14HUBC102.redmond.corp.microsoft.com ([157.54.7.154]) with mapi id 14.02.0318.003; Wed, 8 May 2013 18:39:40 +0000
From: Mike Jones <Michael.Jones@microsoft.com>
To: Richard Barnes <rlb@ipv.sx>, Vladimir Dzhuvinov / NimbusDS <vladimir@nimbusds.com>
Thread-Topic: [jose] #20: Shorter names for JSON serialization
Thread-Index: AQHOS8eUUnVw7/2APkGvFZmOHgLmz5j7beaAgAAjeuA=
Date: Wed, 08 May 2013 18:39:40 +0000
Message-ID: <4E1F6AAD24975D4BA5B168042967394367713EB3@TK5EX14MBXC283.redmond.corp.microsoft.com>
References: <20130508013941.cc40c4f3d92d2001859047cd8cabb9ab.48b3dedebc.wbe@email07.europe.secureserver.net> <CAL02cgTF-Jsfvw+qTEfw8yTcsKm-dQ1u66k6xb9pgW8fB8JM=w@mail.gmail.com>
In-Reply-To: <CAL02cgTF-Jsfvw+qTEfw8yTcsKm-dQ1u66k6xb9pgW8fB8JM=w@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-originating-ip: [157.54.51.32]
Content-Type: multipart/alternative; boundary="_000_4E1F6AAD24975D4BA5B168042967394367713EB3TK5EX14MBXC283r_"
MIME-Version: 1.0
X-Forefront-Antispam-Report: CIP:131.107.125.37; CTRY:US; IPV:CAL; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(377454002)(24454002)(51704005)(13464003)(189002)(199002)(59766001)(65816001)(50986001)(79102001)(53806001)(16601075002)(69226001)(54356001)(512954002)(74876001)(46102001)(47976001)(66066001)(44976003)(80022001)(81542001)(74706001)(47736001)(49866001)(74366001)(51856001)(4396001)(16236675002)(71186001)(54316002)(33656001)(20776003)(76482001)(47446002)(81342001)(56816002)(16406001)(63696002)(15202345002)(56776001)(15974865001)(55846006)(77982001)(74502001)(74662001)(6806003)(31966008); DIR:OUT; SFP:; SCL:1; SRVR:BL2FFO11HUB019; H:TK5EX14HUBC102.redmond.corp.microsoft.com; RD:InfoDomainNonexistent; MX:1; A:1; LANG:en;
X-OriginatorOrg: microsoft.onmicrosoft.com
X-Forefront-PRVS: 084080FC15
Cc: "draft-ietf-jose-json-web-encryption@tools.ietf.org" <draft-ietf-jose-json-web-encryption@tools.ietf.org>, jose issue tracker <trac+jose@trac.tools.ietf.org>, "jose@ietf.org" <jose@ietf.org>
Subject: Re: [jose] #20: Shorter names for JSON serialization
X-BeenThere: jose@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: Javascript Object Signing and Encryption <jose.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/jose>, <mailto:jose-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/jose>
List-Post: <mailto:jose@ietf.org>
List-Help: <mailto:jose-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/jose>, <mailto:jose-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 08 May 2013 18:49:30 -0000

The payload and the ciphertext are actually quite different kinds of fields - in particular, one is plain text and the other is encrypted.  Calling them both "data" would blur this distinction and potentially cause confusion.  I'd rather that we continued using different names when the things being named are different.

                                                            -- Mike

From: Richard Barnes [mailto:rlb@ipv.sx]
Sent: Wednesday, May 08, 2013 8:43 AM
To: Vladimir Dzhuvinov / NimbusDS
Cc: draft-ietf-jose-json-web-encryption@tools.ietf.org; jose issue tracker; jose@ietf.org
Subject: Re: [jose] #20: Shorter names for JSON serialization

"iv" and "tag" would be OK.  I still prefer "mac" over "tag", for consistency with CMS, and just because I think MAC is a more uniformly used phrase.

What about "data" for "payload" and "ciphertext"?

On Wed, May 8, 2013 at 9:39 AM, Vladimir Dzhuvinov / NimbusDS <vladimir@nimbusds.com<mailto:vladimir@nimbusds.com>> wrote:
+1 for "iv" and "tag"

--
Vladimir Dzhuvinov : www.NimbusDS.com<http://www.NimbusDS.com> : vladimir@nimbusds.com<mailto:vladimir@nimbusds.com>



-------- Original Message --------
Subject: Re: [jose] #20: Shorter names for JSON serialization
From: Mike Jones <Michael.Jones@microsoft.com<mailto:Michael.Jones@microsoft.com>>
Date: Tue, May 07, 2013 10:40 pm
To: Richard Barnes <rlb@ipv.sx<mailto:rlb@ipv.sx>>, Jim Schaad <ietf@augustcellars.com<mailto:ietf@augustcellars.com>>
Cc: "draft-ietf-jose-json-web-encryption@tools.ietf.org<mailto:draft-ietf-jose-json-web-encryption@tools.ietf.org>"
<draft-ietf-jose-json-web-encryption@tools.ietf.org<mailto:draft-ietf-jose-json-web-encryption@tools.ietf.org>>, jose issue tracker
<trac+jose@trac.tools.ietf.org<mailto:trac%2Bjose@trac.tools.ietf.org>>, "jose@ietf.org<mailto:jose@ietf.org>" <jose@ietf.org<mailto:jose@ietf.org>>

  What about "iv" and "tag"?  For the other names, I'd
actually prefer staying with those that are full words rather than those
that are abbreviations of words, since they're more descriptive.  But
I agree that "initialization_vector" and "authentication_tag"
were overkill.

                                                             -- Mike

 From: Richard Barnes [mailto:rlb@ipv.sx<mailto:rlb@ipv.sx>]
 Sent: Monday, May 06, 2013 2:51 PM
 To: Jim Schaad
 Cc: jose issue tracker;
draft-ietf-jose-json-web-encryption@tools.ietf.org<mailto:draft-ietf-jose-json-web-encryption@tools.ietf.org>; jose@ietf.org<mailto:jose@ietf.org>
 Subject: Re: [jose] #20: Shorter names for JSON serialization

 Even that's the name for the corresponding field in CMS
AuthEnvelopedData and AuthenticatedData?


 On Monday, May 6, 2013, Jim Schaad wrote:
 I would be againist calling the authentication_tag mac.  I don't object
to
 something like AuthTag.  It is not necessarily a MAC in all cases so
calling
 it one make thing problematical - much like calling a mac a sig.

 Jim


 > -----Original Message-----
 > From: jose-bounces@ietf.org<mailto:jose-bounces@ietf.org> [mailto:jose-bounces@ietf.org<mailto:jose-bounces@ietf.org>] On Behalf
Of
 > jose issue tracker
 > Sent: Monday, May 06, 2013 2:29 PM
 > To: draft-ietf-jose-json-web-encryption@tools.ietf.org<mailto:draft-ietf-jose-json-web-encryption@tools.ietf.org>; rlb@ipv.sx<mailto:rlb@ipv.sx>
 > Cc: jose@ietf.org<mailto:jose@ietf.org>
 > Subject: [jose] #20: Shorter names for JSON serialization
 >
 > #20: Shorter names for JSON serialization
 >
 >  I noticed as I was doing some programming with the JSON syntax for
 JWE/JWS
 > that the current field names in the JSON format are unnecessarily
 > cumbersome.  Nobody in the real world names a variable
 >  "initialization_vector", it's "iv".   Proposed changes:
 >
 >  || OLD                     || NEW  ||
 >  || signatures              || sigs ||
 >  || signature               || sig  ||
 >  || payload                 || data ||
 >  || recipients              || keys ||
 >  || ciphertext              || data ||
 >  || initialization_vector   || iv   ||
 >  || authentication_tag      || mac  ||
 >
 > --
 >
-------------------------+----------------------------------------------
 > -------------------------+---
 >  Reporter:  rlb@ipv.sx<mailto:rlb@ipv.sx>   |      Owner:  draft-ietf-jose-json-web-
 >      Type:  defect       |  encryption@tools.ietf.org<mailto:encryption@tools.ietf.org>
 >  Priority:  minor        |     Status:  new
 > Component:  json-web-    |  Milestone:
 >   encryption             |    Version:
 >  Severity:  -            |   Keywords:
 >
-------------------------+----------------------------------------------
 > -------------------------+---
 >
 > Ticket URL: <http://trac.tools.ietf.org/wg/jose/trac/ticket/20>
 > jose <http://tools.ietf.org/jose/>
 >
 > _______________________________________________
 > jose mailing list
 > jose@ietf.org<mailto:jose@ietf.org>
 > https://www.ietf.org/mailman/listinfo/jose


_______________________________________________
jose mailing list
jose@ietf.org<mailto:jose@ietf.org>
https://www.ietf.org/mailman/listinfo/jose
_______________________________________________
jose mailing list
jose@ietf.org<mailto:jose@ietf.org>
https://www.ietf.org/mailman/listinfo/jose