systeme

Provisioning

La page Provisioning système (/admin/system/provisioning) regroupe les réglages globaux utilisés par MaxiPBX pour configurer automatiquement les téléphones IP : adresse de provisioning, serveur DHCP intégré et registrars SIP proposés aux postes.

Ces paramètres sont globaux au serveur. Ils sont partagés par tous les clients (tenants) de l'instance. À modifier avec prudence : une erreur peut empêcher l'ensemble des téléphones de récupérer leur configuration.

En haut de page, un bandeau affiche le titre « Provisioning système », le sous-titre « Réglages globaux des téléphones, du DHCP et des registrars utilisés par le provisioning » et un badge Admin système.

La page est organisée en 4 onglets : État, Réseau, DHCP, Registrars. L'onglet État est ouvert par défaut.

Onglet « État »

Contrôle rapide en lecture seule des composants internes exposés par le service de configuration.

Titre : « État interne ».
Description : « Contrôle rapide des composants internes exposés par le service de configuration. »
Les données sont rafraîchies automatiquement toutes les 30 secondes.

Chaque composant est affiché sous forme de carte avec :

Élément	Détails
Nom du composant	Affiché en police à chasse fixe (clé technique).
Message	Texte optionnel renvoyé par le composant.
Statut	Badge vert si `ok`, orange (avertissement) sinon. Affiche « inconnu » si le statut n'est pas renseigné.

États particuliers :

Chargement : un bloc gris animé est affiché.
Erreur : un encadré rouge présente le détail de l'erreur.
Vide : message « Aucun état retourné. »

Onglet « Réseau »

Définit l'adresse HTTP/TFTP que les téléphones utilisent pour télécharger leur configuration.

Titre : « Adresse de provisioning ».
Description : « Adresse HTTP/TFTP que les téléphones utilisent pour récupérer leur configuration. »

Champ	Type	Obligatoire	Détails
Hôte de provisioning	Texte	Non	Nom d'hôte du serveur de provisioning. Exemple : `pbx.example.com`.
URL HTTP publique	Texte	Non	URL HTTP publique complète. Exemple : `http://pbx.example.com:8667`.
Port HTTP	Texte (numérique)	Non	Port HTTP du service de provisioning. Exemple : `8667`.

Le bouton Enregistrer envoie les trois valeurs (espaces de début/fin retirés). Un message « Paramètres sauvegardés » confirme l'opération ; en cas d'échec, le détail de l'erreur est affiché.

Onglet « DHCP »

Configuration du serveur DHCP intégré, utile lorsque le PBX distribue lui-même les adresses IP des téléphones.

Titre : « DHCP intégré ».
Description : « Configuration DHCP officielle pour les réseaux où le PBX distribue les adresses des téléphones. »

Champ	Type	Obligatoire	Détails
Activer le DHCP	Interrupteur	Non	« À activer uniquement si ce serveur doit distribuer les IP aux téléphones. » Désactivé par défaut.
Interfaces réseau	Texte (liste)	Non	Une ou plusieurs interfaces séparées par des virgules. Exemple : `eth0, ens18`. Les espaces sont nettoyés et les valeurs vides ignorées.
Première adresse	Texte	Non	Première adresse du pool DHCP. Exemple : `192.168.1.100`.
Dernière adresse	Texte	Non	Dernière adresse du pool DHCP. Exemple : `192.168.1.200`.

Le bouton Enregistrer sauvegarde la configuration. Confirmation « Paramètres sauvegardés ».

N'activez le DHCP intégré que si aucun autre serveur DHCP n'est présent sur le réseau, afin d'éviter les conflits d'adressage.

Onglet « Registrars »

Gestion des serveurs SIP (registrars) proposés aux téléphones provisionnés. L'écran est divisé en deux : la liste à gauche et le formulaire à droite.

Liste des registrars

Titre : « Registrars ».
Description : « Serveurs SIP proposés aux téléphones provisionnés. »
Bouton Nouveau registrar : réinitialise le formulaire pour une création (port principal et port proxy principal préremplis à 5060).
Chaque entrée affiche le nom (ou l'identifiant), la transition hôte principal → hôte proxy principal en police à chasse fixe, et un badge avec le port principal (5060 par défaut).
Cliquer sur une entrée la charge dans le formulaire d'édition.
État vide : « Aucun registrar configuré ».
Erreur : le détail est affiché dans la liste.

Formulaire de création / édition

Le titre passe de « Créer un registrar » à « Modifier le registrar ». L'aide indique : « Les champs hôte principal et proxy principal sont obligatoires côté API officielle. »

Champ	Type	Obligatoire	Détails
Nom affiché	Texte	Non	Libellé du registrar.
Identifiant	Texte	—	Lecture seule (désactivé), renseigné automatiquement à l'édition.
Hôte registrar principal	Texte	Oui	Serveur SIP principal. Validation côté formulaire : ne peut pas être vide.
Port registrar principal	Texte (numérique)	Non	Port du registrar principal (`5060` par défaut).
Hôte proxy principal	Texte	Oui	Proxy SIP principal. Validation côté formulaire : ne peut pas être vide.
Port proxy principal	Texte (numérique)	Non	Port du proxy principal (`5060` par défaut).
Hôte registrar de secours	Texte	Non	Registrar de repli.
Port registrar de secours	Texte (numérique)	Non	Port du registrar de secours.
Hôte proxy de secours	Texte	Non	Proxy de repli.
Port proxy de secours	Texte (numérique)	Non	Port du proxy de secours.
Hôte proxy sortant	Texte	Non	Proxy sortant (outbound).
Port proxy sortant	Texte (numérique)	Non	Port du proxy sortant.

Actions du formulaire :

Enregistrer : crée ou met à jour le registrar. Si l'hôte principal ou l'hôte proxy principal est vide, un message d'erreur reprenant l'aide du formulaire est affiché et l'enregistrement est bloqué. Une double soumission est empêchée. Succès : « Paramètres sauvegardés », puis le formulaire est réinitialisé.
Supprimer : visible uniquement en édition et si le registrar est supprimable. Ouvre une confirmation.

Suppression d'un registrar

Une boîte de confirmation s'ouvre :

Titre : « Supprimer {name} ? »
Description : « Les téléphones qui utilisent ce registrar devront être reprovisionnés avec une autre configuration. »
Bouton de confirmation Supprimer (variante destructive).

Après suppression : message « Registrar supprimé » et formulaire réinitialisé.