[{"data":1,"prerenderedAt":2152},["ShallowReactive",2],{"/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt":3,"navigation-en-us":1400,"banner-en-us":1836,"footer-en-us":1844,"blog-post-authors-en-us-Guest author André Miranda":2091,"blog-related-posts-en-us-tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt":2107,"blog-share-wrapper-en-us":2132,"next-steps-en-us":2142},{"id":4,"title":5,"authors":6,"body":8,"category":1376,"date":1377,"description":1378,"extension":1379,"externalUrl":1380,"faq":1380,"featured":1381,"heroImage":1382,"hidePromo":1381,"meta":1383,"navigation":673,"path":1391,"seo":1392,"slug":1396,"stem":1397,"tags":1380,"template":1398,"updatedDate":1380,"__hash__":1399},"blogPosts/en-us/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt.md","Tutorial: Securing your GitLab Pages with TLS and Let's Encrypt",[7],"Guest author André Miranda",{"type":9,"value":10,"toc":1363},"minimark",[11,22,27,30,39,57,79,83,86,99,103,111,124,128,142,145,204,217,228,237,279,286,390,404,421,425,428,442,451,466,486,495,506,513,539,561,564,616,619,715,718,721,765,796,820,833,873,876,895,902,909,917,920,923,952,959,962,1025,1029,1036,1041,1048,1082,1085,1089,1092,1101,1153,1157,1164,1167,1170,1267,1270,1287,1291,1297,1300,1319,1339,1348,1356,1359],[12,13,14,15,21],"p",{},"In this post we will talk about HTTPS and how to add it to your GitLab Pages site\nwith ",[16,17,20],"a",{"href":18,"rel":19},"https://letsencrypt.org/",[],"Let's Encrypt",".",[23,24,26],"h2",{"id":25},"why-tlsssl","Why TLS/SSL?",[12,28,29],{},"When discussing HTTPS, it's common to hear people saying that a static\nwebsite doesn't need HTTPS, since it doesn't receive any POST requests, or isn't\nhandling credit card transactions or any other secure request.\nBut that's not the whole story.",[12,31,32,33,38],{},"TLS (",[16,34,37],{"href":35,"rel":36},"https://en.wikipedia.org/wiki/Transport_Layer_Security#TLS_1.0",[],"formerly SSL",") is a security protocol that can be added to HTTP\nto increase the security of your website by:",[40,41,42,51,54],"ol",{},[43,44,45,46,50],"li",{},"properly authenticating yourself: the client can trust that you are really\n",[47,48,49],"strong",{},"you",". The TLS handshake that is made at the beginning of the connection\nensures the client that no one is trying to impersonate you;",[43,52,53],{},"data integrity: this ensures that no one has tampered with the data in a\nrequest/response cycle;",[43,55,56],{},"encryption: this is the main selling point of TLS, but the\nother two are just as important. This protects the privacy of the communication\nbetween client and server.",[12,58,59,60,65,66,70,71,78],{},"The TLS layer can be added to other protocols too, such as FTP (making it\n",[16,61,64],{"href":62,"rel":63},"https://en.wikipedia.org/wiki/FTPS",[],"FTPS",") or WebSockets\n(making ",[67,68,69],"code",{},"ws://"," ",[16,72,75],{"href":73,"rel":74},"https://devcenter.heroku.com/articles/websocket-security#wss",[],[67,76,77],{},"wss://",").",[23,80,82],{"id":81},"https-everywhere","HTTPS Everywhere",[12,84,85],{},"Nowadays, there is a strong push for using TLS on every website.\nThe ultimate goal is to make the web safer, by adding those three components\ncited above to every website.",[12,87,88,89,93,94,21],{},"The first big player was the ",[16,90,82],{"href":91,"rel":92},"https://www.eff.org/https-everywhere",[],"\nbrowser extension. Google has also been using HTTPS compliance to better\nrank websites since ",[16,95,98],{"href":96,"rel":97},"https://webmasters.googleblog.com/2014/08/https-as-ranking-signal.html",[],"2014",[23,100,102],{"id":101},"how-to-get-tls-certificates","How to get TLS certificates",[12,104,105,106,21],{},"In order to add TLS to HTTP, one would need to get a certificate, and until 2015,\none would need to either pay for it or figure out how to do it with one of the\navailable ",[16,107,110],{"href":108,"rel":109},"https://en.wikipedia.org/wiki/Certificate_authority",[],"Certificate Authorities",[12,112,113,114,117,118,123],{},"Enter ",[16,115,20],{"href":18,"rel":116},[],", a free, automated, and open Certificate Authority.\nSince ",[16,119,122],{"href":120,"rel":121},"https://letsencrypt.org/2015/12/03/entering-public-beta.html",[],"December 2015"," anyone can get a free certificate from this\nnew Certificate Authority from the comfort of their terminal.",[23,125,127],{"id":126},"implementation","Implementation",[12,129,130,131,136,137,21],{},"So, let's suppose we're going to create a static blog with ",[16,132,135],{"href":133,"rel":134},"https://jekyllrb.com/",[],"Jekyll 3",".\nIf you are not creating a blog or are not using Jekyll just follow along, it\nshould be straightforward enough to translate the steps for different purposes.\nYou can also find many example projects using different static site generators\n(like Middleman or Hugo) in ",[16,138,141],{"href":139,"rel":140},"https://gitlab.com/groups/pages",[],"GitLab's example projects",[12,143,144],{},"A simple example blog can be created with:",[146,147,152],"pre",{"className":148,"code":149,"language":150,"meta":151,"style":151},"language-shell shiki shiki-themes github-light","$ jekyll new cool-blog\nNew jekyll site installed in ~/cool-blog.\n$ cd cool-blog/\n","shell","",[67,153,154,173,193],{"__ignoreMap":151},[155,156,159,163,167,170],"span",{"class":157,"line":158},"line",1,[155,160,162],{"class":161},"s7eDp","$",[155,164,166],{"class":165},"sYBdl"," jekyll",[155,168,169],{"class":165}," new",[155,171,172],{"class":165}," cool-blog\n",[155,174,176,179,181,184,187,190],{"class":157,"line":175},2,[155,177,178],{"class":161},"New",[155,180,166],{"class":165},[155,182,183],{"class":165}," site",[155,185,186],{"class":165}," installed",[155,188,189],{"class":165}," in",[155,191,192],{"class":165}," ~/cool-blog.\n",[155,194,196,198,201],{"class":157,"line":195},3,[155,197,162],{"class":161},[155,199,200],{"class":165}," cd",[155,202,203],{"class":165}," cool-blog/\n",[12,205,206,207,210,211,216],{},"Now you have to create a GitLab project. Here we are going to create a \"user\npage\", which means that it is a project created within a user account (not a\ngroup account), and that the name of the project looks like ",[67,208,209],{},"YOURUSERNAME.gitlab.io",".\nRefer to the ",[16,212,215],{"href":213,"rel":214},"https://docs.gitlab.com/pages/README/#getting-started-with-gitlab-pages",[],"\"Getting started\" section of the GitLab Pages manual","\nfor more information on that.",[12,218,219,220,223,224,227],{},"From now on, remember to replace ",[67,221,222],{},"YOURDOMAIN.org"," with your custom domain and\n",[67,225,226],{},"YOURUSERNAME"," with, well, your username. ;)",[12,229,230,233,234,236],{},[155,231,232],{},"Create a project"," named ",[67,235,209],{}," so that GitLab will\nidentify the project correctly. After that, upload your code to GitLab:",[146,238,240],{"className":148,"code":239,"language":150,"meta":151,"style":151},"$ git remote add origin git@gitlab.com:YOURUSERNAME/YOURUSERNAME.gitlab.io.git\n$ git push -u origin master\n",[67,241,242,261],{"__ignoreMap":151},[155,243,244,246,249,252,255,258],{"class":157,"line":158},[155,245,162],{"class":161},[155,247,248],{"class":165}," git",[155,250,251],{"class":165}," remote",[155,253,254],{"class":165}," add",[155,256,257],{"class":165}," origin",[155,259,260],{"class":165}," git@gitlab.com:YOURUSERNAME/YOURUSERNAME.gitlab.io.git\n",[155,262,263,265,267,270,274,276],{"class":157,"line":175},[155,264,162],{"class":161},[155,266,248],{"class":165},[155,268,269],{"class":165}," push",[155,271,273],{"class":272},"sYu0t"," -u",[155,275,257],{"class":165},[155,277,278],{"class":165}," master\n",[12,280,281,282,285],{},"OK, so far we have a project uploaded to GitLab, but we haven't configured GitLab Pages yet.\nTo configure it, just create a ",[67,283,284],{},".gitlab-ci.yml"," file in the root directory of your repository\nwith the following contents:",[146,287,291],{"className":288,"code":289,"language":290,"meta":151,"style":151},"language-yaml shiki shiki-themes github-light","pages:\n  stage: deploy\n  image: ruby:2.3\n  script:\n    - gem install jekyll\n    - jekyll build -d public/\n  artifacts:\n    paths:\n      - public\n  only:\n    - master\n\n","yaml",[67,292,293,303,314,324,332,341,349,357,365,374,382],{"__ignoreMap":151},[155,294,295,299],{"class":157,"line":158},[155,296,298],{"class":297},"shJU0","pages",[155,300,302],{"class":301},"sgsFI",":\n",[155,304,305,308,311],{"class":157,"line":175},[155,306,307],{"class":297},"  stage",[155,309,310],{"class":301},": ",[155,312,313],{"class":165},"deploy\n",[155,315,316,319,321],{"class":157,"line":195},[155,317,318],{"class":297},"  image",[155,320,310],{"class":301},[155,322,323],{"class":165},"ruby:2.3\n",[155,325,327,330],{"class":157,"line":326},4,[155,328,329],{"class":297},"  script",[155,331,302],{"class":301},[155,333,335,338],{"class":157,"line":334},5,[155,336,337],{"class":301},"    - ",[155,339,340],{"class":165},"gem install jekyll\n",[155,342,344,346],{"class":157,"line":343},6,[155,345,337],{"class":301},[155,347,348],{"class":165},"jekyll build -d public/\n",[155,350,352,355],{"class":157,"line":351},7,[155,353,354],{"class":297},"  artifacts",[155,356,302],{"class":301},[155,358,360,363],{"class":157,"line":359},8,[155,361,362],{"class":297},"    paths",[155,364,302],{"class":301},[155,366,368,371],{"class":157,"line":367},9,[155,369,370],{"class":301},"      - ",[155,372,373],{"class":165},"public\n",[155,375,377,380],{"class":157,"line":376},10,[155,378,379],{"class":297},"  only",[155,381,302],{"class":301},[155,383,385,387],{"class":157,"line":384},11,[155,386,337],{"class":301},[155,388,389],{"class":165},"master\n",[12,391,392,393,396,397,400,401,78],{},"This file instructs GitLab Runner to ",[67,394,395],{},"deploy"," by installing Jekyll and\nbuilding your website under the ",[67,398,399],{},"public/"," folder\n(",[67,402,403],{},"jekyll build -d public/",[12,405,406,407,410,411,414,415,420],{},"While you Wait for the build process to complete, you can track the progress in the\nBuilds page of your project. Once it starts, it probably won't take longer\nthan a few minutes. Once the build is finished, your website will be available at\n",[67,408,409],{},"https://YOURUSERNAME.gitlab.io",". Note that GitLab already provides TLS\ncertificates to all subdomains of ",[67,412,413],{},"gitlab.io"," (but it has some limitations, so\nplease ",[16,416,419],{"href":417,"rel":418},"https://docs.gitlab.com/pages/README/#limitations",[],"refer to the documentation for more","). So if you don't want to add a\ncustom domain, you're done.",[23,422,424],{"id":423},"how-to-configure-the-tls-certificate-of-your-custom-domain","How to configure the TLS certificate of your custom domain.",[12,426,427],{},"Once you buy a domain name and point that domain to your GitLab Pages website,\nyou need to configure 2 things:",[40,429,430,439],{},[43,431,432,433,438],{},"add the domain to GitLab Pages configuration (",[16,434,437],{"href":435,"rel":436},"https://docs.gitlab.com/pages/README/#add-a-custom-domain-to-your-pages-website",[],"see documentation",");",[43,440,441],{},"add your custom certificate to your website.",[12,443,444,445,448,449,21],{},"Once you add your domain, your website will be available under both\n",[67,446,447],{},"http://YOURDOMAIN.org"," and ",[67,450,409],{},[12,452,453,454,457,458,461,462],{},"But if you try to access your custom domain with ",[67,455,456],{},"HTTPS","\n(",[67,459,460],{},"https://YOURDOMAIN.org"," in this case), your browser will show that\nhorrible page, saying that things are going wrong and someone is trying to\nsteal your information. ",[463,464,465],"em",{},"Why is that?",[12,467,468,469,471,472,475,476,478,479,481,482,485],{},"Since GitLab offers TLS certificates to all ",[67,470,413],{}," pages\nand your custom domain is just a ",[67,473,474],{},"CNAME"," over that same domain, GitLab serves\nthe ",[67,477,413],{}," certificate, and your browser receives mixed messages: on one\nside, the browser is trying to access ",[67,480,222],{},", but on the other side\nit is getting a TLS certificate for ",[67,483,484],{},"*.gitlab.io",",\nsignaling that something is wrong.",[12,487,488,489,491,492,21],{},"In order to fix it, you need to obtain a certificate for ",[67,490,222],{}," and\nadd it to GitLab Pages. For that we are going to use\n",[16,493,20],{"href":18,"rel":494},[],[12,496,497,498,501,502,505],{},"Let's Encrypt is a new certificate authority that offers both ",[463,499,500],{},"free"," and\n",[463,503,504],{},"automated"," certificates. That's perfect for us: we don't have to pay for\nhaving HTTPS and you can do everything within the comfort of your terminal.",[12,507,508,509,512],{},"We begin with downloading the ",[67,510,511],{},"letsencrypt-auto"," utility.\nOpen a new terminal window and type:",[146,514,516],{"className":148,"code":515,"language":150,"meta":151,"style":151},"$ git clone https://github.com/letsencrypt/letsencrypt\n$ cd letsencrypt\n",[67,517,518,530],{"__ignoreMap":151},[155,519,520,522,524,527],{"class":157,"line":158},[155,521,162],{"class":161},[155,523,248],{"class":165},[155,525,526],{"class":165}," clone",[155,528,529],{"class":165}," https://github.com/letsencrypt/letsencrypt\n",[155,531,532,534,536],{"class":157,"line":175},[155,533,162],{"class":161},[155,535,200],{"class":165},[155,537,538],{"class":165}," letsencrypt\n",[12,540,541,543,544,547,548,551,552,554,555,560],{},[67,542,511],{}," offers a lot of functionality. For example, if you have\na web server running Apache, you could add ",[67,545,546],{},"letsencrypt-auto --apache"," inside your\nwebserver and have everything done for you. ",[67,549,550],{},"letsencrypt"," targets primarily Unix-like\nwebservers, so the ",[67,553,511],{}," tool won't work for Windows users. Check ",[16,556,559],{"href":557,"rel":558},"https://cultiv.nl/blog/lets-encrypt-on-windows/",[],"this\ntutorial"," to see how to get Let's Encrypt certificates while running\nWindows.",[12,562,563],{},"Since we are running on GitLab's servers instead, we have to do a bit of manual\nwork:",[146,565,567],{"className":148,"code":566,"language":150,"meta":151,"style":151},"$ ./letsencrypt-auto certonly -a manual -d YOURDOMAIN.org\n#\n# If you want to support another domain, www.YOURDOMAIN.org, for example, you\n# can add it to the domain list after -d like:\n# ./letsencrypt-auto certonly -a manual -d YOURDOMAIN.org www.YOURDOMAIN.org\n#\n",[67,568,569,591,597,602,607,612],{"__ignoreMap":151},[155,570,571,573,576,579,582,585,588],{"class":157,"line":158},[155,572,162],{"class":161},[155,574,575],{"class":165}," ./letsencrypt-auto",[155,577,578],{"class":165}," certonly",[155,580,581],{"class":272}," -a",[155,583,584],{"class":165}," manual",[155,586,587],{"class":272}," -d",[155,589,590],{"class":165}," YOURDOMAIN.org\n",[155,592,593],{"class":157,"line":175},[155,594,596],{"class":595},"sAwPA","#\n",[155,598,599],{"class":157,"line":195},[155,600,601],{"class":595},"# If you want to support another domain, www.YOURDOMAIN.org, for example, you\n",[155,603,604],{"class":157,"line":326},[155,605,606],{"class":595},"# can add it to the domain list after -d like:\n",[155,608,609],{"class":157,"line":334},[155,610,611],{"class":595},"# ./letsencrypt-auto certonly -a manual -d YOURDOMAIN.org www.YOURDOMAIN.org\n",[155,613,614],{"class":157,"line":343},[155,615,596],{"class":595},[12,617,618],{},"After you accept that your IP will be publicly logged, a message like the\nfollowing will appear:",[146,620,622],{"className":148,"code":621,"language":150,"meta":151,"style":151},"Make sure your web server displays the following content at\nhttp://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\nbefore continuing:\n\n5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n\n#\n# output omitted\n#\n\nPress ENTER to continue\n",[67,623,624,656,661,669,675,680,684,688,693,697,701],{"__ignoreMap":151},[155,625,626,629,632,635,638,641,644,647,650,653],{"class":157,"line":158},[155,627,628],{"class":161},"Make",[155,630,631],{"class":165}," sure",[155,633,634],{"class":165}," your",[155,636,637],{"class":165}," web",[155,639,640],{"class":165}," server",[155,642,643],{"class":165}," displays",[155,645,646],{"class":165}," the",[155,648,649],{"class":165}," following",[155,651,652],{"class":165}," content",[155,654,655],{"class":165}," at\n",[155,657,658],{"class":157,"line":175},[155,659,660],{"class":161},"http://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[155,662,663,666],{"class":157,"line":195},[155,664,665],{"class":161},"before",[155,667,668],{"class":165}," continuing:\n",[155,670,671],{"class":157,"line":326},[155,672,674],{"emptyLinePlaceholder":673},true,"\n",[155,676,677],{"class":157,"line":334},[155,678,679],{"class":161},"5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n",[155,681,682],{"class":157,"line":343},[155,683,674],{"emptyLinePlaceholder":673},[155,685,686],{"class":157,"line":351},[155,687,596],{"class":595},[155,689,690],{"class":157,"line":359},[155,691,692],{"class":595},"# output omitted\n",[155,694,695],{"class":157,"line":367},[155,696,596],{"class":595},[155,698,699],{"class":157,"line":376},[155,700,674],{"emptyLinePlaceholder":673},[155,702,703,706,709,712],{"class":157,"line":384},[155,704,705],{"class":161},"Press",[155,707,708],{"class":165}," ENTER",[155,710,711],{"class":165}," to",[155,713,714],{"class":165}," continue\n",[12,716,717],{},"Now it is waiting for the server to be correctly configured so it can go on.\nLeave this terminal window open for now.",[12,719,720],{},"So, the goal is to the make our already-published static website return\nsaid token when said URL is requested. That's easy: create a custom\npage! Just create a file in your blog folder that looks like this:",[146,722,726],{"className":723,"code":724,"language":725,"meta":151,"style":151},"language-markdown shiki shiki-themes github-light","---\nlayout: null\npermalink: /.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html\n---\n\n5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n","markdown",[67,727,728,733,743,753,757,761],{"__ignoreMap":151},[155,729,730],{"class":157,"line":158},[155,731,732],{"class":301},"---\n",[155,734,735,738,740],{"class":157,"line":175},[155,736,737],{"class":297},"layout",[155,739,310],{"class":301},[155,741,742],{"class":272},"null\n",[155,744,745,748,750],{"class":157,"line":195},[155,746,747],{"class":297},"permalink",[155,749,310],{"class":301},[155,751,752],{"class":165},"/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html\n",[155,754,755],{"class":157,"line":326},[155,756,732],{"class":301},[155,758,759],{"class":157,"line":334},[155,760,674],{"emptyLinePlaceholder":673},[155,762,763],{"class":157,"line":343},[155,764,679],{"class":301},[12,766,767,768,771,772,774,775,777,778,783,784,787,788,791,792,795],{},"This tells Jekyll to create a static page, which you can see at\n",[67,769,770],{},"cool-blog/_site/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html",",\nwith no extra HTML, just the token in plain text. As we are using the ",[67,773,747],{}," attribute in the\nfront matter, you can name this file anyway you want and put it anywhere, too.\nNote that the behaviour of the ",[67,776,747],{}," attribute has\n",[16,779,782],{"href":780,"rel":781},"https://jekyllrb.com/docs/upgrading/2-to-3/#permalinks-no-longer-automatically-add-a-trailing-slash",[],"changed"," from Jekyll 2 to Jekyll 3, so make sure you have Jekyll 3.x installed.\nIf you're not using version 3 of Jekyll or if you're using a different tool,\njust create the same file in the exact path, like\n",[67,785,786],{},"cool-blog/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html","\nor an equivalent path in your static site generator of choice.\nHere we'll call it ",[67,789,790],{},"letsencrypt-setup.html"," and place it in the root folder\nof the blog. In order to check that everything is working as expected, start a local server with ",[67,793,794],{},"jekyll serve"," in a separate terminal window and try to access the URL:",[146,797,799],{"className":148,"code":798,"language":150,"meta":151,"style":151},"$ curl http://localhost:4000/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n# response:\n5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n",[67,800,801,811,816],{"__ignoreMap":151},[155,802,803,805,808],{"class":157,"line":158},[155,804,162],{"class":161},[155,806,807],{"class":165}," curl",[155,809,810],{"class":165}," http://localhost:4000/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[155,812,813],{"class":157,"line":175},[155,814,815],{"class":595},"# response:\n",[155,817,818],{"class":157,"line":195},[155,819,679],{"class":161},[12,821,822,823,825,826,828,829,832],{},"Note that I just replaced the ",[67,824,447],{}," (from the\n",[67,827,511],{}," instructions) with ",[67,830,831],{},"http://localhost:4000",".\nEverything is working fine, so we just need to upload the new file to GitLab:",[146,834,836],{"className":148,"code":835,"language":150,"meta":151,"style":151},"$ git add letsencrypt-setup.html\n$ git commit -m \"add letsencypt-setup.html file\"\n$ git push\n",[67,837,838,849,864],{"__ignoreMap":151},[155,839,840,842,844,846],{"class":157,"line":158},[155,841,162],{"class":161},[155,843,248],{"class":165},[155,845,254],{"class":165},[155,847,848],{"class":165}," letsencrypt-setup.html\n",[155,850,851,853,855,858,861],{"class":157,"line":175},[155,852,162],{"class":161},[155,854,248],{"class":165},[155,856,857],{"class":165}," commit",[155,859,860],{"class":272}," -m",[155,862,863],{"class":165}," \"add letsencypt-setup.html file\"\n",[155,865,866,868,870],{"class":157,"line":195},[155,867,162],{"class":161},[155,869,248],{"class":165},[155,871,872],{"class":165}," push\n",[12,874,875],{},"Once the build finishes, test again if everything is working well:",[146,877,879],{"className":148,"code":878,"language":150,"meta":151,"style":151},"# Note that we're using the actual domain, not localhost anymore\n$ curl http://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[67,880,881,886],{"__ignoreMap":151},[155,882,883],{"class":157,"line":158},[155,884,885],{"class":595},"# Note that we're using the actual domain, not localhost anymore\n",[155,887,888,890,892],{"class":157,"line":175},[155,889,162],{"class":161},[155,891,807],{"class":165},[155,893,894],{"class":165}," http://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[12,896,897,898,901],{},"If you get a ",[67,899,900],{},"404 page not found",", check if you missed any step, or get in touch\nin the comments below.",[12,903,904,905,908],{},"Now that everything is working as expected, go back to the terminal window\nthat's waiting for you and hit ",[67,906,907],{},"ENTER",". This instructs the Let's Encrypt's\nservers to go to the URL we just created. If they get the response they were waiting for,\nwe've proven that we actually own the domain and now they'll send you the\nTLS certificates. After a while it responds:",[146,910,915],{"className":911,"code":913,"language":914,"meta":151},[912],"language-text","IMPORTANT NOTES:\n - Congratulations! Your certificate and chain have been saved at\n   /etc/letsencrypt/live/YOURDOMAIN.org/fullchain.pem. Your cert will\n   expire on 2016-07-04. To obtain a new version of the certificate in\n   the future, simply run Let's Encrypt again.\n - If you like Let's Encrypt, please consider supporting our work by:\n\n   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate\n   Donating to EFF:                    https://eff.org/donate-le\n\n","text",[67,916,913],{"__ignoreMap":151},[12,918,919],{},"Success! We have correctly acquired a free TLS certificate for our domain!",[12,921,922],{},"Note, however, that like any other TLS certificate, it has an expiration date,\nand in the case of certificates issued by Let's Encrypt, the certificate will\nremain valid for 90 days. When you finish setting up, just put in your calendar to\nremember to renew the certificate in time, otherwise it will become invalid,\nand the browser will reject it.",[12,924,925,926,929,930,933,934,936,937,940,941,944,945,948,949,951],{},"Now we just need to upload the certificate and the key to GitLab.\nGo to ",[47,927,928],{},"Settings"," -> ",[47,931,932],{},"Pages"," inside your project, remove the old ",[67,935,474],{}," and\nadd a new one with the same domain, but now you'll also upload the TLS\ncertificate. Paste the contents of ",[67,938,939],{},"/etc/letsencrypt/live/YOURDOMAIN.org/fullchain.pem","\n(you'll need ",[67,942,943],{},"sudo"," to read the file) to the \"Certificate (PEM)\"\nfield and ",[67,946,947],{},"/etc/letsencrypt/live/YOURDOMAIN.org/privkey.pem"," (also needs ",[67,950,943],{},") to the\n\"Key (PEM)\" field.",[12,953,954],{},[955,956],"img",{"alt":957,"src":958},"Uploading the certificate to GitLab Pages","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782398420/blog/Content%20Images/gitlab-pages-cert-upload-screenshot.png",[12,960,961],{},"And you're done! You now have a fully working HTTPS website:",[146,963,965],{"className":148,"code":964,"language":150,"meta":151,"style":151},"$ curl -vX HEAD https://YOURDOMAIN.org/\n#\n# starting connection\n#\n* TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA\n* Server certificate: YOURDOMAIN.org\n* Server certificate: Lets Encrypt Authority X3\n* Server certificate: DST Root CA X3\n",[67,966,967,982,986,991,995,1004,1011,1018],{"__ignoreMap":151},[155,968,969,971,973,976,979],{"class":157,"line":158},[155,970,162],{"class":161},[155,972,807],{"class":165},[155,974,975],{"class":272}," -vX",[155,977,978],{"class":165}," HEAD",[155,980,981],{"class":165}," https://YOURDOMAIN.org/\n",[155,983,984],{"class":157,"line":175},[155,985,596],{"class":595},[155,987,988],{"class":157,"line":195},[155,989,990],{"class":595},"# starting connection\n",[155,992,993],{"class":157,"line":326},[155,994,596],{"class":595},[155,996,997,1001],{"class":157,"line":334},[155,998,1000],{"class":999},"sD7c4","*",[155,1002,1003],{"class":301}," TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA\n",[155,1005,1006,1008],{"class":157,"line":343},[155,1007,1000],{"class":999},[155,1009,1010],{"class":301}," Server certificate: YOURDOMAIN.org\n",[155,1012,1013,1015],{"class":157,"line":351},[155,1014,1000],{"class":999},[155,1016,1017],{"class":301}," Server certificate: Lets Encrypt Authority X3\n",[155,1019,1020,1022],{"class":157,"line":359},[155,1021,1000],{"class":999},[155,1023,1024],{"class":301}," Server certificate: DST Root CA X3\n",[23,1026,1028],{"id":1027},"how-to-redirect-all-traffic-to-the-https-version","How to redirect all traffic to the HTTPS version",[12,1030,1031,1032,1035],{},"Everything is working fine, but now we have an extra concern: we have two\nworking versions of our website, both HTTP ",[47,1033,1034],{},"and"," HTTPS. We need a way to\nredirect all of our traffic to the HTTPS version, and tell search engines to\ndo the same.",[1037,1038,1040],"h3",{"id":1039},"how-to-tell-search-engines-which-is-the-correct-version","How to tell search engines which is the correct version",[12,1042,1043,1044,1047],{},"Instructing the search engines is really easy: just tell them that the HTTPS\nversion is the \"canonical\" version, and they send all the users to it.\nAnd how do you do that? By adding a ",[67,1045,1046],{},"link"," tag to the header of the HTML:",[146,1049,1053],{"className":1050,"code":1051,"language":1052,"meta":151,"style":151},"language-html shiki shiki-themes github-light","\u003Clink rel=\"canonical\" href=\"https://YOURDOMAIN.org/specific/page\" />\n","html",[67,1054,1055],{"__ignoreMap":151},[155,1056,1057,1060,1062,1065,1068,1071,1074,1076,1079],{"class":157,"line":158},[155,1058,1059],{"class":301},"\u003C",[155,1061,1046],{"class":297},[155,1063,1064],{"class":161}," rel",[155,1066,1067],{"class":301},"=",[155,1069,1070],{"class":165},"\"canonical\"",[155,1072,1073],{"class":161}," href",[155,1075,1067],{"class":301},[155,1077,1078],{"class":165},"\"https://YOURDOMAIN.org/specific/page\"",[155,1080,1081],{"class":301}," />\n",[12,1083,1084],{},"Adding this to every header on a blog tells the search engine that the correct\nversion is the HTTPS one, and they'll comply.",[1037,1086,1088],{"id":1087},"internal-links","Internal links",[12,1090,1091],{},"Remember to use HTTPS for your CSS or JavaScript file URLs, because when the\nbrowser accesses a secure website that relies on an insecure resource, it may\nblock that resource.",[12,1093,1094,1095,1100],{},"It is ",[16,1096,1099],{"href":1097,"rel":1098},"http://www.paulirish.com/2010/the-protocol-relative-url/",[],"considered a good practice"," to use the protocol-agnostic path:",[146,1102,1106],{"className":1103,"code":1104,"language":1105,"meta":151,"style":151},"language-xml shiki shiki-themes github-light","\u003Clink rel=\"stylesheet\" href=\"//YOURDOMAIN.org/styles.css\" />\n\u003Cscript src=\"//YOURDOMAIN.org/script.js\">\u003C/script>\n","xml",[67,1107,1108,1130],{"__ignoreMap":151},[155,1109,1110,1112,1114,1116,1118,1121,1123,1125,1128],{"class":157,"line":158},[155,1111,1059],{"class":301},[155,1113,1046],{"class":297},[155,1115,1064],{"class":161},[155,1117,1067],{"class":301},[155,1119,1120],{"class":165},"\"stylesheet\"",[155,1122,1073],{"class":161},[155,1124,1067],{"class":301},[155,1126,1127],{"class":165},"\"//YOURDOMAIN.org/styles.css\"",[155,1129,1081],{"class":301},[155,1131,1132,1134,1137,1140,1142,1145,1148,1150],{"class":157,"line":175},[155,1133,1059],{"class":301},[155,1135,1136],{"class":297},"script",[155,1138,1139],{"class":161}," src",[155,1141,1067],{"class":301},[155,1143,1144],{"class":165},"\"//YOURDOMAIN.org/script.js\"",[155,1146,1147],{"class":301},">\u003C/",[155,1149,1136],{"class":297},[155,1151,1152],{"class":301},">\n",[1037,1154,1156],{"id":1155},"when-to-use-javascript-based-redirect","When to use JavaScript-based redirect",[12,1158,1159,1160,1163],{},"There is, however, a case where the user specifically types in the URL\n",[47,1161,1162],{},"without"," using HTTPS, and they'll access the HTTP version of your website.",[12,1165,1166],{},"The correct way of handling that would be to respond with a 301 \"Moved\npermanently\" HTTP code, and the browser would remember it for the next request.\nHowever, that's not a possibility we have here, since we're running on GitLab's servers.",[12,1168,1169],{},"A small hack you can do is to redirect your users with a bit of JavaScript code:",[146,1171,1175],{"className":1172,"code":1173,"language":1174,"meta":151,"style":151},"language-javascript shiki shiki-themes github-light","var host = \"YOURDOMAIN.org\";\nif ((host == window.location.host) && (window.location.protocol != 'https:')) {\n  window.location = window.location.toString().replace(/^http:/, \"https:\");\n}\n","javascript",[67,1176,1177,1193,1222,1262],{"__ignoreMap":151},[155,1178,1179,1182,1185,1187,1190],{"class":157,"line":158},[155,1180,1181],{"class":999},"var",[155,1183,1184],{"class":301}," host ",[155,1186,1067],{"class":999},[155,1188,1189],{"class":165}," \"YOURDOMAIN.org\"",[155,1191,1192],{"class":301},";\n",[155,1194,1195,1198,1201,1204,1207,1210,1213,1216,1219],{"class":157,"line":175},[155,1196,1197],{"class":999},"if",[155,1199,1200],{"class":301}," ((host ",[155,1202,1203],{"class":999},"==",[155,1205,1206],{"class":301}," window.location.host) ",[155,1208,1209],{"class":999},"&&",[155,1211,1212],{"class":301}," (window.location.protocol ",[155,1214,1215],{"class":999},"!=",[155,1217,1218],{"class":165}," 'https:'",[155,1220,1221],{"class":301},")) {\n",[155,1223,1224,1227,1229,1232,1235,1238,1241,1244,1247,1250,1253,1256,1259],{"class":157,"line":195},[155,1225,1226],{"class":301},"  window.location ",[155,1228,1067],{"class":999},[155,1230,1231],{"class":301}," window.location.",[155,1233,1234],{"class":161},"toString",[155,1236,1237],{"class":301},"().",[155,1239,1240],{"class":161},"replace",[155,1242,1243],{"class":301},"(",[155,1245,1246],{"class":165},"/",[155,1248,1249],{"class":999},"^",[155,1251,1252],{"class":165},"http:/",[155,1254,1255],{"class":301},", ",[155,1257,1258],{"class":165},"\"https:\"",[155,1260,1261],{"class":301},");\n",[155,1263,1264],{"class":157,"line":326},[155,1265,1266],{"class":301},"}\n",[12,1268,1269],{},"This redirects the user to the HTTPS version, but there are a few problems with it:",[40,1271,1272,1275,1284],{},[43,1273,1274],{},"a user could have JavaScript disabled, and would not be affected by that;",[43,1276,1277,1278,1283],{},"an attacker could simply remove that code and behave as a ",[16,1279,1282],{"href":1280,"rel":1281},"https://en.wikipedia.org/wiki/Man-in-the-middle_attack",[],"Man in the Middle",";",[43,1285,1286],{},"the browser won't remember the redirect instruction, so every time the user types\nthat same URL, the website will have to redirect him/her again.",[23,1288,1290],{"id":1289},"wrap-up","Wrap up",[12,1292,1293],{},[955,1294],{"alt":1295,"src":1296},"a working certificate screenshot","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782399335/blog/Content%20Images/working-certificate-screenshot.png",[12,1298,1299],{},"That's how easy it is to have a free HTTPS-enabled website.\nWith these tools, I see no reason not to do it.",[12,1301,1302,1303,1255,1308,501,1313,1318],{},"If you want to improve GitLab's support for Let's Encrypt, you can\ndiscuss and contribute in issues ",[16,1304,1307],{"href":1305,"rel":1306},"https://gitlab.com/gitlab-org/gitlab-ee/issues/474",[],"#474",[16,1309,1312],{"href":1310,"rel":1311},"https://gitlab.com/gitlab-org/gitlab-ee/issues/467",[],"#467",[16,1314,1317],{"href":1315,"rel":1316},"https://gitlab.com/gitlab-org/gitlab-ee/issues/472",[],"#472"," from GitLab EE. They are open to merge requests!",[12,1320,1321,1322,1327,1328,501,1333,1338],{},"There's an ",[16,1323,1326],{"href":1324,"rel":1325},"https://www.youtube.com/watch?v=cBhZ6S0PFCY",[],"excellent talk"," by ",[16,1329,1332],{"href":1330,"rel":1331},"https://twitter.com/pierrefar",[],"Pierre Far",[16,1334,1337],{"href":1335,"rel":1336},"https://twitter.com/igrigorik",[],"Ilya Grigorik"," on HTTPS where you can learn more\nabout it.",[12,1340,1341,1342,1347],{},"If you want to check the status of your HTTPS enabled website,\n",[16,1343,1346],{"href":1344,"rel":1345},"https://www.ssllabs.com/ssltest/",[],"SSL Labs offers a free online service"," that\n\"performs a deep analysis of the configuration of any SSL web server on the\npublic Internet\".",[12,1349,1350,1351,21],{},"This article is based on ",[16,1352,1355],{"href":1353,"rel":1354},"https://www.paulwakeford.info/2015/11/24/letsencrypt/",[],"Paul Wakeford's post",[12,1357,1358],{},"I hope it helps you :)",[1360,1361,1362],"style",{},"html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .shJU0, html code.shiki .shJU0{--shiki-default:#22863A}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}html pre.shiki code .sD7c4, html code.shiki .sD7c4{--shiki-default:#D73A49}",{"title":151,"searchDepth":175,"depth":175,"links":1364},[1365,1366,1367,1368,1369,1370,1375],{"id":25,"depth":175,"text":26},{"id":81,"depth":175,"text":82},{"id":101,"depth":175,"text":102},{"id":126,"depth":175,"text":127},{"id":423,"depth":175,"text":424},{"id":1027,"depth":175,"text":1028,"children":1371},[1372,1373,1374],{"id":1039,"depth":195,"text":1040},{"id":1087,"depth":195,"text":1088},{"id":1155,"depth":195,"text":1156},{"id":1289,"depth":175,"text":1290},"engineering","2016-04-11","In this post we will talk about HTTPS and how to add it to your GitLab Pages site with Let's Encrypt","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749672214/Blog/Hero%20Images/altssh.jpg",{"excerpt":1384},{"type":9,"value":1385},[1386],[12,1387,14,1388,21],{},[16,1389,20],{"href":18,"rel":1390},[],"/en-us/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt",{"title":5,"description":1378,"ogTitle":5,"ogDescription":1378,"noIndex":1381,"ogImage":1382,"ogUrl":1393,"ogSiteName":1394,"ogType":1395,"canonicalUrls":1393},"https://about.gitlab.com/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt","https://about.gitlab.com","article","tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt","en-us/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt","BlogPost","QN737G6Mzd5Fllutx_PnjMfY0BvmaO3Pckyh-fZTIK8",{"logo":1401,"freeTrial":1405,"sales":1410,"login":1415,"items":1420,"search":1755,"minimal":1787,"duo":1806,"switchNav":1815,"pricingDeployment":1826},{"config":1402},{"href":1246,"dataGaName":1403,"dataGaLocation":1404},"gitlab logo","header",{"text":1406,"config":1407},"Get free trial",{"href":1408,"dataGaName":1409,"dataGaLocation":1404},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":1411,"config":1412},"Request a demo",{"href":1413,"dataGaName":1414,"dataGaLocation":1404},"/request-a-demo/","sales",{"text":1416,"config":1417},"Sign in",{"href":1418,"dataGaName":1419,"dataGaLocation":1404},"https://gitlab.com/users/sign_in/","sign in",[1421,1507,1595,1600,1680,1733],{"text":1422,"left":673,"config":1423,"menu":1425},"Platform",{"dataNavLevelOne":1424},"platform",{"type":1426,"link":1427,"columns":1431,"feature":1496},"lists",{"text":1428,"config":1429},"Explore the Platform",{"href":1430,"dataGaName":1424,"dataGaLocation":1404},"/platform/",[1432,1455,1478],{"title":1433,"items":1434},"DevOps",[1435,1440,1445,1450],{"text":1436,"config":1437},"CI/CD",{"href":1438,"dataGaLocation":1404,"dataGaName":1439},"/solutions/continuous-integration/","ci/cd",{"text":1441,"config":1442},"Source Code Management",{"href":1443,"dataGaLocation":1404,"dataGaName":1444},"/solutions/source-code-management/","source code management",{"text":1446,"config":1447},"Agile Delivery",{"href":1448,"dataGaLocation":1404,"dataGaName":1449},"/solutions/agile-delivery/","agile delivery",{"text":1451,"config":1452},"Artifact Management",{"href":1453,"dataGaLocation":1404,"dataGaName":1454},"/artifact-central/","artifact management",{"title":1456,"items":1457},"Security & Governance",[1458,1463,1468,1473],{"text":1459,"config":1460},"Application Security Testing",{"href":1461,"dataGaLocation":1404,"dataGaName":1462},"/solutions/application-security-testing/","application security testing",{"text":1464,"config":1465},"Governance & Compliance",{"href":1466,"dataGaLocation":1404,"dataGaName":1467},"/solutions/software-compliance/","governance and compliance",{"text":1469,"config":1470},"Secrets Management",{"href":1471,"dataGaLocation":1404,"dataGaName":1472},"/gitlab-secrets-manager/","secrets management",{"text":1474,"config":1475},"Supply Chain Security",{"href":1476,"dataGaLocation":1404,"dataGaName":1477},"/solutions/supply-chain/","supply chain security",{"title":1479,"items":1480},"Agentic AI & Context",[1481,1486,1491],{"text":1482,"config":1483},"Duo Agent Platform",{"href":1484,"dataGaLocation":1404,"dataGaName":1485},"/gitlab-duo-agent-platform/","duo agent platform",{"text":1487,"config":1488},"Orbit Context Graph",{"href":1489,"dataGaLocation":1404,"dataGaName":1490},"/gitlab-orbit/","orbit",{"text":1492,"config":1493},"Visibility & Measurement",{"href":1494,"dataGaLocation":1404,"dataGaName":1495},"/solutions/visibility-measurement/","visibility and measurement",{"config":1497,"title":1500,"text":1501,"link":1502},{"background":1498,"textColor":1499},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1790185102/o7dn32anqcb6z8dgd3as.jpg')","#000","GitLab Orbit is generally available","Higher agent accuracy, lower token cost",{"text":1503,"config":1504},"Read the announcement",{"href":1505,"dataGaName":1506,"dataGaLocation":1404},"/blog/gitlab-orbit-ga/","orbit ga announcement",{"text":1508,"left":673,"config":1509,"menu":1511},"Solutions",{"dataNavLevelOne":1510},"solutions",{"type":1426,"link":1512,"columns":1516,"feature":1586},{"text":1513,"config":1514},"View all Solutions",{"href":1515,"dataGaName":1510,"dataGaLocation":1404},"/solutions/",[1517,1535,1553],{"title":1518,"items":1519},"Outcomes",[1520,1525,1530],{"text":1521,"config":1522},"DevOps Modernization",{"href":1523,"dataGaLocation":1404,"dataGaName":1524},"/assessments/devops-modernization-assessment/","devops modernization",{"text":1526,"config":1527},"Security Modernization",{"href":1528,"dataGaLocation":1404,"dataGaName":1529},"/assessments/security-modernization-assessment/","security modernization",{"text":1531,"config":1532},"AI Modernization",{"href":1533,"dataGaLocation":1404,"dataGaName":1534},"/assessments/ai-modernization-assessment/","ai modernization",{"title":1536,"items":1537},"By size",[1538,1543,1548],{"text":1539,"config":1540},"Enterprise",{"href":1541,"dataGaLocation":1404,"dataGaName":1542},"/enterprise/","enterprise",{"text":1544,"config":1545},"Small Business",{"href":1546,"dataGaLocation":1404,"dataGaName":1547},"/small-business/","small business",{"text":1549,"config":1550},"Startups",{"href":1551,"dataGaLocation":1404,"dataGaName":1552},"/solutions/startups/","startups",{"title":1554,"items":1555},"Industries",[1556,1561,1566,1571,1576,1581],{"text":1557,"config":1558},"Financial Services",{"href":1559,"dataGaLocation":1404,"dataGaName":1560},"/solutions/finance/","financial services",{"text":1562,"config":1563},"Public Sector",{"href":1564,"dataGaLocation":1404,"dataGaName":1565},"/solutions/public-sector/","public sector",{"text":1567,"config":1568},"Telecommunications",{"href":1569,"dataGaLocation":1404,"dataGaName":1570},"/solutions/telecommunications/","telecommunications",{"text":1572,"config":1573},"Automotive",{"href":1574,"dataGaLocation":1404,"dataGaName":1575},"/solutions/automotive/","automotive",{"text":1577,"config":1578},"Education",{"href":1579,"dataGaLocation":1404,"dataGaName":1580},"/solutions/education/","education",{"text":1582,"config":1583},"Aerospace",{"href":1584,"dataGaLocation":1404,"dataGaName":1585},"/solutions/aerospace/","aerospace",{"config":1587,"title":1588,"text":1589,"link":1590},{"background":1498,"textColor":1499},"GitLab Security Standard","Learn how to harden your software factory and let AI agents earn autonomy, without trading away security.",{"text":1591,"config":1592},"Explore the standard",{"href":1593,"dataGaName":1594,"dataGaLocation":1404},"/gitlab-security-standard/","gitlab security standard",{"text":1596,"config":1597},"Pricing",{"href":1598,"dataGaName":1599,"dataGaLocation":1404,"dataNavLevelOne":1599},"/pricing/","pricing",{"text":1601,"config":1602,"menu":1604},"Resources",{"dataNavLevelOne":1603},"resources",{"type":1426,"link":1605,"columns":1609,"feature":1671},{"text":1606,"config":1607},"View all resources",{"href":1608,"dataGaName":1603,"dataGaLocation":1404},"/resources/",[1610,1643],{"title":1611,"items":1612},"Discover",[1613,1618,1623,1628,1633,1638],{"text":1614,"config":1615},"Docs",{"href":1616,"dataGaName":1617,"dataGaLocation":1404},"https://docs.gitlab.com/","docs",{"text":1619,"config":1620},"University",{"href":1621,"dataGaName":1622,"dataGaLocation":1404},"https://university.gitlab.com/","university",{"text":1624,"config":1625},"Demo Series",{"href":1626,"dataGaName":1627,"dataGaLocation":1404},"/gitlab-technical-demo-series/","demo series",{"text":1629,"config":1630},"Demo Hub",{"href":1631,"dataGaName":1632,"dataGaLocation":1404},"/demo-hub/","demo hub",{"text":1634,"config":1635},"Services",{"href":1636,"dataGaName":1637,"dataGaLocation":1404},"/services/","services",{"text":1639,"config":1640},"Well Architected",{"href":1641,"dataGaName":1642,"dataGaLocation":1404},"/resources/well-architected/","well architected",{"title":1644,"items":1645},"Connect",[1646,1651,1656,1661,1666],{"text":1647,"config":1648},"Blog",{"href":1649,"dataGaName":1650,"dataGaLocation":1404},"/blog/","blog",{"text":1652,"config":1653},"Community",{"href":1654,"dataGaName":1655,"dataGaLocation":1404},"/community/","community",{"text":1657,"config":1658},"Customers",{"href":1659,"dataGaName":1660,"dataGaLocation":1404},"/customers/","customers",{"text":1662,"config":1663},"Partners",{"href":1664,"dataGaName":1665,"dataGaLocation":1404},"/partners/","partners",{"text":1667,"config":1668},"Events",{"href":1669,"dataGaName":1670,"dataGaLocation":1404},"/events/","events",{"config":1672,"title":1673,"text":1674,"link":1675},{"background":1498,"textColor":1499},"What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":1676,"config":1677},"Read the latest",{"href":1678,"dataGaName":1679,"dataGaLocation":1404},"/whats-new/","whats new",{"text":1681,"config":1682,"menu":1684},"Company",{"dataNavLevelOne":1683},"company",{"type":1426,"columns":1685},[1686],{"items":1687},[1688,1693,1699,1703,1708,1713,1718,1723,1728],{"text":1689,"config":1690},"About",{"href":1691,"dataGaName":1692,"dataGaLocation":1404},"/company/","about",{"text":1694,"config":1695,"footerGa":1698},"Jobs",{"href":1696,"dataGaName":1697,"dataGaLocation":1404},"/jobs/","jobs",{"dataGaName":1697},{"text":705,"config":1700},{"href":1701,"dataGaName":1702,"dataGaLocation":1404},"/press/","press",{"text":1704,"config":1705},"Handbook",{"href":1706,"dataGaName":1707,"dataGaLocation":1404},"https://handbook.gitlab.com/","handbook",{"text":1709,"config":1710},"Leadership",{"href":1711,"dataGaName":1712,"dataGaLocation":1404},"/company/team/e-group/","leadership",{"text":1714,"config":1715},"Investor relations",{"href":1716,"dataGaName":1717,"dataGaLocation":1404},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":1719,"config":1720},"Trust Center",{"href":1721,"dataGaName":1722,"dataGaLocation":1404},"/security/","trust center",{"text":1724,"config":1725},"AI Transparency Center",{"href":1726,"dataGaName":1727,"dataGaLocation":1404},"/ai-transparency-center/","ai transparency center",{"text":1729,"config":1730},"Newsletter",{"href":1731,"dataGaName":1732,"dataGaLocation":1404},"/company/contact/#contact-forms","newsletter",{"text":1734,"config":1735,"menu":1736},"Contact us",{"dataNavLevelOne":1683},{"type":1426,"columns":1737},[1738],{"items":1739},[1740,1745,1750],{"text":1741,"config":1742},"Talk to sales",{"href":1743,"dataGaName":1744,"dataGaLocation":1404},"/sales/","talk to sales",{"text":1746,"config":1747},"Support portal",{"href":1748,"dataGaName":1749,"dataGaLocation":1404},"https://support.gitlab.com/hc/en-us","support portal",{"text":1751,"config":1752},"Customer portal",{"href":1753,"dataGaName":1754,"dataGaLocation":1404},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":1756,"login":1757,"suggestions":1764},"Close",{"text":1758,"link":1759},"To search repositories and projects, login to",{"text":1760,"config":1761},"gitlab.com",{"href":1418,"dataGaName":1762,"dataGaLocation":1763},"search login","search",{"text":1765,"default":1766},"Suggestions",[1767,1770,1773,1775,1779,1783],{"text":1768,"config":1769},"GitLab Duo Agent Platform",{"href":1484,"dataGaName":1768,"dataGaLocation":1763},{"text":1771,"config":1772},"Code Suggestions (AI)",{"href":1484,"dataGaName":1771,"dataGaLocation":1763},{"text":1436,"config":1774},{"href":1438,"dataGaName":1436,"dataGaLocation":1763},{"text":1776,"config":1777},"GitLab on AWS",{"href":1778,"dataGaName":1776,"dataGaLocation":1763},"/partners/technology-partners/aws/",{"text":1780,"config":1781},"GitLab on Google Cloud",{"href":1782,"dataGaName":1780,"dataGaLocation":1763},"/partners/technology-partners/google-cloud-platform/",{"text":1784,"config":1785},"Why GitLab?",{"href":1786,"dataGaName":1784,"dataGaLocation":1763},"/why-gitlab/",{"freeTrial":1788,"mobileIcon":1793,"desktopIcon":1798,"secondaryButton":1801},{"text":1789,"config":1790},"Start free trial",{"href":1791,"dataGaName":1409,"dataGaLocation":1792},"https://gitlab.com/-/trials/new/","nav",{"altText":1794,"config":1795},"Gitlab Icon",{"src":1796,"dataGaName":1797,"dataGaLocation":1792},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":1794,"config":1799},{"src":1800,"dataGaName":1797,"dataGaLocation":1792},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":1802,"config":1803},"Get Started",{"href":1804,"dataGaName":1805,"dataGaLocation":1792},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":1807,"mobileIcon":1811,"desktopIcon":1813},{"text":1808,"config":1809},"Learn more about GitLab Duo",{"href":1484,"dataGaName":1810,"dataGaLocation":1792},"gitlab duo",{"altText":1794,"config":1812},{"src":1796,"dataGaName":1797,"dataGaLocation":1792},{"altText":1794,"config":1814},{"src":1800,"dataGaName":1797,"dataGaLocation":1792},{"button":1816,"mobileIcon":1821,"desktopIcon":1823},{"text":1817,"config":1818},"/switch",{"href":1819,"dataGaName":1820,"dataGaLocation":1792},"#contact","switch",{"altText":1794,"config":1822},{"src":1796,"dataGaName":1797,"dataGaLocation":1792},{"altText":1794,"config":1824},{"src":1825,"dataGaName":1797,"dataGaLocation":1792},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":1827,"mobileIcon":1832,"desktopIcon":1834},{"text":1828,"config":1829},"Back to pricing",{"href":1598,"dataGaName":1830,"dataGaLocation":1792,"icon":1831},"back to pricing","GoBack",{"altText":1794,"config":1833},{"src":1796,"dataGaName":1797,"dataGaLocation":1792},{"altText":1794,"config":1835},{"src":1800,"dataGaName":1797,"dataGaLocation":1792},{"title":1837,"button":1838,"config":1842},"GitLab Orbit is generally available. Increase agent accuracy and lower token cost",{"text":1503,"config":1839},{"href":1505,"dataGaName":1840,"dataGaLocation":1841},"orbit-ga-banner","global-banner",{"layout":1843,"disabled":1381},"release",{"data":1845},{"text":1846,"config":1847,"items":1852,"minimal":2080},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"twitter":1848,"facebook":1849,"youtube":1850,"linkedin":1851},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[1853,1901,1960,2007,2048],{"title":1596,"links":1854,"subMenu":1870},[1855,1860,1865],{"text":1856,"config":1857},"View plans",{"href":1598,"dataGaName":1858,"dataGaLocation":1859},"view plans","footer",{"text":1861,"config":1862},"Why Premium?",{"href":1863,"dataGaName":1864,"dataGaLocation":1859},"/pricing/premium/","why premium",{"text":1866,"config":1867},"Why Ultimate?",{"href":1868,"dataGaName":1869,"dataGaLocation":1859},"/pricing/ultimate/","why ultimate",[1871],{"title":1872,"links":1873},"Contact Us",[1874,1877,1879,1881,1886,1891,1896],{"text":1875,"config":1876},"Contact sales",{"href":1743,"dataGaName":1414,"dataGaLocation":1859},{"text":1746,"config":1878},{"href":1748,"dataGaName":1749,"dataGaLocation":1859},{"text":1751,"config":1880},{"href":1753,"dataGaName":1754,"dataGaLocation":1859},{"text":1882,"config":1883},"Status",{"href":1884,"dataGaName":1885,"dataGaLocation":1859},"https://status.gitlab.com/","status",{"text":1887,"config":1888},"Terms of use",{"href":1889,"dataGaName":1890,"dataGaLocation":1859},"/terms/","terms of use",{"text":1892,"config":1893},"Privacy statement",{"href":1894,"dataGaName":1895,"dataGaLocation":1859},"/privacy/","privacy statement",{"text":1897,"config":1898},"Cookie preferences",{"dataGaName":1899,"dataGaLocation":1859,"id":1900,"isOneTrustButton":673},"cookie preferences","ot-sdk-btn",{"title":1422,"links":1902,"subMenu":1918},[1903,1906,1908,1910,1912,1914],{"text":1904,"config":1905},"Explore the platform",{"href":1430,"dataGaName":1424,"dataGaLocation":1859},{"text":1482,"config":1907},{"href":1484,"dataGaName":1485,"dataGaLocation":1859},{"text":1436,"config":1909},{"href":1438,"dataGaName":1439,"dataGaLocation":1859},{"text":1487,"config":1911},{"href":1489,"dataGaName":1490,"dataGaLocation":1859},{"text":1469,"config":1913},{"href":1471,"dataGaName":1472,"dataGaLocation":1859},{"text":1915,"config":1916},"Why GitLab",{"href":1786,"dataGaName":1917,"dataGaLocation":1859},"why gitlab",[1919],{"title":1920,"links":1921},"Topics",[1922,1926,1931,1935,1940,1945,1950,1955],{"text":1436,"config":1923},{"href":1924,"dataGaName":1925,"dataGaLocation":1859},"/topics/ci-cd/","cicd",{"text":1927,"config":1928},"GitOps",{"href":1929,"dataGaName":1930,"dataGaLocation":1859},"/topics/gitops/","gitops",{"text":1433,"config":1932},{"href":1933,"dataGaName":1934,"dataGaLocation":1859},"/topics/devops/","devops",{"text":1936,"config":1937},"Version Control",{"href":1938,"dataGaName":1939,"dataGaLocation":1859},"/topics/version-control/","version control",{"text":1941,"config":1942},"DevSecOps",{"href":1943,"dataGaName":1944,"dataGaLocation":1859},"/topics/devsecops/","devsecops",{"text":1946,"config":1947},"Cloud Native",{"href":1948,"dataGaName":1949,"dataGaLocation":1859},"/topics/cloud-native/","cloud native",{"text":1951,"config":1952},"AI for Coding",{"href":1953,"dataGaName":1954,"dataGaLocation":1859},"/topics/devops/ai-for-coding/","ai for coding",{"text":1956,"config":1957},"Agentic AI",{"href":1958,"dataGaName":1959,"dataGaLocation":1859},"/topics/agentic-ai/","agentic ai",{"title":1508,"links":1961},[1962,1965,1968,1971,1974,1977,1979,1981,1983,1985,1987,1990,1992,1995,1999,2003],{"text":1963,"config":1964},"DevOps modernization",{"href":1523,"dataGaName":1524,"dataGaLocation":1859},{"text":1966,"config":1967},"Security modernization",{"href":1528,"dataGaName":1529,"dataGaLocation":1859},{"text":1969,"config":1970},"AI modernization",{"href":1533,"dataGaName":1534,"dataGaLocation":1859},{"text":1972,"config":1973},"Financial services",{"href":1559,"dataGaName":1560,"dataGaLocation":1859},{"text":1975,"config":1976},"Public sector",{"href":1564,"dataGaName":1565,"dataGaLocation":1859},{"text":1567,"config":1978},{"href":1569,"dataGaName":1570,"dataGaLocation":1859},{"text":1572,"config":1980},{"href":1574,"dataGaName":1575,"dataGaLocation":1859},{"text":1577,"config":1982},{"href":1579,"dataGaName":1580,"dataGaLocation":1859},{"text":1582,"config":1984},{"href":1584,"dataGaName":1585,"dataGaLocation":1859},{"text":1539,"config":1986},{"href":1541,"dataGaName":1542,"dataGaLocation":1859},{"text":1988,"config":1989},"Small business",{"href":1546,"dataGaName":1547,"dataGaLocation":1859},{"text":1549,"config":1991},{"href":1551,"dataGaName":1552,"dataGaLocation":1859},{"text":1927,"config":1993},{"href":1994,"dataGaName":1930,"dataGaLocation":1859},"/solutions/gitops/",{"text":1996,"config":1997},"Software composition analysis",{"href":1476,"dataGaName":1998,"dataGaLocation":1859},"software composition analysis",{"text":2000,"config":2001},"Value stream management",{"href":1494,"dataGaName":2002,"dataGaLocation":1859},"value stream management",{"text":2004,"config":2005},"All solutions",{"href":1515,"dataGaName":2006,"dataGaLocation":1859},"all solutions",{"title":1601,"links":2008},[2009,2014,2019,2021,2023,2025,2027,2029,2031,2033,2035,2037,2039,2041,2044],{"text":2010,"config":2011},"Install",{"href":2012,"dataGaName":2013,"dataGaLocation":1859},"/install/","install",{"text":2015,"config":2016},"Quick start guides",{"href":2017,"dataGaName":2018,"dataGaLocation":1859},"/get-started/","quick setup checklists",{"text":1614,"config":2020},{"href":1616,"dataGaName":1617,"dataGaLocation":1859},{"text":1619,"config":2022},{"href":1621,"dataGaName":1622,"dataGaLocation":1859},{"text":1624,"config":2024},{"href":1626,"dataGaName":1627,"dataGaLocation":1859},{"text":1629,"config":2026},{"href":1631,"dataGaName":1632,"dataGaLocation":1859},{"text":1634,"config":2028},{"href":1636,"dataGaName":1637,"dataGaLocation":1859},{"text":1647,"config":2030},{"href":1649,"dataGaName":1650,"dataGaLocation":1859},{"text":1652,"config":2032},{"href":1654,"dataGaName":1655,"dataGaLocation":1859},{"text":1657,"config":2034},{"href":1659,"dataGaName":1660,"dataGaLocation":1859},{"text":1662,"config":2036},{"href":1664,"dataGaName":1665,"dataGaLocation":1859},{"text":1667,"config":2038},{"href":1669,"dataGaName":1670,"dataGaLocation":1859},{"text":1729,"config":2040},{"href":1731,"dataGaName":1732,"dataGaLocation":1859},{"text":2042,"config":2043},"What's new",{"href":1678,"dataGaName":1679,"dataGaLocation":1859},{"text":2045,"config":2046},"All resources",{"href":1608,"dataGaName":2047,"dataGaLocation":1859},"all resources",{"title":1681,"links":2049},[2050,2052,2054,2056,2058,2060,2062,2064,2066,2070,2075],{"text":1689,"config":2051},{"href":1691,"dataGaName":1683,"dataGaLocation":1859},{"text":1694,"config":2053},{"href":1696,"dataGaName":1697,"dataGaLocation":1859},{"text":705,"config":2055},{"href":1701,"dataGaName":1702,"dataGaLocation":1859},{"text":1704,"config":2057},{"href":1706,"dataGaName":1707,"dataGaLocation":1859},{"text":1709,"config":2059},{"href":1711,"dataGaName":1712,"dataGaLocation":1859},{"text":1714,"config":2061},{"href":1716,"dataGaName":1717,"dataGaLocation":1859},{"text":1719,"config":2063},{"href":1721,"dataGaName":1722,"dataGaLocation":1859},{"text":1724,"config":2065},{"href":1726,"dataGaName":1727,"dataGaLocation":1859},{"text":2067,"config":2068},"Sustainability",{"href":2069,"dataGaName":2067,"dataGaLocation":1859},"/sustainability/",{"text":2071,"config":2072},"Diversity, inclusion and belonging (DIB)",{"href":2073,"dataGaName":2074,"dataGaLocation":1859},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":2076,"config":2077},"Modern Slavery Transparency Statement",{"href":2078,"dataGaName":2079,"dataGaLocation":1859},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":2081},[2082,2085,2088],{"text":2083,"config":2084},"Terms",{"href":1889,"dataGaName":1890,"dataGaLocation":1859},{"text":2086,"config":2087},"Cookies",{"dataGaName":1899,"dataGaLocation":1859,"id":1900,"isOneTrustButton":673},{"text":2089,"config":2090},"Privacy",{"href":1894,"dataGaName":1895,"dataGaLocation":1859},[2092],{"id":2093,"title":2094,"body":1380,"config":2095,"content":2097,"description":1380,"extension":2101,"meta":2102,"navigation":673,"path":2103,"seo":2104,"stem":2105,"__hash__":2106},"blogAuthors/en-us/blog/authors/guest-author-andr-miranda.yml","Guest Author Andr Miranda",{"template":2096},"BlogAuthor",{"name":7,"config":2098},{"headshot":2099,"ctfId":2100},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749659488/Blog/Author%20Headshots/gitlab-logo-extra-whitespace.png","Guest-author-Andr-Miranda","yml",{},"/en-us/blog/authors/guest-author-andr-miranda",{},"en-us/blog/authors/guest-author-andr-miranda","ac2zHo3Yd7Rcc4McAovjjDoyFOUP1di-YhL9MOAJMAk",[2108,2116,2124],{"title":2109,"description":2110,"heroImage":2111,"category":1376,"date":2112,"authors":2113,"slug":2115,"externalUrl":1380},"Two front doors: Module-level access in a Django GRC app","A technical deep-dive on restructuring a Django internal tool to support two distinct GitLab teams: Security Compliance and Internal Audit.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750097663/Blog/Hero%20Images/Blog/Hero%20Images/Workflow%201800x945_2gQoQIbY9NvjLFpXtsxtXy_1750097663612.png","2026-10-05",[2114],"Donovan Felton","module-level-access-in-a-django-grc-app",{"title":2117,"description":2118,"heroImage":2119,"category":1376,"date":2120,"authors":2121,"slug":2123,"externalUrl":1380},"How GitLab reduced code-per-agentic-flow ratio by 45%","Learn how Flow Registry, a component-based framework that compiles YAML configurations into fully functional LangGraph flows, helped improve scalability and more.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-09-22",[2122],"Mikolaj Wawrzyniak","how-gitlab-reduced-code-per-agentic-flow-ratio",{"title":2125,"description":2126,"heroImage":2127,"category":1376,"date":2128,"authors":2129,"slug":2131,"externalUrl":1380},"Co-Create: Building GitLab with our users","How GitLab users collaborated with us to build practical product improvements in the first half of 2026.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750099203/Blog/Hero%20Images/Blog/Hero%20Images/blog-image-template-1800x945%20%2820%29_2bJGC5ZP3WheoqzlLT05C5_1750099203484.png","2026-09-10",[2130],"Isa Huerga","co-create-h1-2026",{"header":2133,"text":2134,"button":2138,"disclaimer":2141},"Start your free\n\n30-day GitLab trial\n",[2135,2136,2137],"GitLab Duo Agent Platform access","Try our most advanced features","Automate complex tasks with AI",{"text":1406,"config":2139},{"href":2140,"dataGaName":1409,"dataGaLocation":1650},"https://gitlab.com/-/trials/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/blog/","No credit card required.",{"header":2143,"blurb":2144,"button":2145,"secondaryButton":2150},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":2146,"config":2147},"Get your free trial",{"href":2148,"dataGaName":1409,"dataGaLocation":2149},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":1875,"config":2151},{"href":1743,"dataGaName":1414,"dataGaLocation":2149},1794911799616]