> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/version-control/gitlab/gitlab-cloud-using-oauth.md).

# GitLab Cloud - Using OAUTH

### **Data Access by Hivel**

* Hivel accesses the past 60-90 days of commits and pull requests from active repositories during the initial sync.

### **Authorization Mechanism**

* Hivel employs GitLab's OAuth for authentication.
* Users maintain full control and can withdraw access anytime via GitLab's authorized apps section.

### **Requirements**

* Make sure to log in with an account possessing write permissions to relevant GitLab repositories.
* Write permissions are mandatory for webhook publication, facilitating real-time data sync.

### **Best Practice**

* Opt for a service account rather than an individual-linked account.
* Service accounts are typically overseen by the company's admin.

### **Create your Hivel Account**

1. Navigate to the Hivel [<mark style="color:purple;">sign-up page</mark>](https://app.hivel.ai/signup)
2. Add your work email id.

<figure><img src="/files/gao9TgubChgJqc9oeP8o" alt=""><figcaption></figcaption></figure>

1. Now, you can use your Google or Microsoft login with your work email id; or create a password.
2. Create your Company Profile, and click '**Get Started**'.

<figure><img src="/files/Fw0xoTnojx7GlwFPSlFb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/IWo7f4kTNZvdEneoGZBR" alt=""><figcaption></figcaption></figure>

3. Once you've successfully created your Company Profile, you will be redirected to the Integrations Page.
4. Select GitLab cloud, and log in to your company's GitLab account using a service account.

![](/files/hTr31ohQhSmX7rU1vS23)

* If you are not already logged into GitLab in your current browser session, you will see the standard GitLab login screen.
* Enter your GitLab credentials (username/email and password) or sign in using your corporate Single Sign-On (SSO) provider.

*Note: Our platform never sees, collects, or stores your GitLab password.*

### **Review and Authorize Access Permissions**

* You will be presented with an authorization screen showing our application name and the specific permissions (scopes) requested.
* Review the listed permissions to understand what data our platform needs to function.
* Click the Authorize button to grant access.

### **Finalize the Secure Connection**

* Once authorized, GitLab will automatically redirect your browser back to our platform's dashboard.
* Our system will process the secure connection token in the background.
* You will see a success message indicating your GitLab Cloud integration is active and ready to use.