mirror of
https://github.com/scratchfoundation/restify-cors-middleware.git
synced 2024-12-18 11:52:26 -05:00
54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
# restify-cors-middleware
|
|
|
|
> CORS middleware with full [W3C spec](www.w3.org/TR/cors) support.
|
|
|
|
[](https://npmjs.org/package/restify-cors-middleware)
|
|
[](https://github.com/TabDigital/restify-cors-middleware)
|
|
|
|
[](http://travis-ci.org/TabDigital/restify-cors-middleware)
|
|
[](https://david-dm.org/TabDigital/restify-cors-middleware)
|
|
[](https://david-dm.org/TabDigital/restify-cors-middleware)
|
|
[](https://david-dm.org/TabDigital/restify-cors-middleware)
|
|
[](https://snyk.io/package/npm/restify-cors-middleware)
|
|
|
|
[](https://github.com/feross/standard)
|
|
|
|
## Usage
|
|
|
|
```js
|
|
const corsMiddleware = require('restify-cors-middleware')
|
|
|
|
const cors = corsMiddleware({
|
|
preflightMaxAge: 5, //Optional
|
|
origins: ['http://api.myapp.com', 'http://web.myapp.com'],
|
|
allowHeaders: ['API-Token'],
|
|
exposeHeaders: ['API-Token-Expiry']
|
|
})
|
|
|
|
server.pre(cors.preflight)
|
|
server.use(cors.actual)
|
|
```
|
|
|
|
## Allowed origins
|
|
|
|
You can specify the full list of domains and subdomains allowed in your application:
|
|
|
|
```js
|
|
origins: [
|
|
'http://myapp.com',
|
|
'http://*.myapp.com'
|
|
]
|
|
```
|
|
|
|
For added security, this middleware sets `Access-Control-Allow-Origin` to the origin that matched, not the configured wildcard.
|
|
This means callers won't know about other domains that are supported.
|
|
|
|
Setting `origins: ['*']` is also valid, although it comes with obvious security implications. Note that it will still return a customised response (matching Origin), so any caching layer (reverse proxy or CDN) will grow in size accordingly.
|
|
|
|
## Troubleshooting
|
|
|
|
As per the spec, requests without an `Origin` will not receive any headers. Requests with a matching `Origin` will receive the appropriate response headers. Always be careful that any reverse proxies (e.g. Varnish) very their cache depending on the origin, so you don't serve CORS headers to the wrong request.
|
|
|
|
## Compliance to the spec
|
|
|
|
See [unit tests](https://github.com/TabDigital/restify-cors-middleware/tree/master/test) for examples of preflight and actual requests.
|