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

Mike Jones <Michael.Jones@microsoft.com> Tue, 07 May 2013 21:42 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 A713721F90DF for <jose@ietfa.amsl.com>; Tue, 7 May 2013 14:42:52 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.598
X-Spam-Level:
X-Spam-Status: No, score=-2.598 tagged_above=-999 required=5 tests=[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 G+6clLdC3+XE for <jose@ietfa.amsl.com>; Tue, 7 May 2013 14:42:47 -0700 (PDT)
Received: from na01-bl2-obe.outbound.protection.outlook.com (mail-bl2lp0205.outbound.protection.outlook.com [207.46.163.205]) by ietfa.amsl.com (Postfix) with ESMTP id 3091021F90CC for <jose@ietf.org>; Tue, 7 May 2013 14:42:46 -0700 (PDT)
Received: from BN1AFFO11FD027.protection.gbl (10.58.52.204) by BN1AFFO11HUB010.protection.gbl (10.58.52.120) with Microsoft SMTP Server (TLS) id 15.0.687.1; Tue, 7 May 2013 21:40:36 +0000
Received: from TK5EX14MLTC104.redmond.corp.microsoft.com (131.107.125.37) by BN1AFFO11FD027.mail.protection.outlook.com (10.58.52.87) with Microsoft SMTP Server (TLS) id 15.0.687.1 via Frontend Transport; Tue, 7 May 2013 21:40:35 +0000
Received: from TK5EX14MBXC283.redmond.corp.microsoft.com ([169.254.2.161]) by TK5EX14MLTC104.redmond.corp.microsoft.com ([157.54.79.159]) with mapi id 14.02.0318.003; Tue, 7 May 2013 21:40:34 +0000
From: Mike Jones <Michael.Jones@microsoft.com>
To: Richard Barnes <rlb@ipv.sx>, Jim Schaad <ietf@augustcellars.com>
Thread-Topic: [jose] #20: Shorter names for JSON serialization
Thread-Index: AQHOSokGUnVw7/2APkGvFZmOHgLmz5j4soMAgAGN86A=
Date: Tue, 07 May 2013 21:40:33 +0000
Message-ID: <4E1F6AAD24975D4BA5B16804296739436771242B@TK5EX14MBXC283.redmond.corp.microsoft.com>
References: <049.92c9829790c8d5776a0efee36c11df4c@trac.tools.ietf.org> <00a601ce4a88$dc8cdd70$95a69850$@augustcellars.com> <CAL02cgRNPVpiOrz+7SxNEcsNJAgCGg1dic2h+YX2FnVRZh_4wg@mail.gmail.com>
In-Reply-To: <CAL02cgRNPVpiOrz+7SxNEcsNJAgCGg1dic2h+YX2FnVRZh_4wg@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.36]
Content-Type: multipart/alternative; boundary="_000_4E1F6AAD24975D4BA5B16804296739436771242BTK5EX14MBXC283r_"
MIME-Version: 1.0
X-Forefront-Antispam-Report: CIP:131.107.125.37; CTRY:US; IPV:CAL; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(51704005)(377454002)(13464003)(189002)(199002)(24454002)(54316002)(79102001)(20776003)(49866001)(63696002)(69226001)(76482001)(50986001)(16406001)(33656001)(47976001)(55846006)(74706001)(47736001)(74876001)(74662001)(51856001)(15202345002)(81542001)(46102001)(74502001)(47446002)(81342001)(66066001)(31966008)(77982001)(512954002)(6806003)(54356001)(74366001)(59766001)(56816002)(71186001)(4396001)(16236675002)(53806001)(80022001)(56776001)(65816001); DIR:OUT; SFP:; SCL:1; SRVR:BN1AFFO11HUB010; H:TK5EX14MLTC104.redmond.corp.microsoft.com; RD:InfoDomainNonexistent; MX:1; A:1; LANG:en;
X-OriginatorOrg: microsoft.onmicrosoft.com
X-Forefront-PRVS: 0839D067E7
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: Tue, 07 May 2013 21:42:52 -0000

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]
Sent: Monday, May 06, 2013 2:51 PM
To: Jim Schaad
Cc: jose issue tracker; draft-ietf-jose-json-web-encryption@tools.ietf.org; 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<javascript:;> [mailto:jose-bounces@ietf.org<javascript:;>] On Behalf Of
> jose issue tracker
> Sent: Monday, May 06, 2013 2:29 PM
> To: draft-ietf-jose-json-web-encryption@tools.ietf.org<javascript:;>; rlb@ipv.sx<mailto:rlb@ipv.sx>
> Cc: jose@ietf.org<javascript:;>
> 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<javascript:;>
>  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<javascript:;>
> https://www.ietf.org/mailman/listinfo/jose