> For the complete documentation index, see [llms.txt](https://stablebuild.gitbook.io/stablebuild-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stablebuild.gitbook.io/stablebuild-documentation/docs/fr/product/public-api-keys.md).

# Clés d'API publiques

Une clé d'API publique vous permet d'utiliser StableBuild dans un projet open source. Vous publiez la clé dans votre Dockerfile ou votre configuration de CI, et toute personne qui construit votre projet récupère les mêmes dépendances épinglées via StableBuild. La clé ne sert que les dépendances que vous avez autorisées : les autres dépendances de votre organisation restent privées.

{% hint style="warning" %}
Tout le trafic passant par une clé publique est facturé à votre organisation. Avec le forfait Community, la limite de trafic mensuelle de votre organisation s'applique toujours : une fois cette limite atteinte, les builds qui utilisent la clé publique échouent.
{% endhint %}

### Fonctionnement

Une clé publique est en lecture seule. Elle ne sert que les fichiers de sa liste d'éléments autorisés déjà mis en cache par StableBuild, et ne télécharge jamais rien de nouveau depuis la source en amont.

Pour remplir cette liste, vous ouvrez une fenêtre d'écriture sur la clé. Tant que la fenêtre est ouverte, la clé fonctionne comme une clé d'API classique, et tout ce qu'elle sert est ajouté à ses éléments autorisés. Lancez votre build une fois, puis fermez la fenêtre.

{% hint style="info" %}
Tant qu'une fenêtre d'écriture est ouverte, toute personne disposant de la clé peut tout télécharger par son intermédiaire. Gardez la fenêtre ouverte le moins longtemps possible, et fermez-la dès que votre build est terminé.
{% endhint %}

### Créer une clé publique

1. Ouvrez le [tableau de bord](https://dashboard.stablebuild.com) et cliquez sur **Clés > Ajouter une clé**.
2. Saisissez un nom et cochez **Clé publique**. La clé commence alors par `your-prefix-pub-`.
3. Cliquez sur **Ajouter la clé**. La boîte de dialogue **Ouvrir une fenêtre d'écriture** s'ouvre aussitôt, pour que vous puissiez passer directement à [l'enregistrement de vos dépendances](#recording-your-dependencies).

Les clés publiques portent la mention **Publique** dans la liste des clés, suivie de la mention **Lecture seule** ou **Écriture autorisée jusqu'au**.

### Enregistrer vos dépendances <a href="#recording-your-dependencies" id="recording-your-dependencies"></a>

1. Sur la page **Clés**, cliquez sur les trois points à côté de votre clé publique, puis sur **Ouvrir une fenêtre d'écriture**. Si vous venez de créer la clé, cette boîte de dialogue est déjà ouverte.
2. Copiez la clé avec le bouton à côté, choisissez quand la fenêtre se ferme automatiquement (après 1 heure, 24 heures ou 7 jours), puis cliquez sur **Ouvrir la fenêtre d'écriture**.
3. Lancez votre build une fois avec la clé publique, par exemple :

{% code overflow="wrap" %}

```docker
FROM your-prefix-pub-myproject.dockermirror.stablebuild.com/python:3.12-slim

ARG SB_API_KEY=your-prefix-pub-myproject
ARG APT_PIN_DATE=2026-09-29T08:40:01Z

COPY ./sb-apt.sh /opt/sb-apt.sh
RUN bash /opt/sb-apt.sh load-apt-sources debian
RUN apt update && apt install -y curl

RUN pip install -i https://your-prefix-pub-myproject.pypimirror.stablebuild.com/2026-09-01/ requests==2.32.3

RUN curl -O "https://your-prefix-pub-myproject.httpcache.stablebuild.com/my-cache-key/https://bootstrap.pypa.io/get-pip.py"
```

{% endcode %}

4. Cliquez à nouveau sur les trois points à côté de la clé, puis sur **Fermer la fenêtre d'écriture**.

Tout le monde peut désormais construire votre projet avec cette clé. Quand vos dépendances changent, ouvrez une nouvelle fenêtre d'écriture et relancez le build.

### Gérer les éléments autorisés

Pour voir ce qu'une clé publique peut télécharger, cliquez sur les trois points à côté de la clé, puis sur **Éléments autorisés**. Les éléments sont regroupés par miroir, avec leur date d'ajout. Cliquez sur **Retirer** pour retirer un élément de la liste.

Après la fermeture d'une fenêtre d'écriture ou le retrait d'un élément, la clé peut mettre jusqu'à 5 minutes à repasser en lecture seule ou à cesser de servir l'élément.

Pour voir qui utilise votre clé publique, rendez-vous sur **Facturation > Journaux de consommation bruts**. Chaque requête indique la clé d'API utilisée.