> 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/it/base-di-conoscenza/042-git-integration-authentication-tokens.md). # Token di autenticazione per l'integrazione con Git **Questa pagina descrive il metodo di accesso con token di autenticazione Git per accedere ai tuoi progetti tramite** [**l'integrazione Git di Overleaf**](/latex/it/base-di-conoscenza/040-git-integration.md). Il metodo del token di autenticazione descritto qui è l'unico metodo di accesso disponibile sia per Overleaf Cloud sia per Server Pro. Il precedente metodo di autenticazione basato su nome utente e password non è più disponibile. L'integrazione Git di Overleaf ti consente di clonare il tuo progetto Overleaf in un repository locale, trattando il tuo progetto Overleaf come un repository remoto da cui è possibile fare push e pull delle modifiche. Riepilogo Per eseguire operazioni Git su un progetto Overleaf usando Git, dovrai autenticarti come proprietario del progetto o come collaboratore. Puoi farlo usando un **token di autenticazione Git**. Puoi creare ed eliminare i token di autenticazione nelle tue [Impostazioni account di Overleaf](https://www.overleaf.com/user/settings). * Se ti viene richiesto un nome utente, inserisci il nome utente “git” * Quando ti viene richiesto una password, inserisci il tuo token di autenticazione * Lo stesso token di autenticazione può essere usato per accedere a tutti i tuoi progetti tramite Git * I token che generi dovrebbero essere usati esclusivamente da te e conservati in modo sicuro Quando esegui operazioni Git, usa il nome utente **git** e usa il token di autenticazione come password. Lo stesso token di autenticazione può essere usato per accedere a tutti i tuoi progetti tramite Git. I token che generi dovrebbero essere usati esclusivamente da te e conservati in modo sicuro. Puoi creare ed eliminare i token di autenticazione nelle tue impostazioni account di Overleaf [Impostazioni account](https://www.overleaf.com/user/settings) pagina. ### Passo dopo passo: come clonare un progetto usando i token di autenticazione Git di Overleaf **I seguenti passaggi spiegano come clonare il tuo progetto Overleaf quando usi la riga di comando Git.** Se stai usando un altro client Git, puoi usare un metodo adatto al client per fornire l'URL Git del progetto, "git" come nome utente e il token di autenticazione Git come password. Vedi [Comprendere l'URL Git](#understanding-the-git-url) per una spiegazione dei componenti dell'URL Git. 1. Seleziona **Git** dal [Menu](/latex/it/base-di-conoscenza/148-using-the-overleaf-project-menu.md) all'interno del tuo progetto. ![Menu progetto git.png](/files/ffe60ac28d9fedd12047c47583cd370b896ed747) 1. Copia il comando git clone e l'URL visualizzati nella finestra di dialogo. Li userai quando creerai il tuo repository locale. 2. Incolla il comando e l'URL in un prompt dei comandi. Nota che "git" è fornito come nome utente nel comando fornito. 3. Ottieni il tuo token di autenticazione Git * Se non hai mai creato prima un token di autenticazione Git, ti verrà data l'opzione di generarne uno ora. Per farlo, fai clic su **Genera token**. * Se hai già creato un token di autenticazione Git puoi usare lo stesso oppure generarne uno nuovo nelle tue [Impostazioni account](https://www.overleaf.com/user/settings). **Suggerimento utile**: Puoi [configurare gli helper delle credenziali Git](#how-to-save-your-token-using-git-credential-helpers) in modo da non dover fornire un token ogni volta. 4. Quando ti viene richiesta una password, inserisci il tuo token di autenticazione. ### Passo dopo passo: come aggiornare l'URL remoto Git dal formato basato su password ai token di autenticazione **I seguenti passaggi spiegano come aggiornare l'URL remoto Git dal precedente formato basato su password al nuovo formato basato su token di autenticazione.** 1\. Apri il tuo terminale e vai nella directory del tuo progetto: ``` cd path/to/your/project ``` 2\. Controlla il tuo URL remoto attuale: ``` git remote -v ``` Questo mostrerà gli URL attuali dei tuoi remoti. 3\. Aggiorna l'URL remoto usando il seguente comando: ``` git remote set-url origin https://git@git.overleaf.com/ ``` Sostituiscilo con il tuo ID progetto 4\. Verifica che la modifica sia andata a buon fine eseguendo di nuovo il comando remoto: ``` git remote -v ``` Ora dovresti vedere il nuovo URL elencato. Alla prossima operazione pull o push da questo repository locale, dovrai fornire un token di autenticazione come password. Se non hai già generato un token di autenticazione, puoi farlo dalle Impostazioni account. Quando usi i token di autenticazione, se ti viene richiesto un nome utente, usa "git" e il token di autenticazione come password - puoi evitare di fornire queste credenziali a ogni operazione usando un credential helper (vedi nota sotto). ### Altre informazioni sui token di autenticazione #### Comprendere i token di autenticazione Git di Overleaf * Come una password, un token di autenticazione Git può essere fornito a un'operazione Git per confermare la tua identità. Allo stesso modo in cui non condivideresti una password, non dovresti mai condividere i tuoi token di autenticazione. * I token di autenticazione che generi possono essere usati su tutti i progetti a cui accedi tramite l'integrazione Git. * I token scadranno dopo un anno. * **Puoi avere al massimo 10 token.** Se raggiungi il limite di 10 token, dovresti eliminare i vecchi token inutilizzati o scaduti per poter creare un nuovo token. * Ti consigliamo di usare Git credential helper per memorizzare il tuo token di autenticazione, così non dovrai inserirlo ogni volta che usi l'integrazione Git. Più sotto trovi ulteriori informazioni su come configurarlo. #### Come generare token di autenticazione * Puoi controllare e generare i token di autenticazione Git nelle tue [Impostazioni account](https://www.overleaf.com/user/settings). Puoi generare fino a 10 token. * La prima volta che usi l'integrazione Git, avrai anche l'opzione di generare un token direttamente da un progetto quando selezioni **Git** nel progetto **Menu**. #### Come salvare il tuo token usando gli helper delle credenziali Git Ti consigliamo di usare un helper delle credenziali Git. Questo permetterà al tuo client Git di ricordare il tuo token. Se stai usando il client da riga di comando Git, puoi eseguire questo comando per memorizzare le tue credenziali: ``` $ git config --global credential.helper store ``` Ci sono ulteriori informazioni su questo in questa [pagina della documentazione Git](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage). #### Visualizzazione dei token generati in precedenza Puoi trovare un elenco dei tuoi token di autenticazione Git nelle Impostazioni account. Tuttavia, non potrai visualizzare il token completo. Se non ricordi il tuo token e non hai abilitato gli helper delle credenziali Git, dovrai generarne uno nuovo. Puoi farlo nelle Impostazioni account. #### Eliminazione di un token generato Quando un token viene eliminato, non può più essere usato per autenticare la tua identità durante l'esecuzione di operazioni Git. Se provi a eseguire un'operazione con un token scaduto o eliminato, probabilmente vedrai un errore di autenticazione segnalato dal tuo client Git. #### Come lavorare con i collaboratori Se stai usando l'integrazione Git di Overleaf per collaborare con qualcuno che normalmente non usa Overleaf, dovresti condividere il progetto con lui e potrà creare un account Overleaf. Una volta fatto questo, potrà ottenere l'URL Git del progetto e generare il proprio token per accedere al progetto. **Non dovresti mai condividere un token. Trattalo con la stessa sicurezza di un nome utente e una password. Se pensi di aver condiviso accidentalmente un token, dovresti eliminarlo.** ### Comprendere l'URL Git Il `git clone` e l'URL Git possono essere ottenuti selezionando **Git** nel progetto **Menu**. In alternativa, puoi trovare l'URL Git dall'URL del progetto (l'URL nella barra degli indirizzi del browser quando ti trovi in un progetto). #### Overleaf Cloud Se l'URL del tuo progetto Overleaf è simile a: ``` https://www.overleaf.com/project/1234567 ``` Allora l'URL Git da usare per clonare il progetto sarà: ``` https://git.overleaf.com/1234567 ``` Il tuo nome utente sarà **git** e la password sarà il token che ottieni dal tuo account Overleaf. Il comando e l'URL forniti nella finestra Git nel menu del progetto sono composti da: (1) il comando git clone usato nella riga di comando Git e (2) l'URL Git completo che include l'ID progetto preceduto dal nome utente "git". ![Descrizione visiva del comando git clone e della stringa dell'URL](/files/74e763081d6cca7175cd749bf2fe09b365b1ffa0) #### Overleaf Server Pro Se l'URL del tuo progetto Overleaf è simile a: ``` https:///project/1234567 ``` Nota: \ è il valore dell'host impostato dall'amministratore del tuo Overleaf Server Pro. Allora l'URL Git da usare per clonare il progetto sarà: ``` https:///git/1234567 ``` Il tuo nome utente sarà **git** e la password sarà il token che ottieni dal tuo account Overleaf. Il comando e l'URL forniti nella finestra Git nel menu del progetto sono composti da: (1) il comando git clone usato nella riga di comando Git e (2) l'URL Git completo che include il nome utente "git", il tuo host Overleaf specifico e un percorso che include l'ID progetto. ![Descrizione visiva del comando git clone e della stringa dell'URL](/files/2e3c256500321b539fabb9bd320f388c3d42d21b) --- # 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/it/base-di-conoscenza/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.