Skip to main content
Une clé API authentifie une personne ou un compte de service auprès de W&B. Cette page présente les types de clés API émises par W&B, indique où les trouver et les gérer, et décrit les paramètres de l’organisation qui encadrent la façon dont les membres les créent et les utilisent. Elle s’adresse aux administrateurs de l’organisation et aux administrateurs d’équipe chargés de la gestion des identifiants d’authentification, ainsi qu’aux membres qui gèrent leurs propres clés. Une fois vos clés obtenues, consultez Stocker et gérer les clés API en toute sécurité pour les conserver de manière sécurisée.

​
Types de clés API

W&B délivre des clés API aussi bien aux personnes qu’aux comptes de service.

​
Trouver et gérer les clés API

Les administrateurs de l’organisation, les administrateurs d’équipe et les membres gèrent les clés depuis l’onglet API Keys.
  1. Cliquez sur l’icône de votre profil en haut à droite, puis sélectionnez votre organisation.
  2. Accédez à https://forge.coreweave.com/account-settings/[ORGANIZATION]/api-keys. Remplacez [ORGANIZATION] par le nom de votre organisation. L’onglet API Keys répertorie les clés que vous êtes autorisé à voir.
Pour afficher uniquement vos propres clés API personnelles, cliquez sur l’icône de votre profil, puis sur Paramètres utilisateur, et faites défiler jusqu’à la section API Keys. Voir Paramètres utilisateur.
Dans le Cloud mutualisé, les utilisateurs ayant le rôle d’administrateur de la facturation dans l’organisation ne peuvent pas voir l’onglet API Keys. Dans le Cloud dédié et les déploiements autogérés, l’accès à cet onglet ne dépend pas du rôle de facturation.

​
Visibilité des clés selon le rôle

Les clés affichées dans l’onglet API Keys dépendent de votre rôle :

​
Lire le tableau des clés API

Le tableau répertorie chaque clé avec les colonnes suivantes :
  • Key name : le nom descriptif attribué à la clé lors de sa création.
  • Key ID : la première partie de la clé, qui sert à l’identifier.
  • Owner : l’utilisateur ou le compte de service propriétaire de la clé.
  • Last used : la date à laquelle la clé a authentifié une requête pour la dernière fois.
  • Created on : la date de création de la clé.
Pour des raisons de sécurité, le tableau n’affiche que l’identifiant de la clé. W&B n’affiche la clé secrète complète qu’une seule fois, lors de sa création. Si vous ne disposez plus du secret complet d’une clé, faites pivoter la clé.
Pour affiner la liste, saisissez un nom de clé, un identifiant de clé ou un propriétaire dans le champ de recherche, ou cliquez sur Filters pour filtrer selon des attributs tels que le type de clé.

​
Créer une clé API

  1. Accédez à l’onglet API Keys.
  2. Cliquez sur New key.
  3. Attribuez à la clé un nom explicite.
  4. Cliquez sur Create.
  5. Copiez immédiatement la clé et conservez-la en lieu sûr.
W&B n’affiche la clé API complète qu’une seule fois, lors de sa création. Une fois la boîte de dialogue fermée, vous ne pouvez plus consulter la clé API complète. Seul l’ID de la clé (sa première partie) apparaît dans vos paramètres. Si vous perdez la clé API complète, vous devez en créer une nouvelle.
Dans le Cloud mutualisé, les clés que vous créez depuis cet onglet sont rattachées à l’organisation que vous consultez. Créez une clé distincte pour chaque organisation dans laquelle vous travaillez.

​
Renommer une clé API

Renommez une clé pour indiquer ce qui l’utilise : il sera ainsi plus facile, par la suite, d’identifier l’origine d’une clé que vous ne reconnaissez pas. Le renommage ne modifie pas le secret de la clé et n’interrompt aucun service qui l’utilise.
  1. Trouvez la clé dans le tableau.
  2. Cliquez sur le menu d’actions à la fin de la ligne de la clé, puis sur Edit.
  3. Saisissez un nouveau nom, puis enregistrez.

​
Supprimer des clés API

