# General Translation Platform: Chiavi API URL: https://generaltranslation.com/it/docs/platform/dashboard/reference/api-keys.mdx Docs index: https://generaltranslation.com/llms.txt Description: Crea e gestisci le chiavi API del progetto e dell'organizzazione per app, sviluppo locale e automazione. Riferimento per le chiavi API. Le chiavi API autenticano le tue app, la CLI e l'automazione con General Translation. Usa l'ambito della chiave più ristretto adatto al workflow. ## Ambiti delle chiavi [#key-scopes] General Translation 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 **organizzazione > Developer > 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 | | ----------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | **Creazione di progetti** | Non applicabile | Creare nuovi progetti nell'organizzazione | | **Chiavi API del progetto** | Visualizzare le chiavi API dei progetti | Visualizzare e creare chiavi API del progetto | | **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 prompt personalizzati | | **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 e la distribuzione CDN | Abilita **Creazione di progetti** per l'automazione che chiama l'endpoint [Create a project](/docs/platform/openapi/reference/project/create-project). Abilita anche **Impostazioni del progetto** quando tale automazione crea progetti con la distribuzione CDN abilitata. Concedi a ogni chiave solo le autorizzazioni necessarie. Imposta **Chiavi API del progetto** su **Write** per l'automazione che chiama [Create a project API Key](/docs/platform/openapi/reference/project/create-api-key). L'endpoint accetta un nome e un key type facoltativo, produzione o sviluppo; non accetta autorizzazioni personalizzate. La chiave creata riceve i valori predefiniti previsti per il suo tipo, limitati alle autorizzazioni del progetto detenute dall'identità della richiesta. L'identità della richiesta può essere una chiave di organizzazione o un access token utente OAuth; le chiavi di progetto non possono detenere l'autorizzazione `project:api_keys:write` richiesta. ## 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 per i caricamenti di file, i job di traduzione e l'automazione di produzione. Le chiavi create nella dashboard hanno le autorizzazioni di progetto predefinite; una chiave creata tramite l'API dell'organizzazione potrebbe avere meno autorizzazioni delegate. * Le **chiavi di sviluppo** iniziano con `gtx-dev-`. * Usale per la traduzione su richiesta durante lo sviluppo locale. La loro autorizzazione predefinita è la traduzione runtime; gli endpoint riservati alla produzione le rifiutano. * 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: * **Nome** e **Chiave**, inclusa una versione abbreviata della chiave per identificarla * **Autorizzazioni**, per le chiavi di organizzazione * **Creata il**, la data in cui la chiave è stata generata * **Ultimo utilizzo**, quando la chiave è stata usata l'ultima volta Se disponi del permesso per gestire le chiavi, usa **Modifica chiave** per rinominare una chiave o aggiornare le autorizzazioni di una chiave di organizzazione ed **Elimina** per revocarla. Il segreto completo viene mostrato solo al momento della creazione della chiave. 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. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.