Object Security of CoAP (OSCOAP)
draft-ietf-core-object-security-00

The information below is for an old version of the document
Document Type Active Internet-Draft (core WG)
Authors Göran Selander  , John Preuß Mattsson  , Francesca Palombini  , Ludwig Seitz 
Last updated 2016-10-20
Stream IETF
Intended RFC status (None)
Formats pdf htmlized (tools) htmlized 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)
CoRE Working Group                                           G. Selander
Internet-Draft                                               J. Mattsson
Intended status: Standards Track                            F. Palombini
Expires: April 22, 2017                                      Ericsson AB
                                                                L. Seitz
                                                        SICS Swedish ICT
                                                        October 19, 2016

                    Object Security of CoAP (OSCOAP)
                   draft-ietf-core-object-security-00

Abstract

   This memo defines Object Security of CoAP (OSCOAP), a method for
   application layer protection of message exchanges with the
   Constrained Application Protocol (CoAP), using the CBOR Object
   Signing and Encryption (COSE) format.  OSCOAP provides end-to-end
   encryption, integrity and replay protection to CoAP payload, options,
   and header fields, as well as a secure binding between CoAP request
   and response messages.  The use of OSCOAP is signaled with the CoAP
   option Object-Security, also defined in this memo.

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 April 22, 2017.

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

Selander, et al.         Expires April 22, 2017                 [Page 1]
Internet-Draft      Object Security of CoAP (OSCOAP)        October 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  . . . . . . . . . . . . . . . . . . . . . . . .   3
     1.1.  Terminology . . . . . . . . . . . . . . . . . . . . . . .   4
   2.  The Object-Security Option  . . . . . . . . . . . . . . . . .   5
   3.  The Security Context  . . . . . . . . . . . . . . . . . . . .   6
     3.1.  Security Context Definition . . . . . . . . . . . . . . .   6
     3.2.  Security Context Establishment  . . . . . . . . . . . . .   9
       3.2.1.  Derivation of Sender Key/IV, Recipient Key/IV . . . .   9
       3.2.2.  Sequence Numbers and Replay Window  . . . . . . . . .  10
       3.2.3.  Context Identifier and Sender/Recipient ID  . . . . .  10
   4.  Protected CoAP Message Fields . . . . . . . . . . . . . . . .  11
   5.  The COSE Object . . . . . . . . . . . . . . . . . . . . . . .  14
     5.1.  Plaintext . . . . . . . . . . . . . . . . . . . . . . . .  15
     5.2.  Additional Authenticated Data . . . . . . . . . . . . . .  16
   6.  Protecting CoAP Messages  . . . . . . . . . . . . . . . . . .  17
     6.1.  Replay and Freshness Protection . . . . . . . . . . . . .  17
     6.2.  Protecting the Request  . . . . . . . . . . . . . . . . .  18
     6.3.  Verifying the Request . . . . . . . . . . . . . . . . . .  19
     6.4.  Protecting the Response . . . . . . . . . . . . . . . . .  20
     6.5.  Verifying the Response  . . . . . . . . . . . . . . . . .  21
   7.  Security Considerations . . . . . . . . . . . . . . . . . . .  22
   8.  Privacy Considerations  . . . . . . . . . . . . . . . . . . .  24
   9.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  24
     9.1.  Sid Registration  . . . . . . . . . . . . . . . . . . . .  24
     9.2.  CoAP Option Number Registration . . . . . . . . . . . . .  24
     9.3.  Media Type Registrations  . . . . . . . . . . . . . . . .  24
     9.4.  CoAP Content Format Registration  . . . . . . . . . . . .  25
   10. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . .  26
   11. References  . . . . . . . . . . . . . . . . . . . . . . . . .  26
     11.1.  Normative References . . . . . . . . . . . . . . . . . .  26
     11.2.  Informative References . . . . . . . . . . . . . . . . .  27
   Appendix A.  Overhead . . . . . . . . . . . . . . . . . . . . . .  28
Show full document text