JSONP, or JSON-P (JSON with Padding), is a historical JavaScript technique for requesting data by loading a <script>
element,[1] which is an element intended to load ordinary JavaScript. It was proposed by Bob Ippolito in 2005.[2] JSONP enables sharing of data bypassing same-origin policy, which disallows running JavaScript code to read media DOM elements or XMLHttpRequest data fetched from outside the page's originating site. The originating site is indicated by a combination of URI scheme, hostname, and port number.
JSONP is vulnerable to the data source replacing the innocuous function call with malicious code, which is why it has been superseded by cross-origin resource sharing (available since 2009[3]) in modern applications.
Functionality
editThe HTML <script>
element is generally allowed to execute JavaScript code retrieved from foreign origins. Services replying with pure JSON data, however, were not able to share data from foreign origins before the adoption of CORS (Cross-origin resource sharing).
For example, a request to a foreign service http://server.example.com/Users/1234
may return a record for a person named Clem in the JSON format. JSON syntax is consistent with JavaScript's object syntax.
{
"Name": "Clem",
"Id": 1234,
"Rank": 7
}
Without support for CORS, an attempt to use the data across domains results in a JavaScript error.
<script type="application/javascript"
src="http://server.example.com/Users/1234">
</script>
The browser will download the <script>
file, evaluate its contents, misinterpret the raw JSON data as a block, and throw a syntax error. Even if the data were interpreted as a JavaScript object literal, it could not be accessed by JavaScript running in the browser, since without a variable assignment, object literals are inaccessible.
In the JSONP usage pattern, the URL request pointed to by the src
attribute in the <script>
element returns JSON data, with JavaScript code (usually a function call) wrapped around it. This "wrapped payload" is then interpreted by the browser. In this way, a function that is already defined in the JavaScript environment can manipulate the JSON data. A typical JSONP request and response are shown below.
The function call to parseResponse() is the "P" of JSONP—the "padding" or "prefix" around the pure JSON.[4] For JSONP to work, a server must reply with a response that includes the JSONP function. JSONP does not work with JSON-formatted results. The JSONP function invocation that gets sent back, and the payload that the function receives, must be agreed upon by the client and server. By convention, the server providing the JSON data offers the requesting website to name the JSONP function, typically using the name jsonp or callback as the named query-string parameter, in its request to the server: <script src="http://server.example.com/Users/1234?callback=parseResponse"></script>
.
In this example, the received payload would be:
parseResponse({"Name": "Clem", "Id": 1234, "Rank": 7});
Script element injection
editJSONP makes sense only when used with a script element. For each new JSONP request, the browser must add a new <script>
element, or reuse an existing one. The former option—adding a new script element—is done via dynamic DOM manipulation, and is known as script element injection. The <script>
element is injected into the HTML DOM, with the URL of the desired JSONP endpoint set as the "src" attribute. This dynamic script element injection is usually done by a JavaScript helper library. jQuery and other frameworks have JSONP helper functions; there are also standalone options.
An example of using jQuery to dynamically inject script element for a JSONP call looks like this:
$.getScript("http://server.example.com/Users/192.168.73.96?callback=parseResponse");
After the element is injected, the browser evaluates the element, and performs an HTTP GET on the src URL, retrieving the content. Then the browser evaluates the return payload as JavaScript. This is typically a function invocation. In that way, the use of JSONP can allow browser pages to work around the same-origin policy via script element injection.[5]
The script runs within the scope of the including page and, as such, is still subject to cross-domain restrictions relative to the domain of the including page. This means that a web page cannot, for example, load a library hosted on another site via JSONP and then make XMLHttpRequest requests to that site (unless cross-origin resource sharing (CORS) is supported), although one could use such a library to make XMLHttpRequests to one's own site.
Security concerns
editUntrusted third-party code
editIncluding script elements from remote servers allows the remote servers to inject any content into a website. If the remote servers have vulnerabilities that allow JavaScript injection, the page served from the original server is exposed to an increased risk. If an attacker can inject any JavaScript into the original web page, then that code can retrieve additional JavaScript from any domain, bypassing the same-origin policy.[6] The Content Security Policy HTTP Header lets web sites tell web browsers which domain scripts may be included from.
An effort was undertaken around 2011 to define a safer strict subset definition for JSONP[1] that browsers would be able to enforce on script requests with a specific MIME type such as "application/json-p". If the response did not parse as strict JSONP, the browser could throw an error or just ignore the entire response. However, this approach was abandoned in favor of CORS, and the correct MIME type for JSONP remains application/javascript
.[7]
Whitespace differences
editJSONP carried the same problems as resolving JSON with eval()
: both interpret the JSON text as JavaScript, which meant differences in handling U+2028 (Line Separator) and U+2029 (Paragraph Separator) from JSON proper. This made some JSON strings non-legal in JSONP; servers serving JSONP had to escape these characters prior to transmission.[8] This issue has now been rectified in ES2019.[9]
Callback name manipulation and reflected file download attack
editUnsanitized callback names may be used to pass malicious data to clients, bypassing the restrictions associated with application/json
content type, as demonstrated in reflected file download (RFD) attack from 2014.[10]
Insecure JSONP endpoints can be also injected with malicious data.[11]
Cross-site request forgery
editNaive deployments of JSONP are subject to cross-site request forgery (CSRF or XSRF) attacks.[12] Because the HTML <script>
element does not respect the same-origin policy in web browser implementations, a malicious page can request and obtain JSON data belonging to another site. This will allow the JSON-encoded data to be evaluated in the context of the malicious page, possibly divulging passwords or other sensitive data if the user is currently logged into the other site.
Rosetta Flash
editRosetta Flash is an exploitation technique that allows an attacker to exploit servers with a vulnerable JSONP endpoint by causing Adobe Flash Player to believe that an attacker-specified Flash applet originated on the vulnerable server. Flash Player implements same-origin policy allowing one to make requests (with cookies) and receive responses from the hosting site. The applet can then send the retrieved data back to the attacker. This is a cross-origin exploit with an impact similar to embedding an arbitrary Flash applet in the vulnerable domain. The exploit uses an ActionScript payload compiled to an SWF file composed entirely of alphanumeric characters by crafting a zlib stream with a particular header and DEFLATE blocks with ad-hoc Huffman coding. The resulting alphanumeric-only SWF file is then used as the callback parameter of a JSONP call. High-profile sites such as Google, YouTube, Twitter, Yahoo!, Yandex, LinkedIn, eBay, GitHub, Instagram, and Tumblr were all vulnerable until July 2014.[13] This vulnerability was initially discovered by Erling and Alok Menghrajani, with a public presentation at a security conference. The exploitation of the vulnerability was subsequently improved by Gábor Molnár. Google security engineer Michele Spagnuolo coined the term[14] and has CVE-2014-4671[15] and CVE-2014-5333.[16] Adobe Flash Player release version 14.0.0.145, released on 8 July 2014, introduced stronger validation of Flash files,[17] and in version 14.0.0.176, released on 12 August 2014, finalized the fix,[18] preventing this exploit from working.
Prior to Adobe's fix, websites could protect themselves by prepending an empty JavaScript comment (/**/) or even just a newline as the first bytes of the JSONP response.
History
editIn July 2005, George Jempty suggested an optional variable assignment be prepended to JSON.[19][20] The original proposal for JSONP, where the padding is a callback function, appears to have been made by Bob Ippolito in December 2005[21] and is now used by many Web 2.0 applications such as Dojo Toolkit and Google Web Toolkit.
See also
editReferences
edit- ^ a b "Safer cross-domain Ajax with JSON-P/JSONP". JSON-P.org. Archived from the original on 4 March 2016. Retrieved 30 October 2011.
- ^ Ippolito, Bob (5 December 2005). "Remote JSON - JSONP". Bob Ippolito on Haskell, Python, Erlang, JavaScript, etc. Archived from the original on 8 June 2012. Retrieved 10 February 2017.
- ^ "Cross-Origin Resource Sharing". Can I use... Retrieved 4 May 2020.
- ^ "Experimental RDF result set to JSON translator". Archived from the original on 15 November 2014. Retrieved 20 February 2012.
- ^ "So how does JSONP really work? Some simple examples". Jason Schock. 5 February 2013. Retrieved 26 December 2021.
- ^ Ben Hayak (17 October 2014). "Same Origin Method Execution" (PDF). Retrieved 22 October 2014.
- ^ Grey, Eli (27 June 2010). "Is this safe for providing JSONP?". stackoverflow.com. Retrieved 7 September 2012.
- ^ "JSON: The JavaScript subset that isn't". Magnus Holm. Archived from the original on 13 May 2012. Retrieved 16 May 2011.
- ^ "Subsume JSON (a.k.a. JSON ⊂ ECMAScript)". GitHub. 24 October 2022. Retrieved 24 October 2022.
- ^ Oren Hafif (2014). "Reflected File Download - A New Web Attack Vector". TrustWave. Retrieved 25 March 2015.
- ^ "Practical JSONP injection". 18 January 2017.
- ^ Grossman, Jeremiah (27 January 2006). "Advanced Web Attack Techniques using GMail". Retrieved 3 July 2009.
- ^ Michele, Spagnuolo. "Abusing JSONP with Rosetta Flash". Archived from the original on 21 July 2014. Retrieved 20 July 2014.
- ^ "Google - list of software vulnerabilities discovered or fixed by Googlers". Retrieved 29 July 2014.
- ^ "MITRE: CVE-2014-4671". Retrieved 29 July 2014.
- ^ "MITRE: CVE-2014-5333". Retrieved 21 August 2014.
- ^ "Adobe Security Bulletin APSB14-17". Retrieved 29 July 2014.
- ^ "Adobe Security Bulletin APSB14-18". Retrieved 21 August 2014.
- ^ "eval'ing JSON". 19 July 2005. Archived from the original on 12 February 2006.
- ^ "json: Message: Re: Comments". 17 August 2005. Archived from the original on 22 July 2012.
- ^ "Remote JSON - JSONP". from __future__ import *. Bob.pythonmac.org. 5 December 2005. Archived from the original on 4 December 2009. Retrieved 8 September 2008.
External links
edit- server side filter wraps any response into a jsonp callback – done with jsonp-java source code
- Potential security issues related to JSON
- JSONP data source for remote domains