# General Translation Platform: Clés API URL: https://generaltranslation.com/fr/docs/platform/dashboard/reference/api-keys.mdx --- title: Clés API 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. --- 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] GT 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 > 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é | | -------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------- | | **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 glossaire et les directives | | **Traduction à l’exécution** | Non applicable | Traduire le contenu à la demande | | **File d’attente de traduction** | Non applicable | Mettre en file d’attente des jobs 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 | N’accordez à chaque clé que les autorisations dont elle a besoin. ## 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 **Production keys** commencent par `gtx-api-`. * Utilisez-les dans les applications déployées et l’automatisation de production. En production, les traductions utilisent le contenu publié. * Les **clés de développement** commencent par `gtx-dev-`. * Utilisez-les pour le développement local, les environnements de prévisualisation et l’automatisation des tests. Les clés de développement vous permettent de tester les traductions avant leur publication, sans affecter votre application en production. * 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 : * **Preview**, une version tronquée de la clé pour aider à l’identifier * **Created At**, 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 * **Delete**, pour révoquer une clé dont vous n’avez plus besoin 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.