> 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/ru/baza-znanii/042-git-integration-authentication-tokens.md). # Токены аутентификации для интеграции Git **На этой странице описывается метод входа с использованием токена аутентификации Git для доступа к вашим проектам через** [**интеграцию Git Overleaf**](/latex/ru/baza-znanii/040-git-integration.md). Описанный здесь метод токена аутентификации является единственным способом входа, доступным как для Overleaf Cloud, так и для Server Pro. Более старый метод аутентификации на основе имени пользователя и пароля больше недоступен. Интеграция Git Overleaf позволяет клонировать ваш проект Overleaf в локальный репозиторий, рассматривая ваш проект Overleaf как удалённый репозиторий, в который можно отправлять и из которого можно получать изменения. Краткое содержание Чтобы выполнять операции Git над проектом Overleaf с помощью Git, вам нужно пройти аутентификацию как владелец проекта или как соавтор. Это можно сделать с помощью **токена аутентификации Git**. Вы можете создавать и удалять токены аутентификации в своей учётной записи Overleaf. [Настройки аккаунта Overleaf](https://www.overleaf.com/user/settings). * Если будет запрошено имя пользователя, введите имя пользователя «git» * Если будет запрошен пароль, введите ваш токен аутентификации * Один и тот же токен аутентификации можно использовать для доступа ко всем вашим проектам через Git * Сгенерированные вами токены должны использоваться исключительно вами и храниться в безопасном месте При выполнении операций Git используйте имя пользователя **git** и используйте токен аутентификации в качестве пароля. Один и тот же токен аутентификации можно использовать для доступа ко всем вашим проектам через Git. Сгенерированные вами токены должны использоваться исключительно вами и храниться в безопасном месте. Вы можете создавать и удалять токены аутентификации в своей учётной записи Overleaf. [Настройки аккаунта](https://www.overleaf.com/user/settings) страницы. ### Пошагово: как клонировать проект с использованием токенов аутентификации Git Overleaf **Следующие шаги объясняют, как клонировать ваш проект Overleaf при использовании командной строки Git.** Если вы используете другой Git-клиент, вы можете воспользоваться методом, подходящим для этого клиента, чтобы указать URL Git для проекта, «git» в качестве имени пользователя и токен аутентификации Git в качестве пароля. См. [Понимание URL Git](#understanding-the-git-url) для объяснения компонентов URL Git. 1. Выберите **Git** из [Меню](/latex/ru/baza-znanii/148-using-the-overleaf-project-menu.md) внутри вашего проекта. ![Меню проекта git.png](/files/e4630a88d88d0e8d0558a439addb1b1c927ffe99) 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. Если будет запрошен пароль, введите ваш токен аутентификации. ### Пошагово: как обновить удалённый URL Git с формата на основе пароля на формат с токенами аутентификации **Следующие шаги объясняют, как обновить удалённый URL Git с прежнего формата на основе пароля на новый формат на основе токена аутентификации.** 1\. Откройте терминал и перейдите в каталог вашего проекта: ``` cd path/to/your/project ``` 2\. Проверьте текущий удалённый URL: ``` git remote -v ``` Это отобразит текущие URL для ваших удалённых репозиториев. 3\. Обновите удалённый URL, выполнив следующую команду: ``` git remote set-url origin https://git@git.overleaf.com/ ``` Замените его на ID вашего проекта 4\. Убедитесь, что изменение прошло успешно, снова выполнив команду для удалённого репозитория: ``` git remote -v ``` Теперь вы должны увидеть в списке новый URL. При следующем pull или push из этого локального репозитория вам нужно будет указать токен аутентификации в качестве пароля. Если вы ещё не сгенерировали токен аутентификации, вы можете сделать это в настройках своей учётной записи. При использовании токенов аутентификации, если будет запрошено имя пользователя, используйте «git», а в качестве пароля — токен аутентификации; вы можете избежать ввода этих учётных данных при каждой операции, используя помощник учётных данных (см. примечание ниже). ### Дополнительная помощь по токенам аутентификации #### Понимание токенов аутентификации Git Overleaf * Как и пароль, токен аутентификации Git можно предоставить Git-операции для подтверждения вашей личности. Так же, как вы не стали бы делиться паролем, вы никогда не должны делиться своими токенами аутентификации. * Сгенерированные вами токены аутентификации можно использовать во всех проектах, к которым вы получаете доступ через интеграцию Git. * Токены истекают через один год. * **У вас может быть не более 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-клиент, скорее всего, сообщит об ошибке аутентификации. #### Как работать с соавторами Если вы используете интеграцию Git Overleaf для совместной работы с человеком, который обычно не пользуется Overleaf, вам следует поделиться с ним проектом, и он сможет создать учётную запись Overleaf. После этого он сможет получить URL Git для проекта и сгенерировать собственный токен, чтобы получить доступ к проекту. **Никогда не делитесь токеном. Относитесь к нему так же безопасно, как к имени пользователя и паролю. Если вы считаете, что случайно поделились токеном, вам следует удалить его.** ### Понимание URL Git Это `git clone` а Git URL можно получить, выбрав **Git** в проекте **Меню**. В качестве альтернативы вы можете найти Git URL по URL проекта (URL в адресной строке браузера, когда вы находитесь в проекте). #### Overleaf Cloud Если URL вашего проекта Overleaf выглядит так: ``` https://www.overleaf.com/project/1234567 ``` Тогда URL Git, который нужно использовать для клонирования проекта, будет: ``` https://git.overleaf.com/1234567 ``` Вашим именем пользователя будет **git** а паролем будет токен, который вы получите в своей учётной записи Overleaf. Команда и URL, указанные в модальном окне Git в меню проекта, состоят из: (1) команды git clone, используемой в командной строке Git, и (2) полного URL Git, который включает идентификатор проекта, перед которым добавлено имя пользователя «git». ![Визуальное описание команды git clone и строки URL](/files/a22c726053f04ca8d8888b5de860963f9ddd0b38) #### Overleaf Server Pro Если URL вашего проекта Overleaf выглядит так: ``` https:///project/1234567 ``` Примечание: \ — это значение хоста, заданное администратором вашего Overleaf Server Pro. Тогда URL Git, который нужно использовать для клонирования проекта, будет: ``` https:///git/1234567 ``` Вашим именем пользователя будет **git** а паролем будет токен, который вы получите в своей учётной записи Overleaf. Команда и URL, указанные в модальном окне Git в меню проекта, состоят из: (1) команды git clone, используемой в командной строке Git, и (2) полного URL Git, включая имя пользователя «git», ваш конкретный хост Overleaf и путь, содержащий идентификатор проекта. ![Визуальное описание команды git clone и строки URL](/files/a8891d489954168d75a931be8c746475adfce92d) --- # 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/ru/baza-znanii/042-git-integration-authentication-tokens.md?ask=&goal= ``` `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.