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

# Gerencie o acesso ao repositório

> Entenda as conexões pessoais com o GitHub e o GitLab, o acesso do workspace para builds em segundo plano e quais permissões verificar quando o acesso ao repositório falha.

O acesso ao repositório tem dois propósitos distintos: trabalhar no código no seu chat e buscar código para builds de ambiente compartilhados.

## Conecte sua conta pessoal

Conecte o GitHub ou o GitLab pelas integrações do Replit. O Replit usa seu acesso autorizado para inspecionar código e, quando solicitado e permitido, fazer push de branches e abrir pull requests ou merge requests.

Peça ao Replit:

```text theme={null}
Connect my GitHub account so I can work on an existing repository.
```

Para o GitLab, troque GitHub por GitLab. Conclua o fluxo de conexão e revise o acesso solicitado.

Para conectar pela interface, abra **Repositories** e selecione **Connect** no card do provedor. Se ele mostrar **Manage**, selecione **Connect** em **Personal account**. Você também pode conectar em [Integrations](https://replit.com/settings/integrations) nas suas configurações pessoais.

![Integrações pessoais mostrando os cards de conexão do GitHub e do GitLab.](https://mintcdn.com/replit/l9aRo5oYtavP6PnT/images/code-contributions/personal-git-integrations.jpg?fit=max\&auto=format\&n=l9aRo5oYtavP6PnT\&q=85\&s=8fe6b5e6b81b70eec0de014a1458bc89)

Compartilhe a URL do repositório e confirme que o Replit consegue lê-lo. Abrir um pull request também exige permissão para fazer push de uma branch ou usar o fluxo de fork aprovado da sua equipe.

Para desconectar seu login pessoal, volte a **Repositories > Manage** e selecione **Disconnect** em **Personal account**. Isso não remove as concessões de repositório do workspace.

## Configure o acesso do workspace

Um administrador do workspace configura as concessões de repositório para builds de ambiente em segundo plano. Seu login pessoal não substitui essa configuração compartilhada.

Abra **Repositories**, encontre o card do provedor e selecione **Manage**. Se o card mostrar **Connect**, entre primeiro. Em **Workspace connection(s)**, escolha **Connect** para entrar na configuração do workspace ou **Configure** para gerenciar o acesso existente.

Somente administradores do workspace podem configurar o acesso compartilhado. Os membros podem visualizá-lo e gerenciar o próprio login pessoal. A disponibilidade pode variar por workspace.

### GitHub: instale e conecte o app

1. Entre no GitHub no editor de conexão do workspace para ver suas organizações.
2. Escolha **Add GitHub organization** e depois selecione a organização e os repositórios do GitHub App do Replit. O administrador do GitHub pode precisar aprová-lo.
3. Volte ao Replit, selecione **Refresh** se necessário e escolha **Connect** ao lado da organização instalada. A instalação por si só não a conecta ao workspace.
4. Confirme que a organização mostra **Connected** antes de criar o build de um ambiente.

O GitHub gerencia as permissões de repositório da instalação. Se um repositório estiver ausente, revise-as com o administrador do GitHub.

### GitLab: conecte um grupo

O GitLab usa concessões de grupo e de projeto, não uma instalação de app no estilo do GitHub.

1. Entre no GitLab no editor de conexão do workspace para ver seus grupos.
2. Escolha **Configure** ao lado de um grupo, selecione os projetos a compartilhar e depois escolha **Connect group**.
3. Confirme que o grupo mostra **Connected**. Use **Edit** para alterar os projetos selecionados depois.

Se um grupo ou projeto estiver ausente, verifique suas permissões no GitLab e os requisitos de aprovação da organização.

### Desconecte o acesso compartilhado

Em **Repositories > Manage > Configure**, escolha **Disconnect** para a concessão do workspace. Isso remove o acesso do workspace por meio dessa concessão, não o seu login pessoal nem a instalação do GitHub App no lado do provedor.

Builds e projetos que dependem da concessão perdem o acesso ao repositório. Desconectar um grupo do GitLab também remove a conta de serviço do Replit, as associações e os webhooks dele, e revoga os tokens de build existentes.

Para remover apenas projetos selecionados do GitLab, use **Edit**. Remover projetos revoga o acesso do workspace a eles e pode invalidar tokens de build existentes.

## Solucione problemas de acesso

* **O chat não consegue ler ou fazer push:** Verifique a conta pessoal conectada e as permissões dela no repositório.
* **O build do ambiente não consegue buscar o código:** Verifique a conexão do workspace e os repositórios selecionados.
* **O app não consegue acessar um serviço:** O acesso ao repositório não fornece credenciais de aplicação. Consulte [Adicione segredos aos ambientes](https://docs.replit.com/pt/build/code/adding-secrets-to-environments.md).

Nunca cole um token de acesso pessoal no chat para contornar um erro de acesso.

Depois de configurar o acesso compartilhado, continue em [Crie um ambiente reutilizável](https://docs.replit.com/pt/build/code/create-reusable-environment.md). Identidades de serviços externos e secrets de chat não substituem uma concessão de repositório do workspace.