wazo-provd is the phone provisioning service for the Wazo platform. It generates configuration files for phones and gateways based on the plugins that are installed.
The REST API for wazo-provd is available here
Each model of phone must have its plugin supported by wazo-provd. Plugins are located here
Plugins are meant to be installed and upgraded independently of the OS to be able to use the firmware version that works best for your use case.
Supported plugins are hosted on provd.wazo.community
How it works
Here's a simplified view of how auto-provisioning is supported on a typical SIP hardphone:
- The phone is powered on
- During its boot process, the phone sends a DHCP request to obtain its network configuration
- A DHCP server replies with the phone network configuration + an HTTP URL
- The phone use the provided URL to retrieve a common configuration file, a MAC-specific configuration file, a firmware image and some language files.
Building on this, configuring one of the supported phone on Wazo is as simple as:
- Installing the required provd plugin
- Powering on the phone
- Dialing the user's provisioning code from the phone
And voilà, once the phone has rebooted, your user is ready to make and receive calls. No manual editing of configuration files nor fiddling in the phone's web interface.
On initial insertion into provd, devices are assigned to the tenant of the token used internally by provd, which is the master tenant. When a device is provisioned, it is transferred to the tenant of the line to which it is being associated. When the device is reset to autoprov, the device stays in its tenant. It is not possible to change the tenant of the device once it is set. If you wish to do it anyway, you must delete the device and restart it manually.
- Device synchronisation does not work in situations where multiple devices are connected from behind NAPT network equipment. The devices must be re-synchronised manually.
- There may be an issue if you are using an analog gateway with lines that are not in the same tenant. Indeed, in the case that the gateway is only one device and each port is a separate line, the device will only be seen by the tenant of the first line that was added.
- Introduction to provd plugin model
- HTTP/TFTP requests processing in provd - part 1
- HTTP/TFTP requests processing in provd - part 2