diff options
author | Nick Thomas <nick@gitlab.com> | 2018-02-14 22:59:27 +0300 |
---|---|---|
committer | Nick Thomas <nick@gitlab.com> | 2018-02-15 15:25:47 +0300 |
commit | 0a9131f9971a655aecca2d5abd33bded5b4b2664 (patch) | |
tree | f4f84a112c79f80d6b4e9afc31d36f942aca6feb /doc/administration | |
parent | dd633bc1888453a07474d045eca91a9e66302ce0 (diff) |
Document publicsuffix.org and GitLab Pages
Diffstat (limited to 'doc/administration')
-rw-r--r-- | doc/administration/pages/index.md | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/administration/pages/index.md b/doc/administration/pages/index.md index 7d47aaac299..edb3e4c961e 100644 --- a/doc/administration/pages/index.md +++ b/doc/administration/pages/index.md @@ -61,6 +61,21 @@ Before proceeding with the Pages configuration, you will need to: NOTE: **Note:** If your GitLab instance and the Pages daemon are deployed in a private network or behind a firewall, your GitLab Pages websites will only be accessible to devices/users that have access to the private network. +### Add the domain to the Public Suffix List + +The [Public Suffix List](https://publicsuffix.org) is used by browsers to +decide how to treat subdomains. If your GitLab instance allows members of the +public to create GitLab Pages sites, it also allows those users to create +subdomains on the pages domain (`example.io`). Adding the domain to the Public +Suffix List prevents browsers from accepting +[supercookies](https://en.wikipedia.org/wiki/HTTP_cookie#Supercookie), +among other things. + +Follow [these instructions](https://publicsuffix.org/submit/) to submit your +GitLab Pages subdomain. For instance, if your domain is `example.io`, you should +request that `*.example.io` is added to the Public Suffix List. GitLab.com +added `*.gitlab.io` [in 2016](https://gitlab.com/gitlab-com/infrastructure/issues/230). + ### DNS configuration GitLab Pages expect to run on their own virtual host. In your DNS server/provider |