> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione con GitLab Self-Managed

> Collega Devin alla tua istanza GitLab Self-Managed

<div id="overview">
  ## Panoramica
</div>

Questa guida illustra la configurazione completa per integrare un'**istanza GitLab** con Devin, inclusa sia la **configurazione amministrativa** sia la **configurazione degli utenti finali**.

L'integrazione si articola in due parti:

1. **Configurazione amministrativa**
   * Collega a Devin l'istanza GitLab self-hosted dell'organizzazione
   * Configura un account di servizio
   * Configura l'accesso ai repository
   * Registra OAuth in modo che gli utenti possano collegare le proprie identità GitLab personali
2. **Configurazione utente**
   * Collega l'account GitLab di un utente al proprio account Devin

<Note>
  La configurazione amministrativa deve essere completata prima che qualsiasi utente possa collegare il proprio account GitLab. Solo gli amministratori Enterprise possono eseguire i passaggi della configurazione amministrativa.
</Note>

***

<div id="part-1-admin-setup">
  ## Parte 1: Configurazione Admin
</div>

<div id="step-1-create-a-service-account-in-gitlab">
  ### Passaggio 1: Crea un account di servizio in GitLab
</div>

In GitLab:

1. Vai al **gruppo GitLab** corretto
2. Vai a **Settings**
3. Apri **Service Accounts**
4. Crea un nuovo account di servizio

Questo account di servizio sarà usato da Devin per accedere ai repository in GitLab.

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-create-service-account.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e81fed639122165593233b0e2e959318" alt="Crea un account di servizio in GitLab" width="3158" height="1980" data-path="images/enterprise/gitlab/gitlab-create-service-account.png" />
</Frame>

***

<div id="step-2-add-the-service-account-as-a-group-member">
  ### Passaggio 2: aggiungi l'account di servizio come membro del gruppo
</div>

Sempre in GitLab:

1. Vai alla pagina **Members** del gruppo

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-group-members.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=8a205b2d0ea97565ec9e4dbaca80ad87" alt="Pagina dei membri del gruppo GitLab" width="894" height="1156" data-path="images/enterprise/gitlab/gitlab-group-members.png" />
</Frame>

2. Aggiungi l'account di servizio come membro del gruppo
3. Assegnagli il ruolo **Developer**

Questo è necessario affinché l'account di servizio possa accedere ai repository con le autorizzazioni appropriate.

***

<div id="step-3-generate-a-personal-access-token-for-the-service-account">
  ### Passaggio 3: Genera un token di accesso personale per l'account di servizio
</div>

Dopo aver creato l'account di servizio:

1. Individua l'account di servizio appena creato
2. Fai clic sui tre puntini > **Gestisci i token di accesso** > **Genera un nuovo token di accesso personale** > Seleziona **api** tra gli ambiti di accesso
3. Copia e conserva il token in modo sicuro

<Note>
  Assicurati di selezionare il token dell'account di servizio, e non il token di accesso personale che trovi nelle preferenze del tuo account utente. Devin deve agire come l'account di servizio, non come te. Userai questo token quando aggiungerai la connessione GitLab in Devin.
</Note>

***

<div id="step-4-add-the-gitlab-connection-in-devin">
  ### Passaggio 4: Aggiungi la connessione GitLab in Devin
</div>

In Devin:

1. Vai a **Enterprise Settings**
2. Apri **Connections**
3. Aggiungi una nuova connessione
4. Inserisci:
   * L'**URL del tuo GitLab self-hosted** (se applicabile)

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-add-connection.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e7425687734160e1004131a22b9d1d14" alt="Aggiungi l'URL della connessione GitLab" width="3160" height="1970" data-path="images/enterprise/gitlab/gitlab-add-connection.png" />
</Frame>

* Il **token di accesso personale** creato per l'account di servizio

In questo modo viene creata la connessione GitLab a livello enterprise.

***

<div id="step-5-configure-webhook">
  ### Passaggio 5: Configurare il webhook
</div>

