Snom Service Hub

Content

Page tree

Index:

Introduction

In phone provisioning, placeholders serve as dynamic variables that are substituted with specific values when a phone makes a provisioning request to the server. This approach allows for flexible and scalable configurations, particularly in environments where numerous devices require unique settings.

Supported Placeholders:

  • <mac>: Represents the device's unique MAC address.
  • <phone_type>: Indicates the model or type of the phone making the request.
  • <time>: Captures the timestamp of when the provisioning request is made.

The placeholders are replaced with actual values during the provisioning process, ensuring that the server generates a tailored configuration for each phone.


Benefits of Using Placeholders

  • Scalability: Placeholders eliminate the need to manually create individual configuration files for every device.
  • Consistency: Ensures uniform application of settings while still accommodating device-specific requirements.
  • Reduced Maintenance: Simplifies updates by allowing changes to be applied universally via template configurations.
  • Dynamic Adaptation: Adapts configurations in real-time based on the specific phone and its context.


Use cases for placeholders

MAC Address-Based Configuration:

Scenario: A service provider wants to assign a unique configuration to each phone based on its MAC address.

setting_server=https://provisioning.example.com/configs/<mac>.xml


When a phone with the MAC address 0004132B3C4D requests provisioning, the server replaces <mac> with the actual MAC address, generating the URL:

setting_server=https://provisioning.example.com/configs/0004132B3C4D.xml


Phone Model-Specific Settings

Scenario: A company manages multiple phone models and needs to assign settings tailored to each model.

firmware=https://updates.example.com/firmware/<phone_type>.bin


 If the provisioning request comes from a D865 phone, the <phone_type> placeholder is replaced, resulting in:

firmware=https://updates.example.com/firmware/snomD865.bin


Dynamic Background Image Fetching Based on Timestamp

Scenario: A company wants phones to display a dynamically updated background image that changes periodically, such as daily updates or based on specific events. The timestamp (<time>) ensures that each phone fetches the most recent image.

custom_bg_image: https://assets.example.com/backgrounds/background_<time>.jpg


When a phone makes a provisioning request on 2024-11-18T08:00:00Z, the <time> placeholder is replaced with the timestamp of the request. The resulting URL might be:

https://assets.example.com/backgrounds/background_2024-11-18T08-00-00.jpg


Conclusion

Using placeholders in phone provisioning enables dynamic, efficient, and scalable configuration management. By leveraging <mac>, <phone_type>, and <time>, administrators can create flexible templates that adapt to the unique needs of each device, reducing manual effort and improving operational efficiency.



Further Information


Related articles