> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ko/knowledge-base/042-git-integration-authentication-tokens.md).

# Git 연동 인증 토큰

**이 페이지에서는 Overleaf의** [**Git 통합**](/latex/ko/knowledge-base/040-git-integration.md). 이곳에서 설명하는 인증 토큰 방식은 Overleaf Cloud와 Server Pro에서 사용할 수 있는 유일한 로그인 방식입니다. 기존의 사용자 이름과 비밀번호 기반 인증 방식은 더 이상 사용할 수 없습니다.

Overleaf Git 통합을 사용하면 Overleaf 프로젝트를 로컬 저장소로 클론할 수 있으며, Overleaf 프로젝트를 변경 사항을 푸시하고 풀 수 있는 원격 저장소로 취급합니다.

요약

Git을 사용하여 Overleaf 프로젝트에서 Git 작업을 수행하려면 프로젝트 소유자 또는 공동 작업자로 인증해야 합니다. 다음을 사용하여 이를 수행할 수 있습니다. **Git 인증 토큰**. 인증 토큰은 [Overleaf 계정 설정](https://www.overleaf.com/user/settings).

* 사용자 이름을 입력하라는 메시지가 표시되면 사용자 이름 "git"을 입력하세요
* 비밀번호를 입력하라는 메시지가 표시되면 인증 토큰을 입력하세요
* 동일한 인증 토큰을 사용하여 Git으로 모든 프로젝트에 액세스할 수 있습니다
* 생성한 토큰은 본인만 독점적으로 사용해야 하며 안전하게 보관해야 합니다

Git 작업을 수행할 때는 사용자 이름 **git** 을 사용하고 비밀번호로 인증 토큰을 사용하세요. 동일한 인증 토큰을 사용하여 Git으로 모든 프로젝트에 액세스할 수 있습니다. 생성한 토큰은 본인만 독점적으로 사용해야 하며 안전하게 보관해야 합니다. Overleaf [계정 설정](https://www.overleaf.com/user/settings) 페이지 통합 섹션에서 Overleaf용 Writefull을 켜거나 끌 수 있습니다.

### 단계별 안내: Overleaf Git 인증 토큰을 사용하여 프로젝트를 클론하는 방법

**다음 단계에서는 Git 명령줄을 사용할 때 Overleaf 프로젝트를 클론하는 방법을 설명합니다.**

다른 Git 클라이언트를 사용하는 경우, 해당 클라이언트에 적합한 방법을 사용하여 프로젝트의 Git URL, 사용자 이름으로 "git", 비밀번호로 Git 인증 토큰을 제공할 수 있습니다. 다음을 참조하세요. [Git URL 이해하기](#understanding-the-git-url) 에서 Git URL의 구성 요소에 대한 설명을 확인하세요.

1. 에서 선택할 수 있습니다. **Git** 프로젝트의 [메뉴](/latex/ko/knowledge-base/148-using-the-overleaf-project-menu.md) 에서.

![프로젝트 메뉴 git.png](/files/86b68f95f79cb2717dd0c9429a62a680f069da13)

1. 대화 상자에 표시된 git clone 명령과 URL을 복사하세요. 로컬 저장소를 만들 때 이 정보를 사용하게 됩니다.
2. 명령과 URL을 명령 프롬프트에 붙여넣으세요. 제공된 명령에서 사용자 이름으로 "git"이 제공된다는 점에 유의하세요.
3. Git 인증 토큰 받기
   * 이전에 Git 인증 토큰을 만든 적이 없다면 지금 생성할 수 있는 옵션이 표시됩니다. 그렇게 하려면 **토큰 생성**.
   * 이미 Git 인증 토큰을 만든 적이 있다면 동일한 토큰을 사용할 수도 있고 Overleaf [계정 설정](https://www.overleaf.com/user/settings). **핵심 팁**: 다음을 [Git 자격 증명 도우미를 설정하여](#how-to-save-your-token-using-git-credential-helpers) 매번 토큰을 입력하지 않아도 되게 할 수 있습니다.
4. 비밀번호를 입력하라는 메시지가 표시되면 인증 토큰을 입력하세요.

### 단계별 안내: 비밀번호 기반 형식에서 인증 토큰으로 Git 원격 URL을 업데이트하는 방법

**다음 단계에서는 이전의 비밀번호 기반 형식에서 새로운 인증 토큰 기반 형식으로 Git 원격 URL을 업데이트하는 방법을 설명합니다.**

1\. 터미널을 열고 프로젝트 디렉터리로 이동하세요:

```
cd path/to/your/project
```

2\. 현재 원격 URL을 확인하세요:

```
git remote -v
```

그러면 원격 저장소의 현재 URL이 표시됩니다.

3\. 다음 명령을 사용하여 원격 URL을 업데이트하세요:

```
git remote set-url origin https://git@git.overleaf.com/<YOUR_PROJECT_ID>
```

이를 프로젝트 ID로 바꾸세요

4\. 원격 명령을 다시 실행하여 변경이 성공했는지 확인하세요:

```
git remote -v
```

이제 새 URL이 표시되어야 합니다.

이 로컬 저장소에서 다음 번에 pull 또는 push를 할 때 비밀번호로 인증 토큰을 제공해야 합니다. 아직 인증 토큰을 생성하지 않았다면 계정 설정에서 생성할 수 있습니다. 인증 토큰을 사용할 때 사용자 이름을 입력하라는 메시지가 표시되면 "git"을 사용하고 비밀번호로 인증 토큰을 사용하세요. 자격 증명 도우미를 사용하면 각 작업마다 이러한 자격 증명을 입력하지 않아도 됩니다(아래 참고 참조).

### 인증 토큰에 대한 추가 도움말

#### Overleaf Git 인증 토큰 이해하기

* 비밀번호와 마찬가지로, Git 인증 토큰은 Git 작업을 수행할 때 본인 확인을 위해 제공할 수 있습니다. 비밀번호를 공유하지 않는 것처럼 인증 토큰도 절대 공유해서는 안 됩니다.
* 생성한 인증 토큰은 Git 통합을 사용해 액세스하는 모든 프로젝트에서 사용할 수 있습니다.
* 토큰은 1년 후 만료됩니다.
* **토큰은 최대 10개까지 가질 수 있습니다.** 10개 토큰 한도에 도달하면 새 토큰을 만들기 위해 더 이상 사용하지 않거나 만료된 오래된 토큰을 삭제해야 합니다.
* Git 자격 증명 도우미를 사용하여 인증 토큰을 저장하는 것이 좋습니다. 그러면 Git 통합을 사용할 때마다 토큰을 입력하지 않아도 됩니다. 아래에 설정 방법에 대한 추가 정보가 있습니다.

#### 인증 토큰 생성 방법

* 계정 설정에서 Git 인증 토큰을 검토하고 생성할 수 있습니다. [계정 설정](https://www.overleaf.com/user/settings). 토큰은 최대 10개까지 생성할 수 있습니다.
* Git 통합을 처음 사용할 때 프로젝트에서 직접 토큰을 생성할 수도 있으며, 다음을 선택하면 됩니다. **Git** 프로젝트에서 **메뉴**.

#### Git 자격 증명 도우미를 사용하여 토큰을 저장하는 방법

Git 자격 증명 도우미를 사용하는 것을 권장합니다. 이렇게 하면 Git 클라이언트가 토큰을 기억할 수 있습니다.

Git 명령줄 클라이언트를 사용하는 경우, 다음 명령을 실행하여 자격 증명을 저장할 수 있습니다:

```
$ git config --global credential.helper store
```

이에 대한 자세한 정보는 이 [Git 문서 페이지](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage).

#### 이전에 생성한 토큰 보기

계정 설정에서 Git 인증 토큰 목록을 찾을 수 있습니다. 다만 전체 토큰은 볼 수 없습니다. 토큰을 기억할 수 없고 Git 자격 증명 도우미도 활성화되어 있지 않다면 새 토큰을 생성해야 합니다. 계정 설정에서 그렇게 할 수 있습니다.

#### 생성된 토큰 삭제하기

토큰이 삭제되면 Git 작업을 수행할 때 더 이상 본인 인증에 사용할 수 없습니다. 만료되었거나 삭제된 토큰으로 작업을 시도하면 Git 클라이언트에서 인증 오류가 보고될 가능성이 높습니다.

#### 공동 작업자와 함께 작업하는 방법

보통 Overleaf를 사용하지 않는 사람과 협업하기 위해 Overleaf의 Git 통합을 사용하는 경우, 프로젝트를 공유하고 상대방이 Overleaf 계정을 만들도록 해야 합니다. 그렇게 하면 프로젝트의 Git URL을 얻고 자신의 토큰을 생성하여 프로젝트에 액세스할 수 있습니다.

**토큰은 절대로 공유해서는 안 됩니다. 사용자 이름과 비밀번호만큼 안전하게 취급하세요. 실수로 토큰을 공유했다고 생각되면 삭제해야 합니다.**

### Git URL 이해하기

다음 `git clone` 및 Git URL은 다음을 선택하여 얻을 수 있습니다. **Git** 프로젝트에서 **메뉴**. 또는 프로젝트 URL(프로젝트에 있을 때 브라우저 주소 표시줄의 URL)에서 Git URL을 찾을 수 있습니다.

#### Overleaf Cloud

Overleaf 프로젝트 URL이 다음과 같다면:

```
https://www.overleaf.com/project/1234567
```

그렇다면 프로젝트를 클론하는 데 사용할 Git URL은 다음과 같습니다:

```
https://git.overleaf.com/1234567
```

사용자 이름은 **git** 이고 비밀번호는 Overleaf 계정에서 얻은 토큰입니다.

프로젝트 메뉴의 Git 모달에 제공된 명령과 URL은 다음으로 구성됩니다: (1) Git 명령줄에서 사용하는 git clone 명령과 (2) "git" 사용자 이름이 앞에 붙은 프로젝트 ID를 포함하는 전체 Git URL입니다.

![git clone 명령과 URL 문자열의 시각적 설명](/files/1ed7051fec923248c6247be4a57a7d0488c09d94)

#### Overleaf Server Pro

Overleaf 프로젝트 URL이 다음과 같다면:

```
 https://<SHARELATEX_SITE_URL>/project/1234567
```

참고: \<SHARELATEX\_SITE\_URL>은 Overleaf Server Pro 관리자에 의해 설정된 호스트 값입니다.

그렇다면 프로젝트를 클론하는 데 사용할 Git URL은 다음과 같습니다:

```
https://<SHARELATEX_SITE_URL>/git/1234567
```

사용자 이름은 **git** 이고 비밀번호는 Overleaf 계정에서 얻은 토큰입니다.

프로젝트 메뉴의 Git 모달에 제공된 명령과 URL은 다음으로 구성됩니다: (1) Git 명령줄에서 사용하는 git clone 명령과 (2) "git" 사용자 이름, 사용자의 Overleaf 호스트, 그리고 프로젝트 ID가 포함된 경로를 포함하는 전체 Git URL입니다.

![git clone 명령과 URL 문자열의 시각적 설명](/files/4102c5f92a50309f72f92cc76773d54e90af04b1)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ko/knowledge-base/042-git-integration-authentication-tokens.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.