Files now have attributes

content/files/challenge.md

@@ -13,7 +13,8 @@ On y retrouve notamment :
 - [les flags](#les-flags) ;
 - [les dépendances entre les flags](#dépendances-entre-flags) ;
 - [les débloquages de fichiers](#débloquage-de-fichier) ;
-- [les indices](#les-indices) (fichier ou simple texte).
+- [les indices](#les-indices) (fichier ou simple texte) ;
+- [les fichiers](#les-fichiers).
 
 
 ## Les gains
@@ -128,6 +129,16 @@ Les étapes peuvent avoir des indices, sous forme de fichier à télécharger (a
         + `id = 23` : identifiant du flag ;
 
 
+## Les fichiers
+
+Tous les fichiers sont importés par défaut, voir [la page concernée]({{< relref "/files/files.md" >}}).
+Cependant il peut être nécessaire de préciser certains attributs. Cela se fait alors avec :
+
+- `[[file]]` : paramètres pour un indice :
+    * `filename = "toto.txt"` : nom du fichier tel qu'il apparaît dans le dossier `files` ;
+    * `hidden = true` : indique si le fichier doit être caché aux participants par défaut (l'équipe serveur pourra le distribuer si besoin, dans tous les cas il sera affiché lorsque le challenge sera archivé) ;
+
+
 ## Exemple d'un `challenge.txt` complet
 
 ```toml
@@ -136,6 +147,10 @@ gain = 42
 [[depend]]
 id = 2
 
+[[file]]
+filename = "btmp.log"
+hidden = true
+
 [[flag]]
 label = "Date d'exfiltration"
 help= "yyyy-mm"

content/files/files.md

@@ -27,3 +27,5 @@ Chaque fichier doit avoir une entrée correspondante dans le fichier `DIGESTS.tx
   Seul le hash du fichier entier est requis dans le fichier `DIGESTS.txt`.
 
 [^gz]: l'intérêt de `gzip` est que le serveur web sera capable de distribuer le fichier sans faire apparaître la compression. Voir le [module nginx utilisé](https://nginx.org/en/docs/http/ngx_http_gzip_static_module.html).
+
+Les fichiers peuvent posséder des attributs spécifiques dans [le `challenge.txt`]({{< relref "challenge.md" >}}#les-fichiers)