# Configuring and Managing ALM Integrations

**Org Administration › ALM Connections**

1. At the organization level, we’ve introduced a new **ALM Connections** page where you can manage integrations with enterprise instances of **GitHub**, **GitLab**, and **Bitbucket**.\
   By default, this list is empty until you add your first connection.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FJf9hUd7YNRQ6ZJjK5T5i%2Fimage-20250701-114004.png?alt=media&#x26;token=0719cd6c-3843-4882-acc2-b62d680d7c34" alt=""><figcaption></figcaption></figure>

2. The **ALM Connections page** will contain configured ALM Connections. (default empty)

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FkV3ct8T2LbTeMQuPPVN4%2FScreenshot%202025-07-01%20at%209.01.15%E2%80%AFPM.png?alt=media&#x26;token=e88f67cd-7c8c-4361-a27c-58edd02d8989" alt=""><figcaption></figcaption></figure>

> **Tip:** Refer to our provider-specific Knowledge Base articles for step-by-step instructions on creating the OAuth connected app and generating the Client ID/Secret.

\
\
3\. **Configuring a New ALM Connection**

**Provider**

1. Choose your ALM platform (GitHub, GitLab, or Bitbucket).

**Domain / ALM URL**

2. Enter the URL for your ALM server.
3. Each ALM URL must be unique for each ALM connection within an organization.

**Allowed IP Ranges**

4. Please provide the CIDR ranges or IP addresses from which your Enterprise server operates.

**OAuth Credentials**

5. Paste the **Client ID** and **Client Secret** generated when you created your connected app in the provider’s system.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F6QjMF3HDPp1dm9inIfEa%2Fimage-20250701-153944.png?alt=media&#x26;token=2701f473-c3cd-46cc-ac05-b781f172958f" alt=""><figcaption></figcaption></figure>

**Test Connection**

5. Click **Test Connection** to verify the provided credentials.\
   If the validation is successful, click **Create ALM Connection** to complete the setup.

#### 4. Manage ALM Connections

* Use the dropdown of configured connections to select and modify(Edit/ Delete) an existing integration.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fqew9MUInYLArLOuTXsRA%2FScreenshot%202025-07-01%20at%209.17.04%E2%80%AFPM.png?alt=media&#x26;token=3adac9d1-6a88-4f5b-bd94-1f87f66b3180" alt=""><figcaption></figcaption></figure>

* On click to the edit, below screen would be shown with ALM details, Update the required fields as mentioned in above point 3 (Configuring a New ALM Connection)

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FDJk1LsihGypc88uLz4Y6%2Fimage-20250702-061944.png?alt=media&#x26;token=39d28be0-ba4e-42bb-bb6c-7c21999bfd7e" alt=""><figcaption></figcaption></figure>

**Test Connection**

Click **Test Connection** again to validate the updated credentials.\
If successful, click **Update ALM Connection** to save the changes.

5. **Using ALM Connections During Project Setup**:

Once an ALM connection is successfully created or updated, it will appear in the dropdown under:\
**Project Analysis › Add Analysis Project › Add a New Project**

Select the appropriate ALM URL from the dropdown to proceed with project analysis.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FutI5OAdR7LzZF1CokRxb%2Fimage-20250701-154907.png?alt=media&#x26;token=4a9c5529-5ed7-4d80-9492-20b110eafe3b" alt=""><figcaption></figcaption></figure>

6. **Knowledge Base Articles for Project Analysis via ALM Providers**

* [GitHub](https://knowledgebase.autorabit.com/codescan/docs/add-a-project-to-codescan-from-github)
* [Atlassian Bitbucket](https://knowledgebase.autorabit.com/codescan/docs/add-a-project-to-codescan-from-bitbucket)
* [Gitlab](https://knowledgebase.autorabit.com/codescan/docs/add-a-project-to-codescan-from-gitlab)
