# GitLab

## Webhooks

In order for Gomboc.AI to keep the updated status of any MRs we create for you, you must include a webhook. In order to create a proper webhook, please follow these steps:

1. Go to our portal, [app.gomboc.ai](https://app.gomboc.ai), click on your account icon on the top right > Settings > API Tokens and create a 'Personal' or 'API' token. Use a Personal token when you will be the only one using the token, and use an API token with the appropriate roles if the token will be used within the webhook, or expect multiple people to use the token.

   <figure><img src="/files/InfYhrPH7S4548GJnFMh" alt=""><figcaption></figcaption></figure>
2. Be sure to copy the created token, and start to set up the GitLab webhook. Within your project settings, under webhooks, click 'Add new webhook'. You will need the following values to successful finish the webhook.

   1. URL: <https://scan.app.gomboc.ai/webhook/gitlab>
   2. Secret token: \<Token copied from the Gomboc settings>
   3. Trigger checkboxes: Only 'Merge request events' needs to be checked
   4. SSL verification: The 'Enable SSL verification' box should be check box should be checked

   <figure><img src="/files/WpTNGQ9rc9Wiy21Xn1jb" alt=""><figcaption></figcaption></figure>
3. Once complete, you can finish by clicked 'Add webhook' and proceed to creating the CI/CD, or start to create pull requests through the portal.

## CI/CD

See [GitLab Runners](/integrations/continuous-integration-ci-build-systems/gitlab-runners.md).

### Rate Limiting

If there are many IAC resources in your projects, Gomboc's scanning processes may encounter rate-limiting imposed either by your custom settings, or the default rate limits for endpoints set by Gitlab on account creation. These may be changed per user in Gitlab's settings. For fastest processing you may raise or remove the rate limits for the Gomboc user for the following endpoints. The process is simple, and is detailed in the documentation below.

Relevant endpoints:

#### [Projects](https://docs.gitlab.com/ee/administration/settings/rate_limit_on_projects_api.html)

#### [Groups](https://docs.gitlab.com/ee/administration/settings/rate_limit_on_groups_api.html)

#### [Git HTTP rate limiting](https://docs.gitlab.com/ee/administration/settings/git_http_rate_limits.html)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gomboc.ai/integrations/source-code-management-scm/gitlab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.