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

# Integração com o GitLab autogerenciado

> Conecte o Devin à sua instância autogerenciada do GitLab (versão 15.0 ou posterior): configuração de administrador, contas de serviço, webhooks e vinculação de usuários.

## Visão geral

Este guia apresenta a configuração completa para integrar uma **instância do GitLab** ao Devin, incluindo tanto a **configuração do administrador** quanto a **configuração do usuário final**. O Devin oferece suporte ao GitLab autogerenciado versão 15.0 e posteriores.

A integração tem duas partes:

1. **Configuração do administrador**
   * Conectar a instância auto-hospedada do GitLab da organização ao Devin
   * Configurar uma conta de serviço
   * Configurar o acesso ao repositório
   * Registrar o OAuth para que os usuários possam vincular suas contas pessoais do GitLab
2. **Configuração do usuário**
   * Vincular a conta do GitLab de um usuário à sua conta do Devin

> [!NOTE]
>
> A configuração do administrador deve ser concluída antes que qualquer usuário possa vincular sua conta do GitLab. Somente admins do Enterprise podem executar as etapas de configuração do administrador.

***

## Parte 1: Configuração do administrador

### Etapa 1: Criar uma conta de serviço no GitLab

No GitLab:

1. Acesse o **grupo do GitLab** correto
2. Vá para **Configurações**
3. Abra **Service Accounts**
4. Crie uma nova conta de serviço

Essa é a conta de serviço que o Devin usará para acessar repositórios no GitLab.