La configurazione di un webhook consente a Devin di ricevere automaticamente notifiche in tempo reale quando si verificano eventi specifici in GitLab (come l'apertura o l'aggiornamento di merge request e l'aggiunta di commenti alle merge request).

Per configurare il webhook:

1. In **Enterprise Settings** > **Connections**, individua l'istanza GitLab che hai appena aggiunto
2. Fai clic sul menu a discesa **Gestisci**
3. Seleziona **Configura webhook**
4. Segui i comandi forniti per completare la configurazione

<Frame>
  <img src="https://mintcdn.com/cognitionai/pyEbN3xdufu0Z31G/images/enterprise/gitlab/gitlab-configure-webhook.png?fit=max&auto=format&n=pyEbN3xdufu0Z31G&q=85&s=d2e01d6fd89ca40302f9ea9ebf61848b" alt="Configura webhook" width="452" height="388" data-path="images/enterprise/gitlab/gitlab-configure-webhook.png" />
</Frame>

Una volta configurato, Devin sarà in grado di rispondere agli eventi di GitLab in tempo reale, invece di basarsi su controlli periodici.

***

<div id="step-6-verify-repository-access">
  ### Passaggio 6: Verifica dell'accesso ai repository
</div>

Dopo aver aggiunto la connessione:

1. Conferma che il account di servizio abbia accesso ai repository che vuoi utilizzare
2. In Devin, se i repository non compaiono subito, aggiorna manualmente l'elenco dei repository
3. Vai a **Repository Enterprise**
4. Seleziona l'organizzazione corretta

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-enterprise-repositories.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=ef2b4392c4b1fdf004a26f2304576959" alt="Repository Enterprise" width="3164" height="1980" data-path="images/enterprise/gitlab/gitlab-enterprise-repositories.png" />
</Frame>

5. Apri **Gestisci autorizzazioni**
6. Aggiungi i repository pertinenti con le autorizzazioni **lettura/scrittura** appropriate

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-manage-permissions.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e833b6573eedb18bf62079456d077b74" alt="Gestisci le autorizzazioni del repository" width="540" height="128" data-path="images/enterprise/gitlab/gitlab-manage-permissions.png" />
</Frame>

<Note>
  Se mancano delle repo, potrebbe essere perché Devin aggiorna l'elenco dei repository periodicamente anziché all'istante.
</Note>

***

<div id="part-2-enable-user-linking-for-self-hosted-gitlab">
  ## Parte 2: Abilita il collegamento degli utenti per GitLab self-hosted
</div>

<div id="step-7-register-an-oauth-application-on-the-self-hosted-gitlab-instance">
  ### Passaggio 7: Registrare un'applicazione OAuth sull'istanza GitLab self-hosted
</div>

Per consentire ai singoli utenti di collegare la propria identità GitLab a Devin, l'amministratore deve registrare un'app OAuth per l'istanza GitLab self-hosted.

In Devin:

1. Vai all'area di connessione GitLab dell'Enterprise
2. Apri **Avanzate**
3. Vai alla sezione GitLab self-hosted
4. Avvia la procedura per **registrare un'applicazione OAuth**

<Frame>
  <img src="https://mintcdn.com/cognitionai/EHv4sbxOtqeRVSwT/images/enterprise/gitlab/gitlab-register-oauth.png?fit=max&auto=format&n=EHv4sbxOtqeRVSwT&q=85&s=58275e975adaff88336802286e89eb8b" alt="Registrare un'applicazione OAuth" width="1428" height="1324" data-path="images/enterprise/gitlab/gitlab-register-oauth.png" />
</Frame>

***

<div id="step-8-complete-oauth-app-registration-in-gitlab">
  ### Passaggio 8: Completa la registrazione dell'app OAuth in GitLab
</div>

Segui il collegamento nella finestra modale di registrazione per aprire il modulo dell'applicazione GitLab. Compila i campi come indicato:

1. Imposta **Name** e **Redirect URI** esattamente come mostrato nella finestra modale di Devin
2. Seleziona la casella **Confidential**
3. Seleziona l'ambito **api**
4. Fai clic su **Save application**

<Frame>
  <img src="https://mintcdn.com/cognitionai/hGn6kEeruNGdZWya/images/enterprise/gitlab/gitlab-oauth-app-settings.png?fit=max&auto=format&n=hGn6kEeruNGdZWya&q=85&s=f30a422acffd08b475cfdd4d70be4f0b" alt="Impostazioni dell'app OAuth di GitLab" width="2060" height="1792" data-path="images/enterprise/gitlab/gitlab-oauth-app-settings.png" />
</Frame>

5. Copia **Application ID** e **Application Secret** da GitLab
6. Torna in Devin e incolla questi valori nella finestra modale di registrazione
7. Fai clic su **Register**

In questo modo completi la configurazione lato amministratore necessaria per collegare l'identità degli utenti.

***

<div id="part-3-organization-membership-requirement">
  ## Parte 3: Requisito di appartenenza all'organizzazione
</div>

<div id="step-9-make-sure-the-user-belongs-to-the-correct-devin-organization">
  ### Passaggio 9: assicurati che l'utente appartenga all'organizzazione Devin corretta
</div>

Prima che un utente possa collegare il proprio account GitLab, deve essere membro di un'organizzazione Devin con autorizzazioni per i repository GitLab.

In Devin:

1. Vai alla sezione di appartenenza all'organizzazione
2. Verifica che l'utente faccia parte di un'organizzazione Devin con autorizzazioni per i repository GitLab
3. In caso contrario, aggiungilo prima

<Note>
  **Connessioni personali mostra solo le integrazioni delle organizzazioni a cui appartiene l'utente.** Se un utente non fa parte di un'organizzazione Devin con autorizzazioni per i repository GitLab, l'integrazione GitLab potrebbe non essere visualizzata affatto.
</Note>

***

<div id="part-4-end-user-setup">
  ## Parte 4: Configurazione per l'utente finale
</div>

<div id="step-10-open-personal-connections">
  ### Passaggio 10: Apri Connessioni personali
</div>

Come utente finale su Devin:

1. Vai a **Connessioni personali**
2. Cerca l'integrazione GitLab self-hosted

Se non compare, verifica prima l'appartenenza all'organizzazione.

***

<div id="step-11-link-the-users-gitlab-account">
  ### Passaggio 11: Collega l'account GitLab dell'utente
</div>

Una volta visualizzata l'integrazione:

1. Seleziona la connessione GitLab self-hosted
2. Completa la procedura di collegamento
3. Collega l'**account GitLab** dell'utente al suo **account Devin**

Dopo questo passaggio, Devin dovrebbe essere in grado di operare su GitLab per conto di quell'utente.