Créer et protéger des clés API
Créez des identifiants de production ou sandbox aux permissions minimales, limitez si nécessaire les adresses IP, puis renouvelez ou révoquez les clés en toute sécurité.
- Choisir le contexteSélectionnez l’espace personnel ou celui de l’organisation.
- Définir les autorisationsNommez la clé et choisissez uniquement les scopes nécessaires.
- Limiter les sourcesVous pouvez indiquer les adresses IP ou réseaux autorisés à appeler le service.
- Enregistrer le secretEnregistrez le secret affiché une seule fois dans un gestionnaire de secrets protégé.
- Gérer les accèsRenouvelez une clé pour la remplacer et révoquez les identifiants retirés.
Scopes et rôles
La page API Keys décrit les scopes disponibles, notamment la lecture du compte, l’inférence et l’entraînement IA, les tâches d’hébergement IA, les tâches de transformation de modèles, les services blockchain et les autorisations relatives aux tickets d’assistance. Dans une organisation, les propriétaires et administrateurs gèrent les clés ; les membres peuvent les consulter, mais pas les gérer. Choisissez le contexte auquel l’identifiant doit appartenir : visibilité et autorité dépendent du contexte.
- Sélectionnez l’organisation concernée avant d’ouvrir API Keys.
- Lisez la description des scopes et ne choisissez que les opérations nécessaires.
- Si la gestion des clés n’est pas disponible, adressez-vous à un propriétaire ou administrateur.
Créer une clé de production
Une clé standard nécessite un nom de 2 à 120 caractères, au moins un scope proposé et, facultativement, une liste d’autorisation IP. Saisissez des adresses IP ou réseaux CIDR valides, un par ligne, dans la limite affichée. Une liste vide autorise toute adresse IP source. La clé complète en texte brut ne s’affiche qu’une fois après sa création ; seul un hachage est conservé et la valeur ne pourra pas être récupérée par la suite.
- Choisissez un nom correspondant à l’application ou à l’environnement.
- Accordez les scopes minimaux et indiquez uniquement les adresses sources stables nécessaires.
- Enregistrez directement la valeur affichée dans le stockage de secrets approuvé.
Clé d’inférence sandbox
Le tableau de bord permet de créer une clé sandbox limitée à l’inférence IA et au quota mensuel de requêtes qui y est indiqué. Une seule clé sandbox active est autorisée par compte ou contexte d’organisation. Si une clé existe déjà, utilisez-la ou révoquez-la avant de la remplacer. Séparez les identifiants sandbox et production ; le quota sandbox ne garantit pas la disponibilité d’un service de production.
- Vérifiez si une clé sandbox est déjà active dans ce contexte.
- Créez-en une pour les tests d’inférence et stockez-la séparément.
- Surveillez son quota et révoquez-la lorsqu’elle n’est plus nécessaire.
Protéger le secret
Copiez la clé complète uniquement lors de sa création ou de son renouvellement, lorsqu’elle est affichée. Stockez-la dans un gestionnaire de secrets chiffré dont l’accès est limité au service qui l’utilise. Ne la placez jamais dans le code source ou celui du navigateur, les journaux, captures d’écran, tickets ou conversations. Si vous avez manqué son affichage unique ou perdu sa valeur, renouvelez la clé ; l’assistance ne peut pas retrouver le texte brut.
- Transférez directement la valeur affichée dans un stockage protégé.
- Configurez le service consommateur selon ses paramètres documentés.
- Renouvelez immédiatement la clé si vous soupçonnez une perte ou une divulgation.
Renouveler ou révoquer une clé
Le renouvellement révoque l’ancien identifiant et crée son remplacement avec le même nom, le même niveau, les mêmes scopes et la même liste d’autorisation. La nouvelle valeur ne s’affiche qu’une fois ; mettez rapidement à jour les services dépendants, car l’ancienne clé cesse de fonctionner. La révocation désactive la clé sélectionnée sans la remplacer. Avant l’une ou l’autre action, vérifiez le contexte et l’identifiant de la clé.
- Avant un renouvellement planifié, repérez tous les services qui utilisent la clé.
- Stockez la nouvelle valeur et mettez à jour les services dépendants.
- Révoquez les clés retirées et vérifiez leur état dans le tableau de bord.
Diagnostiquer les requêtes refusées
Une requête peut être refusée si la clé est mal formée ou révoquée, si son utilisateur est inactif, si l’adresse IP source ne figure pas dans la liste d’autorisation ou si le scope demandé est absent. Une requête sandbox peut également dépasser le quota mensuel. Vérifiez le contexte, la version du secret déployée, l’adresse de sortie du client et le scope requis. Ne communiquez jamais le secret lorsque vous demandez de l’aide.
- Confirmez que la clé est active et inclut le scope de l’opération.
- Vérifiez l’adresse IP source réelle et le quota sandbox.
- Renouvelez la clé si elle est incorrecte ou exposée ; ne transmettez que des références expurgées.
Questions fréquentes
Puis-je récupérer une clé plus tard ?
Non. Renouvelez-la pour créer une nouvelle valeur de remplacement.
Quels scopes dois-je accorder ?
Uniquement les scopes proposés et nécessaires à l’intégration.
Les membres peuvent-ils créer des clés d’organisation ?
Non. Seuls les propriétaires et administrateurs gèrent les clés de l’organisation.
Le renouvellement laisse-t-il l’ancienne clé active ?
Non. Il révoque l’ancienne clé et en crée une nouvelle.
Que faire si l’adresse IP du client change ?
Faites mettre à jour la liste d’autorisation par un gestionnaire de clés autorisé.
Puis-je avoir deux clés sandbox ?
Une seule clé sandbox active est autorisée par contexte.