Gitlab Integration - Inbound
============================

This section describes the process of integrating a new Gitlab server (HUB) with the ARC Registry application for the inbound **API** requests. The application uses the Gitlab **Access Tokens** to access the ARC repositories through Gitlab APIs. 
 

Enable Gitlab Access Tokens
---------------------------

To enable ARC Metadata Registry application access the Gitlab server APIs, we need to enable the Gitlab Access Tokens as follows.


#. Login to the GitLab server as **admin**.

#. Goto the **User Settings** page through **Edit Profile** tab and click on the **Access Tokens** link from the navigation on the left side.

#. Add a new **Personal Access Token** with the **read_api** scope. Make sure the expiry date is set to a longer duration.

#. Copy the access token for the next step.


Setup Access Token in Registry Application
------------------------------------------

Use the access token from the above process to setup the same in the registry application. Below are the steps.

#. Go to the **install** directory and take a copy of the **add_gitlab_tokens.sh** script.

#. Edit the script and update the HOST and TOKEN variables to the Gitlab hostname and the access token respectively.

#. Save the script with the hostname and execute the same. The script adds the new hostname and the token to access the Gitlab API to the Gitlab integration module.