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

cors - aka Cross-Origin Resource Sharing support


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


      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:

      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):

      And information on Safari/Webkit (functionality in latest WebKit and Safari 4):

      IE 8 also uses the Access Control spec, but the requests have to go through their XDomainRequest object (XDR):

      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.


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

          Issue Links



              • Assignee:
                benoitc Benoit Chesneau
                jrburke James Burke


                • Created:

                  Issue deployment