Same-origin policy
The same-origin policy is a browser security feature that restricts cross-origin interactions by documents and scripts.
A browser can load and display resources from multiple sites. You might have multiple tabs open at the same time, or a site could embed multiple iframes from different sites. If there is no restriction on interactions between those resources, and if a script is compromised by an attacker, the script could expose everything on a user's browser.
The same-origin policy prevents this from happening by blocking read access to resources loaded from a different origin. "But wait", you say. "I load images and scripts from other origins all the time." Browsers allow a few tags to embed resources from different origin. This is mostly historical artifacts and could expose your site to vulnerabilities such as clickjacking using iframes. You can restrict the origins for these tags using a Content Security Policy.
What is considered "same-origin"?
An origin is defined by the scheme (also known as the protocol, for example
HTTP or HTTPS), port (if it is specified), and host. When all three are the same
for two URLs, it is considered same-origin. For example.
http://www.example.com/foo is the same-origin as http://www.example.com/bar
but not https://www.example.com/baz (the scheme is
different).
What is permitted and what is blocked?
Generally, embedding a cross-origin resource is permitted, while reading a cross-origin resource is blocked.
| iframe |
Cross-origin embed is permitted (if X-Frame-Options permits) but cross-origin read, such as using JavaScript to access a document in an iframe, is not permitted.
|
| css |
Cross-origin CSS can be embedded using a link tag, or @import in a CSS file. The correct Content-Type header may be required.
|
| form |
Cross-origin URL can be used as the action attribute value of a form element. A web application can write form data to a cross-origin destination.
|
| img |
Embedding cross-origin images is permitted. However, reading cross-origin images is blocked (such as loading a cross-origin image into a canvas element using JavaScript).
|
| media |
Cross-origin video and audio can be embedded using video and audio elements.
|
| script | Cross-origin script can be embedded; however, access to certain APIs might be blocked, such as cross-origin fetch requests. |
How to prevent Clickjacking
An attack called "clickjacking" embeds a site in an iframe and overlays
transparent buttons which link to a different destination. Users are tricked
into thinking they are accessing your application while sending data to
attackers.
To block other sites from embedding your site in an iframe, add a content
security policy with frame-ancestors
directive
to the HTTP headers.
Alternatively, you can add X-Frame-Options to the HTTP headers see
MDN
for list of options.
Wrap up
Hopefully you feel a little relieved that browsers work hard to be a gatekeeper of security on the web. Even though browsers try to be safe by blocking access to resources, sometimes you want to access cross-origin resources in your applications. In the next guide, learn about Cross-Origin Resource Sharing (CORS) and how to tell the browser that loading of cross-origin resources is allowed from trusted sources.
Codelabs
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.