# Module `Cors`

Cross-Origin Resource Sharing

If you want to use this extension with Ocsigen Server's configuration file, have a look at the [manual page](./cors.md). If you are using Ocsigen Server as a library, use the interface described here. Each of these functions behaves exactly as its configuration file counterpart.

This module belongs to ocamlfind package `ocsigenserver.ext.cors`.

Example of use:

```ocaml
let _ =
   Ocsigen_server.start
     [ Ocsigen_server.host ~regexp:".*"
       [ Staticmod.run ~dir:"static" ()
       ; Eliom.App.run () 
       ; Cors.run
          ~max_age:86400
          ~credentials:true
          ~methods:[ `POST; `GET; `HEAD ]
          ~exposed_headers:[ "x-eliom-application"
                           ; "x-eliom-location"
                           ; "x-eliom-set-process-cookies"
                           ; "x-eliom-set-cookie-substitutes" ]
          () 
    ]]
```
```ocaml
val run : 
  ?credentials:bool ->
  ?max_age:int ->
  ?exposed_headers:string list ->
  ?methods:Cohttp.Code.meth list ->
  unit ->
  Ocsigen_server.instruction
```
`run` makes it possible to use this extension without configuration file.