Clés API

Max PrilutskiyPDG et cofondateur4 min de lecture

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#

PersonnelleOrganisation
PropriétaireL’utilisateur qui l’a crééeAucun — conçue pour l’automatisation
AutorisationHérite du rôle RBAC du créateur et des autorisations par moteurAccè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èsLa clé perd l’accès elle aussiAucun changement ; appartient à l’organisation
ForfaitTous les forfaitsTous les forfaits ; les rôles personnalisés et les restrictions nécessitent le RBAC Enterprise
Usage typiqueDéveloppement local, MCP, scripts ad hocPipelines 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:read et engine:translate sont 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 :

bash
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.

Étapes suivantes#