> 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/fr/base-de-connaissances/042-git-integration-authentication-tokens.md). # Jetons d’authentification pour l’intégration Git **Cette page décrit la méthode de connexion par jeton d’authentification Git pour accéder à vos projets via l’** [**intégration Git**](/latex/fr/base-de-connaissances/040-git-integration.md). La méthode de jeton d’authentification décrite ici est la seule méthode de connexion disponible pour Overleaf Cloud et Server Pro. L’ancienne méthode d’authentification basée sur un nom d’utilisateur et un mot de passe n’est plus disponible. L’intégration Git d’Overleaf vous permet de cloner votre projet Overleaf dans un dépôt local, en considérant votre projet Overleaf comme un dépôt distant depuis lequel des modifications peuvent être envoyées et récupérées. Résumé Pour effectuer des opérations Git sur un projet Overleaf à l’aide de Git, vous devrez vous authentifier en tant que propriétaire du projet ou en tant que collaborateur. Vous pouvez le faire à l’aide d’un **jeton d’authentification Git**. Vous pouvez créer et supprimer des jetons d’authentification dans vos [Paramètres du compte Overleaf](https://www.overleaf.com/user/settings). * Si un nom d’utilisateur vous est demandé, saisissez le nom d’utilisateur « git » * Si un mot de passe vous est demandé, saisissez votre jeton d’authentification * Le même jeton d’authentification peut être utilisé pour accéder à tous vos projets via Git * Les jetons que vous générez doivent être utilisés exclusivement par vous et conservés en lieu sûr Lors de l’exécution d’opérations Git, utilisez le nom d’utilisateur **git** et utilisez le jeton d’authentification comme mot de passe. Le même jeton d’authentification peut être utilisé pour accéder à tous vos projets via Git. Les jetons que vous générez doivent être utilisés exclusivement par vous et conservés en lieu sûr. Vous pouvez créer et supprimer des jetons d’authentification dans vos Overleaf [Paramètres du compte](https://www.overleaf.com/user/settings) page. ### Étape par étape : comment cloner un projet à l’aide des jetons d’authentification Git d’Overleaf **Les étapes suivantes expliquent comment cloner votre projet Overleaf lors de l’utilisation de la ligne de commande Git.** Si vous utilisez un autre client Git, vous pouvez utiliser une méthode adaptée au client pour fournir l’URL Git du projet, « git » comme nom d’utilisateur, et le jeton d’authentification Git comme mot de passe. Voir [Comprendre l’URL Git](#understanding-the-git-url) pour une explication des composants de l’URL Git. 1. Sélectionnez **Git** depuis le le [menu](/latex/fr/base-de-connaissances/148-using-the-overleaf-project-menu.md) dans votre projet. ![Menu du projet git.png](/files/14aea8ec978da51b0c485ae81f10600020c42a85) 1. Copiez la commande git clone et l’URL affichées dans la boîte de dialogue. Vous les utiliserez lors de la création de votre dépôt local. 2. Collez la commande et l’URL dans une invite de commandes. Notez que « git » est fourni comme nom d’utilisateur dans la commande fournie. 3. Obtenez votre jeton d’authentification Git * Si vous n’avez jamais créé de jeton d’authentification Git auparavant, vous aurez la possibilité d’en générer un maintenant. Pour ce faire, cliquez sur **Générer le jeton**. * Si vous avez déjà créé un jeton d’authentification Git, vous pouvez utiliser le même ou en générer un nouveau dans votre Overleaf [Paramètres du compte](https://www.overleaf.com/user/settings). **Astuce** : Vous pouvez [configurer des assistants d’identification Git](#how-to-save-your-token-using-git-credential-helpers) afin de ne pas avoir à fournir un jeton à chaque fois. 4. Si un mot de passe vous est demandé, saisissez votre jeton d’authentification. ### Étape par étape : comment mettre à jour l’URL distante Git du format basé sur un mot de passe vers le format basé sur des jetons d’authentification **Les étapes suivantes expliquent comment mettre à jour l’URL distante Git de l’ancien format basé sur un mot de passe vers le nouveau format basé sur des jetons d’authentification.** 1\. Ouvrez votre terminal et accédez au répertoire de votre projet : ``` cd path/to/your/project ``` 2\. Vérifiez votre URL distante actuelle : ``` git remote -v ``` Cela affichera la ou les URL actuelles de vos dépôts distants. 3\. Mettez à jour l’URL distante avec la commande suivante : ``` git remote set-url origin https://git@git.overleaf.com/ ``` Remplacez-le par l’identifiant de votre projet 4\. Vérifiez que la modification a réussi en exécutant à nouveau la commande distante : ``` git remote -v ``` Vous devriez maintenant voir la nouvelle URL listée. Lors du prochain pull ou push depuis ce dépôt local, vous devrez fournir un jeton d’authentification comme mot de passe. Si vous n’avez pas encore généré de jeton d’authentification, vous pouvez le faire depuis vos Paramètres du compte. Lors de l’utilisation des jetons d’authentification, si un nom d’utilisateur vous est demandé, utilisez "git" et le jeton d’authentification comme mot de passe — vous pouvez éviter de fournir ces identifiants à chaque opération en utilisant un assistant d’identification (voir la note ci-dessous). ### Plus d’aide sur les jetons d’authentification #### Comprendre les jetons d’authentification Git d’Overleaf * Comme un mot de passe, un jeton d’authentification Git peut être fourni à une opération Git pour confirmer votre identité. De la même manière que vous ne partageriez pas un mot de passe, vous ne devriez jamais partager vos jetons d’authentification. * Les jetons d’authentification que vous générez peuvent être utilisés pour tous les projets auxquels vous accédez via l’intégration Git. * Les jetons expirent après un an. * **Vous pouvez avoir un maximum de 10 jetons.** Si vous atteignez la limite de 10 jetons, vous devez supprimer les anciens jetons inutilisés ou expirés afin de créer un nouveau jeton. * Nous vous recommandons d’utiliser un assistant d’identification Git pour stocker votre jeton d’authentification, afin de ne pas avoir à le saisir à chaque fois que vous utilisez l’intégration Git. Vous trouverez plus d’informations sur la manière de configurer cela ci-dessous. #### Comment générer des jetons d’authentification * Vous pouvez consulter et générer des jetons d’authentification Git dans vos [Paramètres du compte](https://www.overleaf.com/user/settings). Vous pouvez générer jusqu’à 10 jetons. * La première fois que vous utilisez l’intégration Git, vous aurez également la possibilité de générer un jeton directement depuis un projet lorsque vous sélectionnez **Git** dans le projet **menu**. #### Comment enregistrer votre jeton à l’aide des assistants d’identification Git Nous vous recommandons d’utiliser un assistant d’identification Git. Cela permettra à votre client Git de mémoriser votre jeton. Si vous utilisez le client en ligne de commande Git, vous pouvez exécuter cette commande pour stocker vos identifiants : ``` $ git config --global credential.helper store ``` Vous trouverez plus d’informations à ce sujet sur cette [page de documentation Git](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage). #### Afficher les jetons générés précédemment Vous pouvez trouver une liste de vos jetons d’authentification Git dans les Paramètres de votre compte. Cependant, vous ne pourrez pas voir le jeton entier. Si vous ne vous souvenez pas de votre jeton et que les assistants d’identification Git ne sont pas activés, vous devrez en générer un nouveau. Vous pouvez le faire dans vos Paramètres du compte. #### Suppression d’un jeton généré Lorsqu’un jeton est supprimé, il ne peut plus être utilisé pour authentifier votre identité lors d’opérations Git. Si vous tentez une opération avec un jeton expiré ou supprimé, vous verrez probablement une erreur d’authentification signalée par votre client Git. #### Comment travailler avec des collaborateurs Si vous utilisez l’intégration Git d’Overleaf pour collaborer avec quelqu’un qui n’utilise pas habituellement Overleaf, vous devez partager le projet avec cette personne et elle pourra créer un compte Overleaf. Une fois cela fait, elle pourra obtenir l’URL Git du projet et générer son propre jeton afin d’accéder au projet. **Vous ne devriez jamais partager un jeton. Traitez-le avec autant de sécurité qu’un nom d’utilisateur et un mot de passe. Si vous pensez avoir accidentellement partagé un jeton, vous devriez le supprimer.** ### Comprendre l’URL Git Le `git clone` et l’URL Git peut être obtenue en sélectionnant **Git** dans le projet **menu**. Sinon, vous pouvez trouver l’URL Git à partir de l’URL du projet (l’URL dans la barre d’adresse du navigateur lorsque vous êtes dans un projet). #### Overleaf Cloud Si l’URL de votre projet Overleaf ressemble à : ``` https://www.overleaf.com/project/1234567 ``` Alors l’URL Git à utiliser pour cloner le projet sera : ``` https://git.overleaf.com/1234567 ``` Votre nom d’utilisateur sera **git** et le mot de passe sera le jeton que vous obtenez depuis votre compte Overleaf. La commande et l’URL fournies dans la fenêtre Git du menu du projet se composent de : (1) la commande git clone utilisée dans la ligne de commande Git et (2) l’URL Git complète qui inclut l’identifiant du projet précédé du nom d’utilisateur "git". ![Description visuelle de la commande git clone et de la chaîne d’URL](/files/a206ca01756a2f3c521dc8c5106b2ba541642442) #### Overleaf Server Pro Si l’URL de votre projet Overleaf ressemble à : ``` https:///project/1234567 ``` Remarque : \ est la valeur d’hôte définie par l’administrateur de votre Overleaf Server Pro. Alors l’URL Git à utiliser pour cloner le projet sera : ``` https:///git/1234567 ``` Votre nom d’utilisateur sera **git** et le mot de passe sera le jeton que vous obtenez depuis votre compte Overleaf. La commande et l’URL fournies dans la fenêtre Git du menu du projet se composent de : (1) la commande git clone utilisée dans la ligne de commande Git et (2) l’URL Git complète incluant le nom d’utilisateur "git", votre hôte Overleaf spécifique, et un chemin qui inclut l’identifiant du projet. ![Description visuelle de la commande git clone et de la chaîne d’URL](/files/8450e94b314af4c1fd3d2f1e97df31b56313e02c) --- # 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/fr/base-de-connaissances/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.