Supprimez une clé lorsque vous n’en avez plus besoin, ou immédiatement si elle a pu être exposée. Pour supprimer une seule clé, trouvez-la dans le tableau, cliquez sur le menu d’actions à la fin de sa ligne, puis cliquez sur Supprimer et confirmez. Pour supprimer plusieurs clés à la fois :
  1. Cochez la case en regard de chaque clé à supprimer.
  2. Cliquez sur Supprimer. Le bouton indique le nombre de clés sélectionnées.
  3. Confirmez la suppression.
La suppression d’une clé révoque immédiatement l’accès de tout script ou service qui l’utilise. Mettez à jour vos systèmes pour qu’ils utilisent une clé de remplacement avant de supprimer l’ancienne.

​
Faire pivoter une clé API

Faites pivoter vos clés selon un calendrier conforme à votre politique de sécurité, et immédiatement si une clé a pu être exposée. Faites pivoter une clé plutôt que de la supprimer lorsque les charges de travail qui l’utilisent doivent continuer de s’exécuter. W&B ne propose pas d’action de rotation en une seule opération. Comme le secret complet d’une clé n’est affiché qu’à sa création, la rotation consiste à remplacer la clé :
  1. Créez une nouvelle clé API. Donnez-lui un nom qui la distingue de la clé à remplacer.
  2. Mettez à jour tous les scripts, jobs et secrets stockés qui utilisent l’ancienne clé. Pour connaître les options de stockage, consultez Stocker et gérer les clés API en toute sécurité.
  3. Vérifiez que vos charges de travail s’authentifient avec la nouvelle clé.
  4. Supprimez l’ancienne clé.
Tant que vous n’avez pas effectué la dernière étape, les deux clés fonctionnent. C’est ce chevauchement qui permet d’effectuer la rotation sans interruption de service ; veillez donc à le limiter au strict nécessaire.
Si une clé a été exposée publiquement, supprimez-la immédiatement, sans attendre d’avoir mis à jour vos systèmes. Une clé exposée reste valide tant que vous ne l’avez pas supprimée.

​
Restreindre l’utilisation des clés API par les membres

Les administrateurs de l’organisation peuvent restreindre la création et l’utilisation des clés depuis les paramètres de l’organisation dans la W&B App. Ces restrictions déterminent quelles clés peuvent accéder aux ressources de votre organisation et qui peut en créer de nouvelles. Les sections suivantes décrivent les restrictions disponibles, qui varient selon le type de déploiement.

​
Appliquer les clés API limitées à l’organisation

Disponible dans le Cloud mutualisé pour les organisations Enterprise. W&B active ce paramètre organisation par organisation. Si vous ne le voyez pas, contactez votre équipe de compte W&B. Lorsque ce paramètre est appliqué, seules les clés API d’organisation et les clés appartenant aux comptes de service de l’organisation peuvent accéder aux ressources de celle-ci. Une clé API personnelle qu’un membre utilise dans plusieurs organisations ne fonctionne plus pour cette organisation, ce qui empêche une clé divulguée ailleurs d’accéder à vos données.
Les clés API personnelles perdent leur accès en lecture et en écriture à l’organisation dès que vous appliquez ce paramètre, et toute intégration utilisant une clé personnelle cesse de fonctionner. Prévenez vos utilisateurs avant de l’appliquer.
Pour appliquer les clés API limitées à l’organisation, procédez comme suit :
  1. Connectez-vous en tant qu’administrateur de l’organisation.
  2. Ouvrez les paramètres de votre organisation, puis sélectionnez Authentication dans le menu de navigation de gauche.
  3. À côté de Enforce organization-scoped API keys, cliquez sur Enforce.
  4. Saisissez le nom de votre organisation pour confirmer, puis cliquez sur Enforce Organization-Scoped API Keys.
W&B affiche alors le libellé Enforced à côté du paramètre. Pour ne plus l’appliquer, revenez à Authentication et cliquez sur Disable.

​
Désactiver la création de clés API

