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.

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

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.

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:

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 <provider> 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.

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
   Get navigation help	Navigation basics
   Get configuration help	Getting help

Result: You know which settings surface to use next for project webhooks, navigation, or help.