# General Translation Platform: Chiavi API URL: https://generaltranslation.com/it/docs/platform/api-keys.mdx --- title: Chiavi API description: Gestisci le chiavi di autenticazione con autorizzazioni granulari --- Le chiavi API autenticano applicazioni, processi CI e automazioni con i servizi di General Translation. Crea chiavi a livello di progetto per un singolo progetto, oppure a livello di organizzazione per automazioni che richiedono un accesso più ampio. Copia subito la chiave completa dopo averla creata. La dashboard la mostra una sola volta. ## Ambiti delle chiavi | Ambito | Ideale per | | ------------------ | --------------------------------------------------------------------------------------------------------------------------- | | **Progetto** | Un singolo progetto, un'app deployata, lo sviluppo locale, le anteprime e gli strumenti specifici del progetto | | **Organizzazione** | Automazione a livello di organizzazione, CI che funziona su più progetti e strumenti che richiedono autorizzazioni personalizzate | Le chiavi di progetto e le chiavi di organizzazione hanno flussi di creazione diversi. Le chiavi di progetto vengono create come chiavi di produzione o di sviluppo. Le chiavi di organizzazione usano un selettore delle autorizzazioni. ## Chiavi di progetto Crea le chiavi di progetto in **Project -> API Keys**. | Tipo | Prefisso | Caso d'uso | | -------------- | ---------- | ------------------------------------------------------------- | | **Produzione** | `gtx-api-` | Applicazioni distribuite e automazione di produzione | | **Sviluppo** | `gtx-dev-` | Sviluppo locale, ambienti di anteprima e automazione dei test | Le chiavi di progetto sono associate al progetto selezionato. Nella maggior parte dei workflow di progetto con SDK e CLI, usa la chiave insieme al tuo ID progetto: ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` ## Chiavi di organizzazione Crea le chiavi di organizzazione in **Organization -> API Keys**. Le chiavi di organizzazione usano il prefisso `gtx-org-` e possono essere configurate con un set personalizzato di autorizzazioni. Usale per l’automazione a livello di organizzazione o per workflow che devono operare su più progetti dell’organizzazione. ## Autorizzazioni della chiave dell'organizzazione Le autorizzazioni vengono configurate per risorsa. `Write` include `Read`. | Risorsa | Read | Write o abilitato | | ----------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------- | | **File** | Leggere i file e le traduzioni del progetto | Caricare il contenuto sorgente e scrivere i file tradotti | | **Contesto** | Leggere il contesto del progetto e dell'organizzazione | Gestire i gruppi di contesto, il glossario e le direttive | | **Traduzione runtime** | Non applicabile | Tradurre i contenuti on demand | | **Coda di traduzione** | Non applicabile | Accodare 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. ## Ruota o revoca le chiavi Apri l'elenco delle chiavi del progetto o dell'organizzazione per esaminare quelle esistenti. Revoca le chiavi che non usi più e creane di nuove quando ruoti le credenziali. ## Pratiche di sicurezza * Non eseguire mai il commit delle chiavi nel 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 e revoca quelle non utilizzate * Preferisci l'ambito più ristretto possibile compatibile con l'integrazione