To setup Flow Enterprise to work with GitLab Cloud, Flow Enterprise requires that an OAuth integration be configured in your GitLab account. It is recommended that you consider creating a "server user" account that has access to all of the teams and repositories in the organizations you wish to analyze. You should then use that user to configure the OAuth integration.
- Go to https://gitlab.com and login as a user that has access to modify the account.
- Navigate to the settings by first clicking on your account menu in the top-right of the application and going to Settings.
- You will be show a list of organization settings. At the bottom, under Developer Settings you will see OAuth Apps. Please select that to reach the list of OAuth Applications that have been integrated with the organization. Click Register a new application button.
- You will now be asked to enter the details of the new OAuth application. The fields on the form should be filled out according to these guidelines:
- Name: This should be an easily recognizable name for your Flow Enterprise instance. For example, "Flow Enterprise Integration," for a literal use. Or, if you have multiple Flow Enterprise Integrations, perhaps per department, you might use "Flow Enterprise: Core System Developers."
- Redirect URL: This URL is the URL that GitLab will redirect the user browser to after OAuth authentication has been performed. This should be on the format of https://<your Flow Enterprise hostname>/accounts/complete/gitlab/. For example, if your Flow Enterprise instance is at flow.mycompany.com, you would enter: https://flow.mycompany.com/accounts/complete/gitlab/
- Scopes: There are three available scopes. At this time, Flow Enterprise does not need any of them activated.
- Once you have filled out the data, click Save and you should now see a detailed page about your integration. It will show you a Client ID and Client Secret.
- Navigate to the Flow Enterprise Administration Console (see Configuring Flow Enterprise) and enter this key/secret pair in the GitLab Settings section. Click Save and allow Flow Enterprise to restart. At this point, GitLab functionality should be enabled.
- To connect Flow Enterprise to GitLab, browse to the Repos section under My Data. Click Add Repos and choose GitLab. You will be asked to connect to GitLab if you have not already done so. Click Connect GitLab to continue.
- You will now be forwarded to GitLab for Oauth confirmation. You will be asked to login to GitLab (if you are not already). You will then be asked to confirm the integration. Clicking Authorize should return you to Flow Enterprise where you will now be able to import repositories from GitLab Cloud.
If you need help, please email email@example.com for 24/7 assistance.