Disponible dans le Cloud dédié et en mode autogéré à partir de la version v0.84.0. Lorsque ce paramètre est activé, les utilisateurs et les comptes de service d’équipe ne peuvent plus créer de nouvelles clés API. Les comptes de service de l’organisation peuvent toujours en créer, et les clés existantes continuent de fonctionner : l’activation de ce paramètre n’interrompt donc pas les jobs en cours. Utilisez ce paramètre si votre organisation délivre les clés selon un processus contrôlé et que vous souhaitez empêcher les membres de créer leurs propres clés. Pour désactiver la création de clés API, procédez comme suit :
  1. Connectez-vous en tant qu’administrateur de l’organisation.
  2. Ouvrez le tableau de bord de votre organisation, puis sélectionnez Privacy dans le menu de navigation de gauche.
  3. Dans la section Access Control, activez Disable API key creation.
W&B enregistre immédiatement la modification. Pour les autres paramètres de cet onglet, voir Configurer les paramètres de confidentialité. Tant que ce paramètre est activé, le bouton New key de l’onglet API Keys est désactivé et le message suivant s’affiche :
Pour restreindre également la création de comptes de service, consultez GORILLA_DISABLE_TEAM_SERVICE_ACCOUNT_CREATION, qui empêche la création de nouveaux comptes de service à portée d’équipe sur le Cloud dédié et sur les déploiements autogérés en version v0.83.0 ou ultérieure.

​
Disponibilité

Les fonctionnalités des clés API varient selon le type de déploiement et, dans le Cloud mutualisé, selon l’abonnement. Le tableau suivant récapitule la disponibilité de chaque fonctionnalité.

​
Stocker et gérer les clés API en toute sécurité

Les clés API donnent accès à votre compte W&B et doivent être protégées comme des mots de passe. Les sections suivantes présentent les méthodes de stockage recommandées, les pratiques à éviter, la manière de transmettre les clés à votre code, ainsi que les exigences de version du SDK pour les clés plus récentes. Utilisez l’une des méthodes suivantes pour stocker votre clé API en toute sécurité.
  • Gestionnaire de secrets : utilisez un système dédié à la gestion des secrets, tel que AWS Secrets Manager, HashiCorp Vault, Azure Key Vault ou Google Secret Manager.
  • Gestionnaire de mots de passe : utilisez une application de gestion de mots de passe reconnue.
  • Trousseaux du système d’exploitation : stockez les clés dans le trousseau macOS (Keychain), le Gestionnaire d’identifiants Windows ou le service de secrets Linux. Déconseillé en production.

​
À éviter

Évitez les pratiques suivantes, qui peuvent exposer votre clé API :
  • Ne commitez jamais de clés API dans des systèmes de gestion de versions tels que Git.
  • Ne stockez pas de clés API dans des fichiers de configuration en texte brut.
  • Ne passez pas de clés API en ligne de commande, car elles sont visibles dans la sortie de commandes du système d’exploitation comme ps.
  • Évitez de partager des clés API par e-mail, par chat ou par tout autre canal non chiffré.
  • N’intégrez pas de clés API en dur dans votre code source.
Si une clé API est exposée, supprimez-la immédiatement de votre compte W&B et contactez l’assistance ou votre AISE.

​
Variables d’environnement

Lorsque vous utilisez des clés API dans votre code, transmettez-les via des variables d’environnement :
Cette approche évite d’inclure les clés dans votre code source et permet de les faire pivoter plus facilement si nécessaire.
Évitez de définir la variable d’environnement directement dans la commande, car elle apparaît dans la sortie de commandes du système d’exploitation comme ps :

​
Compatibilité des versions du SDK

Si vous utilisez une clé API récente, vérifiez que votre version du SDK la prend en charge. Les clés API récentes sont plus longues que les anciennes. Si vous vous authentifiez avec une ancienne version du SDK wandb ou weave, une erreur liée à la longueur de la clé API peut survenir. Solution : passez à une version plus récente du SDK :
  • SDK wandb v0.22.3+
  • SDK weave v0.52.17+
Si vous ne pouvez pas mettre à jour le SDK immédiatement, contournez le problème en définissant la clé API dans la variable d’environnement WANDB_API_KEY.
Dernière modification le 30 septembre 2026