> 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/ja/narejjibsu/042-git-integration-authentication-tokens.md).

# Git連携の認証トークン

**このページでは、Overleaf の** [**Git 連携**](/latex/ja/narejjibsu/040-git-integration.md)。ここで説明する認証トークン方式は、Overleaf Cloud と Server Pro の両方で利用できる唯一のログイン方法です。ユーザー名とパスワードを使う従来の認証方法は、現在は利用できません。

Overleaf Git 連携を使うと、Overleaf プロジェクトをローカルリポジトリにクローンでき、Overleaf プロジェクトを変更をプッシュしたりプルしたりできるリモートリポジトリとして扱えます。

概要

Overleaf プロジェクトで Git 操作を行うには、プロジェクトの所有者として、または共同編集者として認証する必要があります。これは、 **Git 認証トークン**。認証トークンは、あなたの [Overleaf アカウント設定](https://www.overleaf.com/user/settings).

* ユーザー名の入力を求められたら、ユーザー名「git」を入力してください
* パスワードの入力を求められたら、認証トークンを入力してください
* 同じ認証トークンを使って、Git でアクセスするすべてのプロジェクトにアクセスできます
* 生成したトークンは、あなただけが使用し、安全に保管してください

Git 操作を行うときは、ユーザー名 **git** を使用し、パスワードとして認証トークンを使用してください。同じ認証トークンを使って、Git でアクセスするすべてのプロジェクトにアクセスできます。生成したトークンは、あなただけが使用し、安全に保管してください。認証トークンは、あなたの Overleaf [アカウント設定](https://www.overleaf.com/user/settings) ページの「連携」セクションでオン/オフできます。

### 手順: Overleaf Git 認証トークンを使ってプロジェクトをクローンする方法

**以下の手順では、Git コマンドラインを使用して Overleaf プロジェクトをクローンする方法を説明します。**

別の Git クライアントを使用している場合は、そのクライアントに適した方法で、プロジェクトの Git URL、ユーザー名として「git」、パスワードとして Git 認証トークンを指定できます。 [Git URL の理解](#understanding-the-git-url) で、Git URL の各要素について説明しています。

1. 選択 **Git** から [メニュー](/latex/ja/narejjibsu/148-using-the-overleaf-project-menu.md) プロジェクト内。

![プロジェクトメニュー git.png](/files/aeb2578392b7d6322c9bf7b0d9be2030e2f0ef93)

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 資格情報ヘルパーで保存することをおすすめします。設定方法の詳細は以下をご覧ください。

#### 認証トークンを生成する方法

* あなたの [アカウント設定](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 から Git URL を見つけることもできます（プロジェクト内にいるとき、ブラウザのアドレスバーに表示される 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) プロジェクト ID に「git」ユーザー名が付加された完全な Git URL の 2 つで構成されています。

![git clone コマンドと URL 文字列の視覚的説明](/files/2d2d69ca22455b00dfedfe3768ee3cbc4e0a0c95)

#### 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 の 2 つで構成されています。

![git clone コマンドと URL 文字列の視覚的説明](/files/ae510b968997510dafc766ca135c603e2e142134)


---

# 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/ja/narejjibsu/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.