# General Translation Platform: Clés API URL: https://generaltranslation.com/fr/docs/platform/dashboard/reference/api-keys.mdx Docs index: https://generaltranslation.com/llms.txt Description: Créez et gérez les clés API de projet et d’organisation pour les applications, le développement local et l’automatisation. Référence des clés API. Les clés API permettent d’authentifier vos applications, le CLI et vos automatisations auprès de General Translation. Utilisez le niveau de clé le plus restreint compatible avec le workflow. ## Niveaux de clé [#key-scopes] General Translation prend en charge deux niveaux de clé API : * **Clés d’organisation** pour l’automatisation au niveau de l’organisation. Utilisez-les pour l’automatisation à l’échelle de l’organisation ou pour les workflows qui doivent s’exécuter sur plusieurs projets de l’organisation. * **Clés de projet** pour un seul projet. Utilisez-les pour les applications déployées, le développement local, les aperçus et les outils limités au niveau du projet. Les clés d’organisation et les clés de projet suivent des processus de création différents. Les clés de projet sont créées comme des clés de production ou de développement. Les clés d’organisation utilisent un sélecteur d’autorisations. ## Créer des clés d’organisation [#create-organization-keys] Créez des clés d’organisation depuis **organisation > Developer > API Keys**. Les clés d’organisation utilisent le préfixe `gtx-org-` et peuvent être configurées avec un ensemble d’autorisations personnalisé. Les autorisations sont configurées par ressource. `Write` inclut `Read`. | Ressource | Read | Write ou activé | | -------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------- | | **Création de projet** | Non applicable | Créer de nouveaux projets dans l’organisation | | **Clés API de projet** | Voir les clés API des projets | Voir et créer des clés API de projet | | **Files** | Lire les fichiers et les traductions du projet | Téléverser le contenu source et écrire les fichiers traduits | | **Contexte** | Lire le contexte du projet et de l’organisation | Gérer les Context Groups, le Glossary et les instructions personnalisées | | **Traduction à l’exécution** | Non applicable | Traduire le contenu à la demande | | **File d’attente de traduction** | Non applicable | Mettre en file d’attente des tâches de traduction de fichiers pour un traitement en arrière-plan | | **Paramètres du projet** | Non applicable | Mettre à jour les paramètres du projet, comme le paramètre régional par défaut et la livraison CDN | Activez **Création de projet** pour les automatisations qui appellent l’endpoint [Créer un projet](/docs/platform/openapi/reference/project/create-project). Activez également **Paramètres du projet** lorsque cette automatisation crée des projets avec la livraison CDN activée. N’accordez à chaque clé que les autorisations dont elle a besoin. Définissez **Clés API de projet** sur **Write** pour les automatisations qui appellent [Créer une clé API de projet](/docs/platform/openapi/reference/project/create-api-key). L’endpoint accepte un nom et, facultativement, un type de clé production ou clé de développement ; il n’accepte pas d’autorisations personnalisées. La clé créée reçoit les valeurs par défaut de son type, limitées aux autorisations de projet détenues par l’identité de la requête. L’identité de la requête peut être une clé d’organisation ou un jeton d’accès personnel utilisateur OAuth ; les clés de projet ne peuvent pas détenir l’autorisation `project:api_keys:write` requise. ## Créer des clés de projet [#create-project-keys] Créez des clés de projet depuis **projet > API Keys**. Copiez immédiatement la clé complète et stockez-la dans des variables d’environnement, un gestionnaire de secrets ou un autre emplacement sécurisé. * Les **clés de production** commencent par `gtx-api-`. * Utilisez-les pour les envois de fichiers, les tâches de traduction et l’automatisation de production. Les clés créées dans le dashboard disposent des autorisations de projet par défaut ; une clé créée via l’API d’organisation peut disposer de moins d’autorisations déléguées. * Les **clés de développement** commencent par `gtx-dev-`. * Utilisez-les pour la traduction à la demande pendant le développement local. Leur permission par défaut est la traduction à l’exécution ; les endpoints réservés à la production les rejettent. * N’utilisez pas de clés de développement en production. Dans la plupart des workflows du SDK et de la CLI, utilisez la clé avec l’ID de votre projet : ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` ## Gérer les clés [#manage-keys] Utilisez des noms explicites pour que les clés soient faciles à retrouver par la suite. Ouvrez la liste des clés du projet ou de l’organisation pour passer en revue les clés existantes. La liste des clés affiche : * **Name** et **Key**, incluant une clé tronquée pour aider à l’identifier * **Autorisations**, pour les clés d’organisation * **Created**, la date à laquelle la clé a été générée * **Last Used**, la date à laquelle la clé a été utilisée pour la dernière fois Si vous disposez de l’autorisation de gérer les clés, utilisez **Edit key** pour renommer une clé ou modifier les autorisations d’une clé d’organisation, et **Delete** pour la révoquer. Le secret complet n’est affiché qu’au moment de la création de la clé. Révoquez les clés qui ne sont plus utilisées et créez des clés de remplacement lors de la rotation des identifiants. ## Bonnes pratiques de sécurité [#security-practices] * N’enregistrez jamais de clés dans la gestion de versions. * Stockez les clés dans des variables d’environnement ou un gestionnaire de secrets. * Utilisez des clés distinctes pour le développement, la préproduction et la production. * Effectuez régulièrement une rotation des clés. * Révoquez les clés inutilisées. * Préférez le niveau le plus restreint compatible avec l’intégration. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.