> 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/uk/baza-znan/042-git-integration-authentication-tokens.md). # Токени автентифікації для інтеграції Git **Ця сторінка описує спосіб входу за допомогою токена автентифікації Git для доступу до ваших проєктів через Git-інтеграцію Overleaf** [**інтеграцію Git**](/latex/uk/baza-znan/040-git-integration.md). Описаний тут метод токена автентифікації — це єдиний доступний спосіб входу як для Overleaf Cloud, так і для Server Pro. Старіший метод автентифікації на основі імені користувача та пароля більше недоступний. Інтеграція Git Overleaf дозволяє клонувати ваш проєкт 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 Git **Наведені нижче кроки пояснюють, як клонувати ваш проєкт Overleaf під час використання командного рядка Git.** Якщо ви використовуєте інший Git-клієнт, скористайтеся методом, відповідним для цього клієнта, щоб вказати Git URL проєкту, "git" як ім’я користувача та токен автентифікації Git як пароль. Див. [Розуміння Git URL](#understanding-the-git-url) щоб отримати пояснення складових Git URL. 1. Виберіть **Git** з [Меню](/latex/uk/baza-znan/148-using-the-overleaf-project-menu.md) у вашому проєкті. ![Меню проєкту git.png](/files/100ae7eac0cc1a0e65789afe2c4ac9c60247da00) 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/ ``` Замініть його на ідентифікатор вашого проєкту 4\. Переконайтеся, що зміна пройшла успішно, запустивши команду для віддаленого репозиторію ще раз: ``` git remote -v ``` Тепер ви маєте побачити в списку новий URL. Під час наступного pull або push із цього локального репозиторію вам потрібно буде ввести токен автентифікації як пароль. Якщо ви ще не згенерували токен автентифікації, це можна зробити в налаштуваннях облікового запису. Під час використання токенів автентифікації, якщо буде запропоновано ім’я користувача, використовуйте "git", а токен автентифікації — як пароль; ви можете уникнути введення цих облікових даних під час кожної операції, використовуючи помічник облікових даних (див. примітку нижче). ### Додаткова допомога з токенами автентифікації #### Розуміння токенів автентифікації Overleaf Git * Як і пароль, токен автентифікації 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. Після цього вона зможе отримати Git URL проєкту та згенерувати власний токен, щоб отримати доступ до проєкту. **Ви ніколи не повинні ділитися токеном. Ставтеся до нього так само обережно, як до імені користувача та пароля. Якщо ви вважаєте, що випадково поділилися токеном, вам слід видалити його.** ### Розуміння Git URL Функція `git clone` а Git URL можна отримати, вибравши **Git** у проєкті **Меню**. Або ж ви можете знайти Git URL у URL проєкту (URL у адресному рядку браузера, коли ви перебуваєте в проєкті). #### Overleaf Cloud Якщо URL вашого проєкту Overleaf має вигляд: ``` https://www.overleaf.com/project/1234567 ``` Тоді Git URL, який слід використовувати для клонування проєкту, буде: ``` https://git.overleaf.com/1234567 ``` Ваше ім’я користувача буде **git** а паролем буде токен, який ви отримаєте зі свого облікового запису Overleaf. Команда та URL, наведені в модальному вікні Git у меню проєкту, складаються з: (1) команди git clone, яка використовується в командному рядку Git, і (2) повного Git URL, що включає ідентифікатор проєкту з префіксом імені користувача "git". ![Візуальний опис команди git clone та рядка URL](/files/e022ccd14a4b877b1fb5cbff13568bc3fc6639bb) #### Overleaf Server Pro Якщо URL вашого проєкту Overleaf має вигляд: ``` https:///project/1234567 ``` Примітка: \ — це значення хоста, встановлене адміністратором вашого Overleaf Server Pro. Тоді Git URL, який слід використовувати для клонування проєкту, буде: ``` https:///git/1234567 ``` Ваше ім’я користувача буде **git** а паролем буде токен, який ви отримаєте зі свого облікового запису Overleaf. Команда та URL, наведені в модальному вікні Git у меню проєкту, складаються з: (1) команди git clone, яка використовується в командному рядку Git, і (2) повного Git URL, що включає імені користувача "git", ваш конкретний хост Overleaf і шлях, який містить ідентифікатор проєкту. ![Візуальний опис команди git clone та рядка URL](/files/ede8c4d4071404315c5076618d901e013a1314a7) --- # 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/uk/baza-znan/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.