[{"data":1,"prerenderedAt":3463},["ShallowReactive",2],{"/blog/how-to-set-up-gitlab-saml-sso-with-google-workspace":3,"navigation-en-us":2680,"banner-en-us":3107,"footer-en-us":3117,"blog-post-authors-en-us-Omid Khan":3362,"blog-related-posts-en-us-how-to-set-up-gitlab-saml-sso-with-google-workspace":3377,"blog-promotions-en-us":3401,"next-steps-en-us":3453},{"id":4,"title":5,"authors":6,"body":8,"category":2660,"date":2661,"description":2662,"extension":2663,"externalUrl":2664,"faq":2664,"featured":2665,"heroImage":2666,"meta":2667,"navigation":2665,"path":2668,"seo":2669,"slug":2672,"stem":2673,"tags":2674,"template":2678,"updatedDate":2664,"__hash__":2679},"blogPosts/en-us/blog/how-to-set-up-gitlab-saml-sso-with-google-workspace.md","How to set up GitLab SAML SSO with Google Workspace",[7],"Omid Khan",{"type":9,"value":10,"toc":2596},"minimark",[11,15,18,32,37,40,65,69,72,99,102,133,137,140,145,166,170,173,216,231,234,238,268,278,282,303,307,314,355,359,362,474,485,490,494,497,502,509,551,555,558,602,612,628,632,635,675,681,685,688,692,695,699,702,749,759,800,804,807,812,863,866,872,878,882,885,889,895,931,941,945,948,970,976,980,983,1006,1012,1018,1032,1036,1039,1043,1046,1073,1083,1087,1090,1102,1105,1110,1132,1138,1176,1189,1194,1200,1211,1221,1224,1307,1311,1314,1335,1339,1342,1346,1349,1363,1366,1407,1411,1414,1449,1459,1463,1466,1470,1473,1479,1483,1486,1531,1535,1538,1542,1545,1578,1582,1623,1627,1630,1634,1637,1645,1649,1651,1659,1663,1665,1673,1677,1680,1710,1715,1721,1732,1738,1748,1752,1755,1759,1799,1803,1806,1824,1829,1836,1840,1843,1869,1873,1876,1896,1900,1904,1910,1921,1926,1937,1942,1956,1960,1963,1983,1990,1994,2003,2007,2072,2076,2079,2083,2089,2094,2167,2171,2176,2180,2241,2245,2250,2254,2327,2331,2336,2340,2405,2409,2412,2416,2482,2486,2489,2522,2526,2529,2546,2550,2579,2583,2592],[12,13,14],"p",{},"Single sign-on (SSO) simplifies user authentication and improves security by allowing employees to access multiple applications with one set of credentials. For organizations using both GitLab and Google Workspace, integrating SAML-based SSO streamlines access management and ensures your teams can collaborate seamlessly.",[12,16,17],{},"In this guide, we'll walk through configuring SAML authentication between Google Workspace and GitLab.com, including automatic group synchronization that maps Google Workspace groups to GitLab roles. By the end, your users will be able to sign in to GitLab using their Google credentials, and their permissions will automatically reflect their Google group memberships.",[12,19,20,24,25,31],{},[21,22,23],"strong",{},"Note:"," This guide focuses on GitLab.com (SaaS). If you're using GitLab Self-Managed, the setup process differs slightly. Refer to the ",[26,27,30],"a",{"href":28,"rel":29},"https://docs.gitlab.com/integration/saml/",[],"official GitLab SAML documentation for self-managed instances"," for detailed instructions.",[33,34,36],"h2",{"id":35},"what-youll-need","What you'll need",[12,38,39],{},"Before getting started, make sure you have:",[41,42,43,50,56,62],"ul",{},[44,45,46,49],"li",{},[21,47,48],{},"Google Workspace"," with Super Admin access",[44,51,52,55],{},[21,53,54],{},"GitLab.com"," with a Premium or Ultimate tier subscription",[44,57,58,61],{},[21,59,60],{},"Owner role"," on a GitLab top-level group",[44,63,64],{},"Users already existing in Google Workspace (they'll be created in GitLab automatically on first login)",[33,66,68],{"id":67},"understanding-the-architecture","Understanding the architecture",[12,70,71],{},"When you configure SAML SSO with group synchronization, here's what happens:",[73,74,75,81,87,93],"ol",{},[44,76,77,80],{},[21,78,79],{},"Authentication flow",": Users navigate to GitLab's SSO URL and are redirected to Google Workspace to authenticate.",[44,82,83,86],{},[21,84,85],{},"SAML assertion",": After successful authentication, Google sends a SAML response containing user details and group memberships.",[44,88,89,92],{},[21,90,91],{},"Automatic provisioning",": GitLab creates the user account (if needed) and assigns them to groups based on their Google group memberships.",[44,94,95,98],{},[21,96,97],{},"Permission sync",": Each time users sign in, GitLab updates their group memberships and roles to match their current Google groups.",[12,100,101],{},"This setup provides several benefits:",[41,103,104,110,115,121,127],{},[44,105,106,109],{},[21,107,108],{},"Centralized access control",": You can manage user access through Google Workspace groups.",[44,111,112,114],{},[21,113,91],{},": New users gain GitLab access on their first login.",[44,116,117,120],{},[21,118,119],{},"Dynamic permissions",": User roles update automatically based on group membership changes.",[44,122,123,126],{},[21,124,125],{},"Enhanced security",": You can leverage Google's authentication security features.",[44,128,129,132],{},[21,130,131],{},"Reduced administrative overhead",": There is no need to manually manage GitLab group memberships.",[33,134,136],{"id":135},"part-1-get-your-gitlab-saml-configuration-values","Part 1: Get your GitLab SAML configuration values",[12,138,139],{},"First, you'll need to gather some information from GitLab that you'll use when creating the SAML application in Google Workspace. Here are the steps to take:",[141,142,144],"h3",{"id":143},"step-1-navigate-to-your-gitlab-group-saml-settings","Step 1: Navigate to your GitLab group SAML settings",[73,146,147,153,160],{},[44,148,149,150,152],{},"Sign in to ",[21,151,54],{},".",[44,154,155,156,159],{},"Navigate to your ",[21,157,158],{},"top-level group"," (Note: SAML SSO can only be configured at the top-level group, not in subgroups).",[44,161,162,163,152],{},"In the left sidebar, select ",[21,164,165],{},"Settings > SAML SSO",[141,167,169],{"id":168},"step-2-copy-the-required-urls","Step 2: Copy the required URLs",[12,171,172],{},"On the SAML SSO settings page, you'll see three important URLs. Copy and save these somewhere accessible — you'll need them shortly:",[41,174,175,190,203],{},[44,176,177,180,181],{},[21,178,179],{},"Assertion consumer service URL",": This is where Google will send SAML responses.",[41,182,183],{},[44,184,185,186],{},"Format: ",[187,188,189],"code",{},"https://gitlab.com/groups/your-group/-/saml/callback",[44,191,192,195,196],{},[21,193,194],{},"Identifier",": Also called the Entity ID, this uniquely identifies your GitLab group.",[41,197,198],{},[44,199,185,200],{},[187,201,202],{},"https://gitlab.com/groups/your-group",[44,204,205,208,209],{},[21,206,207],{},"GitLab SSO URL",": This is the URL your users will use to sign in.",[41,210,211],{},[44,212,185,213],{},[187,214,215],{},"https://gitlab.com/groups/your-group/-/saml/sso",[217,218,219,220,219,225],"figure",{},"\n  ",[221,222],"img",{"src":223,"alt":224},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090029/lrw6jbn7ussjze6lxg5o.png","GitLab SAML single sign-on settings",[226,227,228],"figcaption",{},[229,230,224],"em",{},[12,232,233],{},"Now you'll create a custom SAML application in Google Workspace that connects to your GitLab group.",[141,235,237],{"id":236},"step-3-access-the-google-admin-console","Step 3: Access the Google Admin Console",[73,239,240,249,256,262],{},[44,241,242,243,248],{},"Open a new browser tab and sign in to the ",[26,244,247],{"href":245,"rel":246},"https://admin.google.com/",[],"Google Admin Console"," with a Super Administrator account.",[44,250,251,252,255],{},"Click the ",[21,253,254],{},"Menu"," icon (☰) in the top-left.",[44,257,258,259,152],{},"Navigate to ",[21,260,261],{},"Apps > Web and mobile apps",[44,263,264,265,152],{},"Click ",[21,266,267],{},"Add App > Add custom SAML app",[217,269,219,270,219,274],{},[221,271],{"src":272,"alt":273},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090026/c2inhqzppdbszysupjcd.png","Google custom SAML app",[226,275,276],{},[229,277,273],{},[141,279,281],{"id":280},"step-4-configure-the-application-name","Step 4: Configure the application name",[73,283,284,291,298],{},[44,285,286,287,290],{},"In the ",[21,288,289],{},"App name"," field, enter GitLab (or your preferred name).",[44,292,293,294,297],{},"Optionally upload a ",[21,295,296],{},"GitLab logo"," as the app icon for easy recognition.",[44,299,264,300,152],{},[21,301,302],{},"Continue",[141,304,306],{"id":305},"step-5-download-google-identity-provider-details","Step 5: Download Google identity provider details",[12,308,309,310,313],{},"On the ",[21,311,312],{},"Google Identity Provider details"," page, you'll need to capture two pieces of information:",[73,315,316,330,351],{},[44,317,318,321,322],{},[21,319,320],{},"SSO URL",": Copy this URL. It tells GitLab where to send authentication requests.",[41,323,324],{},[44,325,326,327],{},"Example format: ",[187,328,329],{},"https://accounts.google.com/o/saml2/idp?idpid=C1234abcd",[44,331,332,335,336,339,340],{},[21,333,334],{},"Certificate",": Click the ",[21,337,338],{},"Download"," button to save the certificate file.",[41,341,342,348],{},[44,343,344,345],{},"The file will be named something like: ",[187,346,347],{},"GoogleIDPCertificate-gitlab.pem",[44,349,350],{},"Save this file somewhere you can easily find it. You'll need it in the next section",[44,352,264,353,152],{},[21,354,302],{},[141,356,358],{"id":357},"step-6-configure-service-provider-details","Step 6: Configure service provider details",[12,360,361],{},"This is where you'll use the GitLab URLs you copied in Step 2. Enter the following:",[363,364,365,387],"table",{},[366,367,368],"thead",{},[369,370,371,377,382],"tr",{},[372,373,374],"th",{},[21,375,376],{},"Field",[372,378,379],{},[21,380,381],{},"Value",[372,383,384],{},[21,385,386],{},"Description",[388,389,390,404,417,430,446,461],"tbody",{},[369,391,392,398,401],{},[393,394,395],"td",{},[21,396,397],{},"ACS URL",[393,399,400],{},"Your GitLab Assertion consumer service URL",[393,402,403],{},"Where Google sends SAML responses",[369,405,406,411,414],{},[393,407,408],{},[21,409,410],{},"Entity ID",[393,412,413],{},"Your GitLab Identifier",[393,415,416],{},"Unique identifier for your GitLab group",[369,418,419,424,427],{},[393,420,421],{},[21,422,423],{},"Start URL",[393,425,426],{},"Leave blank",[393,428,429],{},"Not required for this setup",[369,431,432,437,443],{},[393,433,434],{},[21,435,436],{},"Name ID format",[393,438,439,440],{},"Select ",[21,441,442],{},"EMAIL",[393,444,445],{},"The format for the user identifier",[369,447,448,453,458],{},[393,449,450],{},[21,451,452],{},"Name ID",[393,454,439,455],{},[21,456,457],{},"Basic Information > Primary Email",[393,459,460],{},"The user's primary email will be used as their identifier",[369,462,463,468,471],{},[393,464,465],{},[21,466,467],{},"Signed response",[393,469,470],{},"Leave unchecked",[393,472,473],{},"GitLab doesn't require signed responses by default",[217,475,219,477,219,481],{"style":476},"margin: 24px 0;",[221,478],{"src":479,"alt":480},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090028/kaui5vj14gkftbfgsbnz.png","GitLab SAML app details",[226,482,483],{},[229,484,480],{},[12,486,264,487,489],{},[21,488,302],{}," when complete.",[141,491,493],{"id":492},"step-7-configure-attribute-mapping","Step 7: Configure attribute mapping",[12,495,496],{},"Attribute mapping tells Google which user information to send to GitLab. You'll configure both basic user attributes and group membership.",[498,499,501],"h4",{"id":500},"basic-attributes","Basic attributes",[12,503,504,505,508],{},"Add these three attribute mappings by clicking ",[21,506,507],{},"Add mapping"," for each:",[363,510,511,525],{},[366,512,513],{},[369,514,515,520],{},[372,516,517],{},[21,518,519],{},"Google Directory attribute",[372,521,522],{},[21,523,524],{},"App attribute",[388,526,527,535,543],{},[369,528,529,532],{},[393,530,531],{},"Primary email",[393,533,534],{},"email",[369,536,537,540],{},[393,538,539],{},"First name",[393,541,542],{},"first_name",[369,544,545,548],{},[393,546,547],{},"Last name",[393,549,550],{},"last_name",[498,552,554],{"id":553},"group-membership-configuration","Group membership configuration",[12,556,557],{},"This is the critical configuration that enables automatic group synchronization:",[73,559,560,567,577,588,597],{},[44,561,562,563,566],{},"Scroll down to the ",[21,564,565],{},"\"Group membership (optional)\""," section.",[44,568,569,570,573,574,152],{},"Under ",[21,571,572],{},"\"Google groups\"",", click ",[21,575,576],{},"\"Search for a group\"",[44,578,579,580],{},"Search for and select each Google Workspace group you want to synchronize with GitLab.",[41,581,582,585],{},[44,583,584],{},"You can select up to 75 groups",[44,586,587],{},"Examples: Engineering, DevOps, Platform-Team, Security-Team",[44,589,569,590,593,594,152],{},[21,591,592],{},"\"App attribute\"",", enter exactly: ",[187,595,596],{},"groups",[44,598,264,599,152],{},[21,600,601],{},"Finish",[217,603,219,604,219,608],{},[221,605],{"src":606,"alt":607},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090027/ksuebt9uoe3w5cdzsjkl.png","GitLab SAML app attribute mapping",[226,609,610],{},[229,611,607],{},[613,614,615],"blockquote",{},[12,616,617,620,621,624,625,627],{},[21,618,619],{},"Critical",": The app attribute name ",[21,622,623],{},"MUST"," be exactly ",[187,626,596],{}," (lowercase). This is what GitLab expects to receive in the SAML response. Any other value or capitalization will prevent group synchronization from working.",[141,629,631],{"id":630},"step-8-enable-the-application-for-users","Step 8: Enable the application for users",[12,633,634],{},"Your SAML app is created but not yet enabled. To make it available to users:",[73,636,637,644,647,653,670],{},[44,638,639,640,643],{},"In the Google Admin Console, find your ",[21,641,642],{},"GitLab"," app in the Web and mobile apps list.",[44,645,646],{},"Click on the app to open its details.",[44,648,649,650,152],{},"In the left sidebar, click ",[21,651,652],{},"User access",[44,654,655,656],{},"Select one of the following:",[41,657,658,664],{},[44,659,660,663],{},[21,661,662],{},"ON for everyone"," - Enables the app for all users in your organization",[44,665,666,669],{},[21,667,668],{},"ON for some organizational units"," - Select specific organizational units",[44,671,264,672,152],{},[21,673,674],{},"Save",[12,676,677,680],{},[21,678,679],{},"Note",": Changes can take up to 24 hours to propagate, but typically take effect within a few minutes.",[33,682,684],{"id":683},"part-3-convert-the-certificate-to-sha-1-fingerprint-format","Part 3: Convert the certificate to SHA-1 fingerprint format",[12,686,687],{},"GitLab requires a SHA-1 certificate fingerprint, but Google's certificate download doesn't include this format directly. You'll need to convert it.",[141,689,691],{"id":690},"step-9-convert-your-certificate","Step 9: Convert your certificate",[12,693,694],{},"You have two options for converting the certificate to the required format.",[498,696,698],{"id":697},"option-1-online-conversion-tool","Option 1: Online conversion tool",[12,700,701],{},"This is a viable method if you're comfortable using a third-party tool:",[73,703,704,720,743],{},[44,705,706,709,710],{},[21,707,708],{},"Locate the certificate file"," you downloaded in Step 5:",[41,711,712,715],{},[44,713,714],{},"Check your Downloads folder",[44,716,717,718],{},"The file name will be something like: ",[187,719,347],{},[44,721,722,725,726],{},[21,723,724],{},"Open the file"," in a text editor:",[41,727,728,734,740],{},[44,729,730,731],{},"Mac: ",[21,732,733],{},"Right-click > Open With > TextEdit",[44,735,736,737],{},"Windows: ",[21,738,739],{},"Right-click > Open With > Notepad",[44,741,742],{},"Linux: Use your preferred text editor",[44,744,745,748],{},[21,746,747],{},"Copy ALL contents"," of the file, including the header and footer:",[750,751,757],"pre",{"className":752,"code":754,"language":755,"meta":756},[753],"language-text","-----BEGIN CERTIFICATE-----\nMIIDdDCCAlygAwIBAgIGAXqD...\n(multiple lines of encoded text)\n...kE7RnF6yQ==\n-----END CERTIFICATE-----\n","text","",[187,758,754],{"__ignoreMap":756},[73,760,762,774,780,786,791],{"start":761},4,[44,763,764,767,768,773],{},[21,765,766],{},"Navigate to",": A SHA-1 fingerprint conversion tool. ",[26,769,772],{"href":770,"rel":771},"https://www.samltool.com/fingerprint.php",[],"This one"," is a good example.",[44,775,776,779],{},[21,777,778],{},"Paste the certificate content"," into the text box.",[44,781,782,785],{},[21,783,784],{},"Select \"SHA-1\""," from the algorithm dropdown (not SHA-256!).",[44,787,264,788,152],{},[21,789,790],{},"\"Calculate Fingerprint\"",[44,792,793,796,797,152],{},[21,794,795],{},"Copy the resulting fingerprint"," - it will be in the format: ",[187,798,799],{},"XX:XX:XX:XX:XX:...",[498,801,803],{"id":802},"option-2-command-line-conversion","Option 2: Command-line conversion",[12,805,806],{},"If you prefer using the command line:",[12,808,809],{},[21,810,811],{},"For Mac, Linux, or Windows with WSL:",[750,813,817],{"className":814,"code":815,"language":816,"meta":756,"style":756},"language-bash shiki shiki-themes github-light","cd ~/Downloads\nopenssl x509 -noout -fingerprint -sha1 -inform pem -in \"GoogleIDPCertificate-gitlab.pem\"\n","bash",[187,818,819,832],{"__ignoreMap":756},[820,821,824,828],"span",{"class":822,"line":823},"line",1,[820,825,827],{"class":826},"sYu0t","cd",[820,829,831],{"class":830},"sYBdl"," ~/Downloads\n",[820,833,835,839,842,845,848,851,854,857,860],{"class":822,"line":834},2,[820,836,838],{"class":837},"s7eDp","openssl",[820,840,841],{"class":830}," x509",[820,843,844],{"class":826}," -noout",[820,846,847],{"class":826}," -fingerprint",[820,849,850],{"class":826}," -sha1",[820,852,853],{"class":826}," -inform",[820,855,856],{"class":830}," pem",[820,858,859],{"class":826}," -in",[820,861,862],{"class":830}," \"GoogleIDPCertificate-gitlab.pem\"\n",[12,864,865],{},"The output will show:",[750,867,870],{"className":868,"code":869,"language":755,"meta":756},[753],"SHA1 Fingerprint=XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX\n",[187,871,869],{"__ignoreMap":756},[12,873,874,875,152],{},"Copy everything after ",[187,876,877],{},"SHA1 Fingerprint=",[33,879,881],{"id":880},"part-4-complete-your-gitlab-saml-configuration","Part 4: Complete your GitLab SAML configuration",[12,883,884],{},"Now that you have the Google SSO URL and certificate fingerprint, you can complete the GitLab side of the configuration.",[141,886,888],{"id":887},"step-10-enter-google-identity-provider-details","Step 10: Enter Google identity provider details",[12,890,891,892,894],{},"Return to your GitLab browser tab (",[21,893,165],{},") and do the following:",[73,896,897,908,921],{},[44,898,899,902,903],{},[21,900,901],{},"Identity provider SSO URL",":",[41,904,905],{},[44,906,907],{},"Paste the SSO URL you copied from Google in Step 5",[44,909,910,902,913],{},[21,911,912],{},"Certificate fingerprint",[41,914,915,918],{},[44,916,917],{},"Paste the SHA-1 fingerprint you generated in Step 9",[44,919,920],{},"Verify the format is correct: 59 characters with colons (XX:XX:XX:...)",[44,922,923,902,926],{},[21,924,925],{},"Enable SAML authentication for this group",[41,927,928],{},[44,929,930],{},"Check this box to activate SAML SSO",[217,932,219,933,219,937],{},[221,934],{"src":935,"alt":936},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090027/ncoeqrdu7aahyuflrq7b.png","GitLab SAML Configuration with Google SAML values",[226,938,939],{},[229,940,936],{},[141,942,944],{"id":943},"step-11-configure-security-settings-recommended","Step 11: Configure security settings (recommended)",[12,946,947],{},"For enhanced security, consider enabling these additional options:",[41,949,950,960],{},[44,951,952,955],{},[21,953,954],{},"\"Enforce SAML authentication for web activity for this group\"",[41,956,957],{},[44,958,959],{},"Requires users to authenticate via SAML to access the GitLab web interface",[44,961,962,965],{},[21,963,964],{},"\"Enforce SAML authentication for Git and Dependency Proxy activity for this group\"",[41,966,967],{},[44,968,969],{},"Requires SAML authentication for Git operations and dependency proxy access",[12,971,264,972,975],{},[21,973,974],{},"Save changes"," to apply your configuration.",[141,977,979],{"id":978},"step-12-test-your-saml-configuration","Step 12: Test your SAML configuration",[12,981,982],{},"Before proceeding with group synchronization, verify that basic SAML authentication works:",[73,984,985,988,997,1000,1003],{},[44,986,987],{},"Open an incognito or private browsing window.",[44,989,990,991],{},"Navigate to your GitLab SSO URL.",[41,992,993],{},[44,994,185,995],{},[187,996,215],{},[44,998,999],{},"You should be redirected to the Google sign-in page.",[44,1001,1002],{},"Sign in with a Google Workspace account that has access to the GitLab app.",[44,1004,1005],{},"After successful authentication, you should be redirected back to GitLab.",[12,1007,1008,1011],{},[21,1009,1010],{},"If the test succeeds",", you can proceed to configure group synchronization.",[12,1013,1014,1017],{},[21,1015,1016],{},"If the test fails",", check the following:",[41,1019,1020,1023,1026,1029],{},[44,1021,1022],{},"Verify the certificate fingerprint is SHA-1 format (not SHA-256).",[44,1024,1025],{},"Confirm the SSO URL is correct.",[44,1027,1028],{},"Ensure the user has access to the GitLab SAML app in Google Admin Console.",[44,1030,1031],{},"Check that the ACS URL and Entity ID match exactly.",[33,1033,1035],{"id":1034},"part-5-set-up-saml-group-synchronization","Part 5: Set up SAML group synchronization",[12,1037,1038],{},"Now it's time to map your Google Workspace groups to GitLab roles so that permissions are automatically managed based on group membership.",[141,1040,1042],{"id":1041},"step-13-configure-default-membership-role","Step 13: Configure default membership role",[12,1044,1045],{},"As a security best practice, set a minimal default role for users who log in but don't belong to any mapped groups:",[73,1047,1048,1054,1060,1069],{},[44,1049,1050,1051,152],{},"In your GitLab group, navigate to ",[21,1052,1053],{},"Settings > General",[44,1055,1056,1057,566],{},"Expand the ",[21,1058,1059],{},"Permissions and group features",[44,1061,569,1062,1065,1066,152],{},[21,1063,1064],{},"Default membership role",", select ",[21,1067,1068],{},"Minimal Access or Guest",[44,1070,264,1071,152],{},[21,1072,974],{},[217,1074,219,1075,219,1079],{},[221,1076],{"src":1077,"alt":1078},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769097587/syi0jeaspzt9tki0w9nd.png","GitLab SAML Default membership setting",[226,1080,1081],{},[229,1082,1078],{},[141,1084,1086],{"id":1085},"step-14-create-saml-group-links","Step 14: Create SAML group links",[12,1088,1089],{},"SAML Group Links are the mappings between Google Workspace groups and GitLab roles. Here's how to create them:",[73,1091,1092,1097],{},[44,1093,1050,1094,152],{},[21,1095,1096],{},"Settings > SAML Group Links",[44,1098,264,1099,152],{},[21,1100,1101],{},"\"Add new SAML Group Link\"",[12,1103,1104],{},"For each Google Workspace group you want to sync:",[12,1106,1107,902],{},[21,1108,1109],{},"SAML Group Name",[41,1111,1112,1119,1126,1129],{},[44,1113,1114,1115,1118],{},"Enter the ",[21,1116,1117],{},"exact name"," of your Google Workspace group",[44,1120,1121,1122,1125],{},"This is ",[21,1123,1124],{},"case-sensitive"," and must match perfectly",[44,1127,1128],{},"Example: Engineering (not engineering)",[44,1130,1131],{},"To find the exact name: Google Admin Console > Directory > Groups",[12,1133,1134,1137],{},[21,1135,1136],{},"Access Level",": Select the appropriate GitLab role:",[41,1139,1140,1146,1152,1158,1164,1170],{},[44,1141,1142,1145],{},[21,1143,1144],{},"Minimal Access"," - Can see that the group exists",[44,1147,1148,1151],{},[21,1149,1150],{},"Guest"," - Can view issues and leave comments",[44,1153,1154,1157],{},[21,1155,1156],{},"Reporter"," - Can pull code, view issues, and create new issues",[44,1159,1160,1163],{},[21,1161,1162],{},"Developer"," - Can push code, create merge requests, and manage issues",[44,1165,1166,1169],{},[21,1167,1168],{},"Maintainer"," - Can manage project settings and members",[44,1171,1172,1175],{},[21,1173,1174],{},"Owner"," - Full administrative control over the group",[73,1177,1179,1183],{"start":1178},3,[44,1180,264,1181,152],{},[21,1182,674],{},[44,1184,1185,1188],{},[21,1186,1187],{},"Repeat this process"," for each Google Workspace group you want to map.",[12,1190,1191,1193],{},[21,1192,23],{}," SAML group sync rules are enforced every time a user signs in. If a user's Google group membership matches a sync rule, their GitLab role will be automatically set to the configured access level, even if you've manually changed it to something different. For example, if you set up a sync rule that grants \"Maintainer\" access and then manually promote a user to \"Owner,\" they'll be automatically downgraded back to \"Maintainer\" on their next SAML sign-in.",[12,1195,1196,1199],{},[21,1197,1198],{},"Best practices:"," To maintain custom access levels for specific users, do one of the following:",[41,1201,1202,1205,1208],{},[44,1203,1204],{},"Use SAML group sync only on your top-level group and manually manage permissions in subgroups",[44,1206,1207],{},"Create separate Google groups for users who need elevated permissions",[44,1209,1210],{},"Avoid setting up sync rules that would conflict with manual role assignments",[217,1212,219,1213,219,1217],{},[221,1214],{"src":1215,"alt":1216},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090028/etjoaiuyhnqh4gnjqcha.png","GitLab SAML Group Links setup",[226,1218,1219],{},[229,1220,1216],{},[12,1222,1223],{},"Here's a practical example of how you might structure your group mappings:",[363,1225,1226,1245],{},[366,1227,1228],{},[369,1229,1230,1235,1240],{},[372,1231,1232],{},[21,1233,1234],{},"Google Workspace Group",[372,1236,1237],{},[21,1238,1239],{},"GitLab Role",[372,1241,1242],{},[21,1243,1244],{},"Purpose",[388,1246,1247,1257,1267,1277,1287,1297],{},[369,1248,1249,1252,1254],{},[393,1250,1251],{},"GitLab-Admins",[393,1253,1174],{},[393,1255,1256],{},"Full administrative access",[369,1258,1259,1262,1264],{},[393,1260,1261],{},"Engineering-Team",[393,1263,1168],{},[393,1265,1266],{},"Can manage projects and settings",[369,1268,1269,1272,1274],{},[393,1270,1271],{},"Developer-Team",[393,1273,1162],{},[393,1275,1276],{},"Can write and push code",[369,1278,1279,1282,1284],{},[393,1280,1281],{},"QA-Team",[393,1283,1162],{},[393,1285,1286],{},"Can test and manage issues",[369,1288,1289,1292,1294],{},[393,1290,1291],{},"Contractors",[393,1293,1156],{},[393,1295,1296],{},"Read-only access to code",[369,1298,1299,1302,1304],{},[393,1300,1301],{},"All-Employees",[393,1303,1144],{},[393,1305,1306],{},"Basic visibility",[141,1308,1310],{"id":1309},"step-15-verify-your-group-links","Step 15: Verify your group links",[12,1312,1313],{},"After creating all your group links:",[73,1315,1316,1321,1327,1332],{},[44,1317,1318,1319,152],{},"Review the complete list of SAML Group Links in ",[21,1320,1096],{},[44,1322,1323,1324,1326],{},"Verify each ",[21,1325,1109],{}," exactly matches the corresponding Google Workspace group.",[44,1328,1323,1329,1331],{},[21,1330,1136],{}," is appropriate for the intended purpose.",[44,1333,1334],{},"Check for any typos or extra spaces.",[33,1336,1338],{"id":1337},"part-6-test-the-complete-configuration","Part 6: Test the complete configuration",[12,1340,1341],{},"Now it's time to test the entire setup including group synchronization.",[141,1343,1345],{"id":1344},"step-16-test-with-a-real-user","Step 16: Test with a real user",[12,1347,1348],{},"Choose a test user who meets these criteria:",[41,1350,1351,1354,1357,1360],{},[44,1352,1353],{},"Has a Google Workspace account",[44,1355,1356],{},"Is a member of at least one Google Workspace group you configured",[44,1358,1359],{},"Has the GitLab SAML app enabled in Google Admin Console",[44,1361,1362],{},"Ideally is not you (to ensure a realistic test)",[12,1364,1365],{},"To perform the test:",[73,1367,1368,1373,1384,1390],{},[44,1369,1370],{},[21,1371,1372],{},"Open an incognito or private browsing window",[44,1374,1375,902,1378],{},[21,1376,1377],{},"Navigate to your GitLab SSO URL",[41,1379,1380],{},[44,1381,1382],{},[187,1383,215],{},[44,1385,1386,1389],{},[21,1387,1388],{},"Sign in"," with the test user's Google Workspace credentials",[44,1391,1392,1393],{},"The user should be:",[41,1394,1395,1398,1401,1404],{},[44,1396,1397],{},"Authenticated successfully",[44,1399,1400],{},"Redirected to GitLab",[44,1402,1403],{},"Automatically added to the GitLab group",[44,1405,1406],{},"Assigned the appropriate role based on their Google group membership",[141,1408,1410],{"id":1409},"step-17-verify-group-membership-and-role-assignment","Step 17: Verify group membership and role assignment",[12,1412,1413],{},"Using your GitLab administrator account:",[73,1415,1416,1419,1425,1428],{},[44,1417,1418],{},"Navigate to your group in GitLab.",[44,1420,439,1421,1424],{},[21,1422,1423],{},"Manage > Members"," from the left sidebar.",[44,1426,1427],{},"Find the test user in the members list.",[44,1429,1430,1431],{},"Verify the following:\n",[41,1432,1433,1436,1443],{},[44,1434,1435],{},"User appears in the members list",[44,1437,1438,1439,1442],{},"User has the correct ",[21,1440,1441],{},"Max role"," based on their Google group(s)",[44,1444,1445,1448],{},[21,1446,1447],{},"Source"," column shows a SAML indicator",[217,1450,219,1451,219,1455],{},[221,1452],{"src":1453,"alt":1454},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090026/hiov7kiukidsiyscfesg.png","Verified SAML user added",[226,1456,1457],{},[229,1458,1454],{},[33,1460,1462],{"id":1461},"part-7-configure-subgroup-access-optional","Part 7: Configure subgroup access (optional)",[12,1464,1465],{},"For larger organizations, you may want to provide more granular access control using GitLab subgroups. SAML Group Links can be configured at any level of your group hierarchy, allowing you to map different Google Workspace groups to specific teams or projects.",[141,1467,1469],{"id":1468},"understanding-gitlabs-subgroup-structure","Understanding GitLab's subgroup structure",[12,1471,1472],{},"GitLab supports nested group hierarchies that can mirror your organizational structure:",[750,1474,1477],{"className":1475,"code":1476,"language":755,"meta":756},[753],"acme-corp/                          ← Top-level group (SAML configured here)\n├── engineering/                    ← Subgroup\n│   ├── backend/                   ← Nested subgroup\n│   └── frontend/                  ← Nested subgroup\n├── marketing/                      ← Subgroup\n└── operations/                     ← Subgroup\n",[187,1478,1476],{"__ignoreMap":756},[141,1480,1482],{"id":1481},"creating-subgroups","Creating subgroups",[12,1484,1485],{},"If you need to create additional subgroups:",[73,1487,1488,1494,1500,1523,1528],{},[44,1489,155,1490,1493],{},[21,1491,1492],{},"parent group"," (e.g., acme-corp).",[44,1495,251,1496,1499],{},[21,1497,1498],{},"New subgroup"," button.",[44,1501,1502,1503],{},"Configure the subgroup:",[41,1504,1505,1511,1517],{},[44,1506,1507,1510],{},[21,1508,1509],{},"Subgroup name",": Display name (e.g., Engineering)",[44,1512,1513,1516],{},[21,1514,1515],{},"Subgroup URL",": URL slug (e.g., engineering)",[44,1518,1519,1522],{},[21,1520,1521],{},"Visibility level",": Choose Private, Internal, or Public",[44,1524,264,1525,152],{},[21,1526,1527],{},"Create subgroup",[44,1529,1530],{},"Repeat for other subgroups as needed.",[141,1532,1534],{"id":1533},"configuring-saml-group-links-for-subgroups","Configuring SAML group links for subgroups",[12,1536,1537],{},"Here are the steps to configure SAML group links for subgroups.",[498,1539,1541],{"id":1540},"add-new-google-groups-to-the-saml-app-if-needed","Add new Google groups to the SAML app (if needed)",[12,1543,1544],{},"If you're introducing new Google Workspace groups for subgroup access:",[73,1546,1547,1553,1558,1563,1566,1574],{},[44,1548,1549,1550,152],{},"Go to ",[21,1551,1552],{},"Google Admin Console > Apps > Web and mobile apps > GitLab",[44,1554,264,1555,152],{},[21,1556,1557],{},"SAML attribute mapping",[44,1559,1560,1561,152],{},"Scroll to ",[21,1562,565],{},[44,1564,1565],{},"Add your new groups (e.g., Backend-Team, Frontend-Team).",[44,1567,1568,1569,1571,1572,152],{},"Verify the ",[21,1570,592],{}," is still ",[187,1573,596],{},[44,1575,264,1576,152],{},[21,1577,674],{},[498,1579,1581],{"id":1580},"map-google-groups-to-subgroups","Map Google groups to subgroups",[73,1583,1584,1595,1599,1603,1618],{},[44,1585,1586,1589,1590],{},[21,1587,1588],{},"Navigate to the specific subgroup"," in GitLab",[41,1591,1592],{},[44,1593,1594],{},"Example: acme-corp/engineering/backend",[44,1596,1549,1597,152],{},[21,1598,1096],{},[44,1600,264,1601,152],{},[21,1602,1101],{},[44,1604,1605,1606],{},"Configure the mapping:",[41,1607,1608,1613],{},[44,1609,1610,1612],{},[21,1611,1109],{},": Backend-Team (exact Google Workspace group name)",[44,1614,1615,1617],{},[21,1616,1136],{},": Developer (or your desired role)",[44,1619,264,1620,1622],{},[21,1621,674],{},".\nRepeat this process for all subgroups and their corresponding Google groups.",[141,1624,1626],{"id":1625},"multi-level-access-example","Multi-level access example",[12,1628,1629],{},"Here's how permissions might work across different levels:",[498,1631,1633],{"id":1632},"top-level-group-acme-corp","Top-level group: acme-corp",[12,1635,1636],{},"SAML Group Links:",[41,1638,1639,1642],{},[44,1640,1641],{},"\"Company-Admins\" → Owner",[44,1643,1644],{},"\"All-Employees\" → Minimal Access",[498,1646,1648],{"id":1647},"subgroup-acme-corpengineering","Subgroup: acme-corp/engineering",[12,1650,1636],{},[41,1652,1653,1656],{},[44,1654,1655],{},"\"Engineering-Leads\" → Owner",[44,1657,1658],{},"\"Engineering-Team\" → Maintainer",[498,1660,1662],{"id":1661},"nested-subgroup-acme-corpengineeringbackend","Nested subgroup: acme-corp/engineering/backend",[12,1664,1636],{},[41,1666,1667,1670],{},[44,1668,1669],{},"\"Backend-Leads\" → Maintainer",[44,1671,1672],{},"\"Backend-Team\" → Developer",[141,1674,1676],{"id":1675},"how-permissions-inherit-and-combine","How permissions inherit and combine",[12,1678,1679],{},"Understanding permission behavior is important:",[41,1681,1682,1692,1698,1704],{},[44,1683,1684,1687,1688,1691],{},[21,1685,1686],{},"Role calculation",": At each level, users receive the ",[21,1689,1690],{},"highest role"," from all their Google groups.",[44,1693,1694,1697],{},[21,1695,1696],{},"Inheritance",": Higher permissions at parent levels flow down to child subgroups.",[44,1699,1700,1703],{},[21,1701,1702],{},"Independence",": Each level calculates permissions based on its own group links plus inherited permissions.",[44,1705,1706,1709],{},[21,1707,1708],{},"No limitation",": Lower permissions at parent levels do NOT restrict higher permissions at child levels.",[12,1711,1712,902],{},[21,1713,1714],{},"Example scenarios",[12,1716,1717,1720],{},[21,1718,1719],{},"User A"," (member of Backend-Team only):",[41,1722,1723,1726,1729],{},[44,1724,1725],{},"acme-corp: Minimal Access (from \"All-Employees\" default)",[44,1727,1728],{},"acme-corp/engineering: Minimal Access (inherited from parent)",[44,1730,1731],{},"acme-corp/engineering/backend: Developer (from \"Backend-Team\" mapping)",[12,1733,1734,1737],{},[21,1735,1736],{},"User B"," (member of Engineering-Leads and Backend-Team):",[41,1739,1740,1742,1745],{},[44,1741,1725],{},[44,1743,1744],{},"acme-corp/engineering: Owner (from \"Engineering-Leads\" mapping)",[44,1746,1747],{},"acme-corp/engineering/backend: Owner (inherited from parent, which is higher than Developer)",[33,1749,1751],{"id":1750},"how-the-synchronization-works","How the synchronization works",[12,1753,1754],{},"Understanding the mechanics of SAML group synchronization helps you manage the system effectively.",[141,1756,1758],{"id":1757},"synchronization-timing","Synchronization timing",[41,1760,1761,1771,1777,1787,1793],{},[44,1762,1763,1766,1767,1770],{},[21,1764,1765],{},"When sync occurs",": Group memberships update ",[21,1768,1769],{},"every time"," a user signs in via SAML.",[44,1772,1773,1776],{},[21,1774,1775],{},"Frequency",": Changes are not continuous — they only happen at login.",[44,1778,1779,1782,1783,1786],{},[21,1780,1781],{},"Direction",": Synchronization is ",[21,1784,1785],{},"one-way"," from Google Workspace to GitLab.",[44,1788,1789,1792],{},[21,1790,1791],{},"First login",": User account is created automatically and groups are assigned.",[44,1794,1795,1798],{},[21,1796,1797],{},"Subsequent logins",": Existing group memberships are updated to match current Google groups.",[141,1800,1802],{"id":1801},"role-priority-and-combination","Role priority and combination",[12,1804,1805],{},"When a user belongs to multiple Google Workspace groups:",[41,1807,1808,1815,1821],{},[44,1809,1810,1811,1814],{},"GitLab evaluates ",[21,1812,1813],{},"all"," the user's groups at each level of the hierarchy.",[44,1816,1817,1818,1820],{},"The user receives the ",[21,1819,1690],{}," from any of their groups.",[44,1822,1823],{},"This calculation happens independently at each level (top-level group, subgroups, etc.).",[12,1825,1826,902],{},[21,1827,1828],{},"Example",[41,1830,1831],{},[44,1832,1833,1834],{},"User in \"Developers\" (Developer role) + \"Tech-Leads\" (Maintainer role) → Gets ",[21,1835,1168],{},[141,1837,1839],{"id":1838},"automatic-role-changes","Automatic role changes",[12,1841,1842],{},"The system automatically handles membership changes:",[41,1844,1845,1851,1857,1863],{},[44,1846,1847,1850],{},[21,1848,1849],{},"User added to a Google group",": Role upgraded on next login.",[44,1852,1853,1856],{},[21,1854,1855],{},"User removed from a Google group",": Role recalculated based on remaining groups on next login.",[44,1858,1859,1862],{},[21,1860,1861],{},"User removed from all mapped groups",": Reverts to default membership role on next login.",[44,1864,1865,1868],{},[21,1866,1867],{},"User added to additional groups",": Gets highest role from all groups on next login.",[141,1870,1872],{"id":1871},"propagation-timing","Propagation timing",[12,1874,1875],{},"Be aware of these timing considerations:",[41,1877,1878,1884,1890],{},[44,1879,1880,1883],{},[21,1881,1882],{},"Google Workspace changes",": Can take up to 24 hours to propagate, though usually take only a few minutes.",[44,1885,1886,1889],{},[21,1887,1888],{},"GitLab sync",": Happens immediately when the user logs in after Google changes are live.",[44,1891,1892,1895],{},[21,1893,1894],{},"Testing",": Have users log out and log back in to test permission changes.",[33,1897,1899],{"id":1898},"understanding-user-lifecycle-and-edge-cases","Understanding user lifecycle and edge cases",[141,1901,1903],{"id":1902},"what-happens-when-you-remove-a-user-from-gitlab","What happens when you remove a user from GitLab?",[12,1905,1906,1909],{},[21,1907,1908],{},"Removing permissions only:"," If you remove a user from GitLab projects but leave their account active and they're still in the authorized Google groups:",[41,1911,1912,1915,1918],{},[44,1913,1914],{},"They keep their same account (same user ID and username)",[44,1916,1917],{},"When they log in via SAML, their group memberships are automatically restored",[44,1919,1920],{},"They regain permissions based on their current Google group memberships",[12,1922,1923],{},[21,1924,1925],{},"Blocking the account:",[41,1927,1928,1931,1934],{},[44,1929,1930],{},"Account exists but is locked",[44,1932,1933],{},"User cannot log in even if in Google groups",[44,1935,1936],{},"Can be unblocked later, preserving all history",[12,1938,1939],{},[21,1940,1941],{},"Deleting the account:",[41,1943,1944,1947,1953],{},[44,1945,1946],{},"Account is permanently removed",[44,1948,1949,1950],{},"If user logs in again (while still in Google groups), GitLab creates a ",[21,1951,1952],{},"completely new account",[44,1954,1955],{},"New account has different user ID with no connection to the old one",[141,1957,1959],{"id":1958},"proper-offboarding-process","Proper offboarding process",[12,1961,1962],{},"To permanently revoke access, follow this order:",[73,1964,1965,1971,1977],{},[44,1966,1967,1970],{},[21,1968,1969],{},"Remove from Google Workspace groups"," - Prevents authentication",[44,1972,1973,1976],{},[21,1974,1975],{},"Block in GitLab"," - Prevents account recreation and preserves audit trails",[44,1978,1979,1982],{},[21,1980,1981],{},"Delete account (optional)"," - Only if you're certain they won't return",[613,1984,1985],{},[12,1986,1987,1989],{},[21,1988,619],{},": Removing a user only from GitLab without removing them from Google groups means they can simply log back in and regain access.",[141,1991,1993],{"id":1992},"google-group-membership-propagation","Google group membership propagation",[12,1995,1996,1997,2002],{},"According to ",[26,1998,2001],{"href":1999,"rel":2000},"https://support.google.com/a/answer/11143403",[],"Google's documentation",", group membership changes can take up to 24 hours to propagate, though typically occur within minutes.",[141,2004,2006],{"id":2005},"account-recreation-scenarios","Account recreation scenarios",[363,2008,2009,2028],{},[366,2010,2011],{},[369,2012,2013,2018,2023],{},[372,2014,2015],{},[21,2016,2017],{},"Scenario",[372,2019,2020],{},[21,2021,2022],{},"User still in Google groups?",[372,2024,2025],{},[21,2026,2027],{},"What happens on login",[388,2029,2030,2041,2051,2061],{},[369,2031,2032,2035,2038],{},[393,2033,2034],{},"Permissions removed",[393,2036,2037],{},"Yes",[393,2039,2040],{},"Same account, group memberships restored",[369,2042,2043,2046,2048],{},[393,2044,2045],{},"Account blocked",[393,2047,2037],{},[393,2049,2050],{},"Login fails",[369,2052,2053,2056,2058],{},[393,2054,2055],{},"Account deleted",[393,2057,2037],{},[393,2059,2060],{},"New account created with new user ID",[369,2062,2063,2066,2069],{},[393,2064,2065],{},"Removed from Google groups",[393,2067,2068],{},"No",[393,2070,2071],{},"Login fails at Google",[33,2073,2075],{"id":2074},"troubleshooting-common-issues","Troubleshooting common issues",[12,2077,2078],{},"Even with careful configuration, you might encounter issues. Here are solutions to the most common problems.",[141,2080,2082],{"id":2081},"users-not-being-added-to-groups","Users not being added to groups",[12,2084,2085,2088],{},[21,2086,2087],{},"Symptom",": User successfully logs in via SAML but doesn't appear in any GitLab groups, or appears with only the default role.",[12,2090,2091,902],{},[21,2092,2093],{},"Possible causes and solutions",[73,2095,2096,2112,2129,2148],{},[44,2097,2098,2101],{},[21,2099,2100],{},"Group names don't match exactly",[41,2102,2103,2106,2109],{},[44,2104,2105],{},"Check spelling and capitalization in both Google Workspace and GitLab",[44,2107,2108],{},"Look for extra spaces before or after group names",[44,2110,2111],{},"Verify the exact name in Google Admin Console > Directory > Groups",[44,2113,2114,2117],{},[21,2115,2116],{},"User not actually in the Google group",[41,2118,2119,2126],{},[44,2120,2121,2122,2125],{},"Verify membership: Google Admin Console > Directory > Groups > ",[820,2123,2124],{},"Group"," > Members",[44,2127,2128],{},"Remember that nested group membership might not be included",[44,2130,2131,2134],{},[21,2132,2133],{},"Groups not configured in SAML app",[41,2135,2136,2139,2145],{},[44,2137,2138],{},"Verify the groups are selected in Google SAML attribute mapping",[44,2140,2141,2142,2144],{},"Confirm \"App attribute\" is set to ",[187,2143,596],{}," (lowercase)",[44,2146,2147],{},"Use \"Test SAML Login\" to inspect the SAML response",[44,2149,2150,2153],{},[21,2151,2152],{},"Timing or cache issue",[41,2154,2155,2158,2161,2164],{},[44,2156,2157],{},"Wait 24 hours for Google changes to fully propagate",[44,2159,2160],{},"Have the user log out of GitLab and Google completely",[44,2162,2163],{},"Clear browser cache and try again",[44,2165,2166],{},"User must log in via the SAML SSO URL, not regular GitLab login",[141,2168,2170],{"id":2169},"user-has-incorrect-role","User has incorrect role",[12,2172,2173,2175],{},[21,2174,2087],{},": User has access but with the wrong permission level.",[12,2177,2178,902],{},[21,2179,2093],{},[73,2181,2182,2202,2215,2228],{},[44,2183,2184,2187],{},[21,2185,2186],{},"User belongs to multiple groups",[41,2188,2189,2196,2199],{},[44,2190,2191,2192,2195],{},"Remember: Users get the ",[21,2193,2194],{},"highest"," role from all their groups",[44,2197,2198],{},"Check all Google groups the user belongs to",[44,2200,2201],{},"Review all SAML Group Link configurations at all levels",[44,2203,2204,2207],{},[21,2205,2206],{},"SAML Group Link misconfigured",[41,2208,2209,2212],{},[44,2210,2211],{},"Verify the Access Level setting in Settings > SAML Group Links",[44,2213,2214],{},"Check for duplicate group mappings that might conflict",[44,2216,2217,2220],{},[21,2218,2219],{},"User hasn't logged in since changes",[41,2221,2222,2225],{},[44,2223,2224],{},"Roles only update when users log in via SAML",[44,2226,2227],{},"Have the user log out completely and log back in via the SSO URL",[44,2229,2230,2233],{},[21,2231,2232],{},"Inherited permissions from parent groups",[41,2234,2235,2238],{},[44,2236,2237],{},"Check SAML Group Links in parent groups",[44,2239,2240],{},"Remember that higher roles at parent levels flow down to children",[141,2242,2244],{"id":2243},"saml-authentication-fails-completely","SAML authentication fails completely",[12,2246,2247,2249],{},[21,2248,2087],{},": Users cannot log in at all, or receive error messages during authentication.",[12,2251,2252,902],{},[21,2253,2093],{},[73,2255,2256,2272,2285,2298,2314],{},[44,2257,2258,2261],{},[21,2259,2260],{},"Incorrect certificate fingerprint",[41,2262,2263,2266,2269],{},[44,2264,2265],{},"Verify you used SHA-1 format, not SHA-256",[44,2267,2268],{},"Check the fingerprint has the correct format with colons",[44,2270,2271],{},"Regenerate using the online tool or OpenSSL command",[44,2273,2274,2277],{},[21,2275,2276],{},"Wrong SSO URL",[41,2278,2279,2282],{},[44,2280,2281],{},"Double-check the SSO URL copied from Google",[44,2283,2284],{},"Ensure there are no extra spaces or characters",[44,2286,2287,2290],{},[21,2288,2289],{},"ACS URL or Entity ID mismatch",[41,2291,2292,2295],{},[44,2293,2294],{},"Verify the ACS URL in Google Admin Console matches GitLab exactly",[44,2296,2297],{},"Confirm the Entity ID matches between both systems",[44,2299,2300,2303],{},[21,2301,2302],{},"User doesn't have app access",[41,2304,2305,2308,2311],{},[44,2306,2307],{},"Check User Access settings in Google Admin Console",[44,2309,2310],{},"Verify the user's organizational unit has the app enabled",[44,2312,2313],{},"Confirm the app is \"ON\" for the appropriate users",[44,2315,2316,2319],{},[21,2317,2318],{},"Certificate expired",[41,2320,2321,2324],{},[44,2322,2323],{},"Check certificate validity dates",[44,2325,2326],{},"Download a fresh certificate if needed",[141,2328,2330],{"id":2329},"groups-attribute-missing-from-saml-response","Groups attribute missing from SAML response",[12,2332,2333,2335],{},[21,2334,2087],{},": Users can log in but group synchronization doesn't work at all.",[12,2337,2338,902],{},[21,2339,2093],{},[73,2341,2342,2364,2377,2390],{},[44,2343,2344,2347],{},[21,2345,2346],{},"Groups not selected in Google configuration",[41,2348,2349,2356,2359],{},[44,2350,2351,2352,2355],{},"Return to ",[21,2353,2354],{},"Google Admin > Apps > GitLab > Attribute"," mapping",[44,2357,2358],{},"Verify groups are selected under \"Group membership\"",[44,2360,2361,2362,2144],{},"Confirm \"App attribute\" is exactly ",[187,2363,596],{},[44,2365,2366,2369],{},[21,2367,2368],{},"User not in any configured groups",[41,2370,2371,2374],{},[44,2372,2373],{},"Only groups the user belongs to are sent in the SAML response",[44,2375,2376],{},"Add the user to at least one selected group to test",[44,2378,2379,2382],{},[21,2380,2381],{},"Configuration hasn't propagated",[41,2383,2384,2387],{},[44,2385,2386],{},"Wait up to 24 hours for changes to take effect",[44,2388,2389],{},"Try logging out of Google Admin Console and back in",[44,2391,2392,2395],{},[21,2393,2394],{},"Typo in app attribute name",[41,2396,2397,2402],{},[44,2398,2399,2400,2144],{},"The attribute name must be exactly ",[187,2401,596],{},[44,2403,2404],{},"Even a capital letter or extra space will break functionality",[33,2406,2408],{"id":2407},"best-practices-for-managing-saml-group-sync","Best practices for managing SAML group sync",[12,2410,2411],{},"Follow these recommendations to maintain a secure and efficient setup.",[141,2413,2415],{"id":2414},"security-best-practices","Security best practices",[73,2417,2418,2434,2450,2466],{},[44,2419,2420,2423],{},[21,2421,2422],{},"Maintain emergency access",[41,2424,2425,2428,2431],{},[44,2426,2427],{},"Keep at least one Owner account that uses password authentication (not SAML)",[44,2429,2430],{},"This provides emergency access if SAML configuration breaks",[44,2432,2433],{},"Store these credentials securely",[44,2435,2436,2439],{},[21,2437,2438],{},"Use least privilege principle",[41,2440,2441,2444,2447],{},[44,2442,2443],{},"Set default membership to Minimal Access",[44,2445,2446],{},"Only grant higher permissions through explicit group mappings",[44,2448,2449],{},"Regularly review and audit group memberships",[44,2451,2452,2455],{},[21,2453,2454],{},"Enable enforcement options",[41,2456,2457,2460,2463],{},[44,2458,2459],{},"Turn on \"Enforce SAML authentication\" options",[44,2461,2462],{},"This prevents users from bypassing SSO",[44,2464,2465],{},"Exceptions should be rare and well-documented",[44,2467,2468,2471],{},[21,2469,2470],{},"Regular security audits",[41,2472,2473,2476,2479],{},[44,2474,2475],{},"Quarterly review of Google Workspace group memberships",[44,2477,2478],{},"Annual review of SAML Group Link mappings",[44,2480,2481],{},"Monitor GitLab audit logs for unusual access patterns",[33,2483,2485],{"id":2484},"summary-and-next-steps","Summary and next steps",[12,2487,2488],{},"Congratulations! You've successfully configured SAML SSO and automatic group synchronization between Google Workspace and GitLab. Your setup now provides:",[41,2490,2491,2497,2502,2507,2512,2517],{},[44,2492,2493,2496],{},[21,2494,2495],{},"Seamless authentication"," - Users sign in with their familiar Google Workspace credentials.",[44,2498,2499,2501],{},[21,2500,91],{}," - User accounts are created on first login without manual intervention.",[44,2503,2504,2506],{},[21,2505,119],{}," - Group memberships and roles update automatically based on Google Workspace groups.",[44,2508,2509,2511],{},[21,2510,108],{}," - Manage all access through your existing Google Workspace groups.",[44,2513,2514,2516],{},[21,2515,125],{}," - Leverage Google's authentication infrastructure and enforce consistent policies.",[44,2518,2519,2521],{},[21,2520,131],{}," - Eliminate manual user and permission management in GitLab.",[141,2523,2525],{"id":2524},"what-happens-now","What happens now",[12,2527,2528],{},"When users access GitLab:",[73,2530,2531,2534,2537,2540,2543],{},[44,2532,2533],{},"They navigate to your GitLab SSO URL.",[44,2535,2536],{},"Authenticate using their Google Workspace credentials.",[44,2538,2539],{},"Get automatically added to appropriate GitLab groups.",[44,2541,2542],{},"Receive permissions based on their Google group memberships.",[44,2544,2545],{},"Their permissions update every time they sign in.",[141,2547,2549],{"id":2548},"additional-resources","Additional resources",[41,2551,2552,2559,2566,2573],{},[44,2553,2554],{},[26,2555,2558],{"href":2556,"rel":2557},"https://docs.gitlab.com/user/group/saml_sso/",[],"GitLab SAML SSO Documentation",[44,2560,2561],{},[26,2562,2565],{"href":2563,"rel":2564},"https://docs.gitlab.com/user/group/saml_sso/group_sync/",[],"GitLab SAML Group Sync Documentation",[44,2567,2568],{},[26,2569,2572],{"href":2570,"rel":2571},"https://support.google.com/a/answer/6087519",[],"Google Workspace SAML App Setup",[44,2574,2575],{},[26,2576,2578],{"href":770,"rel":2577},[],"SAML Certificate Fingerprint Tool",[33,2580,2582],{"id":2581},"related-article","Related article",[41,2584,2585],{},[44,2586,2587],{},[26,2588,2591],{"href":2589,"rel":2590},"https://about.gitlab.com/blog/how-to-gitlab-single-sign-on-with-saml-scim-and-azures-entra-id/",[],"How-to: GitLab Single Sign-on with SAML, SCIM, and Azure's Entra ID",[2593,2594,2595],"style",{},"html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}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);}",{"title":756,"searchDepth":834,"depth":834,"links":2597},[2598,2599,2600,2610,2613,2618,2623,2627,2634,2640,2646,2652,2655,2659],{"id":35,"depth":834,"text":36},{"id":67,"depth":834,"text":68},{"id":135,"depth":834,"text":136,"children":2601},[2602,2603,2604,2605,2606,2607,2608,2609],{"id":143,"depth":1178,"text":144},{"id":168,"depth":1178,"text":169},{"id":236,"depth":1178,"text":237},{"id":280,"depth":1178,"text":281},{"id":305,"depth":1178,"text":306},{"id":357,"depth":1178,"text":358},{"id":492,"depth":1178,"text":493},{"id":630,"depth":1178,"text":631},{"id":683,"depth":834,"text":684,"children":2611},[2612],{"id":690,"depth":1178,"text":691},{"id":880,"depth":834,"text":881,"children":2614},[2615,2616,2617],{"id":887,"depth":1178,"text":888},{"id":943,"depth":1178,"text":944},{"id":978,"depth":1178,"text":979},{"id":1034,"depth":834,"text":1035,"children":2619},[2620,2621,2622],{"id":1041,"depth":1178,"text":1042},{"id":1085,"depth":1178,"text":1086},{"id":1309,"depth":1178,"text":1310},{"id":1337,"depth":834,"text":1338,"children":2624},[2625,2626],{"id":1344,"depth":1178,"text":1345},{"id":1409,"depth":1178,"text":1410},{"id":1461,"depth":834,"text":1462,"children":2628},[2629,2630,2631,2632,2633],{"id":1468,"depth":1178,"text":1469},{"id":1481,"depth":1178,"text":1482},{"id":1533,"depth":1178,"text":1534},{"id":1625,"depth":1178,"text":1626},{"id":1675,"depth":1178,"text":1676},{"id":1750,"depth":834,"text":1751,"children":2635},[2636,2637,2638,2639],{"id":1757,"depth":1178,"text":1758},{"id":1801,"depth":1178,"text":1802},{"id":1838,"depth":1178,"text":1839},{"id":1871,"depth":1178,"text":1872},{"id":1898,"depth":834,"text":1899,"children":2641},[2642,2643,2644,2645],{"id":1902,"depth":1178,"text":1903},{"id":1958,"depth":1178,"text":1959},{"id":1992,"depth":1178,"text":1993},{"id":2005,"depth":1178,"text":2006},{"id":2074,"depth":834,"text":2075,"children":2647},[2648,2649,2650,2651],{"id":2081,"depth":1178,"text":2082},{"id":2169,"depth":1178,"text":2170},{"id":2243,"depth":1178,"text":2244},{"id":2329,"depth":1178,"text":2330},{"id":2407,"depth":834,"text":2408,"children":2653},[2654],{"id":2414,"depth":1178,"text":2415},{"id":2484,"depth":834,"text":2485,"children":2656},[2657,2658],{"id":2524,"depth":1178,"text":2525},{"id":2548,"depth":1178,"text":2549},{"id":2581,"depth":834,"text":2582},"security","2026-01-27","Learn how to automate user provisioning and sync permissions with Google groups with this step-by-step guide.","md",null,true,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1759320418/xjmqcozxzt4frx0hori3.png",{},"/en-us/blog/how-to-set-up-gitlab-saml-sso-with-google-workspace",{"config":2670,"title":5,"description":2662},{"noIndex":2671},false,"how-to-set-up-gitlab-saml-sso-with-google-workspace","en-us/blog/how-to-set-up-gitlab-saml-sso-with-google-workspace",[2660,2675,2676,2677],"tutorial","product","google","BlogPost","wYtIxe8eYxRSpwaAd3kzEUUh4bKSpcPAiKXOg7UHM48",{"logo":2681,"freeTrial":2686,"sales":2691,"login":2696,"items":2700,"search":3027,"minimal":3058,"duo":3077,"switchNav":3086,"pricingDeployment":3097},{"config":2682},{"href":2683,"dataGaName":2684,"dataGaLocation":2685},"/","gitlab logo","header",{"text":2687,"config":2688},"Get free trial",{"href":2689,"dataGaName":2690,"dataGaLocation":2685},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":2692,"config":2693},"Request a demo",{"href":2694,"dataGaName":2695,"dataGaLocation":2685},"/sales/?contact-topic=request-demo","sales",{"text":1388,"config":2697},{"href":2698,"dataGaName":2699,"dataGaLocation":2685},"https://gitlab.com/users/sign_in/","sign in",[2701,2730,2830,2835,2949,3005],{"text":2702,"config":2703,"menu":2705},"Platform",{"dataNavLevelOne":2704},"platform",{"type":2706,"columns":2707},"cards",[2708,2714,2722],{"title":2702,"description":2709,"link":2710},"The intelligent orchestration platform for DevSecOps",{"text":2711,"config":2712},"Explore our Platform",{"href":2713,"dataGaName":2704,"dataGaLocation":2685},"/platform/",{"title":2715,"description":2716,"link":2717},"GitLab Duo Agent Platform","Agentic AI for the entire software lifecycle",{"text":2718,"config":2719},"Meet GitLab Duo",{"href":2720,"dataGaName":2721,"dataGaLocation":2685},"/gitlab-duo-agent-platform/","gitlab duo agent platform",{"title":2723,"description":2724,"link":2725},"Why GitLab","See the top reasons enterprises choose GitLab",{"text":2726,"config":2727},"Learn more",{"href":2728,"dataGaName":2729,"dataGaLocation":2685},"/why-gitlab/","why gitlab",{"text":2731,"left":2665,"config":2732,"menu":2734},"Product",{"dataNavLevelOne":2733},"solutions",{"type":2735,"link":2736,"columns":2740,"feature":2809},"lists",{"text":2737,"config":2738},"View all Solutions",{"href":2739,"dataGaName":2733,"dataGaLocation":2685},"/solutions/",[2741,2765,2788],{"title":2742,"description":2743,"link":2744,"items":2749},"Automation","CI/CD and automation to accelerate deployment",{"config":2745},{"icon":2746,"href":2747,"dataGaName":2748,"dataGaLocation":2685},"AutomatedCodeAlt","/solutions/delivery-automation/","automated software delivery",[2750,2754,2757,2761],{"text":2751,"config":2752},"CI/CD",{"href":2753,"dataGaLocation":2685,"dataGaName":2751},"/solutions/continuous-integration/",{"text":2715,"config":2755},{"href":2720,"dataGaLocation":2685,"dataGaName":2756},"gitlab duo agent platform - product menu",{"text":2758,"config":2759},"Source Code Management",{"href":2760,"dataGaLocation":2685,"dataGaName":2758},"/solutions/source-code-management/",{"text":2762,"config":2763},"Automated Software Delivery",{"href":2747,"dataGaLocation":2685,"dataGaName":2764},"Automated software delivery",{"title":2766,"description":2767,"link":2768,"items":2773},"Security","Deliver code faster without compromising security",{"config":2769},{"href":2770,"dataGaName":2771,"dataGaLocation":2685,"icon":2772},"/solutions/application-security-testing/","security and compliance","ShieldCheckLight",[2774,2778,2783],{"text":2775,"config":2776},"Application Security Testing",{"href":2770,"dataGaName":2777,"dataGaLocation":2685},"Application security testing",{"text":2779,"config":2780},"Software Supply Chain Security",{"href":2781,"dataGaLocation":2685,"dataGaName":2782},"/solutions/supply-chain/","Software supply chain security",{"text":2784,"config":2785},"Software Compliance",{"href":2786,"dataGaName":2787,"dataGaLocation":2685},"/solutions/software-compliance/","software compliance",{"title":2789,"link":2790,"items":2795},"Measurement",{"config":2791},{"icon":2792,"href":2793,"dataGaName":2794,"dataGaLocation":2685},"DigitalTransformation","/solutions/visibility-measurement/","visibility and measurement",[2796,2800,2804],{"text":2797,"config":2798},"Visibility & Measurement",{"href":2793,"dataGaLocation":2685,"dataGaName":2799},"Visibility and Measurement",{"text":2801,"config":2802},"Value Stream Management",{"href":2803,"dataGaLocation":2685,"dataGaName":2801},"/solutions/value-stream-management/",{"text":2805,"config":2806},"Analytics & Insights",{"href":2807,"dataGaLocation":2685,"dataGaName":2808},"/solutions/analytics-and-insights/","Analytics and insights",{"title":2810,"type":2735,"items":2811},"GitLab for",[2812,2818,2824],{"text":2813,"config":2814},"Enterprise",{"icon":2815,"href":2816,"dataGaLocation":2685,"dataGaName":2817},"Building","/enterprise/","enterprise",{"text":2819,"config":2820},"Small Business",{"icon":2821,"href":2822,"dataGaLocation":2685,"dataGaName":2823},"Work","/small-business/","small business",{"text":2825,"config":2826},"Public Sector",{"icon":2827,"href":2828,"dataGaLocation":2685,"dataGaName":2829},"Organization","/solutions/public-sector/","public sector",{"text":2831,"config":2832},"Pricing",{"href":2833,"dataGaName":2834,"dataGaLocation":2685,"dataNavLevelOne":2834},"/pricing/","pricing",{"text":2836,"config":2837,"menu":2839},"Resources",{"dataNavLevelOne":2838},"resources",{"type":2735,"link":2840,"columns":2844,"feature":2938},{"text":2841,"config":2842},"View all resources",{"href":2843,"dataGaName":2838,"dataGaLocation":2685},"/resources/",[2845,2878,2905],{"title":2846,"items":2847},"Getting started",[2848,2853,2858,2863,2868,2873],{"text":2849,"config":2850},"Install",{"href":2851,"dataGaName":2852,"dataGaLocation":2685},"/install/","install",{"text":2854,"config":2855},"Quick start guides",{"href":2856,"dataGaName":2857,"dataGaLocation":2685},"/get-started/","quick setup checklists",{"text":2859,"config":2860},"Learn",{"href":2861,"dataGaLocation":2685,"dataGaName":2862},"https://university.gitlab.com/","learn",{"text":2864,"config":2865},"Product documentation",{"href":2866,"dataGaName":2867,"dataGaLocation":2685},"https://docs.gitlab.com/","product documentation",{"text":2869,"config":2870},"Best practice videos",{"href":2871,"dataGaName":2872,"dataGaLocation":2685},"/getting-started-videos/","best practice videos",{"text":2874,"config":2875},"Integrations",{"href":2876,"dataGaName":2877,"dataGaLocation":2685},"/integrations/","integrations",{"title":2879,"items":2880},"Discover",[2881,2886,2891,2896,2900],{"text":2882,"config":2883},"Customer success stories",{"href":2884,"dataGaName":2885,"dataGaLocation":2685},"/customers/","customer success stories",{"text":2887,"config":2888},"Blog",{"href":2889,"dataGaName":2890,"dataGaLocation":2685},"/blog/","blog",{"text":2892,"config":2893},"Demo Hub",{"href":2894,"dataGaName":2895,"dataGaLocation":2685},"/demo-hub/","demo hub",{"text":2897,"config":2898},"The Source",{"href":2899,"dataGaName":2890,"dataGaLocation":2685},"/the-source/",{"text":2901,"config":2902},"Remote",{"href":2903,"dataGaName":2904,"dataGaLocation":2685},"https://handbook.gitlab.com/handbook/company/culture/all-remote/","remote",{"title":2906,"items":2907},"Connect",[2908,2913,2918,2923,2928,2933],{"text":2909,"config":2910},"GitLab Services",{"href":2911,"dataGaName":2912,"dataGaLocation":2685},"/services/","services",{"text":2914,"config":2915},"Contribute",{"href":2916,"dataGaName":2917,"dataGaLocation":2685},"https://contributors.gitlab.com","contribute",{"text":2919,"config":2920},"Community",{"href":2921,"dataGaName":2922,"dataGaLocation":2685},"/community/","community",{"text":2924,"config":2925},"Forum",{"href":2926,"dataGaName":2927,"dataGaLocation":2685},"https://forum.gitlab.com/","forum",{"text":2929,"config":2930},"Events",{"href":2931,"dataGaName":2932,"dataGaLocation":2685},"/events/","events",{"text":2934,"config":2935},"Partners",{"href":2936,"dataGaName":2937,"dataGaLocation":2685},"/partners/","partners",{"config":2939,"title":2942,"text":2943,"link":2944},{"background":2940,"textColor":2941},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1777322348/qpq8yrgn8knii57omj0c.png')","#000","What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":2945,"config":2946},"Read the latest",{"href":2947,"dataGaName":2948,"dataGaLocation":2685},"/whats-new/","whats new",{"text":2950,"config":2951,"menu":2953},"Company",{"dataNavLevelOne":2952},"company",{"type":2735,"columns":2954},[2955],{"items":2956},[2957,2962,2968,2970,2975,2980,2985,2990,2995,3000],{"text":2958,"config":2959},"About",{"href":2960,"dataGaName":2961,"dataGaLocation":2685},"/company/","about",{"text":2963,"config":2964,"footerGa":2967},"Jobs",{"href":2965,"dataGaName":2966,"dataGaLocation":2685},"/jobs/","jobs",{"dataGaName":2966},{"text":2929,"config":2969},{"href":2931,"dataGaName":2932,"dataGaLocation":2685},{"text":2971,"config":2972},"Leadership",{"href":2973,"dataGaName":2974,"dataGaLocation":2685},"/company/team/e-group/","leadership",{"text":2976,"config":2977},"Handbook",{"href":2978,"dataGaName":2979,"dataGaLocation":2685},"https://handbook.gitlab.com/","handbook",{"text":2981,"config":2982},"Investor relations",{"href":2983,"dataGaName":2984,"dataGaLocation":2685},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":2986,"config":2987},"Trust Center",{"href":2988,"dataGaName":2989,"dataGaLocation":2685},"/security/","trust center",{"text":2991,"config":2992},"AI Transparency Center",{"href":2993,"dataGaName":2994,"dataGaLocation":2685},"/ai-transparency-center/","ai transparency center",{"text":2996,"config":2997},"Newsletter",{"href":2998,"dataGaName":2999,"dataGaLocation":2685},"/company/contact/#contact-forms","newsletter",{"text":3001,"config":3002},"Press",{"href":3003,"dataGaName":3004,"dataGaLocation":2685},"/press/","press",{"text":3006,"config":3007,"menu":3008},"Contact us",{"dataNavLevelOne":2952},{"type":2735,"columns":3009},[3010],{"items":3011},[3012,3017,3022],{"text":3013,"config":3014},"Talk to sales",{"href":3015,"dataGaName":3016,"dataGaLocation":2685},"/sales/","talk to sales",{"text":3018,"config":3019},"Support portal",{"href":3020,"dataGaName":3021,"dataGaLocation":2685},"https://support.gitlab.com/hc/en-us","support portal",{"text":3023,"config":3024},"Customer portal",{"href":3025,"dataGaName":3026,"dataGaLocation":2685},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":3028,"login":3029,"suggestions":3036},"Close",{"text":3030,"link":3031},"To search repositories and projects, login to",{"text":3032,"config":3033},"gitlab.com",{"href":2698,"dataGaName":3034,"dataGaLocation":3035},"search login","search",{"text":3037,"default":3038},"Suggestions",[3039,3041,3045,3047,3051,3055],{"text":2715,"config":3040},{"href":2720,"dataGaName":2715,"dataGaLocation":3035},{"text":3042,"config":3043},"Code Suggestions (AI)",{"href":3044,"dataGaName":3042,"dataGaLocation":3035},"/solutions/code-suggestions/",{"text":2751,"config":3046},{"href":2753,"dataGaName":2751,"dataGaLocation":3035},{"text":3048,"config":3049},"GitLab on AWS",{"href":3050,"dataGaName":3048,"dataGaLocation":3035},"/partners/technology-partners/aws/",{"text":3052,"config":3053},"GitLab on Google Cloud",{"href":3054,"dataGaName":3052,"dataGaLocation":3035},"/partners/technology-partners/google-cloud-platform/",{"text":3056,"config":3057},"Why GitLab?",{"href":2728,"dataGaName":3056,"dataGaLocation":3035},{"freeTrial":3059,"mobileIcon":3064,"desktopIcon":3069,"secondaryButton":3072},{"text":3060,"config":3061},"Start free trial",{"href":3062,"dataGaName":2690,"dataGaLocation":3063},"https://gitlab.com/-/trials/new/","nav",{"altText":3065,"config":3066},"Gitlab Icon",{"src":3067,"dataGaName":3068,"dataGaLocation":3063},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":3065,"config":3070},{"src":3071,"dataGaName":3068,"dataGaLocation":3063},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":3073,"config":3074},"Get Started",{"href":3075,"dataGaName":3076,"dataGaLocation":3063},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":3078,"mobileIcon":3082,"desktopIcon":3084},{"text":3079,"config":3080},"Learn more about GitLab Duo",{"href":2720,"dataGaName":3081,"dataGaLocation":3063},"gitlab duo",{"altText":3065,"config":3083},{"src":3067,"dataGaName":3068,"dataGaLocation":3063},{"altText":3065,"config":3085},{"src":3071,"dataGaName":3068,"dataGaLocation":3063},{"button":3087,"mobileIcon":3092,"desktopIcon":3094},{"text":3088,"config":3089},"/switch",{"href":3090,"dataGaName":3091,"dataGaLocation":3063},"#contact","switch",{"altText":3065,"config":3093},{"src":3067,"dataGaName":3068,"dataGaLocation":3063},{"altText":3065,"config":3095},{"src":3096,"dataGaName":3068,"dataGaLocation":3063},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":3098,"mobileIcon":3103,"desktopIcon":3105},{"text":3099,"config":3100},"Back to pricing",{"href":2833,"dataGaName":3101,"dataGaLocation":3063,"icon":3102},"back to pricing","GoBack",{"altText":3065,"config":3104},{"src":3067,"dataGaName":3068,"dataGaLocation":3063},{"altText":3065,"config":3106},{"src":3071,"dataGaName":3068,"dataGaLocation":3063},{"title":3108,"titleMobile":3109,"button":3110,"config":3115},"Duo Agent Platform delivers 400% ROI, per new Forrester Consulting study.","400% ROI: Forrester TEI for GitLab Duo",{"text":2726,"config":3111},{"href":3112,"dataGaName":3113,"dataGaLocation":3114},"https://about.gitlab.com/blog/gitlab-duo-agent-platform-delivers-400-percent-roi/","forrester-tei-dap-banner","global-banner",{"layout":3116,"disabled":2671},"release",{"data":3118},{"text":3119,"source":3120,"edit":3126,"contribute":3131,"config":3136,"items":3141,"minimal":3351},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"text":3121,"config":3122},"View page source",{"href":3123,"dataGaName":3124,"dataGaLocation":3125},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/","page source","footer",{"text":3127,"config":3128},"Edit this page",{"href":3129,"dataGaName":3130,"dataGaLocation":3125},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/content/","web ide",{"text":3132,"config":3133},"Please contribute",{"href":3134,"dataGaName":3135,"dataGaLocation":3125},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/CONTRIBUTING.md/","please contribute",{"twitter":3137,"facebook":3138,"youtube":3139,"linkedin":3140},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[3142,3189,3243,3287,3319],{"title":2831,"links":3143,"subMenu":3158},[3144,3148,3153],{"text":3145,"config":3146},"View plans",{"href":2833,"dataGaName":3147,"dataGaLocation":3125},"view plans",{"text":3149,"config":3150},"Why Premium?",{"href":3151,"dataGaName":3152,"dataGaLocation":3125},"/pricing/premium/","why premium",{"text":3154,"config":3155},"Why Ultimate?",{"href":3156,"dataGaName":3157,"dataGaLocation":3125},"/pricing/ultimate/","why ultimate",[3159],{"title":3160,"links":3161},"Contact Us",[3162,3165,3167,3169,3174,3179,3184],{"text":3163,"config":3164},"Contact sales",{"href":3015,"dataGaName":2695,"dataGaLocation":3125},{"text":3018,"config":3166},{"href":3020,"dataGaName":3021,"dataGaLocation":3125},{"text":3023,"config":3168},{"href":3025,"dataGaName":3026,"dataGaLocation":3125},{"text":3170,"config":3171},"Status",{"href":3172,"dataGaName":3173,"dataGaLocation":3125},"https://status.gitlab.com/","status",{"text":3175,"config":3176},"Terms of use",{"href":3177,"dataGaName":3178,"dataGaLocation":3125},"/terms/","terms of use",{"text":3180,"config":3181},"Privacy statement",{"href":3182,"dataGaName":3183,"dataGaLocation":3125},"/privacy/","privacy statement",{"text":3185,"config":3186},"Cookie preferences",{"dataGaName":3187,"dataGaLocation":3125,"id":3188,"isOneTrustButton":2665},"cookie preferences","ot-sdk-btn",{"title":2731,"links":3190,"subMenu":3199},[3191,3195],{"text":3192,"config":3193},"DevSecOps platform",{"href":2713,"dataGaName":3194,"dataGaLocation":3125},"devsecops platform",{"text":3196,"config":3197},"AI-Assisted Development",{"href":2720,"dataGaName":3198,"dataGaLocation":3125},"ai-assisted development",[3200],{"title":3201,"links":3202},"Topics",[3203,3208,3213,3218,3223,3228,3233,3238],{"text":3204,"config":3205},"CICD",{"href":3206,"dataGaName":3207,"dataGaLocation":3125},"/topics/ci-cd/","cicd",{"text":3209,"config":3210},"GitOps",{"href":3211,"dataGaName":3212,"dataGaLocation":3125},"/topics/gitops/","gitops",{"text":3214,"config":3215},"DevOps",{"href":3216,"dataGaName":3217,"dataGaLocation":3125},"/topics/devops/","devops",{"text":3219,"config":3220},"Version Control",{"href":3221,"dataGaName":3222,"dataGaLocation":3125},"/topics/version-control/","version control",{"text":3224,"config":3225},"DevSecOps",{"href":3226,"dataGaName":3227,"dataGaLocation":3125},"/topics/devsecops/","devsecops",{"text":3229,"config":3230},"Cloud Native",{"href":3231,"dataGaName":3232,"dataGaLocation":3125},"/topics/cloud-native/","cloud native",{"text":3234,"config":3235},"AI for Coding",{"href":3236,"dataGaName":3237,"dataGaLocation":3125},"/topics/devops/ai-for-coding/","ai for coding",{"text":3239,"config":3240},"Agentic AI",{"href":3241,"dataGaName":3242,"dataGaLocation":3125},"/topics/agentic-ai/","agentic ai",{"title":3244,"links":3245},"Solutions",[3246,3248,3250,3255,3259,3262,3266,3269,3271,3274,3277,3282],{"text":2775,"config":3247},{"href":2770,"dataGaName":2775,"dataGaLocation":3125},{"text":2764,"config":3249},{"href":2747,"dataGaName":2748,"dataGaLocation":3125},{"text":3251,"config":3252},"Agile development",{"href":3253,"dataGaName":3254,"dataGaLocation":3125},"/solutions/agile-delivery/","agile delivery",{"text":3256,"config":3257},"SCM",{"href":2760,"dataGaName":3258,"dataGaLocation":3125},"source code management",{"text":3204,"config":3260},{"href":2753,"dataGaName":3261,"dataGaLocation":3125},"continuous integration & delivery",{"text":3263,"config":3264},"Value stream management",{"href":2803,"dataGaName":3265,"dataGaLocation":3125},"value stream management",{"text":3209,"config":3267},{"href":3268,"dataGaName":3212,"dataGaLocation":3125},"/solutions/gitops/",{"text":2813,"config":3270},{"href":2816,"dataGaName":2817,"dataGaLocation":3125},{"text":3272,"config":3273},"Small business",{"href":2822,"dataGaName":2823,"dataGaLocation":3125},{"text":3275,"config":3276},"Public sector",{"href":2828,"dataGaName":2829,"dataGaLocation":3125},{"text":3278,"config":3279},"Education",{"href":3280,"dataGaName":3281,"dataGaLocation":3125},"/solutions/education/","education",{"text":3283,"config":3284},"Financial services",{"href":3285,"dataGaName":3286,"dataGaLocation":3125},"/solutions/finance/","financial services",{"title":2836,"links":3288},[3289,3291,3293,3295,3298,3300,3303,3305,3307,3309,3311,3313,3315,3317],{"text":2849,"config":3290},{"href":2851,"dataGaName":2852,"dataGaLocation":3125},{"text":2854,"config":3292},{"href":2856,"dataGaName":2857,"dataGaLocation":3125},{"text":2859,"config":3294},{"href":2861,"dataGaName":2862,"dataGaLocation":3125},{"text":2864,"config":3296},{"href":2866,"dataGaName":3297,"dataGaLocation":3125},"docs",{"text":2887,"config":3299},{"href":2889,"dataGaName":2890,"dataGaLocation":3125},{"text":3301,"config":3302},"What's new",{"href":2947,"dataGaName":2948,"dataGaLocation":3125},{"text":2882,"config":3304},{"href":2884,"dataGaName":2885,"dataGaLocation":3125},{"text":2901,"config":3306},{"href":2903,"dataGaName":2904,"dataGaLocation":3125},{"text":2909,"config":3308},{"href":2911,"dataGaName":2912,"dataGaLocation":3125},{"text":2914,"config":3310},{"href":2916,"dataGaName":2917,"dataGaLocation":3125},{"text":2919,"config":3312},{"href":2921,"dataGaName":2922,"dataGaLocation":3125},{"text":2924,"config":3314},{"href":2926,"dataGaName":2927,"dataGaLocation":3125},{"text":2929,"config":3316},{"href":2931,"dataGaName":2932,"dataGaLocation":3125},{"text":2934,"config":3318},{"href":2936,"dataGaName":2937,"dataGaLocation":3125},{"title":2950,"links":3320},[3321,3323,3325,3327,3329,3331,3335,3340,3342,3344,3346],{"text":2958,"config":3322},{"href":2960,"dataGaName":2952,"dataGaLocation":3125},{"text":2963,"config":3324},{"href":2965,"dataGaName":2966,"dataGaLocation":3125},{"text":2971,"config":3326},{"href":2973,"dataGaName":2974,"dataGaLocation":3125},{"text":2976,"config":3328},{"href":2978,"dataGaName":2979,"dataGaLocation":3125},{"text":2981,"config":3330},{"href":2983,"dataGaName":2984,"dataGaLocation":3125},{"text":3332,"config":3333},"Sustainability",{"href":3334,"dataGaName":3332,"dataGaLocation":3125},"/sustainability/",{"text":3336,"config":3337},"Diversity, inclusion and belonging (DIB)",{"href":3338,"dataGaName":3339,"dataGaLocation":3125},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":2986,"config":3341},{"href":2988,"dataGaName":2989,"dataGaLocation":3125},{"text":2996,"config":3343},{"href":2998,"dataGaName":2999,"dataGaLocation":3125},{"text":3001,"config":3345},{"href":3003,"dataGaName":3004,"dataGaLocation":3125},{"text":3347,"config":3348},"Modern Slavery Transparency Statement",{"href":3349,"dataGaName":3350,"dataGaLocation":3125},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":3352},[3353,3356,3359],{"text":3354,"config":3355},"Terms",{"href":3177,"dataGaName":3178,"dataGaLocation":3125},{"text":3357,"config":3358},"Cookies",{"dataGaName":3187,"dataGaLocation":3125,"id":3188,"isOneTrustButton":2665},{"text":3360,"config":3361},"Privacy",{"href":3182,"dataGaName":3183,"dataGaLocation":3125},[3363],{"id":3364,"title":7,"body":2664,"config":3365,"content":3368,"description":2664,"extension":3371,"meta":3372,"navigation":2665,"path":3373,"seo":3374,"stem":3375,"__hash__":3376},"blogAuthors/en-us/blog/authors/omid-khan.yml",{"template":3366,"gitlabHandle":3367},"BlogAuthor","OmidKhan",{"name":7,"config":3369,"role":756},{"headshot":3370},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1769090536/q4p3qwthtken8fpokgzu.jpg","yml",{},"/en-us/blog/authors/omid-khan",{},"en-us/blog/authors/omid-khan","4ZHOi5nEiZLdJm1phW-47SM0x-BGo8jNbg_Zt0oSzEQ",[3378,3385,3393],{"title":3379,"description":3380,"heroImage":2666,"category":2660,"date":3381,"authors":3382,"slug":3384,"externalUrl":2664},"How GitLab tracks vulnerabilities through refactors and reformatting","Learn how GitLab's improved Scope+Offset fingerprinting keeps vulnerability tracking stable across comments, blank lines, and reformatting.","2026-08-12",[3383],"Julian Thome","improved-scope-offset-fingerprinting",{"title":3386,"description":3387,"heroImage":2666,"category":2660,"date":3388,"authors":3389,"slug":3392,"externalUrl":2664},"GitLab Secrets Manager adds ESO, Terraform, API support","Simplify credential management across your stack. GitLab Secrets Manager provides secure retrieval in Kubernetes, Terraform, and external workflows.","2026-08-06",[3390,3391],"Erick Bajao","Joe Randazzo","gitlab-secrets-manager-add-eso-terraform-api-support",{"title":3394,"description":3395,"heroImage":3396,"category":2660,"date":3397,"authors":3398,"slug":3400,"externalUrl":2664},"Secure every commit to production with Claude and GitLab","Claude Security catches vulnerabilities inside a coding session. GitLab picks up from there, scanning, enforcing policy, and producing audit evidence for the software lifecycle. ","https://res.cloudinary.com/about-gitlab-com/image/upload/v1756122536/akivvcnafog9c4dhhzkp.png","2026-08-03",[3399],"Alisa Ho","claude-security-and-gitlab",{"promotions":3402},[3403,3417,3428,3439],{"id":3404,"categories":3405,"header":3407,"text":3408,"button":3409,"image":3414},"ai-modernization",[3406],"ai","Is AI achieving its promise at scale?","Quiz will take 5 minutes or less",{"text":3410,"config":3411},"Get your AI maturity score",{"href":3412,"dataGaName":3413,"dataGaLocation":2890},"/assessments/ai-modernization-assessment/","modernization assessment",{"config":3415},{"src":3416},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/qix0m7kwnd8x2fh1zq49.png",{"id":3418,"categories":3419,"header":3420,"text":3408,"button":3421,"image":3425},"devops-modernization",[2676,3227],"Are you just managing tools or shipping innovation?",{"text":3422,"config":3423},"Get your DevOps maturity score",{"href":3424,"dataGaName":3413,"dataGaLocation":2890},"/assessments/devops-modernization-assessment/",{"config":3426},{"src":3427},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138785/eg818fmakweyuznttgid.png",{"id":3429,"categories":3430,"header":3431,"text":3408,"button":3432,"image":3436},"security-modernization",[2660],"Are you trading speed for security?",{"text":3433,"config":3434},"Get your security maturity score",{"href":3435,"dataGaName":3413,"dataGaLocation":2890},"/assessments/security-modernization-assessment/",{"config":3437},{"src":3438},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/p4pbqd9nnjejg5ds6mdk.png",{"id":3440,"paths":3441,"header":3444,"text":3445,"button":3446,"image":3451},"github-azure-migration",[3442,3443],"migration-from-azure-devops-to-gitlab","integrating-azure-devops-scm-and-gitlab","Is your team ready for GitHub's Azure move?","GitHub is already rebuilding around Azure. Find out what it means for you.",{"text":3447,"config":3448},"See how GitLab compares to GitHub",{"href":3449,"dataGaName":3450,"dataGaLocation":2890},"/compare/gitlab-vs-github/github-azure-migration/","github azure migration",{"config":3452},{"src":3427},{"header":3454,"blurb":3455,"button":3456,"secondaryButton":3461},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":3457,"config":3458},"Get your free trial",{"href":3459,"dataGaName":2690,"dataGaLocation":3460},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":3163,"config":3462},{"href":3015,"dataGaName":2695,"dataGaLocation":3460},1786803751925]