# General Translation Platform: Clés API URL: https://generaltranslation.com/fr/docs/platform/api-keys.mdx --- title: Clés API description: Gérez les clés d’authentification avec des autorisations granulaires --- Les clés API permettent d’authentifier les applications, les jobs CI et les automatisations auprès des services General Translation. Créez des clés au niveau du projet pour un projet donné, ou au niveau de l’organisation pour les automatisations qui nécessitent un accès plus large. Copiez la clé complète immédiatement après sa création. Le tableau de bord ne l’affiche qu’une seule fois. ## Portées des clés | Portée | Idéal pour | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **Projet** | Un projet unique, une application déployée, le développement local, les prévisualisations et les outils propres au projet | | **Organisation** | L’automatisation au niveau de l’organisation, la CI qui s’exécute sur plusieurs projets et les outils nécessitant des autorisations personnalisées | Les clés de projet et les clés d’organisation ont des processus de création différents. Les clés de projet sont créées comme clés de production ou de développement. Les clés d’organisation utilisent un sélecteur d’autorisations. ## Clés de projet Créez des clés de projet depuis **Project -> Clés API**. | Type | Préfixe | Cas d’usage | | ----------------- | ---------- | ----------------------------------------------------------------------------------- | | **Production** | `gtx-api-` | Applications déployées et automatisation en production | | **Développement** | `gtx-dev-` | Développement local, environnements de prévisualisation et automatisation des tests | Les clés de projet sont liées au projet sélectionné. Dans la plupart des workflows du SDK et du CLI, utilisez la clé avec votre ID de projet : ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` ## Clés d’organisation Créez des clés d’organisation depuis **Organization -> Clés API**. Les clés d’organisation utilisent le préfixe `gtx-org-` et peuvent être configurées avec un jeu d’autorisations personnalisé. Utilisez-les pour l’automatisation à l’échelle de l’organisation ou pour des workflows qui doivent s’exécuter sur l’ensemble des projets de l’organisation. ## Autorisations des clés de l’organisation Les autorisations sont configurées par ressource. `Write` inclut `Read`. | Ressource | Lecture | Écriture ou activation | | -------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------- | | **Fichiers** | Lire les fichiers du projet et les traductions | Importer le contenu source et enregistrer les fichiers traduits | | **Contexte** | Lire le contexte du projet et de l’organisation | Gérer les groupes de contexte, 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 | Accordez à chaque clé uniquement les autorisations dont elle a besoin. ## Renouveler ou révoquer des clés Ouvrez la liste des clés du projet ou de l’organisation pour passer en revue les clés existantes. Révoquez les clés qui ne sont plus utilisées et créez-en de nouvelles lors du renouvellement des identifiants d’authentification. ## Bonnes pratiques de sécurité * N’ajoutez jamais de clés au contrôle de code source * 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 * Renouvelez les clés périodiquement et révoquez celles qui ne sont pas utilisées * Préférez la portée la plus restreinte possible pour l’intégration