JSON Web Signature
{{Short description|Proposed standard for signing arbitrary data}}
{{Infobox technology standard
| title = JWS
| long_name = JSON Web Signature
| image =
| image_size =
| alt =
| caption = standard for signing arbitrary JSON
| abbreviation = JWS
| native_name =
| native_name_lang =
| status = Proposed Standard
| year_started =
| first_published =
| version =
| version_date =
| preview =
| preview_date =
| organization = IETF
| committee = IEGS
| series =
| editors =
| authors = {{Plainlist|
- Michael B. Jones
- Microsoft
- John Bradley
- Ping Identity
- Nat Sakimura
- NRI
}}
| base_standards = JSON
| related_standards = {{Plainlist|
- HMAC-based one-time password
- JSON Web Algorithms (JWA)
- JSON Web Encryption (JWE)
- JSON Web Token (JWT)
- JSON Web Key (JWK)
- Secure Hash Algorithm 2 (SHA-2)
}}
| domain = Data exchange
| license =
| copyright =
| website = {{URL|https://datatracker.ietf.org/doc/html/rfc7515}}
}}
A JSON Web Signature (abbreviated JWS) is an IETF-proposed standard ({{IETF RFC|7515}}) for signing arbitrary data.{{cite web|url=https://tools.ietf.org/html/rfc7515|title=JSON Web Signature (JWS) [RFC7515]|date=May 2015 |last1=Jones |first1=Michael B. |last2=Bradley |first2=John |last3=Sakimura |first3=Nat }} This is used as the basis for a variety of web-based technologies including JSON Web Token.
Purpose
JWS is a way to ensure integrity of information in a highly serializable, machine-readable format. That means that it is information, along with proof that the information hasn't changed since being signed. It can be used for sending information from one web site to another, and is especially aimed at communications on the web. It even contains a compact form optimized for applications like URI query parameters.{{cite web|url=https://tools.ietf.org/html/rfc7515#section-3.1|title=JWS Compact Serialization Overview|date=May 2015 |last1=Jones |first1=Michael B. |last2=Bradley |first2=John |last3=Sakimura |first3=Nat }}
= Examples =
== Web commerce ==
JWS can be used for applications in which digitally signed information must be sent in a machine-readable format, such as e-commerce. For example, say a user named Bob is browsing widget prices on a web site (widgets.com), and wishes to get a quote on one of them. Then widgets.com could provide Bob with a JWS object containing all relevant information about the widget, including the price, then sign it using their private key. Then Bob would have a non-repudiable price quote for the product.
== Access to third-party resources ==
Maybe Widgets.com and WidgetStorage.com have a deal in which WidgetStorage.com will accept coupons from Widgets.com in exchange for traffic. Widgets.com could issue JWS giving Bob a 10% discount on the WidgetStorage.com site. Again, because the data is signed, WidgetStorage can know that Widgets.com emitted this. If the data was not signed, then Bob could change his discount to 50% and no one would know just from looking at the data.
Limitations
JWS is one of the standards in the JOSE series{{cite web | title=JSON Object Signing and Encryption (JOSE) | website=Internet Assigned Numbers Authority | date=2015-01-23 | url=https://www.iana.org/assignments/jose/jose.xhtml | access-date=2018-11-19}} and is meant to be used in combination with them. For example, for encryption JSON Web Encryption (JWE){{cite journal|url=https://tools.ietf.org/html/rfc7516|title=JSON Web Encryption (JWE) [RFC7516]|website=ietf.org|date=May 2015 |accessdate=13 May 2015 |last1=Jones |first1=Michael B. |last2=Hildebrand |first2=Joe }} is supposed to be used in conjunction.
As of 2015, JWS was a proposed standard, and was part of several other IETF proposed standards,{{cite journal|url=https://tools.ietf.org/html/rfc7517|title=JSON Web Key (JWK) [RFC7517]|website=ietf.org|date=May 2015 |accessdate=13 May 2015 |last1=Jones |first1=Michael B. }} and there was code available on the web to implement the proposed standard.{{cite web|url=https://code.google.com/p/google-oauth-java-client/source/browse/google-oauth-client/src/main/java/com/google/api/client/auth/jsontoken/JsonWebSignature.java?r=c31891da772f2479cf47c2141c137f6c47a36685|title=google/google-oauth-java-client|work=GitHub|accessdate=13 May 2015}}{{cite web|url=http://jwt.io/|title=JSON Web Tokens - jwt.io|work=jwt.io|accessdate=13 May 2015}}