diff options
Diffstat (limited to 'doc/user/project')
| -rw-r--r-- | doc/user/project/pages/getting_started_part_three.md | 29 | ||||
| -rw-r--r-- | doc/user/project/pages/img/lets_encrypt.png | bin | 0 -> 35040 bytes | |||
| -rw-r--r-- | doc/user/project/pages/index.md | 1 | ||||
| -rw-r--r-- | doc/user/project/pages/lets_encrypt_for_gitlab_pages.md | 2 |
4 files changed, 30 insertions, 2 deletions
diff --git a/doc/user/project/pages/getting_started_part_three.md b/doc/user/project/pages/getting_started_part_three.md index bc9a11504cd..0cb86218783 100644 --- a/doc/user/project/pages/getting_started_part_three.md +++ b/doc/user/project/pages/getting_started_part_three.md @@ -244,11 +244,38 @@ with a certain security level. A static personal website will not require the same security level as an online banking web app, for instance. +### Using certificates provided by Let's Encrypt + +> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/28996) in GitLab 12.1. + There are some certificate authorities that offer free certificates, aiming to make the internet more secure to everyone. The most popular is [Let's Encrypt](https://letsencrypt.org/), which issues certificates trusted by most of browsers, it's open -source, and free to use. See our tutorial on [how to secure your GitLab Pages website with Let's Encrypt](lets_encrypt_for_gitlab_pages.md). +source, and free to use. + +#### Requirements + +Befor you can enable automatic provisioning of SSL certificate for you domain, we you should already have: + +- Created a [project](getting_started_part_two.md) in GitLab which + contains your website's source code. +- Acquired a domain (`example.com`) and added a [DNS entry](getting_started_part_three.md#dns-records) + pointing it to your Pages website. +- [Added your domain to your Pages project](getting_started_part_three.md#add-your-custom-domain-to-gitlab-pages-settings) + and verified your ownership. +- If you use **self-hosted** GitLab instance, you also need to ask you administrator to [enable integration with Let's Encrypt](../../../administration/pages/index.md#lets-encrypt-integration). + +If you've already done all that you can enable Let's Encrypt integration on domain settings page: + + + +Note that issuance of cerficate and updating pages configuration **can take up to an hour**. + +If you already have SSL certificate in domain settings it will continue to work until it will replaced +by Let's Encrypt's certificate. + +### Using certificates provided by CloudFlare Similarly popular are [certificates issued by CloudFlare](https://www.cloudflare.com/ssl/), which also offers a [free CDN service](https://blog.cloudflare.com/cloudflares-free-cdn-and-you/). diff --git a/doc/user/project/pages/img/lets_encrypt.png b/doc/user/project/pages/img/lets_encrypt.png Binary files differnew file mode 100644 index 00000000000..2e825e84d92 --- /dev/null +++ b/doc/user/project/pages/img/lets_encrypt.png diff --git a/doc/user/project/pages/index.md b/doc/user/project/pages/index.md index 64b1e259292..47eddde7e3f 100644 --- a/doc/user/project/pages/index.md +++ b/doc/user/project/pages/index.md @@ -144,7 +144,6 @@ To learn more about configuration options for GitLab Pages, read the following: |---+---| | [Custom domains and SSL/TLS Certificates](getting_started_part_three.md) | How to add custom domains and subdomains to your website, configure DNS records and SSL/TLS certificates. | | [CloudFlare certificates](https://about.gitlab.com/2017/02/07/setting-up-gitlab-pages-with-cloudflare-certificates/) | Secure your Pages site with CloudFlare certificates. | -| [Let's Encrypt certificates](lets_encrypt_for_gitlab_pages.md) | Secure your Pages site with Let's Encrypt certificates. | |---+---| | [Static vs dynamic websites](https://about.gitlab.com/2016/06/03/ssg-overview-gitlab-pages-part-1-dynamic-x-static/) | A conceptual overview on static versus dynamic sites. | | [Modern static site generators](https://about.gitlab.com/2016/06/10/ssg-overview-gitlab-pages-part-2/) | A conceptual overview on SSGs. | diff --git a/doc/user/project/pages/lets_encrypt_for_gitlab_pages.md b/doc/user/project/pages/lets_encrypt_for_gitlab_pages.md index 91a660c0f7a..a04f0c553a8 100644 --- a/doc/user/project/pages/lets_encrypt_for_gitlab_pages.md +++ b/doc/user/project/pages/lets_encrypt_for_gitlab_pages.md @@ -6,6 +6,8 @@ last_updated: 2019-06-04 # Let's Encrypt for GitLab Pages +**This tutorial is DEPRECATED** in favor of [seemless integration](using-certificates-provided-by-lets-encrypt). + If you have a GitLab Pages website served under your own domain, you might want to secure it with a SSL/TSL certificate. |
