Clés API
Les clés API authentifient les requêtes vers l’API de localisation et le serveur MCP. Lingo.dev propose deux types de clés — choisissez celui qui correspond à la personne ou au système qui appelle l’API.
Deux types de clés#
| Personnelle | Organisation | |
|---|---|---|
| Propriétaire | L’utilisateur qui l’a créée | Aucun — conçue pour l’automatisation |
| Autorisation | Hérite du rôle RBAC du créateur et des autorisations par moteur | Accès en lecture et en traduction à l’ensemble de l’organisation sans RBAC ; rôle propre et/ou périmètre par moteur avec RBAC |
| Si le propriétaire perd l’accès | La clé perd l’accès elle aussi | Aucun changement ; appartient à l’organisation |
| Forfait | Tous les forfaits | Tous les forfaits ; les rôles personnalisés et les restrictions nécessitent le RBAC Enterprise |
| Usage typique | Développement local, MCP, scripts ad hoc | Pipelines CI/CD, intégrations en production |
Les clés personnelles sont le choix par défaut. Les clés d’organisation sont des ressources au niveau de l’organisation, dissociées de toute personne en particulier — idéal pour des identifiants qui doivent rester valides au-delà des départs d’employés et des changements de rôle.
Créer une clé#
Ouvrez la page Clés API dans Paramètres. Les clés personnelles et les clés d’organisation se trouvent dans des onglets distincts. Les deux sont disponibles avec tous les forfaits. La création d’une clé d’organisation nécessite l’autorisation Gérer les clés API (org:manage_api_keys).
Cliquez sur Nouvelle clé personnelle, donnez-lui un nom (par ex. : "MCP local", "clé de préproduction de Max"), puis copiez la clé lorsqu’elle s’affiche. La clé hérite de votre rôle RBAC actuel et de vos autorisations par moteur.
Visibilité de la clé
La clé API complète n’est affichée qu’une seule fois, au moment de sa création. Copiez-la et stockez-la en lieu sûr — vous ne pourrez plus la récupérer après avoir fermé la boîte de dialogue.
Clés d’organisation et RBAC#
Sans RBAC, les clés d’organisation ordinaires disposent d’un accès en lecture et en traduction à l’ensemble de l’organisation. Le RBAC Enterprise vous permet de définir des droits plus restreints :
- Rôle uniquement : les autorisations du rôle s’appliquent à l’ensemble de l’organisation. Seuls
engine:readetengine:translatesont acceptés. - Aucun rôle + périmètre de moteurs : la clé donne accès aux moteurs qui lui sont associés.
- Rôle + périmètre de moteurs : les deux sources de droits se cumulent. Le périmètre ne réduit pas les autorisations plus larges accordées par le rôle.
- Ni l’un ni l’autre : tant que le RBAC est activé, la clé n’a accès à aucun moteur.
La création d’une clé d’organisation nécessite l’autorisation Gérer les clés API. Attribuer ou modifier un rôle, accorder l’accès à des moteurs ou définir un périmètre de contenu nécessite également le RBAC. Le rôle doit appartenir à l’organisation, et vous ne pouvez accorder l’accès qu’aux moteurs avec lesquels vous pouvez traduire. Le périmètre de contenu peut inclure des glossaires, des voix de marque et des ensembles de règles que vous pouvez modifier.
Avant de supprimer le RBAC
Si le RBAC est supprimé, les clés d’organisation ordinaires retrouvent un accès en lecture et en traduction à l’ensemble de l’organisation. Les restrictions de rôle et de moteur enregistrées ne limitent plus cet accès. Révoquez ou renouvelez les clés avant de supprimer le RBAC si vous devez conserver ces restrictions. Ce fonctionnement concerne les clés de service ordinaires ; les identifiants destinés à un usage spécifique, comme les clés SCIM, répondent à des exigences d’accès distinctes.
Utiliser une clé#
Transmettez la clé API dans l’en-tête X-API-Key à chaque requête — le format est le même pour les deux types :
curl -X POST https://api.lingo.dev/process/localize \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"engineId": "eng_abc123", "sourceLocale": "en", "targetLocale": "de", "data": {"greeting": "Hello"}}'La même clé fonctionne aussi bien avec l’API de localisation qu’avec le serveur MCP.
Sécurité#
- Les clés sont stockées sous forme de hachages — Lingo.dev ne peut pas récupérer une clé après sa création. Pour la faire tourner, supprimez-la puis recréez-la.
- Les clés personnelles suivent en temps réel les autorisations de leur créateur. Si le rôle du créateur est rétrogradé ou si une autorisation sur un moteur est révoquée, la clé perd le même accès dès l’appel suivant.
- Pour qu’une clé personnelle fonctionne, la personne qui l’a créée doit rester membre de l’organisation. Utilisez une clé d’organisation pour les automatisations qui doivent continuer à fonctionner après le départ d’un ou d’une collègue.
- Les clés d’organisation ont leur propre niveau d’autorité. Toute modification du rôle ou de la portée prend effet immédiatement ; supprimer la clé la révoque.
- Il n’y a aucune limite au nombre de clés par organisation.