![Criar conta de serviço no GitLab](https://mintcdn.com/cognitionai-enterprise/wPdYnPNTsINgaVgH/images/enterprise/gitlab/gitlab-create-service-account.png?fit=max\&auto=format\&n=wPdYnPNTsINgaVgH\&q=85\&s=9822dcd73e5c8a8c3530fcf7214a9b95)

***

### Etapa 2: Adicione a conta de serviço como membro do grupo

Ainda no GitLab:

1. Acesse a página **Members** do grupo

![Página de membros do grupo no GitLab](https://mintcdn.com/cognitionai-enterprise/wPdYnPNTsINgaVgH/images/enterprise/gitlab/gitlab-group-members.png?fit=max\&auto=format\&n=wPdYnPNTsINgaVgH\&q=85\&s=d8ac337cad80ecc4173cfec86f4bff3a)

2. Adicione a conta de serviço como membro do grupo
3. Atribua a ela uma função de acordo com o que o Devin deve fazer:
   * **Developer** é suficiente para conectar o Devin e ler os repositórios
   * **Maintainer** se o Devin precisar configurar webhooks de projeto automaticamente
   * **Owner** para webhooks no nível do grupo (webhooks de grupo exigem GitLab Premium ou Ultimate)

Isso é necessário para que a conta de serviço possa acessar os repositórios corretamente. A associação ao grupo abrange todos os projetos dele.

***

### Etapa 3: Gere um token de acesso pessoal para a conta de serviço

Após criar a conta de serviço:

1. Localize a conta de serviço recém-criada
2. Clique nos três pontos > **Gerenciar tokens de acesso** > **Gerar um novo token de acesso pessoal** > selecione **api** nos escopos de acesso
3. Copie e armazene esse token em segurança

> [!NOTE]
>
> Certifique-se de selecionar o token da conta de serviço, e não o seu token de acesso pessoal, encontrado nas preferências do usuário. O objetivo é que o Devin atue como a conta de serviço, e não como você. Você usará esse token ao adicionar a conexão do GitLab no Devin.

***

### Etapa 4: Adicione a conexão do GitLab no Devin

No Devin:

1. Acesse **Configurações Enterprise**
2. Abra **Conexões**
3. Adicione uma nova conexão
4. Insira:
   * A **URL do GitLab auto-hospedado** (se aplicável)

![Adicionar URL da conexão do GitLab](https://mintcdn.com/cognitionai-enterprise/wPdYnPNTsINgaVgH/images/enterprise/gitlab/gitlab-add-connection.png?fit=max\&auto=format\&n=wPdYnPNTsINgaVgH\&q=85\&s=2bfe22b55a247273d394d103ab8a3646)

* O **token de acesso pessoal** criado para a conta de serviço

Isso cria a conexão Enterprise do GitLab.

***

### Etapa 5: Configurar o webhook

Configurar um webhook permite que o Devin receba automaticamente notificações em tempo real quando determinados eventos ocorrem no GitLab (como a abertura ou atualização de merge requests e comentários em merge requests).

Para configurar o webhook:

1. No Devin, acesse **Settings** > **Conexões** > **GitLab** e clique na conexão do GitLab que você acabou de adicionar para abrir o painel de detalhes
2. Na aba **General**, clique em **Configure** na linha **Webhook**
3. Copie a **URL** e o **Secret Token** do webhook exibidos na caixa de diálogo
4. Siga as etapas de **Group** (recomendado) ou **Project** indicadas na caixa de diálogo para adicionar o webhook no GitLab, selecionando os gatilhos **Comments**, **Merge request events**, **Push events**, **Issues events** e **Pipeline events**

> [!NOTE]
>
> Para adicionar um webhook no GitLab, é necessário ter a função **Maintainer** no projeto ou a função **Owner** no grupo, no caso de webhooks de grupo (Premium ou Ultimate). Quando a configuração automática de webhooks está disponível para sua organização, a caixa de diálogo informa que o Devin configura webhooks em todos os projetos e grupos que a conta de serviço pode administrar. Isso só funciona onde a conta de serviço tem essas funções (consulte a [Etapa 2](#step-2-add-the-service-account-as-a-group-member)). Se não for possível conceder à conta de serviço a função Maintainer ou Owner, um usuário do GitLab com esse acesso pode adicionar o webhook manualmente usando a URL e o token secreto exibidos na caixa de diálogo.

Após a configuração, o Devin poderá responder a eventos do GitLab em tempo real, sem depender de consultas periódicas.

***

### Etapa 6: Verifique o acesso aos repositórios

Após adicionar a conexão:

1. Confirme que a conta de serviço tem acesso aos repositórios que você quer usar
2. No Devin, se os repositórios não aparecerem imediatamente, atualize manualmente a lista de repositórios
3. Acesse **Repositórios Enterprise**
4. Selecione a organização correta

![Repositórios Enterprise](https://mintcdn.com/cognitionai-enterprise/wPdYnPNTsINgaVgH/images/enterprise/gitlab/gitlab-enterprise-repositories.png?fit=max\&auto=format\&n=wPdYnPNTsINgaVgH\&q=85\&s=874767478eede5b1785d76d8400ba99d)

5. Abra **Gerenciar permissões**
6. Adicione os repositórios relevantes com as permissões adequadas de **leitura/gravação**

![Gerenciar permissões de repositório](https://mintcdn.com/cognitionai-enterprise/wPdYnPNTsINgaVgH/images/enterprise/gitlab/gitlab-manage-permissions.png?fit=max\&auto=format\&n=wPdYnPNTsINgaVgH\&q=85\&s=0ee777490c6b85afdff6553839bbfa1b)

> [!NOTE]
>
> Se algum repositório estiver faltando, pode ser porque o Devin atualiza a lista de repositórios periodicamente, e não instantaneamente.

***

## Parte 2: Ativar a vinculação de usuários no GitLab auto-hospedado

### Etapa 7: Registre um aplicativo OAuth na instância auto-hospedada do GitLab

Para permitir que usuários individuais vinculem sua identidade do GitLab ao Devin, o administrador deve registrar um app OAuth para a instância auto-hospedada do GitLab.

No Devin:

1. Acesse a área de conexão do GitLab no Enterprise
2. Abra **Advanced**
3. Vá para a seção de GitLab auto-hospedado
4. Inicie o fluxo para **registrar um aplicativo OAuth**

![Registrar aplicativo OAuth](https://mintcdn.com/cognitionai-enterprise/w1O748bICfxd75-4/images/enterprise/gitlab/gitlab-register-oauth.png?fit=max\&auto=format\&n=w1O748bICfxd75-4\&q=85\&s=349e0b2d1c062829d16fe47b9e1aa36d)

***

### Etapa 8: Conclua o registro do app OAuth no GitLab

Siga o link no modal de registro para abrir o formulário do aplicativo no GitLab. Preencha os campos como mostrado:

1. Defina **Name** e **Redirect URI** exatamente como mostrado no modal do Devin
2. Ative a caixa de seleção **Confidential**
3. Selecione o escopo **api**
4. Clique em **Save application**

![Configurações do app OAuth do GitLab](https://mintcdn.com/cognitionai-enterprise/snLF6dmeNWm-Zgi5/images/enterprise/gitlab/gitlab-oauth-app-settings.png?fit=max\&auto=format\&n=snLF6dmeNWm-Zgi5\&q=85\&s=967122219131f4021f609f2e26458c7e)

5. Copie o **Application ID** e o **Application Secret** do GitLab
6. Volte ao Devin e cole esses valores no modal de registro
7. Clique em **Register**

Isso conclui a configuração do lado do administrador necessária para a vinculação de identidade de usuário.

***

## Parte 3: Requisito de associação à organização

### Etapa 9: Verifique se o usuário pertence à organização do Devin correta

Antes que um usuário possa vincular a conta do GitLab, ele precisa ser membro de uma organização do Devin com permissões para repositórios do GitLab.

No Devin:

1. Vá para a seção de associação à organização
2. Confirme que o usuário faz parte de uma organização do Devin com permissões para repositórios do GitLab
3. Se não fizer parte, adicione-o primeiro

> [!NOTE]
>
> **Conexões pessoais mostra apenas integrações das organizações às quais o usuário pertence.** Se um usuário não estiver em uma organização do Devin com permissões para repositórios do GitLab, a integração do GitLab pode nem aparecer.

***

## Parte 4: Configuração para o usuário final

### Etapa 10: Abra as Conexões pessoais

Como usuário final no Devin:

1. Vá para **Conexões pessoais**
2. Procure a integração auto-hospedada do GitLab

Se ela não aparecer, verifique primeiro sua associação à organização.

***

### Etapa 11: Vincule a conta do GitLab do usuário

Assim que a integração aparecer:

1. Selecione a conexão do GitLab auto-hospedado
2. Conclua o processo de vinculação
3. Vincule a **conta do GitLab** do usuário à **conta do Devin** dele

Depois disso, Devin deverá conseguir atuar como esse usuário nas operações do GitLab.

***

## Considerações de segurança

* **Credenciais criptografadas** — Todos os tokens são criptografados e armazenados com segurança. Isso inclui o token de acesso pessoal da conta de serviço, o segredo do aplicativo OAuth e os tokens OAuth gerados quando os usuários vinculam suas contas no GitLab.
* **Criptografia em trânsito** — Todos os dados são criptografados em trânsito e em repouso. O Devin se conecta à sua instância do GitLab via HTTPS, e as entregas de webhook são verificadas com o token secreto gerado na configuração do webhook.
* **Autorização explícita** — Adicionar a conexão, por si só, não concede acesso a nenhum repositório. É preciso conceder explicitamente os repositórios a uma organização do Devin, com permissões de leitura/gravação, em **Repositórios Enterprise > Gerenciar permissões**.
* **Acesso com escopo definido** — O Devin atua por meio da conta de serviço; portanto, a função dela no GitLab (Developer, Maintainer ou Owner) e a associação dessa conta aos projetos determinam o que o Devin pode acessar.
* **Auditabilidade** — Usar uma conta de serviço dedicada facilita identificar as atividades do Devin no GitLab.
* **Proteções de branch respeitadas** — Os merge requests do Devin estão sujeitos às mesmas regras de proteção de branch e aos mesmos requisitos de aprovação que os de qualquer outro colaborador.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.