# 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 negli ambienti server, nello sviluppo locale e negli strumenti a livello di progetto. Non includerle mai nei bundle distribuiti per browser o app mobili. Nella Dashboard, entrambi gli ambiti supportano le autorizzazioni **All** o **Custom**. **All** concede tutte le autorizzazioni che puoi delegare all'interno di quell'ambito. **Custom** ti consente di selezionare un insieme più ristretto; seleziona almeno un'autorizzazione. Puoi concedere solo le autorizzazioni di cui disponi. ## 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. In questi controlli della Dashboard, 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 | | **Runtime translation** | 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). La sua autorizzazione `org:projects:create` consente anche di creare progetti con la distribuzione CDN abilitata; **Impostazioni del progetto** (`project:write`) serve solo per aggiornare le impostazioni in un secondo momento. Concedi a ogni chiave solo le autorizzazioni necessarie. Imposta **Contesto** su **Read** o **Write** per l'automazione che chiama la [Context Management API](/docs/platform/openapi/reference/context-management/list-groups) (`org:context:read` / `org:context:write`). Le chiavi di progetto non possono gestire i gruppi di contesto. 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). Per un progetto di un'organizzazione, usa una chiave di quell'organizzazione dotata delle autorizzazioni richieste. Le chiavi di progetto non possono creare altre chiavi. Quando crei chiavi tramite l'[API HTTP](/docs/platform/openapi/reference/project/create-api-key), seleziona le autorizzazioni in modo esplicito oppure ometti la selezione per concedere tutte le autorizzazioni del progetto che puoi delegare. A differenza dei controlli della Dashboard, le autorizzazioni Write concesse esplicitamente tramite HTTP non includono Read. ## Creare chiavi di progetto [#create-project-keys] Crea le chiavi di progetto da **progetto > chiavi API**. Le nuove chiavi iniziano con `gtx-api-` e funzionano in development, staging e produzione. Le relative autorizzazioni determinano quali operazioni possono eseguire. 1. Crea una chiave e inserisci un **Name** descrittivo. 2. In **autorizzazioni**, scegli **All** o **Custom**. 3. Con **Custom**, seleziona l'accesso necessario per ciascuna risorsa. 4. Seleziona **Create**, quindi copia subito la chiave completa. Conservala in variabili d'ambiente o in un gestore di segreti. Le chiavi di progetto supportano queste risorse: | Resource | Read | Write o enabled | | ----------------------- | -------------------------------------- | --------------------------------------------------------- | | **file** | Leggere file e traduzioni del progetto | Caricare contenuto sorgente e scrivere i translated files | | **contesto** | Leggere il contesto del progetto | Gestire il contesto del progetto | | **Runtime translation** | Non applicabile | Tradurre contenuti su richiesta | | **coda di traduzione** | Non applicabile | Accodare job di traduzione di file | | **impostazioni del progetto** | Non applicabile | Aggiornare le impostazioni del progetto | Per la traduzione su richiesta in locale è sufficiente qualsiasi chiave di progetto con `project:translations:generate`, compresa una chiave con accesso completo. Per ridurre al minimo i rischi, consigliamo una chiave dedicata con autorizzazioni **Custom**: imposta **Runtime translation** su **Enabled** e lascia le altre risorse su **None**. Per una pipeline di traduzione di file, concedi **file > Write** e **coda di traduzione > Enabled**; aggiungi **contesto > Write** se la pipeline genera contesto. L'impostazione dell'SDK `devApiKey` e la variabile d'ambiente `GT_DEV_API_KEY` continuano ad abilitare la traduzione di sviluppo e l'hot reload. In quell'impostazione indica una chiave di progetto con l'autorizzazione di runtime translation. Il nome dell'impostazione non implica un key type separato. Nella maggior parte dei workflow con SDK e CLI, usa la chiave insieme al tuo project ID: ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` Per l'accesso alla CLI tramite account, usa [`gt login`](/docs/cli/reference/commands/login). Per creare dalla CLI una chiave di progetto con autorizzazioni esplicite, usa [`gt api-key create`](/docs/cli/reference/commands/api-key-create). ## 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**, sia per le chiavi di progetto sia per quelle 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 aggiornarne le autorizzazioni 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. ## Chiavi di sviluppo esistenti [#existing-keys] Le chiavi `gtx-dev-` esistenti continuano ad autenticarsi come chiavi di progetto. Le chiavi con la vecchia autorizzazione predefinita limitata al runtime ricevono ora le autorizzazioni di progetto predefinite, che includono file, contesto, coda di traduzione e impostazioni del progetto. Gli altri set di autorizzazioni personalizzate vengono mantenuti. Controlla le chiavi esistenti in **Project > API Keys**. Per lo sviluppo locale, consigliamo di limitarle a **Runtime translation** oppure di sostituirle con nuove chiavi limitate al runtime. Le chiavi con accesso completo continuano a funzionare, ma il prefisso `gtx-dev-` non implica più autorizzazioni limitate. Non includere mai queste chiavi nei bundle client distribuiti. ## Pratiche di sicurezza [#security-practices] * Non eseguire mai il commit delle chiavi nel sistema di controllo versione. * Non includere mai alcuna chiave API nei bundle distribuiti del browser o delle app mobile, indipendentemente dalle sue autorizzazioni. Conserva le credenziali distribuite in variabili d'ambiente server-side o in un gestore di segreti. * Le chiavi API possono essere usate nel codice client servito esclusivamente dal tuo server di sviluppo locale. Le chiavi di progetto con accesso completo funzionano, ma consigliamo di limitare le chiavi di sviluppo locale a **Runtime translation** (`project:translations:generate`) per ridurre al minimo i rischi. * 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 l'ambito più limitato che funzioni per l'integrazione. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.