FS#40768 : API static

État Fermée
Pourcentage achevé
100%
Type Anomalie
Catégorie Non trié
Assignée à Personne
Système d'exploitation Tous
Sévérité Basse
Priorité Très Basse
Basée sur la version 4.9.14
Due pour la version Non décidée
Échéance Non décidée
Votes
Privée

Concerne le projet: Freebox Server (Ultra V9/ Pop V8/ Delta V7 / Revolution V6 / Mini 4K)
Ouverte par AymKdn - 13/01/2026
Dernière modification par lduboin - 18/02/2026

FS#40768 - API static_lease

Bonsoir,

J’ai ouvert un ticket concernant l’API `static_lease` (https://dev.freebox.fr/bugs/task/40765#comment191833) mais il a déjà été fermé donc je ne peux pas poser une autre question…

Il m’a été dit de passer `options`, le même que pour le endpoint `config`. Sauf que ce `options` est de type DhcpOption, et je ne vois pas comment passer une adresse MAC et une IP (y’a une tonne de paramètre qui ne semble pas lié à ce que je veux). Du coup je ne comprends pas comment utiliser `static_lease` !

Est-il possible de me donner un exemple ?

Merci

Fermée par lduboin
18.02.2026 15:24
Raison de la fermeture : Résolu
Commentaires de fermeture :

Documentation ajoutée dans la version 4.9.16

Commentaires (9)
Tâches liées (0/0)

mmakassikis a commenté le 13.01.2026 18:33

exemple de json à envoyer en POST sur l'api static_lease:

{"id":"","mac":"aa:bb:cc:dd:ee:ff","hostname":"","host":"","ip":"192.168.13.37","comment":"test","options":[]}

nbanba a commenté le 15.01.2026 06:05

Bonjour

@mmakassikis je suis intéressée aussi, le dois mettre à jour la "library BASH"

Vous voulez dire un turc comme :

{"id":"","mac":"aa:bb:cc:dd:ee:ff","hostname":"","host":"","ip":"192.168.13.37","comment":"test","options":[{"id0":"119","val0":"0431347276036c616e000773746f72616765c005036f6f62c005036c6162c00503666278c005"},{"id1":"138","val1":"10.0.10.250","val2":"10.0.10.254"}]}

en plus lisible:

{
  "id": "",
  "mac": "aa:bb:cc:dd:ee:ff",
  "hostname": "",
  "host": "",
  "ip": "192.168.13.37",
  "comment": "test",
  "options": [
    {
      "id0": "119",
      "val0": "0431347276036c616e000773746f72616765c005036f6f62c005036c6162c00503666278c005"
    },
    {
      "id1": "138",
      "val1": "10.0.10.250",
      "val2": "10.0.10.254"
    }
  ]
}

c'est bien ça ?

Merci
Cordialement
nbanba

AymKdn a commenté le 16.01.2026 14:58

Merci ça fonctionne.

J'ai utilisé ça :

{
  "id": "",
  "mac": "aa:bb:cc:dd:ee:ff",
  "hostname": "",
  "host": "",
  "ip": "192.168.x.y",
  "options": []
}

nbanba a commenté le 16.01.2026 20:16

Bonjour

Merci.
En effet ça fonctionne ainsi à iso périmètre par rapport à la rlz précédente.

D'après https://dev.freebox.fr/blog/?p=22359 on peut maintenant utiliser toutes les options dhcp (je comprends donc toutes options dhcp normalisées par 1 RFC accessible sur ietf.org).

Je suis peut-être passé à côté de quelquechose mais ce serait bien d'avoir le naming des options et la syntaxe des arguments.
Comment les options sont elles indexées ?
Faut il passer les arguments en hexa ?
…?

Cordialement
nbanba

lduboin a commenté le 16.01.2026 23:45

Bonjour,

D'après https://dev.freebox.fr/blog/?p=22359 on peut maintenant utiliser toutes les options dhcp (je comprends donc toutes options dhcp normalisées par 1 RFC accessible sur ietf.org).

Pour l'instant seul les options définies dans la RFC 2132 ont été ajoutées: https://datatracker.ietf.org/doc/html/rfc2132 .

La liste des options disponibles et leur syntaxe est disponible
dans la documentation (API > Configuration > DHCP > DHCP Options).

Un exemple est également déja disponible dans la documentation de
/dhcp/config.

nbanba a commenté le 17.01.2026 08:08

Bonjour

Pour l'instant seul les options définies dans la RFC 2132 ont été ajoutées

Merci pour votre retour, ça me permettra de remplacer iPXE.

Par contre c'est incomplet (en dehors de BOOTP), les clients ont besoins de plus d'options, notamment :

dhcp option 82
1. DHCP Relay Agent Information Option
2. https://datatracker.ietf.org/doc/html/rfc3046
dhcp option 119
1. DHCP Domain Search Option
2. https://datatracker.ietf.org/doc/html/rfc3397
dhcp option 138
1. DHCP CAPWAP (Control and provisionning of wireless access point)
2. https://datatracker.ietf.org/doc/html/rfc5417

Aujourd'hui j'ai surtout besoin de DHCP option 119 https://datatracker.ietf.org/doc/html/rfc3397#section-2

L'option 119 peut être délicate à manipuler ⇒ je peux faire une doc pour expliquer comment on passe de :

14rv.lan storage.lan oob.lan lab.lan fbx.lan

0431347276036c616e000773746f72616765c005036f6f62c005036c6162c00503666278c005

Merci

Cordialement
nbanba

Neustradamus_ a commenté le 30.01.2026 23:23

@lduboin: Avez-vous vu le dernier commentaire de nbanba ?

lduboin a commenté le 12.02.2026 20:31

@nbanba

Par contre c'est incomplet (en dehors de BOOTP), les clients ont besoins de plus d'options

De nouvelles options seront présentes dans le prochain firmware (incluant les options 119 et 138).

La configuration d'un relay agent nécessite davantage de modifications et ne sera pas incluse pour le moment. Je vous invite à ouvrir une tâche dédiée.

nbanba a commenté le 12.02.2026 23:34

Bonsoir

@lduboin
Un grand merci pour les implémentations prévues pour la prochaine release, franchement c'est top !

C'est entendu, j'ouvrirai une task dédiée pour DHCP option 82.

Cordialement
nbanba

	Tâches associées à cette tâche (0)

Chargement...

Raccourcis clavier

Activer les raccourcis clavier

Alt + ⇧ Shift + l Se connecter/Se déconnecter
Alt + ⇧ Shift + a Ouvrir une tâche
Alt + ⇧ Shift + m Mes recherches
Alt + ⇧ Shift + t Rechercher par ID de tâche

Liste des tâches

o Ouvrir la tâche sélectionnée
j Déplacer le curseur vers le bas
k Déplacer le curseur vers le haut

Détails de la tâche

n Tâche suivante
p Tâche précédente
Alt + ⇧ Shift + e ↵ Enter Modifier cette tâche
Alt + ⇧ Shift + w Surveiller
Alt + ⇧ Shift + y Fermer cette tâche

Édition de la tâche

Alt + ⇧ Shift + s Enregistrer la tâche