# Configure integrations ## Configure integrations Integrations is the settings area where you connect Atloria to Git providers for repository imports or open project-specific webhook settings. The Git-provider area requests read-only access; webhook configuration continues at the project level. | If you need to… | Go to… | | --- | --- | | Connect an account that is not connected | [Connect or re-authorize a Git provider](#connect-or-re-authorize-a-git-provider) | | Refresh an existing provider authorization | [Connect or re-authorize a Git provider](#connect-or-re-authorize-a-git-provider) | | Open webhook settings for a project | [Open a project's webhook settings](#open-a-projects-webhook-settings) | | Understand an empty or loading project list | [Handle provider and project branches](#handle-provider-and-project-branches) | | Continue with project-level configuration | [Manage project settings](doc:manage-project-settings) | | Learn how to move around the application | [Navigation basics](doc:navigation-basics) | ## Before you start You need an active signed-in session to load provider status. For the Webhooks path, you also need a project available to choose; the project list and its values are loaded when the tab is opened. This screen does not use a save form. **Prerequisites** | Have or know | Why it matters | | --- | --- | | A signed-in Atloria session | Provider status loads after a session is available. | | The Git provider account you want to connect | **Connect** starts that provider's authorization flow. | | The project whose webhooks you need to manage | **Open webhook settings** becomes available after a project is selected. | ## Open Integrations settings The Integrations page is the System Settings surface for provider connections and project webhook entry. Confirm that the page has loaded before choosing a tab. **Prerequisites** - You are signed in to Atloria. **Steps** 1. Open the integrations page. 2. Confirm that the page shows **Git providers** and **Webhooks**. ![The Integrations page with the Git-provider and Webhooks choices visible.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ef7e302857862da4fccb3da4414c67da.png) **Result:** The integrations page is open, and you can choose the Git-provider or Webhooks surface. ## Understand the integration surface Git providers are the accounts used to import repositories. Webhooks are project-level settings that provide the destination for Git-triggered documentation updates. The page has two surfaces: | Surface | Use it to… | | --- | --- | | **Git providers** | Connect, re-authorize, or disconnect GitHub, GitLab, or Bitbucket. | | **Webhooks** | Choose a project and open its webhook settings. | On **Git providers**, an unconnected provider shows `Not connected` and **Connect** after its status has loaded. A connected provider shows `Connected`, the account details, repository and organization summaries, granted permissions, **Re-authorize**, and **Disconnect**. While status is loading, provider actions are replaced by a loading indicator. On **Webhooks**, the project area can show `Loading projects…`, `No projects yet — create a project first, then configure its webhooks.`, or a project selector. **Open webhook settings** is available after a project is selected. The disconnect confirmation includes **Cancel** and **Disconnect**, and warns: `This will revoke Atloria's access to your account.` The live page displayed 12 buttons, 0 labelled controls, 0 grid columns, and 1 unlabelled visible control. The page displayed **Git providers**, **Webhooks**, two **Disconnect** controls, one **Re-authorize** control, and two **Connect** controls. ## Connect or re-authorize a Git provider Use a Git-provider connection to make repository source available for import. The page lists GitHub, GitLab, and Bitbucket; the available action depends on whether the provider is connected. **Prerequisites** - You are signed in. - You know which provider account to authorize. **Steps** 1. Open the **Git providers** surface. 2. Find the provider you want to use. 3. Choose one action: | If the provider shows… | Select… | | --- | --- | | `Not connected` | **Connect** | | `Connected` | **Re-authorize** | 4. Complete the provider authorization window that opens. Atloria requests read-only repository access. It does not push, modify, or delete code, and the OAuth tokens are encrypted at rest and transmitted over TLS. **Result:** The provider authorization request is started for the selected Git provider. ## Open a project's webhook settings Project webhook settings contain the webhook URL, signing secret, regeneration triggers, and recent deliveries for one project. **Prerequisites** - You are signed in. - At least one project is available in the project list. **Steps** 1. Open the **Webhooks** surface. 2. Check the project list after it finishes loading. 3. In the project selector, choose the project whose webhook settings you want to manage. 4. Select **Open webhook settings**. The selector's project values come from the project list loaded by the page. The available project names depend on that list. **Result:** The selected project's webhook settings page opens. ## Handle provider and project branches The page changes its available actions according to provider connection status and project-list state. Use the branch matching one of the statuses, messages, or controls listed in the table below. **Prerequisites** - You have opened either **Git providers** or **Webhooks**. **Steps** 1. Use the branch matching one of the statuses, messages, or controls listed in the table below. | What you see | What to do | | --- | --- | | A provider shows `Connected` | Select **Re-authorize** to renew authorization, or **Disconnect** to open its confirmation. | | A provider shows `Not connected` | Select **Connect**. | | The provider card is still loading | Wait for provider actions to appear. | | `Loading projects…` | Wait for the project list to finish loading. | | `No projects yet — create a project first, then configure its webhooks.` | Create a project before opening project webhook settings. | | The project selector is visible but no project is selected | Select a project before choosing **Open webhook settings**. | 2. If you opened the disconnect confirmation without intending to continue, select **Cancel**. **Result:** You have selected the action that matches the provider or project state on screen. ## When integration actions go wrong Use the visible state and messages to identify where the integration task stopped. | What you see | What it means | What to do | | --- | --- | --- | | `No activity yet` | No integration activity is listed. | Select **Connect** for the provider you want to authorize. | | `Connect a provider to get started.` | The activity area is waiting for a provider connection. | Return to **Git providers** and select **Connect**. | | `No projects yet — create a project first, then configure its webhooks.` | No project is available for the Webhooks path. | Create a project before configuring its webhooks. | | The disconnect confirmation is open | The provider account is about to lose Atloria access. | Select **Cancel** to close the confirmation, or select **Disconnect** to continue. | ## Continue after configuring integrations Webhook work continues in the selected project's settings. Project webhook details belong to the project settings surface. **Prerequisites** - You have selected a project for webhook configuration, or completed the provider authorization flow. **Steps** 1. Choose where to continue: | If you need to… | Open… | | --- | --- | | Continue with project webhooks | [Manage project settings](doc:manage-project-settings) | | Get navigation help | [Navigation basics](doc:navigation-basics) | | Get configuration help | [Getting help](doc:getting-help) | **Result:** You know which settings surface to use next for project webhooks, navigation, or help.