etherpad-lite/doc
muxator a817acbbcc security: when served over https, set the "secure" flag for "express_sid" and "language" cookie
The mechanism used for determining if the application is being served over SSL
is wrapped by the "express-session" library for "express_sid", and manual for
the "language" cookie, but it's very similar in both cases.

The "secure" flag is set if one of these is true:

1. we are directly serving Etherpad over SSL using the native nodejs
   functionality, via the "ssl" options in settings.json

2. Etherpad is being served in plaintext by nodejs, but we are using a reverse
   proxy for terminating the SSL for us;
   In this case, the user has to be instructed to properly set trustProxy: true
   in settings.json, and the information wheter the application is over SSL or
   not will be extracted from the X-Forwarded-Proto HTTP header.

Please note that this will not be compatible with applications being served over
http and https at the same time.

The change on webaccess.js amends 009b61b338, which did not work when the SSL
termination was performed by a reverse proxy.

Reference for automatic "express_sid" configuration:
https://github.com/expressjs/session/blob/v1.17.0/README.md#cookiesecure

Closes #3561.
2019-12-07 04:36:01 +01:00
..
api formatting: bulk remove trailing whitespaces 2019-10-20 02:09:22 +02:00
assets Polish the styles of our docs a little 2014-03-27 18:08:55 +01:00
easysync easysync-full-description: regenerate the pdf document 2018-12-09 15:56:17 +01:00
database.md doc: passwordHash does not contain a bcrypted password, but a salted sha512 sum 2018-11-05 22:45:00 +01:00
docker.md security: when served over https, set the "secure" flag for "express_sid" and "language" cookie 2019-12-07 04:36:01 +01:00
documentation.md Typos and minor fixes in bin, doc, and root 2017-09-14 13:33:27 +02:00
index.md docker: incorporate the docker docs into the official documentation 2019-11-08 23:17:34 +01:00
localization.md Typos and minor fixes in bin, doc, and root 2017-09-14 13:33:27 +02:00
plugins.md formatting: bulk remove trailing whitespaces 2019-10-20 02:09:22 +02:00
skins.md release: prepare for 1.7.5 2019-01-26 00:16:03 +01:00
stats.md docs: direct link to measured.Collection from stats.md 2018-08-14 13:27:31 +02:00
template.html ‘Etherpad Lite’ -> ‘Etherpad’ 2013-09-29 13:57:37 +02:00