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-customest 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_TOKENcontient 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_TOKENest vide dans un sandbox déjà créé : pour les secrets intégrés (commegithub), 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.yamlpuissbx env create sbxenv.dev.yaml. Pour un seul sandbox existant, tu peux aussi relancer la commande avec--sandbox <nom>(pourgithub, 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--placeholderpermettrait 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 avecsbx 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 |
|