GitLab connection

To create a user in Hatica, an Email ID is mandatory. However, when integrating with platforms like GitHub and GitLab, the availability of email IDs depends on how the platforms share user data. Hatica uses email IDs as a unique identifier for user creation and mapping. For example:

• A GitHub or GitLab handle (e.g., jane_doe) can only be associated with a user in Hatica if we have their email ID.
• Without an email ID, the system cannot establish or sync the user’s account.

GitLab API

GitHub

• The Github API provides Email IDs unless the user has marked their email as private.
• If marked private, GitHub returns an email in the format handle@nusers.noreply.github.com.
• This allows Hatica to map user handles to valid email IDs and create user accounts automatically.

GitLab

• The Gitlab API provides a list of users along with their GitLab handles (e.g., john_doe) and usernames (e.g., johndoe123), but not email IDs. GitLab API Users (opens in a new tab)
• Email IDs are only accessible when using an Admin Personal Access Token (PAT) in GitLab Self-Hosted or GitLab Dedicated environments, which most teams do not use.
• Without an email ID, Hatica cannot create user accounts automatically.
  • For the initial setup, once you have connected Gitlab with Hatica, please share the Gitlab IDs with Hatica to get your Members set up. CSV file (opens in a new tab)
  • For additions, users can be manually created in Hatica by adding their GitLab handles through the Hatica UI and then linked to their corporate E-mail IDs to setup connections with other applications e.g Jira.

Create a GitLab Personal Access Token

Follow Gitlab's documentation on how to create a PAT here (opens in a new tab).

Here is the list of permissions required by Hatica via the personal access token:

• read_repository
• read_api

Note: It is advised to set the PAT expiry to the longest duration i.e 1 Year from the date of issue for a seamless experience

GitLab Cloud

To connect Gitlab cloud, follow the instructions below:

1. A personal access token created in your Gitlab

• Gitlab admins should generate the PAT so Hatica can access all repositories.

GitLab Server

To connect Gitlab Server, follow the instructions below:

1. Domain or IP address where the Gitlab server is accessible

2. A personal access token created in your Gitlab

• Its best if the admins of Gitlab generate the PAT since it would provide access to all repositories. If you want to see data for select repos, let us know and we'll consider only those!