# Stocker une clé en sécurité

> Ranger une clé API dans un secret, la fournir à un service hébergé sur Wakastart et éviter qu'elle n'apparaisse dans le code, les journaux ou un navigateur.

Quiconque détient une clé API agit avec ses droits, depuis n'importe quelle adresse autorisée. Elle se range donc comme un mot de passe d'administration : dans un secret, lue au démarrage par le seul serveur qui en a besoin.

## Avant de commencer

- Vous avez reçu la clé (voir [Obtenir une clé API](/v1.0/cles-api/obtenir-une-cle-api)).

## Fournir la clé à un service hébergé sur Wakastart

Si le serveur qui appelle l'API tourne sur Wakastart, fournissez la clé comme secret d'environnement :

1. Dans la définition du service, déclarez la variable attendue `WAKASTART_API_KEY`.
2. Dans l'environnement concerné, créez un secret qui contient la clé, puis reliez la variable à ce secret.

Résultat : la clé est injectée dans le conteneur au déploiement, sans jamais être affichée dans la console. Le détail des écrans est dans [Variables et secrets](/v1.0/variables-et-secrets).

## Fournir la clé à un serveur hébergé ailleurs

1. Rangez la clé dans votre gestionnaire de secrets (coffre de votre hébergeur, Vault, 1Password, etc.).
2. Injectez-la dans le processus par une variable d'environnement au démarrage.
3. Lisez-la une seule fois dans votre code :

```ts
const apiKey = process.env.WAKASTART_API_KEY;
if (!apiKey?.startsWith("sk_")) {
  throw new Error("WAKASTART_API_KEY manquante ou invalide");
}
```

## Ce qu'il ne faut pas faire

:::warning
- N'écrivez jamais la clé dans le code source, un fichier `.env` versionné, une image Docker ou un ticket.
- N'envoyez jamais la clé à un navigateur ou à une application mobile : elle serait lisible par tous ses utilisateurs.
- Ne journalisez jamais l'en-tête `x-api-key` ; si besoin, n'en gardez que les 10 premiers caractères.
:::

D'autres bonnes pratiques :

- une clé par usage et par environnement, pour pouvoir révoquer l'une sans couper les autres ;
- une liste d'adresses IP autorisées dès que vos serveurs ont des adresses fixes ;
- une date d'expiration, et un rappel pour la renouveler à temps (voir [Faire tourner une clé](/v1.0/cles-api/faire-tourner-une-cle)).

## Vérifier le résultat

1. Recherchez le préfixe `sk_` dans votre dépôt de code et vos journaux : aucune clé complète ne doit apparaître.
2. Redémarrez le service : il démarre et son premier appel à l'API répond `200`.

## Voir aussi

- [Variables et secrets](/v1.0/variables-et-secrets).
- [Révoquer une clé](/v1.0/cles-api/revoquer-une-cle).
