# General Translation Platform: Chiavi API URL: https://generaltranslation.com/it/docs/platform/dashboard/reference/api-keys.mdx --- title: Chiavi API description: Crea e gestisci le chiavi API del progetto e dell'organizzazione per app, sviluppo locale e automazione. --- Le chiavi API autenticano le tue app, la CLI e l'automazione con General Translation. Usa lo scope della chiave più ristretto adatto al workflow. ## Ambiti delle chiavi [#key-scopes] GT supporta due ambiti per le chiavi API: * **Chiavi di organizzazione** per l'automazione a livello di organizzazione. Usale per l'automazione a livello di organizzazione o per workflow che devono operare tra più progetti dell'organizzazione. * **Chiavi di progetto** per un singolo progetto. Usale per app distribuite, sviluppo locale, anteprime e strumenti a livello di progetto. Le chiavi di organizzazione e le chiavi di progetto seguono procedure di creazione diverse. Le chiavi di progetto vengono create come chiavi di produzione o di sviluppo. Le chiavi di organizzazione prevedono un selettore dei permessi. ## Crea chiavi di organizzazione [#create-organization-keys] Crea chiavi di organizzazione da **Organization > chiave API**. Le chiavi di organizzazione usano il prefisso `gtx-org-` e possono essere configurate con un set di autorizzazioni personalizzato. Le autorizzazioni sono configurate per risorsa. `Write` include `Read`. | Risorsa | Read | Write o abilitato | | ----------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------- | | **File** | Leggere i file e le traduzioni del progetto | Caricare contenuti sorgente e scrivere file tradotti | | **Contesto** | Leggere il contesto del progetto e dell'organizzazione | Gestire gruppi di contesto, Glossario e direttive | | **Traduzione runtime** | Non applicabile | Tradurre contenuti su richiesta | | **Coda di traduzione** | Non applicabile | Mettere in coda i job di traduzione dei file per l'elaborazione in background | | **Impostazioni del progetto** | Non applicabile | Aggiornare le impostazioni del progetto, come l'impostazione regionale predefinita | Concedi a ogni chiave solo le autorizzazioni necessarie. ## Crea chiavi di progetto [#create-project-keys] Crea le chiavi di progetto da **Progetto > Chiavi API**. Copia subito la chiave completa e salvala nelle variabili d'ambiente, in un gestore di segreti o in un altro archivio sicuro. * Le **chiavi di produzione** iniziano con `gtx-api-`. * Usale nelle applicazioni distribuite e nell'automazione di produzione. Le traduzioni di produzione usano contenuti pubblicati. * Le **chiavi di sviluppo** iniziano con `gtx-dev-`. * Usale per lo sviluppo locale, gli ambienti di anteprima e l'automazione dei test. Le chiavi di sviluppo ti consentono di testare le traduzioni prima che vengano pubblicate, senza influire sulla tua applicazione in produzione. * Non usare chiavi di sviluppo in produzione. Nella maggior parte dei workflow con SDK e CLI, usa la chiave con il tuo ID progetto: ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` ## Gestisci le chiavi [#manage-keys] Usa nomi descrittivi, così sarà più facile identificare le chiavi in seguito. Apri l'elenco delle chiavi del progetto o di organizzazione per esaminare le chiavi esistenti. L'elenco delle chiavi mostra: * **Anteprima**, una versione abbreviata della chiave per identificarla * **Creata il**, la data in cui la chiave è stata generata * **Ultimo utilizzo**, quando la chiave è stata usata l'ultima volta * **Elimina**, per revocare una chiave che non ti serve più Revoca le chiavi che non vengono più usate e creane di nuove quando effettui la rotazione delle credenziali. ## Pratiche di sicurezza [#security-practices] * Non eseguire mai il commit delle chiavi nel sistema di controllo versione. * Conserva le chiavi nelle variabili d'ambiente o in un gestore di segreti. * Usa chiavi separate per sviluppo, staging e produzione. * Ruota periodicamente le chiavi. * Revoca le chiavi non utilizzate. * Preferisci lo scope più limitato che funzioni per l'integrazione.