bots-garden/houlapublic Fork
⑂ v0.0.1
Commits
⬇ Clone ▾
git clone https://git.rickub.com/bots-garden/houla.git
git clone ssh://git@rickub.com/bots-garden/houla.git

Host key fingerprint (ed25519): SHA256:iycHnxEyq0Q7uyVpB7JlznP0G7JrTPXLYRcAU5CSLhc — verify it before your first connect.

Download ZIP
🛟 Updated. 1dfc968Unverified · on v0.0.1 · k33g · 4h ago
huggingface-token-sbx.fr.md · 74 lines · 4.2 KBmarkdown
Blame HistoryOpen raw

Injecter un token Hugging Face dans un sandbox sbx

Ce guide explique comment rendre un token Hugging Face utilisable dans un sandbox Docker (sbx) sans que le vrai token soit stocké dans le conteneur.

Statut : sbx secret set-custom est expérimental. Son comportement, ses options et le format de la valeur factice peuvent changer.

Principe

Hugging Face ne fait pas partie des services intégrés à sbx (comme github). Il faut donc passer par un secret personnalisé :

  • Dans le sandbox, la variable HF_TOKEN contient une valeur factice (sbx-cs-…).
  • Le vrai token reste sur la machine hôte, dans le trousseau du système d'exploitation.
  • Quand un processus du sandbox envoie une requête HTTP vers un des domaines déclarés, le proxy remplace la valeur factice par le vrai token, uniquement dans les en-têtes HTTP, pas dans le corps de la requête.

Pour Hugging Face, cela suffit : le token est envoyé dans l'en-tête Authorization: Bearer ….

Configurer le secret

Toutes les commandes sbx se lancent sur la machine hôte, pas dans le sandbox.

Le secret est global : sans --sandbox, il s'applique à tous les sandboxes, donc aussi bien au sandbox de dev (houla-houla, sbxenv.dev.yaml) qu'au sandbox Olala (houla-olala, sbxenv.yaml). Il n'y a qu'une commande à lancer, une seule fois.

printf '%s' "hf_xxx" | sbx secret set-custom \
    --host huggingface.co \
    --host '*.huggingface.co' \
    --env HF_TOKEN \
    --value-stdin
Option Rôle
--host Domaine auquel le token est envoyé. Répétable. * correspond à un seul niveau de sous-domaine (ex. router.huggingface.co, cdn-lfs.huggingface.co), ** à plusieurs.
--env Nom de la variable d'environnement définie dans le sandbox.
--value-stdin Lit le token sur l'entrée standard (méthode recommandée). Sans cette option, la commande demande la valeur.
--sandbox <nom> Limite le secret à un seul sandbox. Non utilisé ici : on veut le secret partout.
--ref Lit le token au moment où il en a besoin dans une source externe, par ex. op://Vault/Item/credential (1Password).
--command Lit le token au moment où il en a besoin en lançant une commande sur l'hôte qui l'affiche.
--refresh Durée de mise en cache d'un token lu par --ref ou --command (<durée> ou on-demand).

Attention : évite --value hf_xxx : le token se retrouverait dans l'historique du shell et dans la liste des processus.

Pour vérifier que le secret est enregistré :

sbx secret ls --host huggingface.co

Vérifier dans le sandbox

echo "$HF_TOKEN"     # affiche la valeur factice, pas le vrai token
hf auth whoami       # doit afficher ton compte Hugging Face

Problèmes possibles

  • HF_TOKEN est vide dans un sandbox déjà créé : pour les secrets intégrés (comme github), un secret global ne s'applique qu'aux sandboxes créés ensuite. C'est sans doute pareil ici (pas vérifié) : recrée le sandbox, par ex. sbx env rm sbxenv.dev.yaml puis sbx env create sbxenv.dev.yaml. Pour un seul sandbox existant, tu peux aussi relancer la commande avec --sandbox <nom> (pour github, un secret limité à un sandbox s'applique tout de suite).

  • Un outil refuse la valeur factice parce qu'elle ne commence pas par hf_ : une option --placeholder permettrait de choisir son format (par ex. --placeholder 'hf_{rand}'). Elle n'apparaît pas dans la page de doc détaillée : vérifie-la avec sbx secret set-custom --help.

  • Erreur HTTP 403 « no matching allow rule » : le domaine est bloqué par le pare-feu du sandbox. Sur l'hôte :

    sbx policy allow network huggingface.co,cdn-lfs.huggingface.co
    

À ne pas faire

Ne mets pas le token dans la section env: de sbxenv.yaml ou sbxenv.dev.yaml : ces fichiers sont faits pour être commités, et le token se retrouverait dans le dépôt.

Références

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# Injecter un token Hugging Face dans un sandbox sbx

