Uploaded image for project: 'CouchDB'
  1. CouchDB
  2. COUCHDB-431

cors - aka Cross-Origin Resource Sharing support

    Details

    • Type: New Feature
    • Status: Closed
    • Priority: Blocker
    • Resolution: Fixed
    • Affects Version/s: 0.9
    • Fix Version/s: 1.3
    • Component/s: HTTP Interface
    • Labels:
      None
    • Skill Level:
      Regular Contributors Level (Easy to Medium)

      Description

      Historically, browsers have been restricted to making XMLHttpRequests (XHRs) to the same origin (domain) as the web page making the request. However, the latest browsers now support cross-domain requests by implementing the Access Control spec from the W3C:
      http://dev.w3.org/2006/waf/access-control/

      In order to keep older servers safe that assume browsers only do same-domain requests, the Access Control spec requires the server to opt-in to allow cross domain requests by the use of special HTTP headers and supporting some "pre-flight" HTTP calls.

      Why should CouchDB support this: in larger, high traffic site, it is common to serve the static UI files from a separate, differently scaled server complex than the data access/API server layer. Also, there are some API services that are meant to be centrally hosted, but allow API consumers to use the API from different domains. In these cases, the UI in the browser would need to do cross domain requests to access CouchDB servers that act as the API/data access server layer.

      JSONP is not enough in these cases since it is limited to GET requests, so no POSTing or PUTing of documents.

      Some information from Firefox's perspective (functionality available as of Firefox 3.5):
      https://developer.mozilla.org/en/HTTP_access_control

      And information on Safari/Webkit (functionality in latest WebKit and Safari 4):
      http://developer.apple.com/safari/library/documentation/AppleApplications/Conceptual/SafariJSProgTopics/Articles/XHR.html

      IE 8 also uses the Access Control spec, but the requests have to go through their XDomainRequest object (XDR):
      http://msdn.microsoft.com/en-us/library/cc288060%28VS.85%29.aspx

      and I thought IE8 only allowed GET or POST requests through their XDR.

      But as far as CouchDB is concerned, implementing the Access Control headers should be enough, and hopefully IE 9 will allow normal xdomain requests via XHR.

        Attachments

        1. test_cors2-1.tgz
          69 kB
          Benoit Chesneau
        2. test_cors2.tgz
          69 kB
          Benoit Chesneau
        3. cors.html
          2 kB
          Jason Smith
        4. cors_test.html
          3 kB
          Jason Smith
        5. check_method_cors.patch
          1 kB
          Benoit Chesneau
        6. A_0004-Respond-to-CORS-preflight-checks-HTTP-OPTIONS.patch
          2 kB
          Jason Smith
        7. A_0003-Usably-correct-w3c-CORS-headers-for-valid-requests.patch
          6 kB
          Jason Smith
        8. A_0002-Send-server-headers-for-externals-responses.patch
          3 kB
          Jason Smith
        9. A_0001-Generalize-computing-the-appropriate-headers-for-any.patch
          2 kB
          Jason Smith
        10. 0001-cors-support.-should-fix-COUCHDB-431-2.patch
          21 kB
          Benoit Chesneau
        11. 0001-cors-support.-should-fix-COUCHDB-431.patch
          19 kB
          Benoit Chesneau
        12. 0001-cors-support.-should-fix-COUCHDB-431.patch
          19 kB
          Benoit Chesneau
        13. 0001-cors-support.-should-fix-COUCHDB-431.patch
          21 kB
          Benoit Chesneau
        14. 0001-cors-support.-should-fix-COUCHDB-431.patch
          24 kB
          Benoit Chesneau

          Issue Links

            Activity

              People

              • Assignee:
                benoitc Benoit Chesneau
                Reporter:
                jrburke James Burke
              • Votes:
                18 Vote for this issue
                Watchers:
                12 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: