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

# 저장소 접근 관리하기

> 개인 GitHub 및 GitLab 연결, 백그라운드 빌드를 위한 워크스페이스 접근, 저장소 접근이 실패할 때 확인할 권한을 이해하세요.

저장소 접근에는 두 가지 별개의 목적이 있습니다. 채팅에서 코드를 작업하는 것과 공유 환경 빌드를 위해 코드를 가져오는 것입니다.

## 개인 계정 연결하기

Replit의 통합을 통해 GitHub 또는 GitLab을 연결하세요. Replit은 사용자가 승인한 접근 권한으로 코드를 살펴보고, 요청과 권한이 있을 때 브랜치를 푸시하고 pull request 또는 merge request를 엽니다.

Replit에 다음과 같이 요청하세요.

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

GitLab은 GitHub를 GitLab으로 바꿔 요청하세요. 연결 과정을 완료하고 요청된 접근 권한을 검토하세요.

인터페이스에서 연결하려면 **Repositories**를 열고 제공자 카드에서 **Connect**를 선택하세요. **Manage**가 표시되면 **Personal account** 아래의 **Connect**를 선택하세요. 개인 설정의 [Integrations](https://replit.com/settings/integrations)를 통해서도 연결할 수 있습니다.

![GitHub 및 GitLab 연결 카드가 표시된 개인 통합 페이지.](https://mintcdn.com/replit/l9aRo5oYtavP6PnT/images/code-contributions/personal-git-integrations.jpg?fit=max\&auto=format\&n=l9aRo5oYtavP6PnT\&q=85\&s=8fe6b5e6b81b70eec0de014a1458bc89)

저장소 URL을 공유하고 Replit이 읽을 수 있는지 확인하세요. pull request를 열려면 브랜치를 푸시할 권한 또는 팀이 승인한 포크 워크플로를 사용할 권한도 필요합니다.

개인 로그인을 해제하려면 **Repositories > Manage**로 돌아가 **Personal account** 아래의 **Disconnect**를 선택하세요. 이렇게 해도 워크스페이스의 저장소 권한 부여는 제거되지 않습니다.

## 워크스페이스 접근 구성하기

워크스페이스 관리자가 백그라운드 환경 빌드를 위한 저장소 권한 부여를 구성합니다. 개인 로그인은 이 공유 설정을 대신하지 않습니다.

**Repositories**를 열고 제공자 카드를 찾아 **Manage**를 선택하세요. 카드에 **Connect**가 표시되면 먼저 로그인하세요. **Workspace connection(s)** 아래에서 워크스페이스 설정을 위해 로그인하려면 **Connect**를, 기존 접근을 관리하려면 **Configure**를 선택하세요.

워크스페이스 관리자만 공유 접근을 구성할 수 있습니다. 멤버는 이를 확인하고 자신의 개인 로그인을 관리할 수 있습니다. 제공 여부는 워크스페이스마다 다를 수 있습니다.

### GitHub: 앱 설치 및 연결

1. 워크스페이스 연결 편집기에서 GitHub에 로그인해 조직을 확인합니다.
2. **Add GitHub organization**을 선택한 다음 Replit GitHub App을 설치할 조직과 저장소를 선택합니다. GitHub 관리자의 승인이 필요할 수 있습니다.
3. Replit으로 돌아와 필요하면 **Refresh**를 선택하고, 설치된 조직 옆의 **Connect**를 선택합니다. 설치만으로는 워크스페이스에 연결되지 않습니다.
4. 환경을 빌드하기 전에 조직에 **Connected**가 표시되는지 확인합니다.

GitHub가 설치의 저장소 권한을 관리합니다. 저장소가 보이지 않으면 GitHub 관리자와 함께 권한을 검토하세요.

### GitLab: 그룹 연결

GitLab은 GitHub 방식의 앱 설치가 아니라 그룹 및 프로젝트 권한 부여를 사용합니다.

1. 워크스페이스 연결 편집기에서 GitLab에 로그인해 그룹을 확인합니다.
2. 그룹 옆의 **Configure**를 선택하고, 공유할 프로젝트를 선택한 다음 **Connect group**을 선택합니다.
3. 그룹에 **Connected**가 표시되는지 확인합니다. 나중에 선택한 프로젝트를 변경하려면 **Edit**를 사용하세요.

그룹이나 프로젝트가 보이지 않으면 GitLab 권한과 조직의 승인 요구 사항을 확인하세요.

### 공유 접근 해제하기

**Repositories > Manage > Configure**에서 워크스페이스 권한 부여에 대해 **Disconnect**를 선택하세요. 이렇게 하면 해당 권한 부여를 통한 워크스페이스의 접근이 제거되며, 개인 로그인이나 제공자 측 GitHub App 설치는 제거되지 않습니다.

해당 권한 부여에 의존하는 빌드와 프로젝트는 저장소 접근 권한을 잃습니다. GitLab 그룹의 연결을 해제하면 해당 그룹의 Replit 서비스 계정, 멤버십, 웹훅도 제거되고 기존 빌드 토큰이 취소됩니다.

선택한 GitLab 프로젝트만 제거하려면 대신 **Edit**를 사용하세요. 프로젝트를 제거하면 해당 프로젝트의 워크스페이스 접근이 취소되며 기존 빌드 토큰이 무효화될 수 있습니다.

## 접근 문제 해결

* **채팅에서 읽거나 푸시할 수 없음:** 연결된 개인 계정과 해당 계정의 저장소 권한을 확인하세요.
* **환경 빌드가 코드를 가져올 수 없음:** 워크스페이스 연결과 선택한 저장소를 확인하세요.
* **앱이 서비스에 접근할 수 없음:** 저장소 접근은 애플리케이션 자격 증명을 제공하지 않습니다. [환경에 시크릿 추가하기](https://docs.replit.com/ko/build/code/adding-secrets-to-environments.md)를 참조하세요.

접근 오류를 우회하기 위해 개인 액세스 토큰을 채팅에 붙여 넣지 마세요.

공유 접근을 구성한 후에는 [재사용 가능한 환경 만들기](https://docs.replit.com/ko/build/code/create-reusable-environment.md)로 이동하세요. 외부 서비스 ID와 채팅 시크릿은 워크스페이스 저장소 권한 부여를 대신하지 않습니다.