---
title: "Configure GitLab Connector"
slug: "configure-gitlab-connector"
description: "In this article, we'll cover configuring the GitLab connector."
updated: 2024-10-16T20:59:46Z
published: 2024-10-16T20:59:46Z
canonical: "knowledge.curiositysoftware.ie/configure-gitlab-connector"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.curiositysoftware.ie/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure GitLab Connector

In this article, we'll cover configuring the GitLab connector. Navigate to Workspace -> Connectors, add a new GitLab connector.

The configure connector dialogue has three tabs:

1. Details: Where the connector type and name is set.
2. Connection: The connection and configuration information for the connector.
3. Traceability: Shows which Automation Frameworks in the workspace use this GitLab connector.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729112258219.png)

Select GitLab from the Connector Type dropdown and give this a recognisable Profile Name. Also choose if you would like this connector to be shared among all users in the workspace.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729112296218.png)

In the connection tab, configure the following information:

1. Username: The user you would like to commit code with in GitLab.
2. API Key: Personal access token in GitLab - [https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html) - this personal access token must have read and write access to the target repository.
3. Git Repository: The Git repository URL, you will be able to copy this from GitLab. Ensure that this includes '.git' at the end.
4. Commit Branch: Defines the branch you want to commit code to in GitLab, this must already exist in GitLab before committing code from Quality Modeller.
5. Pull Request: This is an On or Off toggle.
  1. If **OFF,** code will be pushed directly to the branch specified above.
  2. If **ON,** then a second field will show called Pull Request Target Branch. Here you can specify a branch to create, that will in turn create the pull request to the main commit branch. This is very useful for code reviews before committing to a repository.

There are a number of Advanced optional fields:

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729111038772.png)

1. Author (Override): Allows you to override the Author of the code commit. This can be hard coded or you use [UserEmail] to apply the current logged in users email.
2. Name (Override): Allows you to override the Name associated with a code commit. This can be hard coded or you use [UserFullName] to apply the current logged in users name.
3. Git Library: This field lets you choose the underlying library that handles Git operations. This can be set to LibGit2Sharp, a C# wrapper around the native Git library, or Native.
4. HTTP Proxy URL: This field is where you specify the URL of an HTTP proxy server if your network requires it to access external resources over HTTP. For example, [http://proxy.mycompany.com:8080](http://proxy.mycompany.com:8080). In this example, the proxy server’s URL is `proxy.mycompany.com`, and it’s using port `8080`. The proxy would forward your tool’s HTTP requests to GitLab.
5. HTTPS Proxy URL: This field is used to specify the URL of an HTTPS proxy, which handles encrypted HTTPS traffic. For example, [https://secure-proxy.mycompany.com:443](https://secure-proxy.mycompany.com:443). In this example, the proxy server is `secure-proxy.mycompany.com`, and it is listening on port `443` (the standard port for HTTPS traffic)

Finally, there are a number of User Actions that can be applied to the connector.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1729111066672.png)

1. Validate: Takes the Saved Username and API Key credentials and tests that a connection can be established and the user can be logged in.
2. ?: Links to this documentation section.
3. Reset: Clears the temporary copy of the Git repository that Quality Modeller stores, this can be useful to run as a troubleshooting step if something goes wrong.
4. Pull: Pulls the latest version of the Git repository into Quality Modeller.
5. Cancel: Cancels any changes made to the configurations.
6. Save: Saves changes.

## Related

- [GitLab](/gitlab.md)