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

cors - aka Cross-Origin Resource Sharing support



    • New Feature
    • Status: Closed
    • Blocker
    • Resolution: Fixed
    • 0.9
    • 1.3
    • HTTP Interface
    • None
    • 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. 0001-cors-support.-should-fix-COUCHDB-431.patch
          24 kB
          Benoit Chesneau
        2. 0001-cors-support.-should-fix-COUCHDB-431.patch
          21 kB
          Benoit Chesneau
        3. 0001-cors-support.-should-fix-COUCHDB-431.patch
          19 kB
          Benoit Chesneau
        4. 0001-cors-support.-should-fix-COUCHDB-431.patch
          19 kB
          Benoit Chesneau
        5. 0001-cors-support.-should-fix-COUCHDB-431-2.patch
          21 kB
          Benoit Chesneau
        6. A_0001-Generalize-computing-the-appropriate-headers-for-any.patch
          2 kB
          Jason Smith
        7. A_0002-Send-server-headers-for-externals-responses.patch
          3 kB
          Jason Smith
        8. A_0003-Usably-correct-w3c-CORS-headers-for-valid-requests.patch
          6 kB
          Jason Smith
        9. A_0004-Respond-to-CORS-preflight-checks-HTTP-OPTIONS.patch
          2 kB
          Jason Smith
        10. check_method_cors.patch
          1 kB
          Benoit Chesneau
        11. cors_test.html
          3 kB
          Jason Smith
        12. cors.html
          2 kB
          Jason Smith
        13. test_cors2.tgz
          69 kB
          Benoit Chesneau
        14. test_cors2-1.tgz
          69 kB
          Benoit Chesneau

        Issue Links



              benoitc Benoit Chesneau
              jrburke James Burke
              18 Vote for this issue
              12 Start watching this issue