> 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/overleaf-learn-latex-pt/base-de-conhecimento/042-git-integration-authentication-tokens.md). # Tokens de autenticação da integração com Git **Esta página descreve o método de início de sessão com token de autenticação Git para aceder aos seus projetos através da** [**integração Git do Overleaf**](/latex/overleaf-learn-latex-pt/base-de-conhecimento/040-git-integration.md). O método de token de autenticação descrito aqui é o único método de início de sessão disponível tanto para o Overleaf Cloud como para o Server Pro. O método mais antigo de autenticação baseado em nome de utilizador e palavra-passe já não está disponível. A integração Git do Overleaf permite-lhe clonar o seu projeto do Overleaf para um repositório local, tratando o seu projeto do Overleaf como um repositório remoto para o qual podem ser enviadas e de onde podem ser obtidas alterações. Resumo Para realizar operações Git num projeto do Overleaf usando Git, terá de autenticar-se como proprietário do projeto ou como colaborador. Pode fazê-lo usando um **token de autenticação Git**. Pode criar e eliminar tokens de autenticação nas suas [Definições da Conta do Overleaf](https://www.overleaf.com/user/settings). * Se lhe for pedido um nome de utilizador, introduza o nome de utilizador “git” * Quando lhe for pedida uma palavra-passe, introduza o seu token de autenticação * O mesmo token de autenticação pode ser usado para aceder a todos os seus projetos usando Git * Os tokens que gerar devem ser usados exclusivamente por si e armazenados de forma segura Ao realizar operações Git, use o nome de utilizador **git** e use o token de autenticação como palavra-passe. O mesmo token de autenticação pode ser usado para aceder a todos os seus projetos usando Git. Os tokens que gerar devem ser usados exclusivamente por si e armazenados de forma segura. Pode criar e eliminar tokens de autenticação na sua conta do Overleaf [Definições da conta](https://www.overleaf.com/user/settings) página. ### Passo a passo: Como clonar um projeto usando tokens de autenticação Git do Overleaf **Os passos seguintes explicam como clonar o seu projeto do Overleaf ao usar a linha de comandos do Git.** Se estiver a usar outro cliente Git, pode usar um método apropriado para o cliente para fornecer o URL Git do projeto, "git" como nome de utilizador e o token de autenticação Git como palavra-passe. Consulte [Compreender o URL Git](#understanding-the-git-url) para uma explicação dos componentes do URL Git. 1. Selecione **Git** a partir do [Menu](/latex/overleaf-learn-latex-pt/base-de-conhecimento/148-using-the-overleaf-project-menu.md) no seu projeto. ![Menu do projeto git.png](/files/288a0a1df7077f434aad02c8ddf604f513f9a91c) 1. Copie o comando git clone e o URL apresentados na caixa de diálogo. Vai utilizá-los ao criar o seu repositório local. 2. Cole o comando e o URL numa linha de comandos. Note que "git" é fornecido como nome de utilizador no comando fornecido. 3. Obtenha o seu token de autenticação Git * Se ainda não tiver criado um token de autenticação Git, ser-lhe-á dada a opção de gerar um agora. Para tal, clique em **Gerar token**. * Se já tiver criado um token de autenticação Git, pode usar o mesmo ou gerar um novo na sua conta do Overleaf [Definições da conta](https://www.overleaf.com/user/settings). **Dica útil**: Pode [configurar auxiliares de credenciais do Git](#how-to-save-your-token-using-git-credential-helpers) para não ter de fornecer um token sempre. 4. Quando lhe for pedida uma palavra-passe, introduza o seu token de autenticação. ### Passo a passo: Como atualizar o URL remoto do Git do formato baseado em palavra-passe para tokens de autenticação **Os passos seguintes explicam como atualizar o URL remoto do Git do formato anterior baseado em palavra-passe para o novo formato baseado em token de autenticação.** 1\. Abra o seu terminal e navegue até ao diretório do seu projeto: ``` cd caminho/para/o/seu/projeto ``` 2\. Verifique o URL remoto atual: ``` git remote -v ``` Isto irá apresentar o(s) URL(s) atual(is) do(s) seu(s) remoto(s). 3\. Atualize o URL remoto usando o seguinte comando: ``` git remote set-url origin https://git@git.overleaf.com/ ``` Substitua-o pelo ID do seu projeto 4\. Verifique se a alteração foi bem-sucedida executando novamente o comando remoto: ``` git remote -v ``` Deverá ver agora o novo URL listado. Na próxima operação pull ou push a partir deste repositório local, terá de fornecer um token de autenticação como palavra-passe. Se ainda não tiver gerado um token de autenticação, pode fazê-lo nas Definições da sua Conta. Ao usar tokens de autenticação, se lhe for pedido um nome de utilizador, use "git" e o token de autenticação como palavra-passe — pode evitar fornecer estas credenciais em cada operação usando um auxiliar de credenciais (consulte a nota abaixo). ### Mais ajuda com tokens de autenticação #### Compreender os tokens de autenticação Git do Overleaf * Tal como uma palavra-passe, um token de autenticação Git pode ser fornecido a uma operação Git para confirmar a sua identidade. Da mesma forma que não partilharia uma palavra-passe, nunca deve partilhar os seus tokens de autenticação. * Os tokens de autenticação que gerar podem ser usados em todos os projetos a que está a aceder através da integração Git. * Os tokens expiram após um ano. * **Pode ter no máximo 10 tokens.** Se atingir o limite de 10 tokens, deverá eliminar tokens antigos não utilizados ou expirados para poder criar um novo token. * Recomendamos usar um auxiliar de credenciais do Git para guardar o seu token de autenticação, para que não tenha de o introduzir sempre que usar a integração Git. Há mais informações sobre como configurá-lo abaixo. #### Como gerar tokens de autenticação * Pode rever e gerar tokens de autenticação Git nas suas [Definições da conta](https://www.overleaf.com/user/settings). Pode gerar até 10 tokens. * Na primeira vez que usar a integração Git, também terá a opção de gerar um token diretamente a partir de um projeto quando selecionar **Git** no projeto **Menu**. #### Como guardar o seu token usando auxiliares de credenciais Git Recomendamos usar um auxiliar de credenciais Git. Isto permitirá ao seu cliente Git memorizar o seu token. Se estiver a usar o cliente de linha de comandos Git, pode executar este comando para guardar as suas credenciais: ``` $ git config --global credential.helper store ``` Há mais informações sobre isto nesta [página de documentação do Git](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage). #### Ver tokens gerados anteriormente Pode encontrar uma lista dos seus tokens de autenticação Git nas Definições da sua Conta. No entanto, não poderá ver o token completo. Se não se lembrar do seu token e não tiver os auxiliares de credenciais Git ativados, terá de gerar um novo. Pode fazê-lo nas Definições da sua Conta. #### Eliminar um token gerado Quando um token é eliminado, deixa de poder ser usado para autenticar a sua identidade ao realizar operações Git. Se tentar uma operação com um token expirado ou eliminado, é provável que veja um erro de autenticação indicado pelo seu cliente Git. #### Como trabalhar com colaboradores Se estiver a usar a integração Git do Overleaf para colaborar com alguém que normalmente não usa o Overleaf, deve partilhar o projeto com essa pessoa e ela poderá criar uma conta Overleaf. Depois de o fazer, poderá obter o URL Git do projeto e gerar o seu próprio token para aceder ao projeto. **Nunca deve partilhar um token. Trate-o com a mesma segurança que um nome de utilizador e uma palavra-passe. Se achar que partilhou acidentalmente um token, deve eliminá-lo.** ### Compreender o URL Git O `git clone` e o URL Git podem ser obtidos selecionando **Git** no projeto **Menu**. Em alternativa, pode encontrar o URL Git a partir do URL do projeto (o URL na barra de endereços do navegador quando está num projeto). #### Overleaf Cloud Se o URL do seu projeto do Overleaf tiver o aspeto de: ``` https://www.overleaf.com/project/1234567 ``` Então o URL Git a usar para clonar o projeto será: ``` https://git.overleaf.com/1234567 ``` O seu nome de utilizador será **git** e a palavra-passe será o token que obtém na sua conta do Overleaf. O comando e o URL fornecidos na janela modal do Git no menu do projeto consistem em: (1) o comando git clone usado na linha de comandos do Git e (2) o URL Git completo que inclui o ID do projeto precedido pelo nome de utilizador "git". ![Descrição visual do comando git clone e da string do URL](/files/2707851292167f8324008ca4718503ed9a90c5e4) #### Overleaf Server Pro Se o URL do seu projeto do Overleaf tiver o aspeto de: ``` https:///project/1234567 ``` Nota: O \ é o valor do host definido pelo administrador do seu Overleaf Server Pro. Então o URL Git a usar para clonar o projeto será: ``` https:///git/1234567 ``` O seu nome de utilizador será **git** e a palavra-passe será o token que obtém na sua conta do Overleaf. O comando e o URL fornecidos na janela modal do Git no menu do projeto consistem em: (1) o comando git clone usado na linha de comandos do Git e (2) o URL Git completo que inclui o nome de utilizador "git", o seu host específico do Overleaf e um caminho que inclui o ID do projeto. ![Descrição visual do comando git clone e da string do URL](/files/1a5451ea37d05c70c99186ab0df2f32847304415) --- # 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/overleaf-learn-latex-pt/base-de-conhecimento/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.