| < draft-jones-jose-jwe-json-serialization-03.txt | draft-jones-jose-jwe-json-serialization-04.txt > | |||
|---|---|---|---|---|
| JOSE Working Group M. Jones | JOSE Working Group M. Jones | |||
| Internet-Draft Microsoft | Internet-Draft Microsoft | |||
| Intended status: Standards Track November 6, 2012 | Intended status: Standards Track December 27, 2012 | |||
| Expires: May 10, 2013 | Expires: June 30, 2013 | |||
| JSON Web Encryption JSON Serialization (JWE-JS) | JSON Web Encryption JSON Serialization (JWE-JS) | |||
| draft-jones-jose-jwe-json-serialization-03 | draft-jones-jose-jwe-json-serialization-04 | |||
| Abstract | Abstract | |||
| The JSON Web Encryption JSON Serialization (JWE-JS) is a means of | The JSON Web Encryption JSON Serialization (JWE-JS) is a means of | |||
| representing encrypted content using JavaScript Object Notation | representing encrypted content using JavaScript Object Notation | |||
| (JSON) data structures. This specification describes a means of | (JSON) data structures. This specification describes a means of | |||
| representing secured content as a JSON data object (as opposed to the | representing secured content as a JSON data object (as opposed to the | |||
| JWE specification, which uses a compact serialization with a URL-safe | JWE specification, which uses a compact serialization with a URL-safe | |||
| representation). It enables the same content to be encrypted to | representation). It enables the same content to be encrypted to | |||
| multiple parties (unlike JWE). Cryptographic algorithms and | multiple parties (unlike JWE). Cryptographic algorithms and | |||
| skipping to change at page 1, line 41 ¶ | skipping to change at page 1, line 41 ¶ | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
| working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
| Drafts is at http://datatracker.ietf.org/drafts/current/. | Drafts is at http://datatracker.ietf.org/drafts/current/. | |||
| Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
| and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
| time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
| material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
| This Internet-Draft will expire on May 10, 2013. | This Internet-Draft will expire on June 30, 2013. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2012 IETF Trust and the persons identified as the | Copyright (c) 2012 IETF Trust and the persons identified as the | |||
| document authors. All rights reserved. | document authors. All rights reserved. | |||
| This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
| Provisions Relating to IETF Documents | Provisions Relating to IETF Documents | |||
| (http://trustee.ietf.org/license-info) in effect on the date of | (http://trustee.ietf.org/license-info) in effect on the date of | |||
| publication of this document. Please review these documents | publication of this document. Please review these documents | |||
| skipping to change at page 2, line 27 ¶ | skipping to change at page 2, line 27 ¶ | |||
| 3. JSON Serialization . . . . . . . . . . . . . . . . . . . . . . 3 | 3. JSON Serialization . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 4. Example JWE-JS . . . . . . . . . . . . . . . . . . . . . . . . 5 | 4. Example JWE-JS . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 6 | 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 6. Security Considerations . . . . . . . . . . . . . . . . . . . . 6 | 6. Security Considerations . . . . . . . . . . . . . . . . . . . . 6 | |||
| 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 6 | 7. References . . . . . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 7.1. Normative References . . . . . . . . . . . . . . . . . . . 6 | 7.1. Normative References . . . . . . . . . . . . . . . . . . . 6 | |||
| 7.2. Informative References . . . . . . . . . . . . . . . . . . 7 | 7.2. Informative References . . . . . . . . . . . . . . . . . . 7 | |||
| Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . . 7 | Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . . 7 | |||
| Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . . 7 | Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . . 7 | |||
| Appendix C. Document History . . . . . . . . . . . . . . . . . . . 7 | Appendix C. Document History . . . . . . . . . . . . . . . . . . . 7 | |||
| Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 8 | Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 1. Introduction | 1. Introduction | |||
| The JSON Web Encryption JSON Serialization (JWE-JS) is a format for | The JSON Web Encryption JSON Serialization (JWE-JS) is a format for | |||
| representing encrypted content as a JavaScript Object Notation (JSON) | representing encrypted content as a JavaScript Object Notation (JSON) | |||
| [RFC4627] object. It enables the same content to be encrypted to | [RFC4627] object. It enables the same content to be encrypted to | |||
| multiple parties (unlike JWE [JWE].) The encryption mechanisms are | multiple parties (unlike JWE [JWE].) The encryption mechanisms are | |||
| independent of the type of content being encrypted. Cryptographic | independent of the type of content being encrypted. Cryptographic | |||
| algorithms and identifiers used with this specification are described | algorithms and identifiers used with this specification are described | |||
| in the separate JSON Web Algorithms (JWA) [JWA] specification. The | in the separate JSON Web Algorithms (JWA) [JWA] specification. The | |||
| skipping to change at page 6, line 48 ¶ | skipping to change at page 6, line 48 ¶ | |||
| 6. Security Considerations | 6. Security Considerations | |||
| The security considerations for this specification are the same as | The security considerations for this specification are the same as | |||
| those for the JSON Web Encryption (JWE) [JWE] specification. | those for the JSON Web Encryption (JWE) [JWE] specification. | |||
| 7. References | 7. References | |||
| 7.1. Normative References | 7.1. Normative References | |||
| [JWA] Jones, M., "JSON Web Algorithms (JWA)", November 2012. | [JWA] Jones, M., "JSON Web Algorithms (JWA)", | |||
| draft-ietf-jose-json-web-algorithms (work in progress), | ||||
| December 2012. | ||||
| [JWE] Jones, M., Rescorla, E., and J. Hildebrand, "JSON Web | [JWE] Jones, M., Rescorla, E., and J. Hildebrand, "JSON Web | |||
| Encryption (JWE)", November 2012. | Encryption (JWE)", draft-ietf-jose-json-web-encryption | |||
| (work in progress), December 2012. | ||||
| [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | |||
| Requirement Levels", BCP 14, RFC 2119, March 1997. | Requirement Levels", BCP 14, RFC 2119, March 1997. | |||
| [RFC4627] Crockford, D., "The application/json Media Type for | [RFC4627] Crockford, D., "The application/json Media Type for | |||
| JavaScript Object Notation (JSON)", RFC 4627, July 2006. | JavaScript Object Notation (JSON)", RFC 4627, July 2006. | |||
| 7.2. Informative References | 7.2. Informative References | |||
| [I-D.rescorla-jsms] | [I-D.rescorla-jsms] | |||
| Rescorla, E. and J. Hildebrand, "JavaScript Message | Rescorla, E. and J. Hildebrand, "JavaScript Message | |||
| Security Format", draft-rescorla-jsms-00 (work in | Security Format", draft-rescorla-jsms-00 (work in | |||
| progress), March 2011. | progress), March 2011. | |||
| [JSE] Bradley, J. and N. Sakimura (editor), "JSON Simple | [JSE] Bradley, J. and N. Sakimura (editor), "JSON Simple | |||
| Encryption", September 2010. | Encryption", September 2010. | |||
| [JWS-JS] Jones, M., Bradley, J., and N. Sakimura, "JSON Web | [JWS-JS] Jones, M., Bradley, J., and N. Sakimura, "JSON Web | |||
| Signature JSON Serialization (JWS-JS)", November 2012. | Signature JSON Serialization (JWS-JS)", | |||
| draft-jones-jose-jws-json-serialization (work in | ||||
| progress), December 2012. | ||||
| Appendix A. Acknowledgements | Appendix A. Acknowledgements | |||
| JSON serializations for encrypted content were previously explored by | JSON serializations for encrypted content were previously explored by | |||
| JSON Simple Encryption [JSE] and JavaScript Message Security Format | JSON Simple Encryption [JSE] and JavaScript Message Security Format | |||
| [I-D.rescorla-jsms]. | [I-D.rescorla-jsms]. | |||
| Appendix B. Open Issues | Appendix B. Open Issues | |||
| [[ to be removed by the RFC editor before publication as an RFC ]] | [[ to be removed by the RFC editor before publication as an RFC ]] | |||
| The following items remain to be considered or done in this draft: | The following items remain to be considered or done in this draft: | |||
| o Track changes that occur in the JWE spec. | o Track changes that occur in the JWE spec. | |||
| Appendix C. Document History | Appendix C. Document History | |||
| [[ to be removed by the RFC editor before publication as an RFC ]] | [[ to be removed by the RFC editor before publication as an RFC ]] | |||
| -04 | ||||
| o Added seriesInfo information to Internet Draft references. | ||||
| -03 | -03 | |||
| o Updated values for example AES CBC calculations. | o Updated values for example AES CBC calculations. | |||
| -02 | -02 | |||
| o Changed to use an array of structures for per-recipient values, | o Changed to use an array of structures for per-recipient values, | |||
| rather than a set of parallel arrays. | rather than a set of parallel arrays. | |||
| o Promoted Initialization Vector from being a header parameter to | o Promoted Initialization Vector from being a header parameter to | |||
| being a top-level JWE element. This saves approximately 16 bytes | being a top-level JWE element. This saves approximately 16 bytes | |||
| in the compact serialization, which is a significant savings for | in the compact serialization, which is a significant savings for | |||
| some use cases. Promoting the Initialization Vector out of the | some use cases. Promoting the Initialization Vector out of the | |||
| header also avoids repeating this shared value in the JSON | header also avoids repeating this shared value in the JSON | |||
| serialization. | serialization. | |||
| skipping to change at page 8, line 39 ¶ | skipping to change at page 8, line 49 ¶ | |||
| draft-jones-json-web-encryption-json-serialization-02 | draft-jones-json-web-encryption-json-serialization-02 | |||
| o Updated examples to track updated algorithm properties in the JWA | o Updated examples to track updated algorithm properties in the JWA | |||
| spec. | spec. | |||
| o Tracked editorial changes made to the JWE spec. | o Tracked editorial changes made to the JWE spec. | |||
| draft-jones-json-web-encryption-json-serialization-01 | draft-jones-json-web-encryption-json-serialization-01 | |||
| o Tracked changes between JOSE JWE draft -00 and -01, which added an | o Tracked changes between JOSE JWE draft -00 and -01, which added an | |||
| integrity check for non-AEAD algorithms. | integrity check for non-Authenticated Encryption algorithms. | |||
| draft-jones-json-web-encryption-json-serialization-00 | draft-jones-json-web-encryption-json-serialization-00 | |||
| o Created the initial version incorporating JOSE working group input | o Created the initial version incorporating JOSE working group input | |||
| and drawing from the JSON Serialization previously proposed in | and drawing from the JSON Serialization previously proposed in | |||
| draft-jones-json-web-token-01. | draft-jones-json-web-token-01. | |||
| Author's Address | Author's Address | |||
| Michael B. Jones | Michael B. Jones | |||
| Microsoft | Microsoft | |||
| Email: mbj@microsoft.com | Email: mbj@microsoft.com | |||
| End of changes. 11 change blocks. | ||||
| 10 lines changed or deleted | 18 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||