Ce guide explique comment rendre un token Hugging Face utilisable dans un sandbox Docker (`sbx`) sans que le vrai token soit stocké dans le conteneur.

> **Statut :** `sbx secret set-custom` est **expérimental**. Son comportement, ses options et le format de la valeur factice peuvent changer.

## Principe

Hugging Face ne fait pas partie des services intégrés à `sbx` (comme `github`). Il faut donc passer par un **secret personnalisé** :

- Dans le sandbox, la variable `HF_TOKEN` contient une **valeur factice** (`sbx-cs-…`).
- Le vrai token reste sur la machine hôte, dans le trousseau du système d'exploitation.
- Quand un processus du sandbox envoie une requête HTTP vers un des domaines déclarés, le proxy remplace la valeur factice par le vrai token, **uniquement dans les en-têtes HTTP**, pas dans le corps de la requête.

Pour Hugging Face, cela suffit : le token est envoyé dans l'en-tête `Authorization: Bearer …`.

## Configurer le secret

Toutes les commandes `sbx` se lancent **sur la machine hôte**, pas dans le sandbox.

Le secret est **global** : sans `--sandbox`, il s'applique à tous les sandboxes, donc aussi bien au sandbox de dev (`houla-houla`, `sbxenv.dev.yaml`) qu'au sandbox Olala (`houla-olala`, `sbxenv.yaml`). Il n'y a qu'une commande à lancer, une seule fois.

```bash
printf '%s' "hf_xxx" | sbx secret set-custom \
    --host huggingface.co \
    --host '*.huggingface.co' \
    --env HF_TOKEN \
    --value-stdin
```

| Option | Rôle |
| --- | --- |
| `--host` | Domaine auquel le token est envoyé. Répétable. `*` correspond à un seul niveau de sous-domaine (ex. `router.huggingface.co`, `cdn-lfs.huggingface.co`), `**` à plusieurs. |
| `--env` | Nom de la variable d'environnement définie dans le sandbox. |
| `--value-stdin` | Lit le token sur l'entrée standard (méthode recommandée). Sans cette option, la commande demande la valeur. |
| `--sandbox <nom>` | Limite le secret à un seul sandbox. Non utilisé ici : on veut le secret partout. |
| `--ref` | Lit le token au moment où il en a besoin dans une source externe, par ex. `op://Vault/Item/credential` (1Password). |
| `--command` | Lit le token au moment où il en a besoin en lançant une commande sur l'hôte qui l'affiche. |
| `--refresh` | Durée de mise en cache d'un token lu par `--ref` ou `--command` (`<durée>` ou `on-demand`). |

> **Attention :** évite `--value hf_xxx` : le token se retrouverait dans l'historique du shell et dans la liste des processus.

Pour vérifier que le secret est enregistré :

```bash
sbx secret ls --host huggingface.co
```

## Vérifier dans le sandbox

```bash
echo "$HF_TOKEN"     # affiche la valeur factice, pas le vrai token
hf auth whoami       # doit afficher ton compte Hugging Face
```

## Problèmes possibles

- **`HF_TOKEN` est vide dans un sandbox déjà créé** : pour les secrets intégrés (comme `github`), un secret global ne s'applique qu'aux sandboxes créés ensuite. C'est sans doute pareil ici (pas vérifié) : recrée le sandbox, par ex. `sbx env rm sbxenv.dev.yaml` puis `sbx env create sbxenv.dev.yaml`. Pour un seul sandbox existant, tu peux aussi relancer la commande avec `--sandbox <nom>` (pour `github`, un secret limité à un sandbox s'applique tout de suite).
- **Un outil refuse la valeur factice parce qu'elle ne commence pas par `hf_`** : une option `--placeholder` permettrait de choisir son format (par ex. `--placeholder 'hf_{rand}'`). Elle n'apparaît pas dans la page de doc détaillée : vérifie-la avec `sbx secret set-custom --help`.
- **Erreur HTTP 403 « no matching allow rule »** : le domaine est bloqué par le pare-feu du sandbox. Sur l'hôte :

  ```bash
  sbx policy allow network huggingface.co,cdn-lfs.huggingface.co
  ```

## À ne pas faire

Ne mets pas le token dans la section `env:` de `sbxenv.yaml` ou `sbxenv.dev.yaml` : ces fichiers sont faits pour être commités, et le token se retrouverait dans le dépôt.

## Références

- [Manage credentials – Docker Sandboxes](https://docs.docker.com/ai/sandboxes/configuration/credentials/)
- [`sbx secret set-custom`](https://docs.docker.com/reference/cli/sbx/secret/set-custom/)
- [`sbx secret`](https://docs.docker.com/reference/cli/sbx/secret/)