CBOR Web Token (CWT)
draft-ietf-ace-cbor-web-token-00

The information below is for an old version of the document
Document Type Active Internet-Draft (ace WG)
Last updated 2016-05-20
Replaces draft-wahlstroem-ace-cbor-web-token
Stream IETF
Intended RFC status (None)
Formats plain text pdf html bibtex
Reviews
Stream WG state WG Document
Document shepherd No shepherd assigned
IESG IESG state I-D Exists
Consensus Boilerplate Unknown
Telechat date
Responsible AD (None)
Send notices to (None)
ACE Working Group                                          E. Wahlstroem
Internet-Draft                                          Nexus Technology
Intended status: Informational                                  M. Jones
Expires: November 21, 2016                                     Microsoft
                                                           H. Tschofenig
                                                                ARM Ltd.
                                                            May 20, 2016

                          CBOR Web Token (CWT)
                    draft-ietf-ace-cbor-web-token-00

Abstract

   CBOR Web Token (CWT) is a compact means of representing claims to be
   transferred between two parties.  CWT is a profile of the JSON Web
   Token (JWT) that is optimized for constrained devices.  The claims in
   a CWT are encoded in the Concise Binary Object Representation (CBOR)
   and CBOR Object Signing and Encryption (COSE) is used for added
   application layer security protection.  A claim is a piece of
   information asserted about a subject and is represented as a name/
   value pair consisting of a claim name and a claim value.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on November 21, 2016.

Copyright Notice

   Copyright (c) 2016 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of

Wahlstroem, et al.      Expires November 21, 2016               [Page 1]
Internet-Draft               CBOR Web Token                     May 2016

   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . .   3
   3.  Claims  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
     3.1.  Claim Names . . . . . . . . . . . . . . . . . . . . . . .   4
       3.1.1.  iss (Issuer) Claim  . . . . . . . . . . . . . . . . .   4
       3.1.2.  sub (Subject) Claim . . . . . . . . . . . . . . . . .   4
       3.1.3.  aud (Audience) Claim  . . . . . . . . . . . . . . . .   4
       3.1.4.  exp (Expiration Time) Claim . . . . . . . . . . . . .   4
       3.1.5.  nbf (Not Before) Claim  . . . . . . . . . . . . . . .   4
       3.1.6.  iat (Issued At) Claim . . . . . . . . . . . . . . . .   5
       3.1.7.  cti (CWT ID) Claim  . . . . . . . . . . . . . . . . .   5
   4.  Summary of the values, CBOR major types and encoded claim
       keys  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
   5.  Security Considerations . . . . . . . . . . . . . . . . . . .   5
   6.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   6
   7.  Normative References  . . . . . . . . . . . . . . . . . . . .   6
   Appendix A.  Examples . . . . . . . . . . . . . . . . . . . . . .   6
     A.1.  CWT with "aud" and symmetric key  . . . . . . . . . . . .   7
     A.2.  CWT with "aud" and EC key . . . . . . . . . . . . . . . .   8
     A.3.  Full CWT  . . . . . . . . . . . . . . . . . . . . . . . .  10
   Appendix B.  Acknowledgements . . . . . . . . . . . . . . . . . .  12
   Appendix C.  Document History . . . . . . . . . . . . . . . . . .  12
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  13

1.  Introduction

   The JSON Web Token (JWT) [5] is a standardized security token format
   that has found use in OAuth 2.0 and OpenID Connect deployments, among
   other applications.  JWT uses JSON Web Signatures (JWS) [3] and JSON
   Web Encryption (JWE) [4] to secure the contents of the JWT, which is
   a set of claims represented in JSON [5].  The use of JSON for
   encoding information is popular for Web and native applications, but
   it is considered inefficient for some Internet of Things (IoT)
   systems that use low power radio technologies.

   In this document an alternative encoding of claims is defined.
Show full document text